Documentation PI Nexus+ Documentation

PI Nexus+ / Administration Guide

Administration Guide

Configure targets, rules, scan automation, notifications, and monitoring, and keep PI Nexus+ running.

Overview

Software Athlete

Version: 1.7.0.0

This guide is for the PI Nexus+ administrator who configures what PI Nexus+ monitors and keeps it running day to day.

The documentation has four parts:

  • Installation Guide: plan, install, upgrade and repair PI Nexus+, and fix installation problems.
  • Administration Guide (this document): connect PI Data Archives, AF, PI Vision and hosts, set up scan automation and notifications, and keep PI Nexus+ running.
  • User Guide: find unhealthy objects, investigate issues, follow dependencies and changes, and confirm repairs.
  • Reference (online only): the tables behind all three guides, such as defaults, states, issue catalogues, rights and ports, at https://www.software-athlete.com/pages/documentation-pi-nexus-reference.

Articles in this category

17 articles
Administration OverviewThis chapter shows where each setting lives in the Admin area and how to give people access to PI Nexus+.PI Data ArchivesThis chapter adds the PI Data Archives whose PI Points PI Nexus+ inventories, and optionally tracks their PI Interfaces and the interfaces' runtime health.AF Servers and DatabasesThis chapter chooses the AF databases PI Nexus+ inventories, sets how their attributes and analyses are evaluated, and controls which databases may receive analysis recalculations.OpenID ConnectThis chapter connects PI Nexus+ to PI Data Archives and AF servers through AVEVA Identity Manager instead of the Windows service account, and protects the client secret.PI Vision InstancesThis 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.PI Point RulesThis chapter defines which PI Points PI Nexus+ inventories and which health checks apply to them, so that issues match how each group of tags is expected to behave.External SystemsThis chapter records the systems outside the PI System that feed PI Points or receive their data, such as OPC servers, ERP or MES, so that issues and dependency graphs name the source, the owner and the runbook. Users work with them as described in External Systems in the User Guide.SitesThis chapter groups servers into sites, usually by plant, so that users can filter the app by site and emails can go to each site's team. Sites are available in every edition. What users see is described in Servers and Sites in the User Guide.PI Adapter MonitoringThis chapter turns on monitoring of AVEVA PI Adapters (for example OPC UA, DNP3, Modbus, MQTT and RDBMS) through the health data they publish to PI. Users work with the results as described in PI Adapters in the User Guide.Host MonitoringThis chapter sets up agentless monitoring of the Windows servers in your PI landscape: CPU, memory, disks, PI services and PI roles. Users work with the results as described in Host Monitoring in the User Guide; all values and limits are in the Host Monitoring Reference.Scan AutomationThis chapter sets up automatic monitoring, the one policy that keeps health, inventory and full verification current for every managed target. Operators follow the result on the Scanning page (see Scanning in the User Guide); all cadences and timings are in the Scan Automation Reference.Manual Scans and PI Point Rule ReconciliationThis chapter covers the scanning tasks that need an administrator: reconciling PI Point rule changes and recovering a stuck scan. Deleting a single scan run is a support action described under Delete a scan run in the Reference. How operators queue manual scans, read the work list and use Run now is described in Scanning in the User Guide.NotificationsThis chapter sets up email: the SMTP connection, which emails PI Nexus+ sends, and who receives them. Email types, defaults and delivery timings are in the Notifications Reference.Support and DiagnosticsThis chapter shows where PI Nexus+ logs, how to capture a problem with temporary debug logging and a support bundle, and how to read the readiness and scale checks. File names, levels and the bundle's contents are in the Logs and Support Bundle Reference.Inventory Maintenance and SQL Admin UIThis chapter sets how long PI Nexus+ keeps history, explains the purge and reset actions, and covers the SQL Server page. Every retention default and what each purge removes are in the Retention and Maintenance Reference.PI Vision Ad Hoc Workspace LinksThis chapter makes Open in PI Vision available, so users can open a PI Point or AF Attribute as a trend in PI Vision's Ad Hoc Workspace.Troubleshooting Scans and ConnectionsThis chapter helps you find why scans fail or fall behind, and where each kind of target's own problems are covered. Installation problems (installer, website, database connection, license) are in Installation Troubleshooting in the Installation Guide.