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
- 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.
- Open System Status and check the license and the error log.
- Check the service log in
C:\ProgramData\Software Athlete\Vision Audit+\Logs. Turn on debug logging if the log has too little detail. - 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.
- 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
| Symptom | Cause | Fix |
|---|---|---|
| The service starts and stops right away | no valid license, or the AF database cannot be reached | check 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 permission | run the Configuration Utility, SQL Database page, Check permissions, and apply the missing permissions |
Access Denied when the service starts | the service account cannot read the Vision Audit+ program folder, or lacks Log on as a service | give 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 log | PI Web API rejects writes | set DisableWrites and EnableCSRFDefense to False in the PI Web API configuration and restart PI Web API |
| No new history entries, although the service runs | PI Web API 2023 SP1 without Patch 1 stopped answering, or the service has lost its connection | restart PI Web API; install PI Web API 2023 SP1 Patch 1. Then check the service log |
| History writes for large displays fail, small displays work | SQL Server replication or CDC limits large values on the AF SQL database | raise max text repl size (see SQL Server replication and change data capture in the Installation Guide) |
| A request stays In Progress | the service is stopped, or it has no leader | start the service; with several nodes, check System Status. The request is processed when the service is available again |
Toolbar
| Symptom | Cause | Fix |
|---|---|---|
| A pane is missing in PI Vision | the feature is off in the toolbar configuration, or the browser still has the old toolbar | install the toolbar in the Configuration Utility and refresh PI Vision with Ctrl+F5 |
Vision Audit+ could not load ... with an AF element, server or database | the 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 missing | give 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 name | add 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 address | PI Vision runs on HTTPS and the browser blocks requests to HTTP | set 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 reached | PI Web API is stopped, its name cannot be resolved from the user's computer, or its certificate is not trusted there | open 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+ server | the server and toolbar switches differ | see Turning features on and off. After the change, users must refresh PI Vision |
| Users cannot create a snapshot or revert | the user has no Write and Write Data permission in the Vision Audit+ AF database | give the permissions (see Create the AF database in the Installation Guide) |
| A Data Sources scan or Display Usage search stops after 2 minutes | no service node answered, for example because the service is stopped or its PI Vision SQL check fails | start 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.
