Installing the Nodinite Boomi Monitoring agent

Get started with the Nodinite Boomi Monitoring Agent to monitor Boomi Integrations Atoms, processes, and certificates. This guide covers both modern Portal-based installation and the new MSI installer for specific scenarios.

✅ Portal-based scripted installation (IIS-hosted, recommended)
✅ NEW: MSI-based Windows Service installer for non-Nodinite servers ^{New 7.2.0}
✅ Clear guidance for service account and prerequisites
✅ Troubleshooting tips and direct support access

Nodinite v7.2.0 and Later (Recommended)

^{New 7.2.0}

Boomi Monitoring Agent v7.2.0 and later should be installed using the Nodinite Portal-based scripted installation. This modern approach provides automated installation and configuration with minimal manual intervention.

Why Use Portal-Based Installation?

✅ Automates agent installation and configuration via PowerShell scripts
✅ Configures multiple agents simultaneously with consistent settings
✅ Eliminates manual installations and reduces human error
✅ Centrally manages all environments from the Portal
✅ Includes AI Diagnostics ^{New 7.2.0} for intelligent error analysis
✅ Supports .NET 10 runtime for modern platform performance
✅ IIS-hosted for optimal integration with Nodinite Core Services

Get Started with Portal-Based Installation

Follow the comprehensive Install Nodinite v7 guide to install the Boomi Monitoring Agent using the Portal-based approach. The Portal generates PowerShell scripts that install and configure the agent automatically.

Key Steps:

1. Register your environment in the Nodinite Portal
2. Select Boomi Monitoring Agent in the Agents configuration tab
3. Configure agent settings (port, service account information, optional certificate override for encrypting sensitive data)
4. Download the installation package with embedded PowerShell scripts
5. Run the PowerShell script to install and configure automatically

Complete Portal Installation Guide - Step-by-step instructions with screenshots

---

MSI Installer for Windows Service Deployment

^{New 7.2.0} MSI-based installer for Windows Service deployment. Use this method when:

• Installing on a non-Nodinite application server (remote server, DMZ, separate monitoring zone)
• Specific Windows Service requirements (service dependencies, custom startup, scheduled restarts)
• IIS is unavailable or not desired on the target server
• Group Managed Service Account (gMSA) required for automated password management

MSI Installation Benefits

✅ Flexible deployment - Install on any Windows Server, not just Nodinite app server
✅ Windows Service architecture - Standard service management, dependencies, recovery options
✅ gMSA support ^{New 7.2.0} - Automated password rotation without manual updates (see gMSA accounts)
✅ AI Diagnostics ^{New 7.2.0} - Intelligent troubleshooting assistance
✅ Traditional MSI workflow - Familiar installation for IT teams

MSI Installation Prerequisites

Important

You must be a local administrator to install Windows Services. See Prerequisites for complete requirements including .NET 10 Runtime.

MSI Installation Steps

Step 1 - Download MSI Package

Download the latest Boomi Monitoring Agent MSI from the Nodinite Portal.

Step 2 - Run MSI Installer

Double-click the MSI file and follow the installation wizard. You will be prompted for:

• Installation directory (default: C:\Program Files\Nodinite\Agents\BoomiMonitoring)
• Service account credentials (domain\user or use gMSA)
• Service port (default: 8000, customize if needed)

Step 3 - Configure Service Account

For gMSA (recommended):

• Enter gMSA account name (e.g., DOMAIN\BoomiAgent$) (see gMSA accounts)
• No password required

For traditional account:

• Domain\Username
• Password
• Ensure account has "Log on as a service" right (see How to set Logon as a Service right)

Step 4 - Complete Installation

The installer will:

1. Install binaries to specified directory
2. Create Windows Service (Nodinite.Boomi.Monitoring)
3. Start the service automatically

Step 5 - Verify Installation

Open browser and navigate to http://localhost:8000/swagger (adjust port if customized). You should see the Swagger UI.

Step 6 - Add Agent Configuration

Follow Add or manage a Monitoring Agent Configuration to register the agent with Nodinite Core Services.

---

Nodinite version 6 (Manual IIS Setup - Legacy)

Warning

Deprecated: The manual IIS installation method is legacy and intended only for v6 environments. This method is not recommended for new deployments and will be retired in future versions.

Important

Version 7.2.0+ Users: If you are installing Boomi Monitoring Agent v7.2.0 or later, use either the Portal-based installation method or the MSI installer for Windows Service deployment. The manual IIS setup below is for legacy v6 installations only.

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.

1. Open the IIS Manamagement Console (inetmgr)
2. 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.

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

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

1. Expand 'Sites'
   
   Example of creating a new Web Site in IIS.
2. 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.
     
3. 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:

• Add or manage a Monitoring Agent Configuration

---

Next step

Add or manage a Monitoring Agent Configuration
Configuration
Update
Uninstall

Related Topics

Monitoring Agents
Prerequisites