Enterprise Recon 2.0.29

Solaris 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.
  3. (Optional) Verify the checksum of the downloaded Node Agent package file.

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> pkgrm er2

  2. Install the Node Agent:

    # Where './er2-2.0.xx-solaris10-sparc.pkg' is the full path of the installation package # Syntax: pkgadd -d <path_to_package.pkg> <pkgid> pkgadd -d ./er2-2.0.xx-solaris10-sparc.pkg er2

Verify Checksum for Node Agent Package File

You can determine the integrity of the downloaded Node Agent package file by verifying the checksum before installing the Node Agent.

  1. Download the Node Agent package file.
  2. Run the commands in a terminal to generate the hash value for the Node Agent package file.
    • MD5 hash (128-bit)

      # Syntax: digest -a md5 -v <path to Node Agent package file> digest -a md5 -v ./er2-2.0.xx-solaris10-sparc.pkg
      Example MD5 hash: f65a2cd26570ddb7efb6a2a4318388ac

    • SHA1 hash (160-bit)

      # Syntax: digest -a sha1 -v <path to Node Agent package file> digest -a sha1 -v ./er2-2.0.xx-solaris10-sparc.pkg
      Example SHA1 hash: 33bcd6678580ae38a03183e94b4038e72b8f18f4

    • SHA256 hash (256-bit)

      # Syntax: digest -a sha256 -v <path to Node Agent package file> digest -a sha256 -v ./er2-2.0.xx-solaris10-sparc.pkg
      Example SHA256 hash: 1ee094a222f7d9bae9015ab2c4ea37df71000556b3acd2632ee27013844c49da

  3. In the Web Console, go to the DOWNLOADS > NODE AGENT DOWNLOADS page. The Hash column lists the expected hash values for each Node Agent package file.
  4. Compare the generated hash values from Step 2 with the expected hash values listed in the Web Console; both hash values should be equal.

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:

  • Interactive Mode
  • Manual Mode

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

Interactive Mode

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.

Interactive Mode Command Prompts Description
Master server host name or IP Address [10.1.100.0] 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.

Manual Mode

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.

Install RPM in Custom Location

To install the Node Agent RPM package in a custom location:

  1. Download the Node Agent from the Master Server. The Master Server must be version 2.0.21 and above.
  2. Install the package in a custom location.

    # Syntax: pkgadd -a none -d <node_agent_package> <pkg_id> # Install the Node Agent package into the '/opt/er2' directory.
    pkgadd -a none -d ./er2-2.0.xx-solaris10-sparc.pkg er2
    # Specify the installation directory when prompted.

  3. Configure the package:

    # Configure the Node Agent package. # Run 'er2-config' binary from the custom install location, i.e. '<custom_location>/usr/sbin/er2-config' # Specify the location of the configuration file. The location of the configuration file is '<custom_location>/var/lib/er2/agent.cfg'
    /opt/er2/usr/sbin/er2-config -c /opt/er2/var/lib/er2/agent.cfg -interactive

  4. 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 /etc/init.d/er2-agent restart
# Option 2 er2-agent -stop # stops the agent er2-agent -start # starts the agent