Updating the Nodinite IBM MQ Monitoring Agent
On this page you will learn how to update the Nodinite IBM MQ Monitoring Agent. The IBM MQ Monitoring Agent can easily be updated using the latest software package (MSI).
Release notes
For information about the releases, please visit the Release Notes for the IBM MQ Monitoring Agent.
Running Version
The installed version is displayed in the 'Version' text box.
You can also view the file details property on the local installation
Compatibility and versioning issues
| Version | Comment |
|---|---|
| 5.3.x | Sensitive information is now encrypted and the configuration file is tied with the service account/password combination, make sure to store passwords in your password protected manager |
PreReq: You must have successfully installed the Nodinite IBM MQ Monitoring Agent prior to an update. The Service account credentials to use must have Logon as Service Right. See Prerequisites for IBM MQ Monitoring Agent for more information. You must be a local administrator to have the right to install (and thereby update) Windows Services.
Step 1: Start the installer
Double-click on the MSI file to start the update process.
Depending on settings in Windows a security warning may be presented. Click 'Run' to continue.
Step 2: Welcome Screen
On successful execution of the MSI file, a Welcome screen is presented.
Click the 'Next' button to continue with the update process or click the 'Cancel' button to quit the installer.
Step 3: Custom Setup
Select the Components and the Location for the installation. The Default settings are recommended.
![!NOTE] If you change the location your old configuration will be lost
Click the 'Next' button to continue with the update process or click the 'Cancel' button to quit the installer.
Step 4: Service Account Information
Enter the credentials for the Account to run Nodinite IBM MQ Monitoring Agent. Depending on the connection string settings this account will be used to log on and query the databases being monitored.
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.
Note
The account must have 'Log on as Service Right'
Click the 'Next' button to continue with the update process or click the 'Cancel' button to quit the installer.
Insufficient Privileges
Error message when account information does not meet Prerequisites.
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 5: Completed setup
The last step of the update process gives either a success or a premature exit.
Successful update example.
Failed update example: A failed update will render a premature exit.
Click the 'Finish' button to Exit and quit the installer (update process).
When the setup has finished the default text editor will open a text file named the 'README.txt'. The README.txt file holds additional information that you need to manage the agent as a Monitoring Agents.
Support
Contact our Support for additional guidance if you fail to resolve the update problem.
Note
Additional information to aid the troubleshooting may exist in the Windows Event Logs..
Next Step
Add or manage a Monitoring Agent Configuration
Configuration of the agent
Install IBM MQ Monitoring Agent
Uninstall