Installing Unified Metasys Server on Server OS - Metasys - LIT-12012162 - MS-ADS05U-0 MS-ADX10U-0 MS-ADX10SQL-0 MS-ADX25U-0 MS-ADX25SQL-0 MS-ADX50U-0 MS-ADX50SQL-0 MS-ADX50SQL2-0 MS-ADX100U-0 MS-ADX100SQL2-0 - Server - Metasys Server - 12.0.50

Metasys Server Installation and Upgrade Instructions

Product
Building Automation Systems > Application Servers > Metasys Server
Document type
Installation Guide
Document number
LIT-12012162
Version
12.0.50
Revision date
2023-10-12
Product status
Active
Table 1. Supported Platforms Unified Metasys Server on Server OS

Supported Operating System

Supported Database Options

Windows® Server® 2019 (version 1809 or later) (64-bit)

Windows® Server® 2016 (version 1607 or later) (64-bit)

SQL Server® 2019 with CU19 (64-bit)

SQL Server® 2017 with CU31 (64-bit)

SQL Server® 2016 with SP3 GDR (64-bit)

Use the steps in the following table for installing and configuring the Metasys Server software on a computer with a server operating system.

Table 2. Installing Unified Metasys Server on Server OS

Step

Action

Reference or Additional Steps

1.

Verify that the computer intended for Metasys Server software is running one of the following supported Windows Server operating systems:
  • Windows® Server® 2019 (version 1809 or later) (64-bit)
  • Windows® Server® 2016 (version 1607 or later) (64-bit)
Ensure you run Windows Update to verify the operating system is up to date.

Open a command prompt window and run the command Winver as Administrator. The Windows version is listed in the dialog box that appears. Start Windows Update from the Search box and apply all required and recommended updates before installing any Metasys software.

2.

Verify that the computer name is valid for Metasys Server software.

In Control Panel, click System and Security > System and verify the computer name that appears in the window meets the following criteria:
  • begins with a letter, not a number
  • contains a maximum of 15 characters
  • contains only letters A-Z (upper or lower case), numbers 0-9, and hyphens
    Note: Underscores are not valid for the Metasys system.
  • does not end in letters ADS
  • does not contain any diacritic or accent marks

3.

Configure the Windows Firewall to ensure the ports that Metasys software requires are open.

See Configuring the Windows Defender firewall.

4.

Follow the appropriate step:
  • If you are installing the Metasys Server software on an English language computer, skip to the next step.
  • If you are installing the Metasys Server software on a non-English language computer, you need to set the computer's regional settings and the default language used by the SQL Server database to the same locale as the site default language.

Consult the Microsoft documentation and see Installing Metasys server for a non-English locale.

5.

If the computer has multiple network cards, configure the network card that the Metasys Server software is to use.

See Configuring Additional Network Cards.

6.

Install Microsoft .NET Framework 3.5 if the computer does not have this software feature installed.

In Control Panel, click Programs > Programs and Features > Turn Windows features on and off. Click the Microsoft .NET Framework 3.5 or .NET Framework 3.5 feature. Check the HTTP Activation component. If you do not have Internet access, insert the operating system media, open a Command prompt with Run as Administrator, and execute this command (where <drive> is the disk drive with the media): Dism /online /enable-feature /featurename:NetFx3 /All /Source:<drive>:\sources\sxs /LimitAccess.

On server-class OSs, use the Add Roles and Features Wizard in Server Manager to add the .NET Framework 3.5 Features and HTTP Activation components. On some server-class OSs, HTTP Activation may be listed under WCF Services.

7.

Make sure all required software components are enabled.

See Required Windows operating system roles and features for more information.

8.

Install a supported version of SQL Server Standard or Enterprise software to the C: drive (primary partition), including the recommended cumulative update, if any. Select the Database Engine Services and Management Tools components. If you are installing SQL Server 2016 and you plan to install the Metasys Advanced Reporting System with the ADX also select Reporting Services. For SQL Server 2017, use the standalone Reporting Services installer.
Note: If you want to install SQL Server software to an alternative disk drive (for example, E: drive), you need to follow some special steps. For details, see Specifying Custom Locations for Metasys Server Application and Databases.

Refer to SQL Server Installation and Upgrade Instructions (LIT-12012240). For the standalone Reporting Services installer, download SQL Server 2017 Reporting Services.

9.

If you intend to use the Metasys Advanced Reporting System, verify that Reporting Services is configured properly.
Note: SQL Server 2019 does not support Metasys Advanced Reporting System.

Refer to the Verifying SQL Server Reporting Services Configuration section of SQL Server Installation and Upgrade Instructions (LIT-12012240).

10.

Install support files if you plan to offer the Site Management Portal in languages other than English.

Refer to the Appendix: Reporting Services Language Support for Metasys Advanced Reporting System of SQL Server Installation and Upgrade Instructions (LIT-12012240).

11.

If you want the Metasys Server to use trusted certificates instead of self-signed certificates (the default), configure the certificates on the Metasys Server before installing the software. Otherwise, go to the next step.

See Appendix: Certificate management and security.

12.

Install the Metasys Server software.

See Installing Metasys Server: Default Method. However, if you want to install to an alternate disk drive or will be installing an ADX with Advanced Reporting, see Installing Metasys Server: Custom Method.

13.

License the Metasys ADX software with the Software Manager

See Licensing the Metasys Server Software, including steps for enabling and installing FIPS and for installing the MVE software

14. Install and license any other Metasys software at this time, including the Metasys Export Utility and MVE.

Refer to their respective installation documents. For MVE, see Installing MVE Software.

15.

Start Metasys UI to verify proper operation.

Metasys UI Help (LIT-12011953)

16.

(Optional) License SMP software.

Note: An SMP license is not required if MVE is installed and licensed.
Refer to Metasys Software Purchase Options Product Bulletin (LIT-12011703)

17.

(Optional) If you want to move the Metasys historical databases now, use SQL Management Studio to move the databases to the desired location.

See Moving Metasys Historical Databases to a Custom Location.

18.

(Optional) Start Launcher and add a profile for the Site Management Portal (SMP).

Refer to Launcher Tool Help (LIT-12011742) .

19.

(Optional) Start Metasys SMP from the Launcher and verify proper operation.

See Launching the User Interfaces .

20.

(Optional) Install the Metasys Database Manager.
Note: Metasys Database Manager is not FIPS compliant.

Refer to the Metasys Database Manager Installation Guide (LIT-12011553) .

21.

If prompted, restart the computer.

Use the standard procedure to restart the operating system.

22.

(Optional) If you need the server to be FIPS compliant, enable FIPS mode and install the Metasys FIPS component.

See Enabling and installing FIPS component.