Documentation Vision Audit+ Documentation

Vision Audit+ / Administration Guide

Troubleshooting

This chapter lists common problems with their cause and fix, and how to collect information for support.

Overview

This chapter lists common problems with their cause and fix, and how to collect information for support.

Find the cause

  1. Read the message in the pane. It usually names the object or service that failed, and whether the problem lies in Vision Audit+, PI Web API, AF or SQL.
  2. Open System Status and check the license and the error log.
  3. Check the service log in C:\ProgramData\Software Athlete\Vision Audit+\Logs. Turn on debug logging if the log has too little detail.
  4. Check whether the service account reaches PI Web API, the AF database and the PI Vision SQL database. A good test is to sign in as the service account and open them.
  5. If the cause lies in PI Web API, AF or the PI Data Archive, check their logs and contact AVEVA technical support.

Service and installation

SymptomCauseFix
The service starts and stops right awayno valid license, or the AF database cannot be reachedcheck the log and the Windows Application event log. Copy a valid license.dat to the ProgramData folder; check that the SQL Server and database names match the license
The log repeats SQL access is not ready (SQL error N)the service account cannot sign in to SQL or lacks a permissionrun the Configuration Utility, SQL Database page, Check permissions, and apply the missing permissions
Access Denied when the service startsthe service account cannot read the Vision Audit+ program folder, or lacks Log on as a servicegive the account read and execute rights on C:\Program Files\Software Athlete\Vision Audit+ and the Log on as a service right
Error initializing database: ... Forbidden in the Configuration Utility, or Forbidden in the service logPI Web API rejects writesset DisableWrites and EnableCSRFDefense to False in the PI Web API configuration and restart PI Web API
No new history entries, although the service runsPI Web API 2023 SP1 without Patch 1 stopped answering, or the service has lost its connectionrestart PI Web API; install PI Web API 2023 SP1 Patch 1. Then check the service log
History writes for large displays fail, small displays workSQL Server replication or CDC limits large values on the AF SQL databaseraise max text repl size (see SQL Server replication and change data capture in the Installation Guide)
A request stays In Progressthe service is stopped, or it has no leaderstart the service; with several nodes, check System Status. The request is processed when the service is available again

Toolbar

SymptomCauseFix
A pane is missing in PI Visionthe feature is off in the toolbar configuration, or the browser still has the old toolbarinstall the toolbar in the Configuration Utility and refresh PI Vision with Ctrl+F5
Vision Audit+ could not load ... with an AF element, server or databasethe object does not exist, or the user has no Read permission on it (PI Web API reports both as not found), or Kerberos delegation from PI Web API to AF is missinggive the user Read and Read Data on the Vision Audit+ AF database, set up Kerberos delegation, and check the AF server and database in the Configuration Utility
The pane says the browser blocked the response of PI Web API (CORS)PI Web API runs on another server and does not allow the address users open PI Vision with, for example an alias or load balancer nameadd the address to CorsOrigins and set CorsHeaders to * and CorsSupportsCredentials to True. If PI Web API runs on the PI Vision server, leave the URL empty in the Configuration Utility
The pane says PI Web API is set to an HTTP addressPI Vision runs on HTTPS and the browser blocks requests to HTTPset the PI Web API URL to https://... in the Configuration Utility and install the toolbar again
The pane says PI Web API could not be reachedPI Web API is stopped, its name cannot be resolved from the user's computer, or its certificate is not trusted thereopen the PI Web API URL from the message in the browser and fix what fails, then select Reconnect
A feature pane says This feature is disabled on the Vision Audit+ serverthe server and toolbar switches differsee Turning features on and off. After the change, users must refresh PI Vision
Users cannot create a snapshot or revertthe user has no Write and Write Data permission in the Vision Audit+ AF databasegive the permissions (see Create the AF database in the Installation Guide)
A Data Sources scan or Display Usage search stops after 2 minutesno service node answered, for example because the service is stopped or its PI Vision SQL check failsstart the service and check its log. Data Sources also pauses while the PI Vision SQL database is unavailable

Contact support

For technical help, contact Software Athlete at contact@software-athlete.com. Include:

  • the product version (shown in System Status and About);
  • your PI Vision and PI Web API versions and a short description of the setup;
  • a clear description of the problem and screenshots of the messages;
  • the log files from C:\ProgramData\Software Athlete\Vision Audit+\Logs, or the error log downloaded from System Status.