Automatic Agent Deployment

Automatic Agent Deployment



The Automatic Agent Deployment feature allows you to deploy select monitoring agents to one or more monitorable systems at one time. This feature is also useful for conducting periodic agent version checks and can be used to update one or many agents.

NOTE: This feature’s functionality assumes your Nagios XI instance has the necessary dependencies and network configurations.

How To Get There

Navigate to Configure > Deploy Agent on the Nagios XI banner menu.

The Deploy Agent screen is the default landing page. There is also a new Auto Deployment menu on the left navigation menu that displays additional Automatic Deployment options.



Deploy Agent

Nagios XI now allows you to deploy agents automatically to one or many systems with the click of a button. The automatic deployment of agents to your monitored systems has several advantages:

The Deploy Agent page is simple and powerful. The fields and processes on the page are detailed below.




IP Addresses: Enter one or more host IP addresses. Separate addresses with a carriage return. NOTE: If entering more than one host, the hosts entered must have the same operating system and username/password combination.

Operating System: The operating system of the host system(s). The currently supported operating systems are:

Auth Type: The type of authorization used to access the host.

Username and Password: The user account and password with appropriate administrative or root level access.

Agent Software: The agent that will be deployed to the host(s).



 To Deploy an Agent:

  1. Enter host data into all the fields on the Deploy Agent screen.
  2. Click Deploy.
  3. The system will attempt to deploy the selected agent.
  4. After agents have been successfully installed, you can click on the Run Wizard button to run the agent configuration wizard on the selected host system. If your agent deploy fails, you can make the necessary changes and click on the Run Again button to re-run the deploy.

Important Notes


Manage Deployed Agents

You can easily manage your deployed agents through the Manage Deployed Agents page. The page contains agent details like version, status, OS, and vital dates. The interval that the system uses to monitor deployed agents is set on the Deployment Settings page.

You can also add an agent to monitor on a system that is not currently supported in Automatic Agent Deployment (ex. Windows).




IP Addresses/Hostname: Address of host.

Agent Status: The status returned after last status check.

Agent: The name of the agent deployed.

Agent Version: The version number of the agent deployed.

OS: Operating system of host.

Last Status Check: The date and time of the last status check.

Last Update: The date and time of the last agent update.

Creator: Name of the logged in user that deployed the agent.

Deployed/Added On: The date and time the agent was deployed.




To update an NCPA token on an agent:

If an NCPA token is updated on the host system, you can update that token in the Managed Deployed Agents list.

  1. Find the agent to update in the Managed Deployed Agents list.
  2. Click on the edit icon on the record.
  3. Enter the updated NCPA token in the resulting popup window.
  4. Click Save.

To add an agent that is already deployed (Example: Windows Server):

If you want to manage and check the status of an agent that has already been deployed on a host (a NCPA agent on a windows server for example), you can add that agent to the Managed Deployed Agents list.

  1. Click the Add Agent button.
  2. Fill in the required data on the resulting popup window.
  3. Click Add.



Deployment Settings

Based on your business needs, you can set the interval that Nagios XI will check the status of the deployed agents. You can also change the NCPA token that will be distributed among your deployments to a universal token that is already in use by your business.




Status Check Interval: The interval that Nagios XI will conduct status checks on deployed agents that will display on the Manage Deployed Agents page. Time interval is in hours.

NCPA Token: The token that will be used in each new NCPA agent deployment.



  1. Choose the hourly interval to run status checks on agents.
  2. Enter an NCPA token to deploy across managed hosts.
  3. Click Update Settings.


Important Notes 




Common Deploy Failure Messages

On deploy failure, the verbose message displayed should be informational enough to troubleshoot the issue. A couple of common errors and solutions are:


View Auto Deploy Jobs and Raw Output

On the Deploy Agent screen, you can click on the View past auto deploy jobs link to view a list of past Automatic Deployment jobs. From there, you can view raw job output to troubleshoot issues or re-run the deploy job.


Scroll down to find the job record you are interested in. You can troubleshoot possible issues by viewing raw job output, drill into the job name to re-run the auto deploy job, or remove the job from the job list.


Article ID: 869
Created On: Wed, Jun 3, 2020 at 3:58 PM
Last Updated On: Mon, Jun 8, 2020 at 2:07 PM
Authored by: rspielman

Online URL: