- 4 minutes to read

Install Nodinite Mule ESB Monitoring Agent

This guide teaches how to install the Nodinite Mule ESB Monitoring Agent.

PreReq: You must download the Nodinite Mule ESB Monitoring Agent version to install and then configure the Windows and Mule Server machines prior to installation. The Service account must have Logon as Service Right. See Prerequisites for Mule ESB Monitoring Agent for more information. 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 Mule ESB Monitoring Agent.
msi

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

Click the 'Next' button to continue with the installation process or click on 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.

EULA
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.
Custom Setup

NOTE: Default settings are recommended

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 Mule ESB 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

Domain User

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

Insufficient Privileges

Error message when account information does not meet the Prerequisites for Mule ESB 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

Now all preparations are performed, click on the 'Next' button to continue with the installation process or click on the 'Cancel' button to quit the installer.

Ready to install
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
Completed

Failed installation example: A failed installation will render a premature exit
Nodinite Monitoring Agent - Mule Setup Wizard ended prematurely
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 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. This file is [re]generated on each successful start.
README.txt

Install Nodinite Mule ESB Monitoring Application

Next, you must install a Nodinite Mule ESB Monitoring Application on each Mule ESB server instance to be monitored. This is simply a ZIP file that you put into the apps directory.

  • Download the latest version of the Nodinite Nodinite Mule ESB Monitoring Application from download.nodinite.com.

NOTE: Do not use the Mule Management Console when deploying this application, drop the zip-file directly into the apps directory to install.


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 Mule ESB Monitoring Agent exist in the Troubleshooting user guide.


Next Step

Configuration of the agent
Add or manage a Monitoring Agent Configuration

Prerequisites for Mule ESB Monitoring Agent
Monitoring Agents
Update
Uninstall