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

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

1. Install the files.

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

   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"

2. 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. Configure the Windows SNMP service. For more information, see Windows SNMP Service Configuration.

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

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

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

• When the AE SNMP Subagent starts first, the Automation Engine can immediately connect to the SNMP Subagent when it boots.

• When the Automation Engine already runs 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.

• Note that 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 Automation Engine's INI file by using the snmpreconnect= parameter (default value: 500 seconds).

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

See also:

• SNMP Support
• MIB - Management Information Base