PI Nexus+ / Installation Guide
Installation Troubleshooting
This chapter fixes the problems that stop an installation from working. Read the log in C:\ProgramData\Software Athlete\PI Nexus+\Logs for the full error. Scan and connection problems are covered in Troubleshooting Scans and Connections in the Administration Guide.
Overview
This chapter fixes the problems that stop an installation from working. Read the log in C:\ProgramData\Software Athlete\PI Nexus+\Logs for the full error. Scan and connection problems are covered in Troubleshooting Scans and Connections in the Administration Guide.
Installer
| Symptom | Cause | Fix |
|---|---|---|
| Warning that the account cannot be resolved or assigned; fallback identities in use | Name not qualified, wrong password, missing logon right or a Deny right | Fix the name, password or rights (also in Group Policy), then set the identities by hand (Verify Runtime Identities) |
| Another installation is in progress, or setup hangs | Another Windows Installer session, or a pending reboot | Wait or reboot, then run setup again |
| Setup fails while turning on IIS | Windows could not add the IIS features | Install IIS, Windows Authentication and IIS Management Scripts and Tools by hand; run setup again |
Service PI Nexus+ Scanner is marked for deletion (exit code 1072) | An earlier uninstall has not finished | Reboot, then run Repair |
Installer logs: the setup log in %TEMP%, pi-nexus-installer-<date>.log in the Logs folder, and the Windows Application log, source PI Nexus+ Installer.
Website and sign-in
| Symptom | Cause | Fix |
|---|---|---|
| Page does not open | Site or app pool stopped, port 5139 taken or blocked | Start the site and PINexusAppPool; check the port and firewall |
| HTTP Error 503. The service is unavailable. | The app pool stops at start: wrong identity or password, or a startup error | Check the identity; read the Application log and pi-nexus-api-<date>.log |
| HTTP Error 500.19 | IIS locks the modules or handlers section | Unlock the section named in the installer log, for example appcmd unlock config -section:system.webServer/handlers |
| Sign-in prompt repeats | Windows Authentication off or Anonymous Authentication on | Correct both in IIS for the site |
/api/me fails, or Permissions are using setup fallback | No bootstrap.json, wrong SQL target, no database access, or schema not current | Check bootstrap.json, the identity and Admin > SQL Server; run Database Setup |
Database and scanner service
| Symptom | Cause | Fix |
|---|---|---|
Login failed for user or Cannot open database "PINexus" | No login, database user or db_owner for the account | Run Database Setup again, or have the SQL administrator run Prepare-Database.sql |
| Database Setup stops at Granting database permissions | No login, and no right to create one | Have the SQL administrator run Prepare-Database.sql |
| Scanner service does not start (error 1053) | Wrong identity, no Log on as a service, or no database | Check identity and right; read pi-nexus-worker-<date>.log |
Scanner log: PendingMigrations=1 and LatestMigration=<none> | The database has no schema yet | Admin > SQL Server > Apply, or run Database Setup; restart the service |
License
| Symptom | Cause | Fix |
|---|---|---|
| Inventory pages and scans blocked | License missing, expired or damaged | Install a valid license under Admin > License |
| Banner names unlicensed PI Data Archives | An enabled archive is not in the license | Disable it, or get a license that names it |
| PI Points shown as Not Evaluated | More active PI Points than licensed | Narrow the rules or targets, or get a larger license |
If none of this helps, collect the information listed in Checklist and Important Paths and contact support.
Reference: Paths and Files
