Metasys Server Lite Installation and Upgrade Instructions
[Pages:108]Metasys Server Lite Installation and Upgrade Instructions
MS-ADSLE5U-x, MS-ADSLA5U-x Building Technologies & Solutions 2022-05-20
LIT-12012258 Release 12.0
2
Metasys Server Lite Installation and Upgrade Instructions
stnetnoC
Contents
Welcome............................................................................................................................................................ 5 Summary of Changes............................................................................................................................ 5
Getting Started................................................................................................................................................. 5 Licensing................................................................................................................................................. 6 Prerequisite Software Checklist for Installation and Upgrade.........................................................6 Recommended OS and SQL Server Combinations............................................................................ 7 Pre-work checklist for installs and upgrades..................................................................................... 8
Metasys Server Lite Installation................................................................................................................... 12 Installing Metasys Server Lite on Desktop OS................................................................................. 12 Installing Metasys Server Lite and SCT on Desktop OS.................................................................. 15
Metasys Server Lite In-Place Upgrade.........................................................................................................18 In-Place Upgrade Considerations......................................................................................................18 Upgrading Metasys Server Lite on Desktop OS (In-Place)............................................................. 26 Upgrading Metasys Server Lite and SCT on Desktop OS (In-Place).............................................. 32
Metasys Server Lite Out-of-Place Upgrade................................................................................................. 40 Out-of-Place Upgrade Considerations.............................................................................................. 40 Upgrading Metasys Server Lite on Desktop OS (Out-of-Place)..................................................... 48 Upgrading Metasys Server Lite and SCT on Desktop OS (Out-of-Place)...................................... 53
SQL Server Software...................................................................................................................................... 59 Verifying your computer has a supported version of SQL Server software installed................. 61
Uninstalling the Metasys Server Lite Software........................................................................................... 61 Metasys Server Lite Software........................................................................................................................62
Installing Metasys server for a non-English locale.......................................................................... 63 Installing Metasys Server Lite: Default Method...............................................................................64 Installing Metasys Server Lite: Custom Method.............................................................................. 65 Upgrading Metasys Server Lite..........................................................................................................66 Licensing the Metasys Server Lite Software..................................................................................... 67 Enabling and installing FIPS component.......................................................................................... 67 Uninstalling and unlicensing FIPS component................................................................................ 69 Installing Microsoft Silverlight 5................................................................................................................... 70 Launching the User Interfaces..................................................................................................................... 70 Launching the ADS-Lite SMP UI......................................................................................................... 70 Launching the Metasys UI.................................................................................................................. 71 Appendix: Windows firewall..........................................................................................................................72 Configuring the Windows firewall..................................................................................................... 72 Closing ports........................................................................................................................................ 74 Appendix: Certificate management and security.......................................................................................76 Requesting a server certificate.......................................................................................................... 77 Completing a server certificate request........................................................................................... 77 Binding the secure certificate............................................................................................................ 77
Metasys Server Lite Installation and Upgrade Instructions
3
Importing root and intermediate certificates.................................................................................. 78 Verifying the server certificate chain.................................................................................................79 Removing or rebinding the secure certificate..................................................................................79 Removing the self-signed certificates in the certificate store........................................................79 Certificate management troubleshooting........................................................................................80 Setting the Site Security Level to Encrypted and Trusted............................................................... 81 Changing Advanced Security Enabled to False................................................................................ 82 Appendix: General Troubleshooting............................................................................................................83 Required Windows operating system roles and features.............................................................. 83 Using MetasysSysAgent User Name and Password........................................................................86 General Troubleshooting....................................................................................................................86 Metasys Server Installation Log.........................................................................................................99 Related Documentation...................................................................................................................... 99 Appendix: Special Scenarios......................................................................................................................... 99 Specifying Custom Locations for Lite Application and Databases................................................ 99 Moving Metasys Historical Databases to a Custom Location...................................................... 101 Configuring Additional Network Cards...........................................................................................102 Customizing Windows IIS for Metasys API.....................................................................................104 Configuring a Virtual Machine for Metasys Server Lite................................................................ 106 Software terms............................................................................................................................................. 106 Product warranty..........................................................................................................................................107 Patents...........................................................................................................................................................107 Contact information.....................................................................................................................................107
4
Metasys Server Lite Installation and Upgrade Instructions
Welcome
Welcome to the Metasys? Server Lite Installation and Upgrade Instructions. The document guides you through the steps you need to follow to install or upgrade the Metasys Server Lite software. The instructions apply to both the Metasys Server Lite Europe and the Metasys Server Lite Asia products. The Metasys Server Lite products are also referred to as the Application and Data Server (ADS) Lite.
To use the Help System zip file, download the zip file. Unzip the contents and run the launch.html file from a browser.
Summary of Changes
The following information is new or revised:
? Updated the version numbers in Prerequisite Software Checklist for Installation and Upgrade for the Metasys products installed.
? Removed support for Microsoft? Windows? 7 as a Metasys Server Lite operating system. Also, updated the service pack numbers for supported products in Prerequisite Software Checklist for Installation and Upgrade and Recommended OS and SQL Server Combinations.
? Updated version number for Metasys Server Lite software from Release 11.0 to 12.0 throughout document.
? Updated version number for SCT software from Release 14.2 to 15.0 throughout document.
? Updated installation sections to remind users to verify that all required software components are enabled.
? Added information about Device archive failed (543) error in the General Troubleshooting section.
Getting Started
The Metasys Server Lite setup is a comprehensive utility that installs many of the components required by the Metasys system. The following tables list the components installed by the Metasys Server Lite installer. For the software listed under the Components and Products NOT Installed column, use the respective installation programs to add those components and applications.
Table 1: Components installed and not installed with Metasys Server Lite
Windows? Components Installed
Metasys Products Installed
Components and Products NOT Installed
? Microsoft? Internet Information Services (IIS)
? Application and Data Server ? SQL Server Management Lite (ADS-Lite) at Release 12.0 Studio Express
? Microsoft .NET Framework ? Metasys UI Release 6.0
4.7.2
? Launcher 2.0
?
Microsoft Visual C++ Runtime Libraries
?
Software Manager Release 3.0
? Microsoft Message Queuing (MSMQ)
? Metasys databases
? Microsoft? SQL Server? 2017 Express CU17 64-bit
? Site Management Portal (SMP)
? Microsoft .NET Framework 3.5
? System Configuration Tool (SCT)
? Graphics+ Generation Tool (GGT)
? Metasys Export Utility
? Metasys Database Manager
? Johnson Controls System Configuration Tool (JCT)
Metasys Server Lite Installation and Upgrade Instructions
5
Note: The Metasys Server Lite setup attempts to install the Microsoft .NET Framework 3.5 component. If the computer that you are installing the Metasys Server on does not have access to Windows updates, the installation of this component fails. If installation of this component fails, install it manually.
The following table lists the third-party components installed with the Metasys Server Lite setup at Release 12.0.
Table 2: Third-Party Components Installed with the Metasys Server Lite Setup
Third-Party Component
Brief Description
Erlang OTP 23.2 (11.1.4)
A required component for RabbitMQ functionality.
RabbitMQ Server 3.8.16
RabbitMQ is a service bus used to send notification messages to other services and is used for inter-process communication (messages) on the server.
Set Rate Limits
IIS module that applies rate limiting to Metasys API calls. This module and settings do not apply to SMP or MUI.
GraphDB
GraphDB is an enterprise ready Semantic Graph Database
Licensing
The Metasys Server Lite requires a software license for its base product. An application called Software Manager, installed with Metasys Server Lite software, manages Metasys software licenses on a machine. We recommend that you license Metasys Server Lite software immediately after installation. Also installed with the Metasys Server Lite is the Monitoring and Commanding API, which you also need to license. Metasys UI, however, does not require a separate license. For information about activating licenses, refer to the Starting a license activation section in the Software Manager Help (LIT-12012389).
Note: SMP requires a license at Release 12.0, except for an ADX with MVE installed and licensed.
Prerequisite Software Checklist for Installation and Upgrade
Before you begin with the Metasys Server Lite installation or upgrade, review the following table to verify that you have the required software. The table also indicates where you can obtain each software component.
Table 3: Prerequisite Software Checklist Software Component
Products
Where to Obtain
Operating System1 (select one)
Windows? 10 Pro and Windows 10 Enterprise Editions versions 2004, 21H1, and 21H2 (64-bit). For all future Windows 10 updates after version 21H2, we will evaluate and certify that Metasys software can support the updates before we provide guidance on support.2
ADS-Lite/SCT
Microsoft Corporation
Operating System (OS) Components (installed by Metasys Server Lite)
6
Metasys Server Lite Installation and Upgrade Instructions
Table 3: Prerequisite Software Checklist Software Component
Products
Where to Obtain
Internet Information Services (IIS)3
ADS-Lite/SCT OS media
Microsoft Message Queuing (MSMQ)2 Miscellaneous (select all)
Microsoft .NET Framework 3.5
ADS-Lite/SCT OS media
Microsoft .NET Framework 4.7.2 (installed by Metasys Server Lite) Microsoft Silverlight? 5.0 or higher4
Database (select one)
silverlight
SQL Server? 2019 Express with CU14 (64bit)
SQL Server? 2017 Express with CU27 (64bit)
SQL Server? 2016 Express with SP2 CU17 (64-bit)
Database Tools
ADS-Lite/SCT Microsoft Corporation
ADS-Lite/SCT Microsoft Corporation
ADS-Lite/SCT Microsoft Corporation or License Portal
SQL Installer Tool
ADS-Lite/SCT License Portal
Microsoft SQL Server Management Studio Express5
License Portal Microsoft Download Center
1 We highly recommend that the computer you want to use for Metasys software had its operating system installed on a cleanly formatted hard disk. If you use a computer that was upgraded from a previous version of Windows, files and registry settings left behind after the upgrade may adversely affect the installation of Metasys system software.
2 Metasys system software does not support the touch screen interface that is featured in the Windows 10 operating system.
3 The Metasys Server Lite install program adds this component for you if missing. 4 Required for viewing Graphics+ files on Site Management Portal software clients. 5 A software database management tool used for SQL Server software. Depending on which SQL Server Express version
you install, this tool may or may not be included.
Recommended OS and SQL Server Combinations
The following table lists by operating system the SQL Server software editions that have been fully qualified by Johnson Controls for Metasys Server Lite for the current release. You can select other combinations, but we recommend that you select from the following pairings.
Metasys Server Lite Installation and Upgrade Instructions
7
Table 4: Recommended Operating System and SQL Server Combinations
Operating System
Database Software
SQL Server? 2019 Express with CU14 (64-bit)
SQL Server? 2017 Express with CU27 (64-bit)
SQL Server? 2016 Express with SP2 CU17 (64-bit)
Windows? 10 Pro and
x
x
x
Windows 10 Enterprise
Editions versions 2004,
21H1, and 21H2 (64-
bit). For all future
Windows 10 updates
after version 21H2,
we will evaluate and
certify that Metasys
software can support
the updates before we
provide guidance on
support.
Pre-work checklist for installs and upgrades
Review the following table for steps to perform before you travel to the customer's site for upgrading their Metasys system.
Table 5: Pre-work Checklist
Step Action
Details
Review related documentation
Download and review all the relevant Flash Sheets, FYIs, and Quick Patches from the portal. Links to all these resources are available on the Field Support Center Find Answers page. Download and review all the relevant product literature from the Knowledge Exchange website. Knowledge Exchange has the most up-to-date versions of product literature.
Verify that the OS and See Prerequisite Software Checklist for Installation and
SQL Server software
Upgrade.
versions on the target
computer are supported
for Release 12.0. Also
check that all available
Windows updates and
SQL Server cumulative
updates have been
applied.
Understand steps for installing Metasys software on a virtual machine (VM)
If you are upgrading from a hardware ADS-Lite server to a virtual ADS-Lite server, ensure the virtual server is running in static memory mode, not dynamic. Otherwise, operational issues with SQL Server may occur. Also, configure the ADS-Lite VM with the same amount of memory as the hardware ADS-Lite server, or with 8GB to 16GB for ADS-Lite on Windows OS VMs.
8
Metasys Server Lite Installation and Upgrade Instructions
................
................
In order to avoid copyright disputes, this page is only a partial summary.
To fulfill the demand for quickly locating and searching documents.
It is intelligent file search solution for home and business.
Related download
- introduction
- eviews tutorial 10 1 1 princeton university
- the perfect everyday all in one printer
- windows 10 deployment
- dell wyse thinos 8 6 024 and thinos lite 2 6 024
- installing ghostscript on windows 10
- windows 10 osd configmgr best practices
- configuring windows installing the melco software
- smartonline 200 240v 10kva 9kw double conversion ups 6u
- kingston mobilelite wireless
Related searches
- installation and operation qualification
- sql server 2016 installation steps
- sql server 2016 installation file
- exchange server 2016 installation guide
- windows server 2016 installation guide
- exchange server 2016 installation steps
- sql server 2016 installation media
- sql server installation center 2016
- nexplanon removal and insertion instructions professional
- shocks and strut installation deals
- sql server 2016 installation guide
- your colleague is trying to upgrade from windows server 2008