Add an Agent to a Network

Required Tenable Vulnerability Management User Role: Scan Manager or Administrator

An agent is part of the Default network unless you add it to a custom network. An agent can only be part of one network at a time.

Note: If you assign one or more agents to a network and any of those agents are already assigned to another custom network, a confirmation message appears indicating that, by adding agents to this network, they are reassigned from their previous networks.

Before you begin:

Create a new network.

Note: Tenable recommends moving agents to a new network, rather than an existing network, to prevent unwanted asset merges. If the network where you move an agent already contains asset records, and the identifiers for assets from the moved agent match the identifiers already existing in the network, Tenable Vulnerability Management merges those assets automatically.

If you want to move an agent from one existing network to another existing network:
- Note the IP addresses of the assets identified by the agent you want to move.
- Use the IP addresses to move the assets from the first network to the second network.
- Add the agent from the first network to the second network.

To add an agent to a network:

In the upper-left corner, click the button.

The left navigation plane appears.
In the left navigation plane, click Settings.

The Settings page appears.
Click the Sensors tile.

The Sensors page appears. By default, the Nessus Scanners tab is active and Linked Scanners is selected in the drop-down box.
Do one of the following:
- To add agents from the Linked Agents tab:
  1. Click the Nessus Agents tab.
    
    The list of agents appears and Linked Agents is selected in the drop-down box.
  2. Select an agent or agents in one of the following ways:
    
    In the agents table, right-click the row for the agent you want to add.
    
    The action buttons appear in the row.
    
    In the Actions column, click the button in the row for the freeze window you want to delete.
    
    The action buttons appear in the row.
    
    In the agents table, select the check box next to each agent you want to add.
    
    The action bar appear at the top of the table.
    
    In the table header, select the check box to select the entire page.
    
    The action bar appears at the bottom of the page.
  3. Click Add to network or Add Selected to Network, as applicable.
    
    The Add to Network plane appears.
  4. In the drop-down list, select the network to which you want to add the agent or agents.
  5. Click Assign.
    
    Tenable Vulnerability Management adds the agents to the selected network.
- To add agents from the Networks page:
  1. Click the Networks tab.
    
    The list of networks appears.
  2. In the networks table, click the network you want to add an agent to.
    
    The Settings page appears.
  3. In the left navigation list, click Manage Agents.
    
    Lists of both Available Agents to Add and Member Agents in Network appear.
  4. In the row of the agent to add to the network, click the button.
    
    Tenable Vulnerability Management determines whether there are any agent group conflicts. Once you manually resolve the conflict, repeat the steps above.
    
    If there are no group conflicts, Tenable Vulnerability Management adds the agent to the network.
If you moved the agents from a custom network to the Default network, you need to move the agents' associated assets to the Default network manually. Assets do not revert back to the Default network automatically. For more information, see Move Assets to a Network via Settings.

To add an agent group to a network:

In the upper-left corner, click the button.

The left navigation plane appears.
In the left navigation plane, click Settings.

The Settings page appears.
Click the Sensors tile.

The Sensors page appears. By default, the Nessus Scanners tab is active and Linked Scanners is selected in the drop-down box.
Click the Nessus Agents tab.

The list of agents appears and Linked Agents is selected in the drop-down box.
Filter the agent table to view the agent group you want to add to a network:
1. Click Filters.
2. Select Member of Group from the Category drop-down list.
3. Select the agent group to add in the Value drop-down list.
4. Click Apply.
In the agent table header, select the check box to select the entire page.

The action bar appears at the bottom of the page.
In the action bar, click the Add selected to network.

The Add to Network plane appears.
In the drop-down, select the network to which you want to add the agent or agents.
Click Assign.

Tenable Vulnerability Management adds the agents to the selected network.

If you moved the agents from a custom network to the Default network, you need to move the agents' associated assets to the Default network manually. Assets do not revert back to the Default network automatically. For more information, see Move Assets to a Network via Settings.