PI Nexus+ / Administration Guide
PI Vision Instances
This chapter adds a PI Vision instance so PI Nexus+ can inventory its displays and show which displays use a PI Point, AF attribute or analysis. Skip it if you do not use PI Vision.
Overview
This chapter adds a PI Vision instance so PI Nexus+ can inventory its displays and show which displays use a PI Point, AF attribute or analysis. Skip it if you do not use PI Vision.
Before you start
PI Nexus+ reads displays from the PI Vision SQL database, not from the web server. Create a SQL Server login for the PI Nexus+ service account, or map a group it belongs to, and grant it db_datareader on each PI Vision database.
Add an instance

- Open Admin > PI Vision Instances and choose Add Instance.
- Enter a Name, for example
PI Vision Production, and the URL of PI Vision. It must end in/PIVision, for examplehttps://pivis01.example.com/PIVision. - Enter the SQL Server and Database of PI Vision; both are required. Choose the Site once two sites exist.
- Leave Unused display check on to mark displays not opened for Unused After Days (365 by default).
- Under Datasource Health Levels, choose how missing, error and warning datasources affect a display's health.
- Choose Test. It checks the URL format and reads the SQL database; it does not contact the web server.
- Choose Save Instance. Enabled for scanning is ticked by default; clear it to save the instance without scanning it.
Keep Missing Datasource at Error where displays are operationally important, or set it to Warning where PI Vision is mainly used for ad hoc views. Remove in the row menu deletes the instance together with its display inventory. Users work with displays as described in PI Vision Displays in the User Guide.
Troubleshooting
| Symptom | Cause | Fix |
|---|---|---|
| "PI Vision URL must end with /PIVision" | The URL points to the server or a display | Enter the PI Vision application URL ending in /PIVision |
| Test fails with a SQL login error | No login or no db_datareader for the account | Grant the rights in Before you start |
| Test fails: database not found | Wrong SQL Server or database name | Check the names in the PI Vision installation |
| Test passes, but the scan fails with a SQL login error | Only the web application's account has db_datareader; the scan runs as the scanner service account | Grant the rights to both accounts |
| Displays are not inventoried | Enabled for scanning is cleared | Choose Enable in the row menu |
Reference: PI Vision Instance Settings
