Updating the RabbitMQ Monitoring Agent
The Nodinite RabbitMQ Monitoring Agent is built on .NET and follows a monthly update release cycle with security patches, performance improvements, and bug fixes. Keep your agent up to date to maintain support and ensure compatibility with Nodinite Core Services.
On this page, you will learn how to:
- ✅ Update agents using the modern Portal-based scripted installation (v7 - recommended)
- ✅ Apply MSI-based updates to remote servers when Portal approach is not available (legacy)
- ✅ Verify compatibility and versioning for seamless upgrades
- ✅ Troubleshoot and resolve common update issues
Release notes
For detailed information about each release, visit the release notes for the RabbitMQ Monitoring Agent.
Important
Always read the release notes before updating to understand new features, bug fixes, and potential breaking changes.
Nodinite version 7
Preferred Method: Portal-Based Scripted Installation
In Nodinite v7, updating agents is automated through the Portal-based scripted installation. This modern approach:
✅ Automates agent installation and updates 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
Follow the Install Nodinite v7 or Update Nodinite v7 guide to update agents using the Portal-based approach. The Portal generates PowerShell scripts that install and configure agents automatically.
Nodinite version 6 (MSI-Based Installation - Legacy)
Warning
The MSI-based installation method for Nodinite v6 is deprecated and will be retired. Please upgrade to Nodinite v7 for the modern Portal-based scripted installation experience.
Running Version
You can view the installed version in the 'Version' text box.
Example of the Version text box displaying the installed RabbitMQ Monitoring Agent version.
Alternatively, check the file details property on the local installation.
Example of the file version details property for the RabbitMQ Monitoring Agent.
Prerequisites for Updating
Ensure you have already installed the RabbitMQ Monitoring Agent. The service account must have Logon as Service Right. See prerequisites for RabbitMQ Monitoring Agent for more details.
Note
You must be a local administrator to install or update Windows Services.
Compatibility and versioning issues
- Upgrading from 4.X to 5.X? Review Updating from V4 to V5 for important compatibility notes.
Update guide
Follow these steps to update the RabbitMQ Monitoring Agent.
Step 1: Start the installer
Double-click the MSI file to begin the update process for the Nodinite RabbitMQ Monitoring Agent.
Example of the MSI installer file for the RabbitMQ Monitoring Agent.
Step 2: Welcome Screen
When the MSI launches, you'll see the Welcome screen.
Example of the Welcome screen in the RabbitMQ Monitoring Agent installer.
Click 'Next' to continue or 'Cancel' to exit.
Step 3: Custom Setup
Select features and the installation location.
Example of the Custom Setup screen showing feature and location selection.
Default settings are recommended
Note
If you change the location, your old configuration will not be used.
Click 'Next' to continue or 'Cancel' to exit.
Step 4: Service Account Information
Enter the credentials for the Account that will run the Nodinite RabbitMQ Monitoring Agent.
Service Account Fields
- Domain: Enter the domain name. For local accounts, use the server name or a dot (.)
- User: Enter the account name
- Password: Enter the password
Example of the service account credentials dialog for the RabbitMQ Monitoring Agent.
Note
The account must have 'Log on as Service Right'.
Click 'Next' to continue or 'Cancel' to exit.
Insufficient Privileges
If you see an error, the account may lack the required rights or local administrator status. Follow the How to set Logon as a Service right guide and retry. If issues persist, check credentials and restart the installer.
Example of the Insufficient Privileges error message during installation.
Check the local event log for errors (System and Application).
Step 5: Completed setup
The final step of the update process will indicate either a success or a premature exit.
Example of the Completed setup screen after a successful update.
Click 'Finish' to exit the installer.
When the setup finishes, your default text editor opens a README.txt file with information to help you set up and manage the agent as a Monitoring Agents for Nodinite.
Example of the README.txt file opened in the default text editor after installation.
Instructions on how to add the RabbitMQ Monitoring Agent as a Monitoring Agents are detailed in a shared article:
Troubleshooting
A failed update will result in a premature exit.
Example of the premature exit screen indicating a failed update.
Support
If you need help, contact our Support.
Additional troubleshooting information may be available in the Windows Event Logs.
Next Step
Configuration of the agent
Related Topics
Prerequisites for RabbitMQ Monitoring Agent
Add or manage a Monitoring Agent Configuration
Monitoring Agents
Install RabbitMQ Monitoring Agent
Uninstall