Troubleshooting - Metasys - LIT-12011685 - Software Application - Graphic Generation Tool - Graphics+ - 1.3.1

Graphic Generation Tool Installation Instructions
Brand
Metasys
Product name
Graphic Generation Tool
Graphics+
Document type
Installation Guide
Document number
LIT-12011685
Version
1.3.1
Revision date
2017-06-01
Language
English

The table below provides troubleshooting information for the Graphic Generation Tool application.

Table 1. Troubleshooting

Problem

Solution

When you install the Graphic Generation Tool, you see a message stating that an Admin user profile is required.

Exit the installation program and install the software using a computer account that has Administrator privileges.

Note: The installation log includes information about error messages that you may encounter when you install the Graphic Generation Tool. This information may help you resolve an error message. You can find the installation log in the following locations.

Windows 7 and Windows Server 2008 R2:

C:\Users\<user name>\AppData\Roaming \GraphicToolInstallLog.html

When you install or upgrade the Graphic Generation Tool, the following error message appears:

The Graphic Generation Tool must not be running when installing or upgrading. Please close the Graphic Generation Tool and click Retry or click Exit to end Setup.

Save your work and close the Graphic Generation Tool application. Then, click Retry in the message box or start the installation program again. Follow the instructions in Upgrading the Graphic Generation Tool.

You are installing .NET Framework 4.0 on a computer running other Metasys software, and the Metasys software stops running.
Restart the computer.
Note: If a disruption occurs on the SCT or on the Ready Access Portal, restart this device as well.

You are installing .NET Framework 4.0 on a computer that already has this application installed. The following dialog box appears:

Close this dialog box by clicking the X in the upper right corner of the screen. Continue installing.

When you attempt to update the System Configuration Tool (SCT) or the Application and Data Server (ADS) with the latest Graphics+ Package via the Update Metasys Hosts command in the Graphic Generation Tool (GGT), you may receive an error at 99%. The Graphics+ Package does not update. This error occurs with the SCT or the ADS at Metasys® Release 5.2 with a Graphics+ Package for Release 1.1 or 1.2.

or

You are a Metasys for Validated Environment (MVE) site and branch laptops or external storage devices cannot be connected to the SCT or ADS.

To manually update the SCT or ADS with the latest Graphics+ Package:

  1. Ensure that you have access to any installed GGT application so the ADS or the SCT can be manually updated.

  2. Locate the MetasysGraphicsPackage.zip file. If you do not have access to any installed GGT application, contact your local Johnson Controls branch representative for the MetasysGraphicsPackage.zip file. For Windows® 7, and Windows Server 2008 R2, the zip file is located here:

    C:\Program Files (x86)\Johnson Controls\XAML Graphics Components\Metasys Graphics Package\V1\

  3. Extract the contents of MetasysGraphicsPackage.zip into the following location:

    For the computer on which SCT is installed:

    C:\Inetpub\wwwroot\MetasysIII\ToolUI

    Note: Accept any file overwrite prompts. Two files are replaced when you extract the contents of the zip file:

    C:\inetpub\wwwroot\MetasysIII\UI\ClientBin\Metasys.Graphics.Viewer.xap

    and

    C:\Inetpub\Wwwroot\MetasysIII\UI\com\jci\metasys\MetasysGraphicsPackage.properties.

    For the ADS:

    C:\Inetpub\wwwroot\MetasysIII\UI

  4. In the GGT, verify the Graphics+ Package updated by selectingFile > Update Metasys Hosts. The Update Metasys Host window appears.
  5. In the GGT, select the Metasys Host (either the SCT or the Site Director) and select Connect.
  6. In the GGT, the next window displays all the discovered Metasys Hosts. Ensure the correct Graphics+ Package version is listed in the Graphics Version column. If the correct version is listed, close the window. If the correct version is not listed, repeat the workaround.