Installing the Nodinite Boomi Monitoring agent

This guide teaches how to manually install the Nodinite Boomi Monitoring agent. With Nodinite 7, the installation can be scripted.

Before you begin

First, ensure sure you comply with the prerequisites.

Note
You must be a local administrator to have the right to install Web Applications and manage IIS

Step 1: Download

Make sure to download the latest binaries (zip package) from the Nodinite portal.

Step 2: Create IIS App Pool

Next, create a new IIS App Pool.

Open the IIS Manamagement Console (inetmgr)
Create a new IIS App Pool, name it, for example Nodinite-%ENVIRONMENTNAME%-BoomiMonitoring_ID-AppPool
1. No Managed Code
2. Integrated
3. Check the Start the application pool immediately

Step 3: Unzip package

In this step, you will unpack and unblock the files.

Unzip the package to folder: c:\Program Files\Nodinite\%ENVIRONMENTNAME%\Agents\BoomiMonitoring_ID\.
- Replace the %ENVIRONMENTNAME% accordingly with your Environment. The _ID should be replaced to uniquely identify this instance given that you are installing multiple instances of the agent. You can omit it completely if this is the only instance.
- ^{New 7.x} With Nodinite 7, the _ID should be set in the Nodinite Portal.

Unblock the files,

Get-ChildItem -Path '%FOLDERFROMSTEP3%' -Recurse | Unblock-File

Step 4: Create Web Site

In this step, you will create a new Web Site:

Expand 'Sites'

Example of creating a new Web Site in IIS.
Create a new Web Site and name it 'Nodinite-%ENVIRONMENTNAME%-BoomiMonitoring_ID'
- Set the folder you chose in step 2.
- Select the App pool created in step 2.
Edit Permissions on the Application
- IIS AppPool\%NAMEOFIISPOOLFROMSTEP2%
- Click 'Check name' to validate account.
- Select 'Full control'.

Step 5: Test

In this step, you are verifying that the agent is operational.

Click the Web Application and select Browse. This should then open the default browser with a new tab, and a page with the Swagger content like below.

Here's an example of the Swagger feature in the Nodinite Boomi Monitoring agent.

If you would like to test the APIs, you must first Authorize requests with an x-api-key.

Click the Authorize button to enter the x-api-key.

Enter the x-api-key, reuse from any other installed and configured Nodinite Monitoring Agent.

Step 6: Add Agent as a new Monitoring Agent Configuration

Instructions on how to add the Nodinite Boomi Monitoring agent as a Monitoring Agents is detailed in a shared article, click on the link below to learn more: