Link a Node

To link a child node to a cluster, you install an instance of Tenable Nessus as a cluster child node, then configure the node to link to the parent node of the cluster.

Note: Before you begin, you must get the linking key from the cluster parent node. This is because you have to complete the Link the child node to the parent node process in one session. Starting the process and then navigating away from the user interface before completing the process can disable the child node user interface prematurely.

To install and configure Tenable Nessus as a child node:

  1. Install Tenable Nessus as described in the appropriate Install Tenable Nessus procedure for your operating system.

  2. On the Welcome to Nessus, select Link Nessus to another Tenable product.

  3. Click Continue.

    The Managed Scanner screen appears.

  4. From the Managed by drop-down box, select Nessus Manager (Cluster Node).

  5. Click Continue.

    The Create a user account screen appears.

  6. Create a Tenable Nessus administrator user account, which you use to log in to Tenable Nessus:
    1. In the Username box, enter a username.
    2. In the Password box, enter a password for the user account.

  7. Click Submit.

    Tenable Nessus finishes the configuration process, which may take several minutes.

To link the child node to the parent node:

  1. In the Tenable Nessus child node, use the administrator user account you created during initial configuration to sign in to Tenable Nessus.

    The Agents page appears. By default, the Node Settings tab is open.

  2. Enable the toggle to On.
  3. Configure the General Settings:
    • Node Name — Type a unique name that identifies this Tenable Nessus child node on the parent node.
    • (Optional) Node Host — Type the hostname or IP address that Tenable Nessus Agents should use to access the child node. If you do not provide a host node, Tenable Nessus Agent uses the system hostname. If Tenable Nessus Agent cannot detect the hostname, the link fails.
    • (Optional) Node Port — Type the port for the specified host.
  4. Configure the Cluster Settings: 
    • Cluster Linking Key — Paste or type the linking key that you copied from the Tenable Nessus Manager parent node.
    • Parent Node Host — Type the hostname or IP address of the Tenable Nessus Manager parent node to which you are linking.
    • Parent Node Port — Type the port for the specified host. The default is 8834.
    • (Optional) Use Proxy — Select the checkbox if you want to connect to the parent node via the proxy settings set in Proxy Server.

  5. Click Save.

    A confirmation window appears.

  6. To confirm linking the node to the parent node, click Continue.

    The Tenable Nessus child node links to the parent node. Tenable Nessus logs you out of the user interface and disables the user interface.

    Note: Once you disable the child node user interface, subsequent attempts to access the child node user interface result in the following error: error: The requested file was not found.

What to do next:

  • Log in to the Tenable Nessus Manager parent node to manage linked Tenable Nessus Agents and nodes.
  • Link or migrate agents to the cluster.
  • On the Tenable Nessus Manager parent node, manage cluster groups to organize your nodes into groups that conform to your network topology. You must segment your network with cluster groups when certain agents only have access to certain child nodes. By default, Nessus assigns the node to the default cluster group.