Documentation Version: er2.0.28-docs-1.1

FreeBSD Agent

Install THE NODE agent

  1. On your Web Console, go to DOWNLOADS > NODE AGENT DOWNLOADS.
  2. On the Node Agent Downloads page, click on the Filename for your Platform.

In the terminal:

  1. If there is a previous version of the Node Agent installed, remove it first:# Retrieves the name of the installed Node Agent.
    pkg info|grep er2

    # Deletes the installed agent, <package name>
    pkg delete <package name>
  2. Install the Node Agent:

    pkg install <path to package.tbz>

Configure the Node Agent

After you have installed the Node Agent, configure the Node Agent to:

  1. Point to the Master Server.
  2. (Optional) Use the Master Public Key (see Server Information) when connecting to the Master Server.
  3. (Optional) Specify Target initial group.
  4. Test the connection settings.

To configure the Node Agent, choose either mode:

For the changes to take effect, you must restart the Node Agent.


Running this command helps you to quickly configure the Node Agent:

er2-config -interactive

The interactive mode asks you for the following information to help you configure the Node Agent.

Pressing ENTER while configuring the Node Agent with the interactive mode configures the Node Agent to use the last saved value for that parameter. If there is no last saved value, an empty or default value is used. This may cause the Node Agent to fail to locate the Master Server.
Interactive Mode Command Prompts Description

Master server host name or IP Address []

Specify a Master Server's host name or IP address.

(Optional) Master server public key

Enter the Master Public Key. See Install Node Agents.

(Optional) Target initial group

Specify Target initial group.

Test connection settings (Y/n)

Test the Node Agent's connection settings to the Master Server, enter Y.

For the changes to take effect, you must restart the Node Agent.


To configure the Node Agent without interactive mode, run:

## Required for connecting to the Master Server
# -i <hostname|ip_address>: Master Server IP address or host name.
## Optional parameters
# -t: Tests if the Node Agent can connect to the given host name or IP address.
# -k <master_public_key>: Sets the Master Public Key.
# -g <target_group>: Sets the default Target Group for scan locations added for this Agent.

er2-config -i <hostname|ip_address> [-t] [-k <master_public_key>] [-g <target_group>]

For the changes to take effect, you must restart the Node Agent.

Upgrade Node Agents

See Agent Upgrade for more information.

Restart the Node Agent

For your configuration settings to take effect, you must restart the Node Agent:

## Run either of these options
# Option 1

er2-agent -stop # stops the Agent
er2-agent -start # starts the Agent

# Option 2

/etc/rc.d/er2_agent restart