The following 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".
Supplied Files
The AE SNMP-Subagent files are stored in the particular platform's subfolder on IMAGE:SNMP\WINDOWS.
| File name | Description |
|---|---|
| UCSNMP1.DLL | AE SNMP Subagent |
| UCSNMP1.INI | INI file of the AE SNMP Subagent |
| UC4VERS2-MIB.MIB | MIB description |
Installation
You can set up the AE SNMP Subagent when you install the Automation Engine or subsequently.
- Install the files
- 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.
- 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"
- Configure the 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 theAutomation Engine's communication and work processes on all computers. No restart is necessary if the Automation Engine's INI file is already adjusted.
- Configure the Windows SNMP service.
- Adjust the relevant parameters in the AE SNMP Subagent's INI file.
- 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.
- 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.
Please note the following:
- 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 parameter snmpreconnect= (default value: 500 seconds).
The Masteragent (Windows service) is decisive for the SNMP-trap version.