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

Metasys Performance Verification Tool (PVT) User Guide

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

The following table includes general troubleshooting information.

Table 1. General troubleshooting
Error Message or Scenario Solution
An error occurred while using PVT. To troubleshoot an issue in PVT, complete the following steps to check the logs:
  1. Navigate to C:\ProgramData\Johnson Controls\Metasys Performance Verification Tool\logs. The following log file names are included in the folder:
    • pvt-info.log
    • pvt-error.log
    • pvt-windowsservice-info.log
    • pvt-WindowsService-Error.log
  2. Review the log file in Notepad or another text editor.
When generating a Riser diagram, the following error occurs: An error occurred in the creation of the Visio document Ensure you install Visio 2013 or higher in order to generate Riser diagrams with PVT.
When you log on to the server machine to complete changes in Site Configuration which was originally completed by another user, you receive the following error: Access to path C:\ProgramData\Johnson Controls\Metasys Performance Verification Tool\ServerCreds.bin is denied, and it is not possible to make site configuration changes.
  1. Close PVT.
  2. Navigate to the folder C:\ProgramData\Johnson Controls\Metasys Performance Verification Too.
  3. Rename ServerCreds.bin file as ServerCreds.bin.old.
The PVT installation fails and the following error appears in the pvt-error.log file: Error 1920. Service 'PVT Sync Service' (PVT Sync Service) failed to start. Verify that you have sufficient privileges to start system services. Ensure that you have .NET framework version 4.7.2 or higher installed on the machine.

Scan does not start, and the following error appears in the pvt-WindowsService-Error.log file:

|ERROR|PvtSyncWinSvc|System.Security.Authentication.AuthenticationException: Invalid Credentials|System.Security.Authentication.AuthenticationException: Invalid Credentials at JohnsonControls.Tools.Metasys.ScanEngine.Providers.Authentication.MmdaAuthenticationProvider.Authenticate(ISiteCredentials credentials, Boolean isSctArchive)at JohnsonControls.Tools.Metasys.ScanEngine.Providers.Authentication.OnlineAuthenticationProvider.Authenticate()at JohnsonControls.Tools.Metasys.ScanEngine.Service.AuthenticationService.Authenticate()at JohnsonControls.Tools.Metasys.ScanEngine.Service.PvtScanService.<AuthenticateAsync>b__21_0()at System.Threading.Tasks.Task`1.InnerInvoke()at System.Threading.Tasks.Task.Execute()

This may occur when the MetasysSysAgent password is changed after PVT is set up to scan.
An error occurs while you install PVT.

Navigate to C:\Users\<LoggedInUserName>\AppData\Local" with name "Metasys_Performance_Verification_Tool_<DateTimeStamp>.html to check the logs and troubleshoot the installation errors.