Updating from Version 6 to Version 7
Welcome to Nodinite 7 – a more secure, simpler platform with improved performance and modern architecture.
What's New in v7
Security & Architecture:
- Windows Service → IIS Hosting – Many Monitoring Agents now run as modern IIS applications
- Enhanced TLS Support – Simplified HTTPS configuration with certificate management
- Modern .NET – Built on .NET 10.0 for better performance
- Portal-based management – Portal provides a single source of truth for environment configuration: shared knowledge, centralized access control, and full visibility into who can view, modify, and download
Key Benefits:
- Better security with IIS application pool isolation
- Improved performance and scalability
- Portal-based configuration with shared knowledge, user access control, and team visibility into who can modify or download
- Single zip download for Core Services and all locally installed agents — always the latest version, no version pinpointing or clicking through multiple packages
Prerequisites
Before starting, ensure you have:
Backup databases and configuration files
Administrator access to Nodinite Application Servers
PowerShell 7 installed with execution policy set to Unrestricted or ByPass
PowerShell 7 script user must be sysadmin on SQL Server instance
Nodinite 7 contract and product key from the Portal
IIS Windows Features installed (including Web-Scripting-Tools and Web-AppInit)
.NET 10.0 Hosting Bundle
Important
Install the Hosting Bundle — not the plain Runtime or SDK. On the .NET download page, scroll to ASP.NET Core Runtime → Windows → Hosting Bundle. The Hosting Bundle includes the .NET Runtime and the IIS support module (ASP.NET Core Module v2) required by Nodinite.
Install order matters: IIS Windows Features must be installed before the Hosting Bundle. Installing the Hosting Bundle on a server without IIS features means the IIS module is skipped. If you installed the Hosting Bundle first, run the installer again (repair) after enabling IIS features.
Note
The Logic Apps Monitoring Agent was previously the only component requiring the .NET 9 Hosting Bundle. From v7.3.9 onwards, it runs on .NET 10 as well. Only the .NET 10 Hosting Bundle is needed for v7.3.9 and later.
Select Hosting Bundle under Windows in the ASP.NET Core Runtime section — not x64/x86.Latest DacFX installed on App Server
Stop the Pickup Log Events Service before starting
Migration Steps
| Step | Task | Complexity |
|---|---|---|
| 1. Register Environment | Create environment in Portal | Simple |
| 2. Review | Review settings with visual diagram | Simple |
| 3. Download Binaries | Download Core Services package | Simple |
| 4. Run PowerShell Script | Execute migration script | Moderate |
| 5. Remove Core Services | Clean up old IIS applications | Simple |
| 6. Export Monitoring Agents | Export agent configurations | Simple |
| 7. Import Monitoring Agents | Import agents to Portal | Simple |
| 8. Update Monitoring Agents | Install v7 agents | Moderate |
| 9. Remove Windows Services | Remove old services | Simple |
| 10. Verify Functionality | Test core functionality | Simple |
| 11. Configure TLS | Enable HTTPS and close wizard | Complex |
| 12. Install Pickup Service | Install v7 Pickup Service | Moderate |
| 13. Update Agent Configurations | Update endpoints and URIs | Moderate |
| 14. Final Cleanup | Remove old files and folders | Simple |
| 15. Post Migration Tasks | Verify completion and follow post-installation guide | Simple |
After Migration is Complete
See Step 15: Post Migration Tasks for the completion checklist, post-installation guidance, and recommendations for future enhancements such as gMSA accounts and OAuth 2.0 / OpenID Connect.
Contact your Partner or Nodinite Support for guidance on these features.
Troubleshooting
Need Help?
- Review individual step troubleshooting sections
- Check Installation Troubleshooting
- Contact your Partner for 1st line support
- Email Nodinite Support