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 and Net SNMP must have been installed and activated on the Automation Engine computer.

To Install the SNMP Subagent in UNIX, follows these steps:

  1. Unpack the TAR file of the AE SNMP Subagent and copy the unpacked files to any directory of your choice or to the folder of the Automation Engine.

  2. In the INI file (ucsrv.ini) of the Automation Engine, activate the SNMP connection 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.

  3. End and restart the communication and work processes (CPs and WPS) of the AE on all computers. No restart is necessary if the INI file of the AE is already adjusted.

  4. Adjust the relevant parameters in the INI file of the SNMP agent. For more information, see Agent SNMP.

  5. You can select whether the AE SNMP Subagent should run as Masteragent. For more information, see Agent Mode on UNIX. To do so, Set the Masteragent mode in the INI of the SNMP Subagent using the role=1 parameter.

  6. Adjust the supplied naacnf and ucsnmp1.conf configuration files.

  7. Set the variable SNMPCONFPATH. It contains the directory with the ucsnmp1.conf file (such as export SNMPCONFPATH=./). You do not have to set the MIB and MIBDIR environment variables.

  8. Start the AE SNMP Subagent and specify the INI file.

    Note: The SNMP Subagent must start under the root user, 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 the AE 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 is already running 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.

  • 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 INI file of the Automation Engine 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".

See also: