Installing PVT - Metasys - LIT-12012406 - Software application - Performance Verification Tool - 4.3

Metasys Performance Verification Tool (PVT) User Guide

Product name
Performance Verification Tool
Document type
User Guide
Document number
LIT-12012406
Version
4.3
Revision date
2023-07-27

Before you begin

Before you install PVT, verify that you have the following information:
  • A Johnson Controls Global ID, a connection to the internet, and a supported machine.

  • Administrator permissions. If you do not have administrator permissions, an error appears. Contact your local IT department to receive the appropriate permissions.

Important: PVT does not support the reading of scan data from any PVT release before 3.1. Release 2.0.3 is a special version of PVT that you can use to read scans taken with older versions of PVT and to generate reports. You must not use 2.0.3 to take new scans of a site unless you need to perform a PMI scan, which is not supported in version 3.1 and above.
Note: Ensure that you close Software Manager before you install PVT.
Note: If you want to perform a custom installation on a drive other than C:\, ensure that you uninstall any previous version of PVT, and delete the Metasys Performance Verification Tool folder under both C:\Program Files (x86)\Johnson Controls and C:\ProgramData\Johnson Controls. You cannot perform a custom installation if you upgrade PVT directly.

Procedure

Complete all or part of the following steps according to your installation or upgrade scenario:
  • If you are upgrading to PVT 4.2 from versions 1.5, 2.0, or 2.0.2, complete steps 1 to 9.
  • If you are installing PVT 4.2 for the first time, complete steps 5 to 8.
  • If you are upgrading to PVT 4.2 from version 3.1 or from a previous 4.x version, complete steps 5 to 8.
  1. Ensure port 443 (Outbound) is open in order for the tool to communicate with the cloud.
  2. Perform a backup of all the projects as follows:
    • Export the projects created as .PVT files.
    • Save synchronized projects from the following location: C:\Program Files (x86)\Johnson Controls\Metasys Performance Verification Tool\CreatedPVTs.
  3. Uninstall Metasys Performance Verification Tool from the computer.
    Note: Do not cancel the uninstallation process or shut down your machine during the process to avoid malfunctioning of the application.
  4. When the uninstallation is complete, delete the Metasys Performance Verification Tool folder under C:\Program Files (x86)\Johnson Controls\ and C:\ProgramData\Johnson Controls.
  5. Check if Microsoft Edge enhanced security configuration is enabled on the machine. If it is enabled, perform the following steps to ensure that the security settings do not restrict access to PVT.
    Note: For more information about enhanced security configuration, refer to the Microsoft documentation.
    1. Add the following sites to the Manage enhanced security for sites list:
      • https://[*.]microsoft.com
      • https://aadcdn.msauth.net
      • https://aadcdn.msftauth.net
      • https://sts.ga.johnsoncontrols.com
      • https://login.microsoftonline.com
      • https://jcib2c.b2clogin.com
      • https://pvt.jci.com
      • https://aadcdn.msftauthimages.net
      • https://autologon.microsoftazuread-sso.com
      • https://ocsp.digicert.com
    2. Enable Javascript for the default browser of your local machine.
      Note: For more information, refer to https://www.enable-javascript.com/.
  6. Navigate to the Johnson Controls License Portal, download the installer for PVT 4.2, and run the executable file.
  7. Follow the installation wizard to complete the installation.
    Note: To ensure a successful installation, do not shut down your machine or cancel the installation process when it has started.

    Custom installation on a drive other than C:\ is introduced at PVT 4.2. With this method, you can select any drive in your computer for the database location and installer file. To install PVT on a driver other that C:\, complete the following steps:

    1. When the installation wizard opens, click Custom.
    2. On the next window, if you want to install PVT to a custom location, click Browse and select a location. The default filepath that displays is C:\Program Files (x86)\Johnson Controls.
      Note: If you provide an invalid file path, you receive the error The users folder cannot be selected.
  8. Activate a valid license with the Software Manager. See Licensing PVT.
    Note: To use the automated scans feature, the PVTAUTOSCAN 4.x license must be active.
  9. Run the application to verify the license is now activated.
    If you use PVT in automatic scan mode, see Using PVT in automatic scan mode. If you use PVT in interactive mode, see Using PVT in interactive mode.