You are here: Nessus Agents > Local Agents Commands

Local Agents Commands

The Nessus Agent commands can link or unlink agents, or it can report on the status of the agent.

Link and Unlink the Nessus Agent

To link an agent, you will the key value from the Nessus Manager. Other options include the name of the Nessus Agent, the Agent group or groups that the agent will be part of, the CA path, the host, and the port for the Agent to connect.

Basic usage for the Nessus Agents command line:

# /opt/nessus_agent/sbin/nessuscli agent link --key=00b5a8fec9f3a21fa1cff66ce99c6324adf324226948c6f1516eb9f9433b964744

Once the agent is successfully linked, you will see the output following the command:

# /opt/nessus_agent/sbin/nessuscli agent link --key=00b5a8fec9f3a21fa1cff66ce99c6324adf324226948c6f1516eb9f9433b964744 --groups= Workstation --host=ndev3 --port=8834

Agent successfully linked

If there were issues connecting the Agent to the Manager, you will see a Failed to link the agent message.

# /opt/nessus_agent/sbin/nessuscli agent link --key=00abd4c487c472edb77cea8a14bb8c603a88203a2e6bf1f6df46159b5ad5ef18df --name=Workstation --groups=Accounting --host=172.16.44.252 --port=8834

Failed to link the agent:

Check the Nessus Agent Status

The Nessus agent status will show you if an agent is linked, and how many jobs are pending if it is linked.

# /opt/nessus_agent/sbin/nessuscli agent status

Agent linked

0 jobs pending

If the Nessus agent is not linked, the status will show that it is not linked to any servers.

# /opt/nessus_agent/sbin/nessuscli agent status

Agent not linked to a server

If the Nessus Agent is linked, the status will show the IP address of the connected server and port:

# /opt/nessus_agent/sbin/nessuscli agent status

Agent is linked to 172.26.16.184:8834

0 jobs pending

Copyright © 2017. Tenable Network Security, Inc. All rights reserved. Tenable Network Security, Nessus, SecurityCenter Continuous View, Passive Vulnerability Scanner, and Log Correlation Engine are registered trademarks of Tenable Network Security, Inc. All other products or services are trademarks of their respective owners.