Troubleshooting - Metasys - LIT-12012067 - Configuration software - System Configuration Tool - 13.2

SCT Installation and Upgrade Instructions

Product name
System Configuration Tool
Document type
Installation Guide
Document number
LIT-12012067
Version
13.2
Revision date
2019-10-14

Use the following table to resolve issues that may occur during installation. If the SCT ceases to function correctly, and you cannot find a solution in the following table, uninstall and reinstall the SCT. Under normal circumstances the SCT software installer sets up all of the required components.

Problem

Solution

You experience installation problems and would like to consult the error log.

The error messages are located in the following folder:

C:\Users\<username>\AppData\Local

Look for the file called: \Metasys_System_Configuration_Tool_<xxxxxxxxxxxxx>.html.

You receive the following error message when installing SCT:

Metasys System Configuration Tool (SCT) previous version detected. Please remove SCT and then run this setup again.

A previous version of SCT is installed on the computer. You must uninstall any previous version of SCT before installing. Follow the directions in the Uninstalling existing SCT release 11.0 or earlier software and Uninstalling existing NAE/NIE update tool software sections and try the installation again.

You receive the following error message when installing SCT:

No valid MSSQL Server instances found on the local machine.

There are two instances that cause this error to occur:

  • An unsupported version of SQL Server is installed on the computer.
  • You have a computer with a version of Windows that does not support the one-click install (for example, Windows Server 2012) and no version of SQL Server installed.

Cancel the installation and see SQL Server Software to review the supported versions of SQL Server. Then, upgrade to a supported version before you proceed with the SCT installation.

Installation of SCT 13.0 and later fails. The SCT error log displays the following error:

DISMHelper: [datetime] ERROR – Could not load file or assembly ‘System.Management.Automation, Version=3.0.0.

For Windows 7 x64 operating systems, the Windows Management Framework (WMF) 5.1 or later is required prior to installing SCT. The WMF 5.1 software package is available at this link:

https://www.microsoft.com/en-us/download/details.aspx?id=54616

The SCT installation fails and the SCT install log contains the following error if you click View all:

DISMHelper:[2019-03-21T11:12:37] ERROR - 0x800f080c

Or the following error appears when you launch SCT from the Launcher:

Check network connections. Check proxy settings in options.

Windows 10 version 1809 uses a new method to install the Simple Network Management Protocol (SNMP) feature, which has components that SCT requires.

To use the SCT on Windows 10 version 1809, it is best practice to install SCT Release 13.2. You can install SCT Release 13.0 on Windows 10 version 1809, but you must first complete the steps described in Flash Sheet: System Configuration Tool (SCT) installation fails on Microsoft® Windows® 10 version 1809 (LIT-2019F1) or contact your local Johnson Controls representative. You cannot install SCT Release 12.0 or earlier on Windows 10 version 1809.

The SCT installation fails and the SCT install log contains the following error:

ExecuteSqlDuringInstall: ERROR - The database could not be exclusively locked to perform the operation.

Complete the following steps to stop the Action Queue service:

  1. In Control Panel, select Administrative Tools > Services.
  2. Right-click Metasys III SCT Action Queue, and then click Stop.

After the Action Queue service stops, try the installation again.

In the SQL Server Management Studio, SQL Server Agent has the following text after it:

(Agent XPs disabled)

CTOOLS is a 16-bit program and is not supported on any 64-bit operating system. Click OK to close the user message window.

During the installation of Windows 8.1 features, a Windows Features dialog box appears that reads:

Windows needs files from Windows Update to finish installing some features.

Two choices are given:

Download files from Windows Update

Don't connect to Windows Update

This is normal.

This text appears if you install SQL Server software without Notification Services, which is not required for the SCT.

One of these error messages appear when you try to log in to the Site Management Portal:

HTTP 404 File not found Internet Information Services

Page cannot be found

Windows 8.1 is trying unsuccessfully to access the Internet to retrieve .NET Framework version 3.5.1 files or other necessary updates. Select either choice and refer to Installing Required Features without Internet Connection for Windows 8.1 in the Metasys Server Installation and Upgrade Instructions PDF (LIT-12012162) for further instructions.

While using the SQL Installer tool, you receive a user or error message during SQL Server software installation or upgrade. Possible messages include:

SQL Server Install error

Instance Name already installed

Install failed - Missing Windows Installer 4.5

Install failed - Missing .NET 3.5.1 SP1

No new features were installed during the setup execution

The OS does not meet the minimum requirements for this SQL Server install

Install failed - Bad software key

WARNING: Please install the following prerequisites: .NET 3.5.1 SP1, Windows Installer 4.5

To eliminate either of these errors, follow these steps:
  1. Exit all programs.
  2. Uninstall the SCT software.
  3. Press the &Windows key + R;. The Run dialog box appears.
  4. Type &%TEMP%; and click OK. Windows Explorer opens to display the contents of the temp folder.
  5. Delete all files and folders in this directory.
  6. Restart the computer.
  7. Reinstall the SCT software.

While using the SQL Installer tool, you experience installation problems after you edit the text in the Command Line Options window of the SQL Installer.

Consult the error log file. The error messages file is located in the following folder:

C:\Program Files\Microsoft SQL Server\<number based on the SQL release>\Setup Bootstrap\Log\Summary.txt

Correct the problem and try the SQL Server installation or upgrade again.

You receive the following error message while installing SCT:

Metasys NAE/NIE Update Tool (NUT) previous version detected. Please remove NUT and then run this setup again.

The text within the Command Line Options window contains errors. Correct the errors or restart the SQL Installer so that the Command Line Options window defaults to its original content.

The SCT software does not function correctly after you do one of the following:
  • Attempt to reinstall SQL Server software because it appears to be damaged.
  • Upgrade from an older version of SQL Server Express software to a newer version of SQL Server Express software outside the regular upgrade process.

A previous version of the NAE/NIE Update Tool is installed on the computer. You must uninstall prior versions of the NAE/NIE Update Tool before installing SCT. Follow the directions in the Uninstalling existing NAE/NIE update tool software section and try the installation again.

After you upgrade to a newer version of SQL Server, SCT no longer starts.

To correctly change your SQL Server software outside the usual installation or upgrade process, follow these steps:
  1. Back up all archive databases and back up the historical databases: JCIAuditTrails, JCIEvents, JCIHistorianDB, JCIItemAnnotation, and MetasysReporting.
  2. Uninstall the SCT and ADS/ADX software using Add/Remove Programs or Uninstall a Program.
  3. Reinstall or upgrade SQL Server software as you intended.
  4. Reinstall the SCT.
  5. Restore the archive databases and the historical databases: JCIAuditTrails, JCIEvents, JCIHistorianDB, JCIItemAnnotation, and MetasysReporting.
If you have already changed SQL Server software without uninstalling the SCT, follow these steps:
  1. Back up all archive databases and back up the historical databases: JCIAuditTrails, JCIEvents, JCIHistorianDB, JCIItemAnnotation, and MetasysReporting.
  2. Uninstall the SCT software using Add/Remove Programs or Uninstall a Program.
  3. Reinstall the SCT.
  4. Restore the archive databases and the historical databases: JCIAuditTrails, JCIEvents, JCIHistorianDB, JCIItemAnnotation, and MetasysReporting.

The following error appears when you try to log in to the SCT:

Unable to Authorize Active Directory User.

To correctly change your SQL Server software outside the usual installation or upgrade process, follow these steps:
  1. Back up all archive databases and back up the historical databases: JCIAuditTrails, JCIEvents, JCIHistorianDB, JCIItemAnnotation, and MetasysReporting.
  2. Uninstall the SCT software using Add/Remove Programs or Uninstall a Program.
  3. Reinstall or upgrade SQL Server software as you intended.
  4. Reinstall SCT.
  5. Restore the archive databases and the historical databases: JCIAuditTrails, JCIEvents, JCIHistorianDB, JCIItemAnnotation, and MetasysReporting.
If you have already changed SQL Server software without uninstalling the SCT, follow these steps:
  1. Back up all archive databases and back up the historical databases: JCIAuditTrails, JCIEvents, JCIHistorianDB, JCIItemAnnotation, and MetasysReporting.
  2. Uninstall the SCT software using Add/Remove Programs or Uninstall a Program.
  3. Uninstall the SQL Server software.
  4. Using Windows Explorer, browse to C:\Inetpub\wwwroot and delete the MetasysIII folder.
  5. Browse to C:\WINDOWS\inf\009 and C:\WINDOWS\inf\inc and delete the MSSQLServer folder in each one.
  6. Install SQL Server software.
  7. Reinstall SCT.
  8. Restore the archive databases and the historical databases: JCIAuditTrails, JCIEvents, JCIHistorianDB, JCIItemAnnotation, and MetasysReporting.

The following error appears when you try to log in to the SCT:

Error: Unable to Login. Unexpected Error.

The user may have recently changed the password of their Active Directory® (AD) domain account, their account is locked out, or their account does not have sufficient privileges. To work around this problem, follow these steps:
  1. Log in to the Site Management Portal UI and select Tools > Administrator.
  2. Select Active Directory > Configure.
  3. Select the user’s account and click Edit.
  4. Change the password to match the user’s new AD password.
  5. Click Save.
To permanently solve this problem, use a dedicated Active Directory account that has the password set to never expire as the Active Directory Service Account. (For details, refer to the Security Administrator System Technical Bulletin [LIT-1201528]).

Solution 1:

The Internet Explorer web browser proxy setting is set to bypass the proxy server for local addresses. To resolve this problem, start the browser and select Tools > Internet Options. Click the Connections tab, then LAN Settings. On the Local Area Network Settings window, select Automatically Detect Settings and select Use automatic configuration script. Type the address of the proxy server. Then, clear both check boxes under the Proxy server section. Relaunch the browser.

Solution 2:

The URL of the SCT you entered included a space. Remove the space and reload the page.

Solution 3:

The Launcher is configured to use a proxy server, even though the network does not require a proxy server. Open the Launcher and click the Network Settings button. On the Network Settings window, select Use browser settings.

Solution 4:

Microsoft SQL Server is not running. Start the SQL Server service with the SQL Server Configuration Manager.

(Continued) The following error appears when you try to log in to the SCT:

Error: Unable to Login. Unexpected Error.

Solution 5:

SQL Server is missing from the computer’s Path variable. To resolve this problem, follow these steps:
  1. Select Settings > Control Panel > System.
  2. Click the Advanced tab, then click Environment Variables button.
  3. Under System Variables, double-click the Path entry.
  4. In the Edit System Variable window, make sure the SQL path is present somewhere within the variable value string. If the path is not present, add it with a semicolon (;) at the start of the string as a separator.

For SQL Server software, the path is as follows:

;C:\Program Files\Microsoft SQL Server\MSSQL10_50.MSSQLSERVER\MSSQL\Binn.

For SQL Server 2012 software, the path is as follows:

;C:\Program Files\Microsoft SQL Server\MSSQL11.MSSQLSERVER\MSSQL\Binn.

Solution 6:

The computer contains files from an earlier operating system or from an earlier version of Metasys software that are conflicting with the updated software. Verify that a folder with an older OS does not exist on the hard disk (for example, WINDOWS.OLD).

You change the default language of the SCT, but when you log in, you do not see the new default language.

Solution 1:

SCT has become corrupted and access to the Metasys system folder is broken. To resolve this problem, uninstall SCT then reinstall it.

Solution 2:

The computer is using an older version of the Internet Explorer web browser. Upgrade the browser to version 11.

The following error appears when you launch SCT from the Launcher:

Missing Resource File.

To resolve this problem:
  1. In Control Panel, select Administrative Tools > Services.
  2. Right-click IIS Admin and select Stop.
  3. In Windows Explorer, browse to C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727\ Temporary ASP.NET Files\sct
  4. Delete the files in the sct folder.
  5. In the Services window, right-click IIS Admin and select Start.
  6. Close all windows and log in again.

The following error appears when you launch SCT from the Launcher:

HTTP Error 500.19 - Internal Server Error

The requested page cannot be accessed because the related configuration data for the page is invalid.

You are trying to use an older version of Launcher that is not compatible with this SCT release. Uninstall the old version of Launcher, then try again. Or to have the latest Launcher pushed to your computer directly from the SCT computer, open the browser and go to http://<sct computer name or IP address>/launcher.msi.

The Software Manager Notice dialog box appears when you launch SCT.
To resolve this problem:
  1. Run the Software Manager.
  2. Validate SCT and your field controller package files are listed as a Licensed.
  3. If SCT or the field controller packages are listed as Unlicensed, select Activate New in the Choose Action drop-down list or click the Add License button.
  4. Follow the on-screen prompts through the License Portal or upload an offline License Activation File. When your software is licensed, open the SCT software.