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 our products meet all your needs. You can post feedback in the AppManager forum on Qmunity, our community Web site that also includes product notifications, blogs, and product user groups.

For more information about this release and for the latest management guides, see the AppManager Documentation page. To download this module and view the latest release notes, see the AppManager Module Upgrades & Trials page.

What's New?

This release of the AppManager SNMP Toolkit resolves 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)

To get the updates provided in this release, you must install the module to the 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 the SNMP Toolkit replaces all previous releases.

Return to Top

System Requirements

For the most recently updated list of supported application versions, see the AppManager Supported Products Web site.

The SNMP Toolkit has the following system requirements:

• AppManager version 7.0 or later installed on the AppManager repository (QDB) computer, on all proxy agent computers, and on all console computers
  Note Support for Windows Server 2008 on AppManager 7.x requires AppManager Windows Agent hotfix 71704 or later. For more information, see the AppManager Suite Hotfixes page.
• One of the following versions of Microsoft Windows installed on each proxy agent computer:
  • Windows Server 2008 R2
  • Windows Server 2008 (32-bit or 64-bit)
  • Windows Server 2003 R2 (32-bit or 64-bit)
• SNMP v1, v2, or v3 running on the devices you want to monitor
• AppManager for Microsoft Windows module installed on the AppManager repository (QDB) computer, on all proxy agent computers, and on all console computers
  Note NetIQ Corporation recommends version 7.6.170.0 at minimum. For more information, see the AppManager Module Upgrades & Trials Web page.

For more information, see the AppManager SNMP Toolkit Management Guide, included in the download package.

Return to Top

Contents of the Download Package

The SNMP Toolkit includes a managed object, qSNMPa4.dll, and Knowledge Scripts to discover and monitor SNMP resources. The download package includes this Readme, a management guide, Help for Knowledge Scripts, and several files that are used during installation:

• AM70-SNMP-7.4.60.0.msi, the module installer.
• AM70-SNMP-7.4.60.0.ini, a configuration file used with the AppManager setup program.
• AM70-SNMP-7.4.60.0.xml, a configuration file used for deploying the module with Control Center. This file is the file you check into the Control Center Web Depot.
• AM70-SNMP-7.4.60.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.

Return to Top

Installing This Release

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 to either 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, 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.

Return to Top

Known Issues

NetIQ Corporation strives to ensure our products provide quality solutions for your enterprise software needs. The following issue is 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)

Return to Top

Previous Releases

This release of the AppManager SNMP Toolkit included enhancements added in previous releases.

Release 7.4.53.0, May 2011

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)

Release 7.4.49.0, April 2011

This release added support for Microsoft Windows 2008 R2.

Release 7.4.41.0, December 2010

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)

Release 7.4.36.0, April 2010

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)

Release 7.4.34.0, December 2009

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)

Release 7.4.29.0, May 2009

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)

Hotfix 71484, December 2008

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)

Hotfix 71413, December 2008

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)

Hotfix 71313, October 2008

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)

Release 7.4, July 2008

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.

Release 7.3, May 2008

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

Return to Top

Contact Information

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

For general corporate and product information, see the NetIQ Corporate Web site.

For interactive conversations with your peers and NetIQ Corporation experts, become an active member of Qmunity, our community Web site that offers product forums, product notifications, blogs, and product user groups.

Return to Top

Legal Notice

THIS DOCUMENT AND THE SOFTWARE DESCRIBED IN THIS DOCUMENT ARE FURNISHED UNDER AND ARE SUBJECT TO THE TERMS OF A LICENSE AGREEMENT OR A NON-DISCLOSURE AGREEMENT. EXCEPT AS EXPRESSLY SET FORTH IN SUCH LICENSE AGREEMENT OR NON-DISCLOSURE AGREEMENT, NETIQ CORPORATION PROVIDES THIS DOCUMENT AND THE SOFTWARE DESCRIBED IN THIS DOCUMENT "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. SOME STATES DO NOT ALLOW DISCLAIMERS OF EXPRESS OR IMPLIED WARRANTIES IN CERTAIN TRANSACTIONS; THEREFORE, THIS STATEMENT MAY NOT APPLY TO YOU.

This document and the software described in this document may not be lent, sold, or given away without the prior written permission of NetIQ Corporation, except as otherwise permitted by law. Except as expressly set forth in such license agreement or non-disclosure agreement, no part of this document or the software described in this document may be reproduced, stored in a retrieval system, or transmitted in any form or by any means, electronic, mechanical, or otherwise, without the prior written consent of NetIQ Corporation. Some companies, names, and data in this document are used for illustration purposes and may not represent real companies, individuals, or data.

This document could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein. These changes may be incorporated in new editions of this document. NetIQ Corporation may make improvements in or changes to the software described in this document at any time.

© 2012 NetIQ Corporation and its affiliates. All Rights Reserved.

U.S. Government Restricted Rights: If the software and documentation are being acquired by or on behalf of the U.S. Government or by a U.S. Government prime contractor or subcontractor (at any tier), in accordance with 48 C.F.R. 227.7202-4 (for Department of Defense (DOD) acquisitions) and 48 C.F.R. 2.101 and 12.212 (for non-DOD acquisitions), the government's rights in the software and documentation, including its rights to use, modify, reproduce, release, perform, display or disclose the software or documentation, will be subject in all respects to the commercial license rights and restrictions provided in the license agreement.

Check Point, FireWall-1, VPN-1, Provider-1, and SiteManager-1 are trademarks or registered trademarks of Check Point Software Technologies Ltd.

ActiveAudit, ActiveView, Aegis, AppManager, Change Administrator, Change Guardian, Compliance Suite, the cube logo design, Directory and Resource Administrator, Directory Security Administrator, Domain Migration Administrator, Exchange Administrator, File Security Administrator, Group Policy Administrator, Group Policy Guardian, Group Policy Suite, IntelliPolicy, Knowledge Scripts, NetConnect, NetIQ, the NetIQ logo, PSAudit, PSDetect, PSPasswordManager, PSSecure, Secure Configuration Manager, Security Administration Suite, Security Manager, Server Consolidator, VigilEnt, and Vivinet are trademarks or registered trademarks of NetIQ Corporation or its subsidiaries in the USA. All other company and product names mentioned are used only for identification purposes and may be trademarks or registered trademarks of their respective companies.

For purposes of clarity, any module, adapter or other similar material ("Module") is licensed under the terms and conditions of the End User License Agreement for the applicable version of the NetIQ product or software to which it relates or interoperates with, and by accessing, copying or using a Module you agree to be bound by such terms. If you do not agree to the terms of the End User License Agreement you are not authorized to use, access or copy a Module and you must destroy all copies of the Module and contact NetIQ for further instructions.

Return to Top