Simple Network Management Protocol (SNMP) is perhaps the most prevalent network management protocol in use today. Most network devices (such as routers, switches, phones, and printers) and many host systems provide SNMP Management Agents. These agents allow you to monitor and manage the devices and host systems from a remote location. The AppManager SNMP Toolkit monitors SNMP version 1, 2, and 3 devices by using SNMP to poll Management Information Bases (MIBs).
This release improves usability and resolves previous issues. Many of these improvements were made in direct response to suggestions from our customers. We thank you for your time and valuable input. We hope you continue to help us ensure that our products meet all your needs. You can post feedback in the AppManager forum on NetIQ Communities, our online community that also includes product information, blogs, and links to helpful resources.
The documentation for this product is available on the NetIQ website in HTML and PDF formats on a page that does not require you to log in. If you have suggestions for documentation improvements, click Click to comment on this content to the right of each section of any page in the HTML version of the documentation posted at the AppManager Modules page. To download this product, see the AppManager Module Upgrades & Trials website.
This release of AppManager SNMP Toolkit provides the following enhancements:
Support for Transport Layer Security 1.2 (TLS): This release of AppManager SNMP Toolkit provides support for TLS 1.2.
This release of AppManager SNMP resolves the following issues:
Illegal Conversion results in an SNMP failure: SNMP_SYNCGET Knowledge Script for some OIDs result in non-numeric values. Converting string to numeric value results in SNMP failure. With this release, it is ensured that the string to numeric value conversion is only attempted if the result is numeric.(ENG345364)
SNMP_SYNCGET KS fails to process all OIDs in the list when one or more fails: With this release, the SNMP_SYNCGET KS is introduced with a new KS option to process the OIDs individually. By default the option is unchecked and KS continues to work with default behavior. On selecting this option, individual success or failure events of each OID can be seen.(ENG345523)
To get the updates provided in this release, you must install the module to the AppManager repository (QDB) and on the agent computer, and then propagate changes to any running jobs for the Knowledge Scripts that were updated in this release. AppManager 7.x does not automatically update renamed or copied Knowledge Scripts. For more information, see the "Upgrading Knowledge Script Jobs" section in the management guide.
This release of AppManager SNMP Toolkit replaces all Previous Releases.
For the most recently updated list of supported application versions, see the AppManager Supported Products page. Unless noted otherwise, this module supports all updates, hotfixes, and service packs for the releases listed below.
AppManager SNMP Toolkit has the following system requirements:
|
Software/Hardware |
Version |
|---|---|
|
NetIQ AppManager installed on the AppManager repository (QDB) computers, on all proxy agent computers, and on all console computers |
8.0.3, 8.2, 9.1, 9.2, 9.5, or later One of the following AppManager agents are required:
|
|
Microsoft Windows operating system on each proxy agent computers |
One of the following:
|
|
SNMP running on the devices that you want to monitor |
Versions 1, 2, or 3 |
|
AppManager for Microsoft Windows module installed on the AppManager repository (QDB) computer, on all proxy agent computers, and on all console computers |
7.6.170.0 or later |
|
Microsoft SQL Server Native Client 11.0 (for TLS 1.2 support) |
11.3.6538.0 or later NOTE:The SQL Server Native client can be installed from this Microsoft download link. |
For more information on hardware requirements and supported operating systems and browsers, see the SNMP Toolkit Management Guide, included in the download package.
NOTE:If you want TLS 1.2 support and are running AppManager 9.1 or 9.2, then you are required to perform some additional steps. To know about the steps, see the article.
The SNMP Toolkit includes a managed object, and Knowledge Scripts to discover and monitor SNMP resources. The download package includes a release notes, a management guide, Help for Knowledge Scripts, and several files that are used during installation:
AM70-SNMP-7.5.76.0.msi, the module installer.
AM70-SNMP-7.5.76.0.ini, a configuration file used with the AppManager setup program.
AM70-SNMP-7.5.76.0.xml, a configuration file used for deploying the module with Control Center. This is the file you check into the Control Center Web Depot.
AM70-SNMP-7.5.76.0-RepositoryFiles.exe, a compressed file that contains the QDB and console files. You do not need to run this file during installation.
ckAMSNMP.exe, the pre-installation check used with the AppManager setup program.
When you download the module, these files are copied by default to the local folder on the download computer. Consider copying these files to the \windows_installation\setup\Setup Files folder on the same distribution computer on which you saved your main AppManager software and documentation. By doing so, you maintain all AppManager software in one location that is easily accessible when you want to add more repositories, management servers, or agents.
Run the module installer to install the module components in the following locations:
On all proxy agent computers to install the agent components
On all console computers to install the Help and console extensions
Run the module installer only once on each of these computers.
You must also install the Knowledge Scripts. You can install these components into local or remote QDBs. When installing to the primary QDB, select the option to install Knowledge Scripts, and then specify the SQL Server name of the server hosting the QDB, as well as the case-sensitive QDB name.
IMPORTANT:If you use Control Center 7.x, run the module installer for each QDB attached to Control Center. If you use Control Center 8.x or later, run the module installer only for the primary QDB, and Control Center will automatically replicate this module to secondary QDBs.
Install Knowledge Scripts only once per QDB. The module installer now installs Knowledge Scripts for each module directly into the QDB instead of to the \AppManager\qdb\kp folder as in previous releases.
For more information about installing this module, see the AppManager SNMP Toolkit Management Guide, included in the download package.
NetIQ Corporation strives to ensure our products provide quality solutions for your enterprise software needs. The following issues are currently being researched. If you need further assistance with any issue, please contact Technical Support.
Knowledge Scripts accept only integers: AppManager SNMP Toolkit Knowledge Scripts cannot get numbers that are not integers. The SyncGet and SyncGetTable Knowledge Scripts report incorrect data when calculating deltas and percentages. (ENG300772)
This release of AppManager SNMP Toolkit includes enhancements added in previous releases.
This release provided the following enhancement:
Support for Microsoft Windows 10 and Windows Server 2016: This release supports Windows 10 and Windows Server 2016. For more information, see the System Requirements.
Discovery_Snmp discovers a maximum of 250 SNMP devices: In this release, you can now discover up to 250 SNMP devices at a time using the Discovery_Snmp Knowledge Script.
Snmp_SyncGet can convert string into numeric value: In this release, a new parameter is added in the Snmp_SyncGet Knowledge Script that enables you to convert a string into number if the string represents a valid numeric data.
This release of AppManager SNMP Toolkit resolved the following issues:
Discovery_Snmp fails to discover PDU MIB: The Discovery_Snmp Knowledge Script failed to discover the PDU MIB. In this release, the issue is resolved. (ENG337458)
Snmp_SyncGet fails to convert the string into numeric value: The Snmp_SyncGet Knowledge Script did not convert the string to number if the string had valid numeric data. In this release, the issue is resolved. (ENG343949)
Snmp_AddMIBs raises a warning event when a new MIB is loaded: An event was raised whenever a new MIB was loaded. In this release, the issue is resolved. (ENG342021)
Invalid OID/ODE error when NS-ROOT-MIB is added to the SNMP module: The Snmp_SyncGet Knowledge Script failed to query the tables when the index to the table was represented by string. In this release, the issue is resolved. (ENG342324)
This release provided the following enhancement:
Support for Advanced Encryption Standard (AES) encryption algorithm: This release now supports the AES encryption algorithm in addition to the Data Encryption Standard (DES) encryption algorithm. (ENG312718)
This release resolved the following issue:
Knowledge Scripts fail with timeout error: This release resolves an issue where discovery and other SNMP Toolkit Knowledge Scripts timed out in environments with heavy network traffic. With this release, the timeout ranges are appropriate for those environments. (ENG318964, ENG320193)
This release resolved the following issues:
Discovery_Snmp fails with TOO_BIG error: This release resolves an issue where discovery would fail and report an event with the status TOO_BIG when discovering a device with a significantly large number of MIB objects. (ENG306109)
SNMPTrap_Async events report incorrect computer name: This release resolves an issue where SNMPTrap_Async events show the name and IP address of the proxy agent instead of the target computer when the proxy and target computers are on different subnets. (ENG305565)
This release added support for Microsoft Windows 2008 R2.
This release resolved the following issue:
SNMP_SyncGet fails with an internal failure event when run on some devices: This release resolves an issue where the SNMP_SyncGet Knowledge Script intermittently fails with an internal failure event when run on devices with MIBs containing UCD-specific OPAQUE types. (ENG299327)
This release resolved the following issue:
AddMIBs job fails for MIB names greater than 33 characters: This release resolves an issue in which the SNMP_AddMIBs Knowledge Script job fails when attempting to load MIBs with names that contain more than 33 characters. With this release, the AddMIBs job can process MIB names of any length. (ENG286256)
This release resolved the following issue:
Discovery_Snmp does not discover devices using UDP port other than 161: Before you install this release, the Discovery_Snmp Knowledge Script job fails to discover devices listening on non-standard UDP ports. The job times out and raises a failure event. After you install this release, a code change enables the job to successfully discover devices listening on non-standard UDP ports. (ENG281509)
This release resolved the following issue:
SNMPTrap_Async Knowledge Script job fails when monitoring multiple devices: Before you install this release, the SNMPTrap_Async Knowledge Script job fails when you attempt to monitor multiple devices and use multiple OID filters at the same time. The job does not fail if you monitor one device or use one filter. After you install this release, the job runs successfully for multiple devices and multiple filters. (ENG265176)
This release resolved the following issues:
Error occurs when running SNMPTrap_Async: Before installing this release, when running the SNMPTrap_Async Knowledge Script against two UPSs, an invalid argument causes an error to occur. After installing this release, the error no longer occurs and you can run the SNMPTrap_Async job successfully. (ENG261638)
SNMP_SyncGet Knowledge Script sometimes fails when run against a MIB OCTET_STRING type object: Before installing this release, when running the SNMP_SyncGet Knowledge Script, the string comparison fails when it runs against a MIB OCTET_STRING type object without a display hint in its MIB definition. After installing this release, a correction to the Knowledge Script allows the job to run a string comparison successfully. (ENG262613)
This release resolved the following issue:
SNMPTrap_Async jobs cause high CPU usage: Before you install this release, SNMPTrap_Async Knowledge Script jobs cause high CPU usage and never complete because the Trap Client enters a never-ending loop and the Trap Receiver does not receive acknowledge messages from the client. After you install this release, a rebuilt TCP Listener in the Trap Client and Trap Receiver allows SNMPTrap_Async jobs to complete. (ENG257776)
This release resolved the following issue:
Trap Receiver discovery fails: Before you install this release, the Discovery_Snmp Knowledge Script job fails to discover the NetIQ Trap Receiver. After you install this release, you can successfully discover the NetIQ Trap Receiver. (ENG253579)
This release provided the following enhancements:
AppManager SNMP Toolkit includes the ability to check for SNMP traps forwarded from NetIQ SNMP Trap Receiver.
Trap Receiver supports the ability to forward incoming traps to a second destination IP address and port, in addition to sending them to AppManager. (ENG247136)
Trap Receiver includes different levels of logging, including trace and debug messages. The configuration file identifies the level of logging you want to use and whether port forwarding is enabled. (ENG246913)
This release included changes to following Knowledge Scripts:
SNMP_AddMIBs: This script now copies files to and reloads both AppManager/bin/AMSnmpMIBs and AppManager/bin/MIBs directories. Both managed objects generate events for this script, and the short event messages include the name of the relevant managed object.
SNMP_SNMPTrap_Async: This new script checks for incoming SNMP traps forwarded from NetIQ SNMP Trap Receiver.
SNMP_DeviceReboot: This script now monitors whether an SNMP device or its network management component has rebooted between job intervals, and the user can select which uptime to monitor.
This initial release provided the following enhancements:
Support for a blank context in SNMP version 3: You can configure SNMP permissions for devices that do not support context. For more information, see the “Configuring SNMP Permissions” topic in the AppManager SNMP Tookit Management Guide included in the module's download package.
Support for 64-bit Windows Server 2003: You can install AppManager SNMP Tookit on proxy agent computers running 64-bit Windows Server 2003.
Support for IPv6 MIB objects: AppManager SNMP Tookit can poll MIB objects specific to Internet Protocol version 6 (IPv6), defined in MIBs such as INET-ADDRESS-MIB, IPV6-TC, and CISCO-TC. IPv6 provides a 128-bit address space that allows greater flexibility in assigning IP addresses. For more information about adding IPv6 MIBs to the MIB tree, see the help for the Snmp_AddMIBs Knowledge Script.
Our goal is to provide documentation that meets your needs. If you have suggestions for improvements, please email Documentation-Feedback@netiq.com. We value your input and look forward to hearing from you.
For detailed contact information, see the Support Contact Information website.
For general corporate and product information, see the NetIQ Corporate website.
For interactive conversations with your peers and NetIQ experts, become an active member of our community. The NetIQ online community provides product information, useful links to helpful resources, blogs, and social media channels.
For information about NetIQ legal notices, trademarks, disclaimers, warranties, export and other use restrictions, U.S. Government restricted rights, patent policy, and FIPS compliance, see https://www.netiq.com/company/legal/.
Copyright (C) 2018 NetIQ Corporation. All Rights Reserved.