Installing & updating Node Agents

Introduction

This article shall serve as an installation guide for all available Node Agent packages by OS.

This guide assumes you have already downloaded your respective Node Agent package from your Enterprise Recon web console under Downloads > Node Agent Downloads, and placed the installation package in the host machine.

 

AIX

Supported for AIX 6.1 and above

  1. Open a Terminal window in the same directory as the Node Agent package and login as root
  2. Enter the command; rpm -e er<TAB to auto-complete>
    This is to remove any conflicting files if you have installed a Node Agent on this host before
    If auto-complete doesn't show "er2" or any previously installed Node Agent packages, skip this step
  3. Enter the command; rpm -i <NODE AGENT PACKAGE.rpm>
    (eg. rpm -i er2-2.0.17-aix61-power-41.rpm)



  4. Once the installation completes, you want to set the Agent to point to the Master Server
    You can do this by entering the command; /usr/sbin/er2-config /var/lib/er2/agent.cfg -t -i <MASTER SERVER IP ADDRESS>
    (eg. /usr/sbin/er2-config /var/lib/er2/ agent.cfg -t -i 10.1.100.0)



  5. If using the Master Server public key, you may set the key by entering the command; /usr/sbin/er2-config /var/lib/er2/agent.cfg -t set hub_public_key <PUBLIC KEY>
    (eg. /usr/sbin/er2-config /var/lib/er2/ agent.cfg -t set hub_public_key AF0BE8CD90F51E962FE45C6C81)



  6. Finally, restart the Agent to make sure changes are applied by entering the command; /etc/rc.d/init.d/er2-agent restart

 

FreeBSD

Supported for FreeBSD 6 and above

  1. Open a Terminal window and login as root
  2. Navigate to the directory where the Node Agent package is
    If performing a fresh installation, please skip to step 4
  3. Enter the command; pkg_info|grep er2
    ... then; pkg_delete <NAME OF PREVIOUSLY INSTALLED AGENT>
    (eg. pkg_delete er2-2.0.17-freebsd61-x64-41)



  4. To install, enter the command; pkg_add <NODE AGENT PACKAGE.tbz>
    (eg. pkg_add er2-2.0.17-freebsd61-x64-41.tbz)



  5. Once the installation completes, you want to set the Agent to point to the Master Server
    You can do this by entering the command; /usr/sbin/er2-config /var/lib/er2/agent.cfg -t -i <MASTER SERVER IP ADDRESS>
    (eg. /usr/sbin/er2-config /var/lib/er2/ agent.cfg -t -i 10.1.100.0)



  6. If using the Master Server public key, you may set the key by entering the command; /usr/sbin/er2-config /var/lib/er2/agent.cfg -t -i <MASTER SERVER IP ADDRESS> -k <PUBLIC KEY>
    (eg. /usr/sbin/er2-config /var/lib/er2/agent.cfg -t -i 10.1.100.0 -k AF0BE8CD90F51E962FE45C6C81)



  7. Finally, restart the Agent to make sure changes are applied by entering the command; /etc/rc.d/er2_agent restart

 

HP-UX

Supported for HP-UX Itanium 11.23 and above

  1. Open a Terminal window and login as root
  2. Navigate to the directory where the Node Agent package is
  3. Enter the command; swremove ER2Agent
    This is to remove any conflicting files if you have installed a Node Agent on this host before



  4. Enter the command; swinstall -s <NODE AGENT PACKAGE.depot>
    (eg. swinstall -s er2-2.0.17_hpux11-ia64_41.depot)



  5. You will be brought to the installation GUI, make sure you select the 'ER2Agent' package then select the 'Actions' tab and 'Mark For Install'



    Once marked, under the 'Actions' tab, select 'Install', then 'OK'





    Once installation is complete, it should show this window



  6. Afterwards, set up the Node Agent by entering the command; er2-config -interactive



  7. Finally, restart the Agent to make sure changes are applied by entering the command; /etc/rc.d/er2_agent restart

 

Linux

Supported for all Red Hat and Debian-based distributions using kernel 2.4 and above

  1. Open a Terminal window in the same directory as the Node Agent package and login as root
  2. If you've downloaded the .deb package, enter the command; dpkg -i <NODE AGENT PACKAGE.deb>
    (eg. dpkg -i er2_2.0.17-linux26-x64-41.deb)

    Then skip to step 5



  3. If you've downloaded the .rpm package, enter the command; rpm -e er<TAB to auto-complete>
    This is to remove any conflicting files if you have installed a Node Agent on this host before
    If auto-complete doesn't show "er2" or any previously installed Node Agent packages, skip this step
  4. Enter the command; rpm -i <NODE AGENT PACKAGE.rpm>



  5. Once the installation completes, you want to set the Agent to point to the Master Server
    You can do this by entering the command; /usr/sbin/er2-config /var/lib/er2/agent.cfg -t -i <MASTER SERVER IP ADDRESS>
    (eg. /usr/sbin/er2-config /var/lib/er2/ agent.cfg -t -i 10.1.100.0)



  6. If using the Master Server public key, you may set the key by entering the command; /usr/sbin/er2-config /var/lib/er2/agent.cfg -t -k <PUBLIC KEY>
    (eg. /usr/sbin/er2-config /var/lib/er2/agent.cfg -t -k AF0BE8CD90F51E962FE45C6C81)



  7. Finally, restart the Agent to make sure changes are applied by entering the command; /etc/init.d/er2-agent restart

 

macOS

Supported for 10.8+

  1. Run the Node Agent .pkg installer
  2. Follow the GUI installer









  3. Open a new Terminal window, we will now have to set the Node Agent to point to your Master Server
  4. Enter the command; sudo /usr/local/er2/er2-config -i <MASTER SERVER IP ADDRESS>
    (eg. sudo /usr/local/er2/er2-config -i 10.1.100.0)

    If using the Master Server public key, add this behind; -k <PUBLIC KEY>
    (eg. sudo /usr/local/er2/er2-config -i 10.1.100.0 -k AF0BE8CD90F51E962FE45C6C81)



  5. Once done, restart the Agent service by entering;
    sudo /usr/local/er2/er2-agent -stop
    sudo /usr/local/er2/er2-agent -start

    If for whatever reason the above commands don't work, try;
    sudo launchctl unload /library/launchdaemons/com.groundlabs.plist
    sudo launchctl load /library/launchdaemons/com.groundlabs.plist

 

Solaris

Supported for all Solaris distributions from 9 and above

  1. Open a Terminal window in the same directory as the Node Agent package and login as root
  2. If you've previously installed an Agent on this host, enter the command; pkgrm er2
    If not, skip this step



  3. To install, enter the command; pkgadd -d <NODE AGENT PACKAGE.pkg>
    (eg. pkgadd -d er2-2.0.17-solaris10-sparc-41.pkg)



  4. Once the installation completes, you want to set the Node Agent to point to your Master Server
    You can do this by entering the command; er2-config -t -i <MASTER SERVER IP ADDRESS>
    (eg. /usr/sbin/er2-config /var/lib/er2/ agent.cfg -t -i 10.1.100.0)

    If using the Master Server public key, use this command instead; er2-config -t -i <MASTER SERVER IP ADDRESS> -k <PUBLIC KEY>
    (eg. er2-config -t -i 10.1.100.0 -k AF0BE8CD90F51E962FE45C6C81)



  5. Finally, restart the Agent to make sure changes are applied by entering the command; /etc/init.d/er2-agent restart

 

Windows

Supported for all Windows distributions from 2003 and above

  1. Run the Node Agent .msi package as an Administrator
  2. Proceed with the installation GUI
    You may choose the 'Custom' installation if you wish to install in a different directory/drive (default drive is C:\)
  3. During the installation, the 'Enterprise Recon Configuration Tool' will come up
    Key in the corresponding information and click 'Finish'



  

Verifying Agents

After any new installation of Node Agents, it is necessary to verify them in the Enterprise Recon web console in order to utilize them.

  1. In your Enterprise Recon web console, go to Network Configuration > Agent Manager



  2. Then click 'Verify All' or 'Verify' on your new Node Agents



 

All information in this article is accurate and true as of the last edited date.

Have more questions? Submit a request

0 Comments

Please sign in to leave a comment.