Upgrading Unified Metasys Server and SCT 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 name
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 with SCT 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 upgrading the Metasys Server and SCT software on a computer with a server operating system.

Table 2. Upgrading Unified Metasys Server with SCT on Server Computer (In-Place)

Step

Action

Reference or Additional Steps

1.

Create a full disk image backup of the computer's hard drive to external media before upgrading any Metasys software (optional but recommended).

Refer to the documentation that came with your operating system backup software.

2.

Check if the computer has a SHA256 self-signed certificate bound to Default Web Site in IIS. If the Metasys Server computer has a purchased certificate from a certificate authority (CA), determine if this is a SHA256 (Secure Hash Algorithm) certificate. If so, follow the steps on the right. If not, skip to the next step. Also, for more details, refer to the Network and IT Guidance Technical Bulletin (LIT-12011279) .

  1. In Control Panel, click System and Security > Administrative Tools.
  2. Start IIS Manager. Expand the server, then expand Sites.
  3. Click Default Web Site. Click Bindings in the right pane. The Site Bindings window appears.
  4. Look for a Site Binding called Type: https, Port: 443. If this site binding is not present, skip these substeps.
  5. If this site binding is present, select it and click Edit.
  6. In the Edit Site Binding window, click View.
  7. Read the values in the Issued to: and Issued by: fields. If these values are the same, the computer has a self-signed certificate. If these values are different, the computer has a purchased certificate from a CA.
  8. On the Certificate window, click Details.
  9. Read the value for the signature hash algorithm. If the value is not at least sha256, you need to update your certificate. The upgrade will not overwrite bound site certificates with at least a 256-bit RSA.
    1. If you have a self-signed certificate, or have a purchased one from a CA that does not need to be updated, make no changes.
    2. If you need to update a purchased certificate, make no changes, and contact your public CA for how to update your signed certificate to at least SHA256. If you continue with server installation now, a self-signed certificate is installed, which you can replace with a purchased certificate after the upgrade.
  10. Close IIS Manager.

3.

Upload and back up all Metasys Server and network engine archive databases to the existing SCT. Make sure you select the Include Security option for the upload.

Refer to Database Uploading, Downloading, and Synchronization of SCT: System Configuration Tool Help (LIT-12011964) or the SCT Technical Bulletin (LIT-1201534) for the release you have currently installed (not the new release).

4.

Determine if you need to record existing user accounts and roles:
  • If the current Metasys system is at Release 5.2 and earlier, follow the steps on the right.
  • If the current Metasys system is at Release 6.0 or later, skip to the next step.

Log in to SCT and open the Security Administrator tool (Tools > Administrator). In Security Administrator, record all roles, local user accounts, and Active Directory user accounts that you want to recreate in the upgraded SCT. All customized roles and user accounts are lost when you uninstall SCT 5.2 (or earlier) and install a newer version of SCT. For easy recall later, you may find it helpful to use the computer's print screen function to capture the user access permissions and other information for each role. Refer to the Metasys Site Management Portal Help (LIT-1201793) for Release 5.2 or earlier.

5.

Forward all trend samples from each network engine to the Metasys Server Site Director by using the Route Samples command at each engine. This step ensures that the Site Director has all possible samples before you begin the upgrade. Wait a few minutes to ensure that all samples have been forwarded.

Refer to Metasys Site Management Portal Help (LIT-1201793) for information about the Route Samples command.

6.

Stop the Metasys III Device Manager service on the Metasys Server computer. This action prevents the collection of any new audits, alarms, trends, and annotations while you perform the upgrade. If the customer can accept the loss of data samples during an upgrade, you can skip to the next step.

Right-click the Windows taskbar and start Task Manager. Click the Services tab. Locate a service called Metasys III Device Manager. Select this service and right-click and select Stop Service. The Metasys III Device Manager service stops.

7.

Perform a complete backup of all historical data in the Metasys Server computer with the Metasys Database Manager. If the system to be upgraded is at Release 8.0 or 8.1, after the historical databases are backed up, use the SQL Server Management Studio to backup the SpacesAuthorization database. After the installation is complete, restore the SpacesAuthorization database.

Refer to Backing Up a Database in Metasys Database Manager Help (LIT-12011202) .

8.

Make a copy of each historical database backup file and archive backup file and store them on removable media for example, a flash drive or DVD.

Use Windows Explorer to prepare and archive the file copies.

9.

Uninstall the Ready Access Portal software if currently installed.

Refer to the Uninstalling Ready Access Portal Software section in the Ready Access Portal Software Installation Instructions (LIT-12011523) .

10.

Uninstall the NxE Information and Configuration Tool (NCT) if present.

In Control Panel, click Programs > Programs and Features. Select the program from the list and click Uninstall.

11.

Uninstall the Metasys Export Utility software if currently installed.

In Control Panel, click Programs > Programs and Features. Select the program from the list and click Uninstall.

12.

Uninstall Energy Essentials if present. This uninstall step is required before you uninstall the Metasys Server software in a later step.

In Control Panel, click Programs > Programs and Features. Select the program from the list and click Uninstall.

13.

Select the appropriate action:
  • If Metasys UI Online Release 1.5.1 or earlier software is installed, uninstall Metasys UI Online.
  • If Metasys UI Online Release 2.0 or higher is installed, skip to the next step.

In Control Panel, click Programs > Programs and Features. Select the program from the list and click Uninstall.

14.

Select the appropriate action:
  • If Metasys UI Offline Release 1.5.1 or earlier software is installed, uninstall Metasys UI Offline.
  • If Metasys UI Offline Release 2.0 is installed, or Metasys UI Offline is not installed, skip to the next step.

In Control Panel, click Programs > Programs and Features. Select the program from the list and click Uninstall.

15.

Select the appropriate action:
  • If the site is at Release 7.0 or earlier, uninstall the NAE Update Tool if present. This uninstall step is required before you can install or upgrade to the new version of SCT.
  • If the site is at Release 8.0 or later, skip to the next step.

In Control Panel, click Programs > Programs and Features. Select the program from the list and click Uninstall.

16.

Uninstall the existing MVE software if present.

See Uninstalling MVE Software.

17.

Select the appropriate action:
  • If the computer has Metasys Server software at Release 7.x or earlier, uninstall the existing Metasys Server software. When prompted, select to remove license keys because you are upgrading to a new major software release.
  • If you uninstalled MVE in the previous step, uninstall the Metasys Server software.
  • If the computer has Metasys Server software at Release 8.x or later, and did not have MVE installed, skip to the next step.

See Uninstalling the Metasys Server Software Introduction.

18.

Select the appropriate action:
  • If you have SCT Release 7.0 or later, skip to the next step.
  • If you have SCT Release 6.5.x or earlier, follow the steps to the right to manually record all SCT users.
  1. Log in to SCT and open the Security Administrator tool (Tools > Administrator).
  2. In Security Administrator, record all SCT roles, local user accounts, and Active Directory user accounts that you want to recreate in the upgraded SCT. All SCT customized roles and user accounts are lost when you uninstall SCT in the next step.
  3. For easy recall later, you may find it helpful to use the computer's print screen function to capture the user access permissions and other information for each role.

19.

Select the appropriate action:
  • If the site is at Release 7.0 or earlier, uninstall the current version of Metasys Launcher from the Metasys Server computer and remove from all clients that log in to the Metasys Server.
  • If the site is at Release 8.0 or later, skip to the next step.

In Control Panel, click Programs > Programs and Features. Select Johnson Controls - Launcher from the list of programs and click Uninstall.

20.

Select the appropriate action:
  • If you have SCT Release 6.5.x or earlier, skip to the next step.
  • If you have SCT Release 7.0 to 13.1, or 15.0.1, follow the steps to the right.
  • If you have SCT Release 13.2 to 14.2.x, upgrade to SCT 15.0.3 software. Then license the SCT 15.0.3 software with the Software Manager. For details, refer to the SCT Installation and Upgrade Instructions (LIT-12012067)
  1. Uninstall the existing SCT 7.0 to SCT 13.1 software. To retain the SCT security database, make sure that you uncheck the box for removing databases. For details, refer to the SCT Installation and Upgrade Instructions (LIT-12012067) .

  2. Install SCT 15.0 software. Then license the SCT 15.0 software with the Software Manager. For details, refer to the SCT Installation and Upgrade Instructions (LIT-12012067) .

21.

Select the appropriate action:
  • If you have SCT Release 7.0 or later, skip to the next step.
  • If you have SCT Release 6.5.x or earlier, follow the steps to the right.
  1. Uninstall the existing SCT 6.5.x or earlier software. The SCT and Metasys Server security databases are not separate at Release 6.5.x or earlier, so an SCT upgrade option is not available. Refer to the Uninstalling SCT section of the SCT Installation and Upgrade Instructions (LIT-12012067) .

  2. Install and license the SCT 15.0 software. Refer to the SCT Installation and Upgrade Instructions (LIT-12012067) .

22.

Start SCT from the Launcher or the Metasys SCT shortcut. Log in with the MetasysSysAgent user and password. The login process could take a little longer than usual.

Refer to Launcher Tool Help (LIT-12011742) .

23.

As part of the in-place upgrade, open the archive database with SCT by clicking Item > Open Archive. See the information on the right.

Select the appropriate action:
  • If the archive database is not listed, use SCT to restore the database (Tools > Database > Restore Backup). After the restore completes, open the archive by clicking Item > Open Archive. Click Upgrade to upgrade the archive to the new release.

  • A message to upgrade the archive to this Metasys system release appears. Click Upgrade Archive to upgrade the archive to the new release.

24.

Select the appropriate action:
  • If you upgraded SCT from Release 7.x or later skip to the next step.
  • If you upgraded SCT from Release 6.5.x or earlier, start SCT. Open the Security Administrator tool (Tools > Administrator). In Security Administrator, recreate all roles, user accounts, and Active Directory user accounts that were present in the old version of SCT (or, create a new limited set of SCT users). If you made screen captures of the SCT roles and users in an earlier step, use these screens as a guide for adding the roles and user accounts to SCT.

Refer to the Security Administrator System Technical Bulletin (LIT-1201528) .

25.

Uninstall the Metasys Database Manager if currently installed.

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

26.

If you uninstalled the Metasys Server software in a previous step, install the Metasys Server 12.0.50 software now. Otherwise, upgrade the Metasys Server 12.0.50 software now.

To install, see Metasys Server Software. To upgrade, see Upgrading Metasys Server.

27.

License the Metasys Server software and SMP software with the Software Manager.

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

28.

Start Launcher on the computer and launch the Site Management Portal (SMP) for the upgraded Metasys Server.

Refer to Launcher Tool Help (LIT-12011742) .

29.

To verify Metasys Server operation, log in to the Metasys Server using the MetasysSysAgent user and password.

See Launching the User Interfaces.

30.

Log in to SCT 15.0 and open the archive database. Allow SCT to upgrade the database to Release 15.0.

Refer to SCT: System Configuration Tool Help (LIT-12011964) .

 

Log on to SCT 15.0, then use the Manage Archive wizard to upgrade the ADS/ADX device to Release 12.0. When asked to enter the Metasys Server user credentials, specify the MetasysSysAgent user and password. If during the upgrade process an Upgrade Warning dialog box appears regarding password resets, set a default password for the affected users, then contact the users of their new default password. Each affected user is prompted to change this default password when logging on to the Metasys Server 12.0.50 for the first time.

Refer to SCT: System Configuration Tool Help (LIT-12011964) .

31.
If you upgraded the ADS/ADX device in your SCT archive from a Metasys version prior to Release 12.0, to Release 12.0, confirm the following:
  • All Third party BBMDs are compatible with the upgraded Metasys server (no checks needed if no Third party BBMDs are configured for the site).
  • All Email DDA destinations are compatible with the upgraded Metasys server (no checks needed if no Email DDA destinations are configured for the Metasys server).

To check the configuration of the Third party BBMDs, see Checking third party BBMDs compatibility for ADS/ADX upgrades.

To check the configuration of the Email DDA destinations, see Checking email DDA compatibility for ADS/ADX upgrades.
Note: The archive download to a Release 12.0 ADS/ADX fails if these attributes have an incompatible configuration. For more information, see General Troubleshooting.

32.

Download the Site Director archive database from SCT 15.0 to the Metasys Server Site Director, making sure that you click Include Security. When asked to enter the Metasys Server user credentials, specify the MetasysSysAgent user and password. If the login for the Metasys Server fails, click the Clear Security Database tab and click Set to be cleared. The device is upgraded, but the security database is removed from the archive.
Note: A Server download logs off Metasys UI and SMP users.
Note: Before you attempt a download/upload to the server from SCT, wait for it to become operational. If you perform a download/upload before then, the server does not operate correctly. To fix this, restart the Metasys server host, wait for it to become operational, and try the process again.

Refer to Database Uploading, Downloading, and Synchronization in SCT: System Configuration Tool Help (LIT-12011964) for information on downloading.

33.

(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.

34.

As part of the in-place upgrade, install the Metasys Database Manager at Release 12.0.50.

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

35.

Update the network engines that you want to upgrade to Release 12.0.
Note: If you are upgrading from Release 5.2 or later, you do not need to update all devices to the newer release (except the Site Director). SCT 15.0 supports devices at multiple Metasys software releases, beginning with Release 5.2.

Refer to NAE Update Tool Help (LIT-12011524) and SCT: System Configuration Tool Help (LIT-12011964) .

36.

If you updated network engines to Release 12.0, use SCT 15.0 to download the archive database of each network engine. The download also restores the Security database. After the download completes, issue the Reset Device command to each downloaded N40-class device (NxE35, NIE39, NxE45, NIE49, NxE25, or NIE29s) to ensure that the security database is archived to non-volatile memory. This step is new beginning at Release 8.0, but is not required for any other network engine (for example, NxE55s, NxE59s, SNEs, and SNCs).

Refer to Database Uploading, Downloading, and Synchronization in SCT: System Configuration Tool Help (LIT-12011964) for information on downloading.

37.

If you need to bind a purchased SHA256 certificate from a public certificate authority, follow the steps on the right.
Note: The purchased certificate must be SHA256 to work with Metasys UI.
  1. In Control Panel, click System and Security > Administrative Tools.
  2. Start Internet Information Services (IIS) Manager.
  3. Expand the server, then expand Sites.
  4. Click Default Web Site.
  5. Click Bindings in the right pane. The Site Bindings window appears.
  6. Select the Site Binding called Type: https, Port: 443.
  7. Click Edit. The Edit Site Binding window appears with the SSL certificate drop-down list currently showing MUI Application Server. Click Select and select your signed certificate on the Select Certificate window.
  8. Click OK to confirm your selection, then click OK on the Edit Site Binding window.
  9. Close all windows.
38.

Create a full disk image backup of the computer's hard drive to external media (optional but recommended).

Refer to the documentation that came with your operating system backup software.