Installing the Nodinite Web Services Monitoring Agent
Get up and running with the Nodinite Web Services Monitoring Agent in just a few steps. This guide covers both the modern Portal-based installation (recommended) and the legacy MSI-based approach for remote servers.
Nodinite v7.0.4 and Later (Recommended)
New 7.0.4
Web Services Monitoring Agent v7.0.4 and later should be installed using the Nodinite Portal-based scripted installation. This modern approach provides automated installation and configuration with minimal manual intervention.
Why Use Portal-Based Installation?
✅ Automated agent installation and configuration via PowerShell scripts
✅ Configures multiple agents simultaneously with consistent settings
✅ Eliminates manual MSI installations and reduces human error
✅ Centrally manages all environments from the Portal
✅ Includes AI Diagnostics New 7.0.4 for intelligent error analysis
✅ Supports .NET 10 Hosting Bundle for modern runtime performance
Get Started with Portal-Based Installation
Follow the comprehensive Install Nodinite v7 guide to install the Web Services Monitoring Agent using the Portal-based approach. The Portal generates PowerShell scripts that install and configure the agent automatically.
Key Steps:
- Register your environment in the Nodinite Portal
- Select Web Services Agent in the Agents configuration tab
- Configure agent settings (port, service account, endpoints)
- Download the installation package with embedded PowerShell scripts
- Run the PowerShell script to install and configure automatically
Complete Portal Installation Guide - Step-by-step instructions with screenshots
Legacy Installation (Remote Servers Only - Not Recommended)
Warning
Deprecated: The MSI-based installation method is legacy and intended only for remote server installations where the Portal-based approach cannot be used. This method is not recommended for new deployments and will be retired in future versions.
Important
Version 7.0.4+ Users: If you are installing Web Services Monitoring Agent v7.0.4 or later, use the Portal-based installation method instead. The MSI approach below is for legacy v6 installations or remote servers only.
When to Use MSI Installation
Use this method only if:
- You are installing on a remote server that cannot be managed via Portal scripts
- You are maintaining a legacy v6 environment (upgrade to v7 recommended)
- You have specific infrastructure constraints preventing automated installation
MSI Installation Prerequisites
With this guide, you will:
- Verify all prerequisites for a smooth installation
- Install the agent using the MSI installer
- Configure service account credentials securely
- Troubleshoot common installation issues
- Add the agent to your Nodinite monitoring configuration
Note
You must be a local administrator to have the right to install Windows Services
Before you begin
Make sure you comply with the prerequisites.
Step 1: Start the installer
Double-click on the MSI file to start the installation of the Nodinite Web Service Monitoring Agent:
Start the MSI installer for the Nodinite Web Services Monitoring Agent.
Step 2: Welcome screen
On successful execution of the MSI file, a Welcome screen is presented:
Welcome screen of the Nodinite Web Services Monitoring Agent installer.
Click the 'Next' button to continue the installation process or click the 'Cancel' button to quit the installer.
Step 3: Accept End User License Agreement
The Licensee is ultimately responsible for making sure Nodinite products are used according to the End User License Agreement. Make sure you have the assigned formal rights to install and perform modifications to the target environment before you continue installing any Nodinite products:
You must accept the terms in the License Agreement to continue.
Step 4: Custom setup
Select the components to install and select the destination path for the installation:
Choose components and destination path for installation.
Note
Default settings are recommended
Click the 'Next' button to continue the installation process or click the 'Cancel' button to quit the installer.
Step 5: Service Account Information
Enter the credentials for the Account to run the Nodinite Web Service Monitoring Agent.
Enter credentials:
Domain: The name of the Domain the Server belongs to. If a local account is being used, use the name of the server or a . (dot) as Domain
User: The name of the account
Password: The password for the account
Enter the domain service account credentials for the agent.
Click the 'Next' button to continue the installation process or click the 'Cancel' button to quit the installer.
Insufficient privileges
Error message when provided account information does not meet the Prerequisites:
Error message for insufficient privileges during installation.
If you get this message, the most common reason is that the account is not allowed to run as a service or is not a local Administrator on the server. Follow the guide How to set Logon as a Service right and click retry. If the problem remains, click cancel and restart. Make sure to enter valid credentials!
Tip
Check the local event log if there are errors (both System and Application)
Step 6: Ready to install
Now all preparations are performed, click on the 'Next' button to continue the installation process or click the 'Cancel' button to quit the installer.
Here's an example of the Ready to install dialogue.
Step 7: Completed setup
The last step of the installation gives either a success or a premature exit.
: ✅ Successful installation example
Successful installation of the Nodinite Web Services Monitoring Agent.
Failed installation example:
A failed installation will render a premature exit.
Click the Finish button to Exit and quit the installer.
Step 8: Add Agent as a new Monitoring Agent Configuration
When the setup has been completed with success, your default text editor will open a text file named 'README.txt'. The README.txt file holds additional information that you need to add the agent as a Monitoring Agents. This file is [re]generated on each successful start.
README.txt file with post-installation instructions.
Instructions on how to add the Web Service Monitoring Agent as a Monitoring Agents is detailed in a shared article, click on the link below to learn more:
Support
Contact our Support for additional guidance if you fail to resolve the installation problem.
Note
Additional information to aid the troubleshooting may exist in the Windows Event Logs.
Next Step
Configuration of the agent
Update
Uninstall
Related Topics
Add or manage a Monitoring Agent Configuration
Monitoring Agents
Prerequisites