Installation

Installation

Structure of ucsnmp1.ini (UNIX)

---

Installing the Automation Engine SNMP Subagent (UNIX)

The following document guides you through the UNIX installation for AE SNMP Subagent.

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

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 configurationA set of constituent components that make up a system. This includes information on how the components are connected including the settings applied. http://docs.hp.com/en/B2355-90692/naaagt.1M.html)

Supplied Files

The AE SNMP-Subagent files are stored in the appropriate platform's subfolder in IMAGE:SNMP\UNIX.

Installation

	1.	Installation of files

• Unpack the AE SNMP Subagent's TAR file.
• Copy the unpacked files to any directory of your choice or to the Automation Engine's folder.

	2.	Configuration of INI files

• Activate the SNMP connection in the Automation Engine's INI file UCSRV.INI using the parameter snmp=1 (section [GLOBAL]). Also set the parameters snmp= and snmpreconnect= (section [TCP/IP].
• 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.
• Adjust the relevant parameters in the AE SNMP Subagent's INI file.

	3.	Masteragent mode

• 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.
• Set the Masteragent mode in the AE SNMP Subagent's INI file using the parameter role=1.
• Adjust the supplied configuration files naacnf and ucsnmp1.conf.
• The variable SNMPCONFPATH must be set. It contains the directory with the file ucsnmp1.conf (such as export SNMPCONFPATH=./).
• It is not required to set the environment variables MIB and MIBDIR.

	4.	Starting the AE SNMP Subagent

• Start the AE SNMP Subagent and specify the INI file.
• Note that the SNMP Subagent must start under the root user because otherwise the Automation Engine cannot establish a connection.
  
  For example:
  ./ucsnmp1 -i /home/UC4/Server/ucsnmp1.ini &

The following start parameters are available:

Start parameters	Description
-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.

Note the following: 

• 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 parameter snmpreconnect= (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"