Follow the steps in this section if you want to use the custom method of installing Metasys Server software. Use the custom method for any of the following reasons:
- you want to select a specific SQL Server instance other than MSSQLSERVER
- you want to install the Metasys Server software in a location other than the default location (C:\Program Files (x86)\Johnson Controls)
- you want to install the third-party applications that the Metasys Server uses (RabbitMQ and Erlang/OTP) in a location other than the default location (C:\Program Files (x86)\Johnson Controls)
- you want to install the Metasys Advanced Reporting System on the Metasys Server
- you want to install a split ADX
When you begin the installation process, Metasys Server Setup detects whether the computer has a previous release of ADS/ADX software and meets the prerequisites defined in this document. If pre-Release 8.0 ADS/ADX software is found, a message appears requesting you to uninstall the ADS/ADX software first; see Uninstalling Metasys Server Software. If Release 8.0 or later ADS/ADX software is found, an upgrade option is available. Skip this section and go to Upgrading Metasys Server. Also, before you start the installation process, close Software Manager if currently open.
- Obtain the Metasys Server installation file (MetasysServer_12.0.50.exe) and Metasys Server data file (MetasysServer_12.0.50.data). Store both files in the same location.
- Using Windows Explorer, browse to the location of the Metasys Server installation and data files.
- Right-click MetasysServer_12.0.50.exe and select Run as Administrator. Enter the
Administrator's user credentials if prompted. The setup window appears. Figure 1. Metasys Server Setup Window
- Click Custom. The Database screen appears.Figure 2. Metasys Server Database Window
- Under the Database section, select from these options:
-
Install SQL Server Express
Locally
: Click this option if you want the Metasys Server Setup program to
install a local instance of SQL Server 2017 Express with CU19. This option is disabled
on computers with a Windows Server operating system. If the computer has an
unsupported version of SQL Server Express software, the installation halts with a
message that you must upgrade to a supported version. Note: This option is only available on Windows 10 host computers when a SQL Server instance is not present.
- Use Existing Database Server : Click this option if an instance of SQL Server software is installed on the computer already, then select the server instance name.
-
Server Name
: Click the down arrow to select the server name of the SQL database
engine installed on the computer. For a unified ADX, you select (localhost) in most cases. However, if multiple SQL Server
instances are found on the local server, click the one to use for Metasys software.
For a split ADX, input the database server name in this format:
<servername>
(default instance) or<servername>\<database instance>
(named instance).Note: If your installation of SQL Server uses the default instance name, specify only the server name, but do not include the default instance name. Otherwise, an error message appears and you cannot proceed with the installation. You only need to specify a database instance if you have a named instance. Also, if the server name you specify does not resolve, use the server's IP address. - Use Windows Credentials : Select if you want the installer to use the Windows OS credentials of the currently logged-in user to access the SQL Server software. The logged-in user must be a member of the system administrators (sysadmin) role in SQL Server. After installation, you can remove the SQL Server software system administrator rights from this user if so directed by IT personnel.
- Username and Password : Clear the Use Windows Credentials box to enter the SQL Server Administrator login and password credentials in these fields if you want the installer to use a SQL Server login with system administrator rights.
-
Install SQL Server Express
Locally
: Click this option if you want the Metasys Server Setup program to
install a local instance of SQL Server 2017 Express with CU19. This option is disabled
on computers with a Windows Server operating system. If the computer has an
unsupported version of SQL Server Express software, the installation halts with a
message that you must upgrade to a supported version.
- Click the General tab. The General screen appears.
- In the Install Path and Third Party Install Path fields, you can either accept the default installation paths or select custom installation locations for the Metasys Server application and third-party applications that the server uses (RabbitMQ and Erlang/OTP). To select a custom location, click Browse to select a custom installation location (for example, drive E: instead of drive C:). A Browse For Folder dialog box appears. Select an installation location for each and click OK.
- From the Available Network Interface Cards
list, select a network adaptor. Figure 3. Metasys Server General Window
- Click the Reporting tab. The Reporting screen
appears.Figure 4. Metasys Server Reporting Window
- Under the Reporting section, select from these options:
- Install Metasys Advanced Reporting : Click to select to install the Metasys Advanced Reporting System. Metasys Advanced Reporting requires a computer with a server operating system that has the Reporting Services component of SQL Server properly configured.
-
Server Name
: Specify the computer where the SCT software
is installed by either clicking the down arrow or typing the server
name. Select the database that SCT uses. Input the server name in this
format: <servername>\<database instance> (named
instance). Note: When you enter the server name of the SCT computer and database instance, do not enter the default instance name. An error message appears and you cannot proceed with the installation. Only enter a database instance if you have a named instance.
- Use Windows Credentials : Select if you want the installer to use the Windows OS credentials of the currently logged-in user to access the SQL Server software. The logged-in user must be a member of the system administrators (sysadmin) role in SQL Server. After installation, you can remove the SQL Server software system administrator rights from this user if so directed by IT personnel. With SCT installed on a remote computer, the user logged in to the web/application server computer must have system administrator rights to SQL Server.
- Username and Password : Clear the Use Windows Credentials box to enter the SQL Server Administrator login and password credentials in these fields if you want the installer to use a SQL Server login with system administrator rights. (If you used the SQL Installer tool to set up SQL Server, you must use the SQL Server sa user and password).
- SCT Archive : Specify the name of the SCT archive that the Metasys Advanced Reporting System is to use. The installer verifies the existence of the archive you specify.
- To continue, click Install. The Initializing screen
appears:
Do not click Cancel, unless you need to halt installation and apply an update to SQL Server software. Seconds later, the installer continues and the progress of each step is shown.
If the setup program requires a restart during installation, it prompts you, then resumes installation after the restart.Note: If .NET Framework 4.7.2 is missing from the computer, the Metasys Server installation is paused at this point and the .NET Framework 4.7.2 components are installed now, then the computer restarts. After the restart, the Metasys Server installer automatically resumes. - After all installation steps have finished, the Metasys Server Setup
Complete box appears.
- Click Restart Now: a restart is needed to make the changes on your computer. After the restart, continue with the next step.
- Click Finish: a restart is not needed. Proceed to the next step.
- If you disabled antivirus software before you began installing the Metasys Server software, after the computer restarts, log in and re-enable the software.
- (Optional) If the site is trending large amounts of data, resize the MSMQ limitation. For details, refer to Message Queue Size Considerations in the ADS/ADX Commissioning Guide (LIT-1201645) .
- License the Metasys Server with the Software Manager, which is installed with the server. For details, refer to Software Manager Help (LIT-12012389).