Installing the Automation Engine SNMP Subagent (UNIX)

SNMP (Simple Network Management Protocol) is an industry standard for monitoring and controlling systems, devices and components within a network environment. This document guides you through the UNIX installation for AE SNMP Subagent.

Important! The AE SNMP Subagent must be installed on a computer on which at least one of the Automation Engine's work processes is available.

This page includes the following:

Requirements

The AE SNMP Subagent and Net SNMP must have been installed and activated on the Automation Engine computer.
Exception: HP UX. The AE SNMP Subagent must operate as SNMP Masteragent in order to use EMANATE via naaagt. (naaagt configuration http://docs.hp.com/en/B2355-90692/naaagt.1M.html).

To Install the SNMP Subagent in UNIX

Install the files.
1. Unpack the AE SNMP Subagent's TAR file.
2. Copy the unpacked files to any directory of your choice or to the Automation Engine's folder.
Configure the INI files.
1. Activate the SNMP connection in the INI file (UCSRV.INI) of the Automation Engine using the snmp=1 parameter in the [GLOBAL] section. Also set the parameters snmp= and snmpreconnect= in the section [TCP/IP]. For more information,. see Automation Engine.
2. End and restart the Automation Engine's communication and work processes on all computers. No restart is necessary if the Automation Engine's INI file is already adjusted.
3. Adjust the relevant parameters in the INI file of the SNMP agent. For more information, see Agent SNMP.
Specify masteragent mode.
1. On HP UX, it is essential to specify Masteragent mode. On all other platforms, you can select whether the AE SNMP Subagent should run as Masteragent. For more information, see Agent Mode on UNIX.
2. Set the Masteragent mode in the AE SNMP Subagent's INI file using the role=1 parameter.
3. Adjust the supplied configuration files naacnf and ucsnmp1.conf.
4. The variable SNMPCONFPATH must be set. It contains the directory with the file ucsnmp1.conf (such as export SNMPCONFPATH=./).
5. It is not required to set the environment variables MIB and MIBDIR.
Start the AE SNMP Subagent and specify the INI file.

Note: The SNMP Subagent must start under the root user because otherwise the Automation Engine cannot establish a connection.

Example

./ucsnmp1 -i /home/UC4/Server/ucsnmp1.ini &

The following start parameters are available:
- -i INI file path and name
  Path and name of the INI file to be used
  By default, the INI file is searched in the folder in which the AE SNMP Subagent is stored.
- -h
  Shows available parameters and usage
- -v
  Shows the AE SNMP Subagent's version
- -crtini INI file path and name
  Generates a standard INI file
  By default, the INI file is searched in the folder in which theAE SNMP Subagent is stored.
The order in which you start the Automation Engine and the SNMP Subagent is irrelevant.

Notes:

If the AE SNMP Subagent starts first, the Automation Engine can immediately connect to the SNMP Subagent when it boots.
If the Automation Engine already runs with an active SNMP connection (UCSRV.INI), it attempts to contact the SNMP Subagents in regular intervals (snmpreconnect=). The SNMP service can be restarted subsequently even if the Automation Engine is running.
Note that traps and all SNMP events can only be sent to the SNMP Subagent when the SNMP connection is active. All events that should have been sent before the reconnection took place are lost.
You can set the time interval for the reconnection in the Automation Engine's INI file using the snmpreconnect= parameter (default value: 500 seconds).
Messages are output when the SNMP agent starts. These messages are warnings and do not affect the system's functionality (as opposed to error messages). The following message is always output and can be ignored: "No log handling enabled - turning on stderr logging".