- 3 minutes to read

Installing the Message Queueing Monitoring Agent

This guide teaches how to install the Nodinite Message Queueing Monitoring Agent.

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 for the Message Queueing Monitoring agent.

Step 1: Start the installer

Double-click on the MSI file to start the installation of the Nodinite Message QueuesMonitoring Agent.
msi

Step 2: Accept End User License Agreement (EULA)

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.

EULA

Step 3: Welcome screen

On successful execution of the MSI file, a Welcome screen is presented.
Welcome

Click the 'Next' button to continue with the installation process or click on the 'Cancel' button to quit the installer.

Step 4: Custom setup

Select Components and Location of installation. Default settings are recommended.
Custom Setup

Click the 'Next' button to continue with the installation process or click on the 'Cancel' button to quit the installer.

Step 5: Service Account Information

Enter the credentials for the Account to run Nodinite Message QueuesMonitoring 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.

><i class="fal fa-fw fa-exclamation-triangle text-yellow"></i> **NOTE:** The account must have 'Log on as Service Right'

Domain service account

Click the 'Next' button to continue with the installation process or the 'Cancel' button to quit the installer.

Insufficient Privileges

Error message when account information does not meet [Prerequisites][Prerequisites for Message Queues Monitoring Agent].
Insufficient Privileges

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

Ready to install Click next to start installation

Step 7 Completed setup

The last step of the installation gives either a success or a premature exit.
Successful installation example
Completed

Failed installation example: A failed installation will render a premature exit
Premature Exit

Click the Finish button to Exit and quit the installer.

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 add the agent as a Monitoring Agents.
README.txt

Step 8: Add Agent as a new Monitoring Agent Configuration

The last installation step would be to install the Monitoring Agent as a new Monitoring Agents from within the Web Client with information as provided from the README.txt file in the previous step.


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..

Frequently asked questions

Additional solutions to common problems and the FAQ for the Nodinite Message Queueing Monitoring Agent exist in the Troubleshooting user guide.


Next Step

Configuration of the agent
Update
Uninstall

Add or manage a Monitoring Agent Configuration
Monitoring Agents
Prerequisites for Message Queueing Monitoring Agent
Web Client