Installing the Automation Engine SNMP Subagent (Windows)

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 Windows installation for AE SNMP Subagent.

Requirements

  • The AE SNMP Subagent and the Windows SNMP service must be installed and activated on the Automation Engine computer.

  • Install Windows Patch KB950923 if you cannot start the AE SNMP Subagent on Windows Vista or Windows Server 2008 and the Windows event log shows the error message "SNMP Extension agent has terminated. Event 2020, EvntAgnt".

To Install the SNMP Subagent in Windows, follow these steps:

You can set up the AE SNMP Subagent when you install the Automation Engine or subsequently.

  1. Start the AE SNMP Subagent's setup program. You can also manually copy the UCSNMP1.DLL library and the UCSNMP1.INI file to the %WINDIR%\System32 directory.

  2. Register the library in the registry database as follows:

    [HKEY_LOCAL_MACHINE\SOFTWARE\AUTOMIC\SnmpAgent\Vers1]               

    "Pathname"="UCSnmp1.dll"

     

    [HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\SNMP\Parameters\ExtensionAgents]

    "10"="SOFTWARE\AUTOMIC\SnmpAgent\Vers1"


  3. 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.

  4. 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.

  5. Configure the Windows SNMP service. For more information, see Windows SNMP Service Configuration.

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

  7. The AE SNMP Subagent uses the path that is specified in the Windows system environment variable UC_SNMP_INI in order to access the INI file. If this variable is not available, the Subagent searches it in the directory in which the AE SNMP Subagent is installed. If the INI file is not available here, the Subagent uses the default values.

  8. Start the AE SNMP Subagent.

    Restart the Windows SNMP service. It automatically starts the AE SNMP Subagent.

    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=). You can restart the SNMP service subsequently even when the Automation Engine is running.

  • The SNMP connection needs to be active to send traps and SNMP events to the SNMP Subagent. 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).

    • The Masteragent (Windows service) is decisive for the SNMP-trap version.

See also: