Using SNMP Monitoring Programs

You can monitor the POA from the Management and Monitoring component of Novell ZENworks® for Servers, ManageWise®, or any other SNMP management and monitoring program. When properly configured, the POA sends SNMP traps to network management consoles for display along with other SNMP monitored programs.

Although the POA is SNMP-enabled by default, the server where the POA is installed must be properly configured to support SNMP, and the POA object in eDirectory must be properly configured as well. To set up SNMP services for your server, complete the following tasks:


Setting Up SNMP Services for the POA

Select the instructions for the platform where the POA runs:


Setting Up SNMP Services for the NetWare POA

The NetWare POA supports SNMP through the SNMP services loaded on the NetWare server. SNMP services are provided through the SNMP NLM. The SNMP NLM initiates and responds to requests for monitoring information and generates trap messages.

If the SNMP NLM is not loaded before the NetWare POA, the POA still loads and functions normally, but SNMP support is disabled. The POA does not attempt to auto-load snmp.nlm.

To load the SNMP NLM manually:

  1. Go to the console of each NetWare server where you want to implement SNMP services.

    These servers should already have the GroupWise agents installed.

  2. Type the command to load the SNMP NLM:

    Syntax:
    load snmp v control=x monitor=y trap=z

    where v represents Verbose, meaning to display informational messages, and x, y and z are replaced with your system SNMP community strings for SNMP SETs, GETs and TRAPs).

    Example:
    load snmp v control=private monitor=public trap=all

    The configuration for the SNMP NLM is found in snmp.cfg and traptarg.cfg in the sys:\etc directory. View the contents of these files for more information.

    The TCP/IP NLM automatically loads snmp.nlm, using default values for the community strings. If your system uses different community string values, load snmp.nlm before tcpip.nlm.

  3. If the SNMP NLM is already loaded, you can add the control and trap parameters by typing the following at the console prompt:

    snmp control= trap=

    To automatically load these commands, include them in the autoexec.ncf file.

    For more information about implementing SNMP services, see your NetWare documentation.

  4. Skip to Copying and Compiling the POA MIB File.


Setting Up SNMP Services for the Linux POA

The Linux POA is compatible with NET-SNMP. An older version of SNMP called UCD-SNMP cannot be used with the Linux POA. NET-SNMP comes standard with the versions of Red Hat Linux supported for GroupWise 6.5 for Linux, but it does not come standard with the supported versions of SUSE Linux. If you are using SUSE Linux, you must update to NET-SNMP in order to use SNMP to monitor the Linux POA.

  1. Make sure you are logged in as root.

  2. If NET-SNMP is not already set up on your Linux server, use the following command to configure SNMP:

    snmpconf -g basic_setup

    The snmpconf command creates the snmpd.conf file in one of the following directories, depending on your version of Linux:

    /usr/share/snmp
    /usr/local/share/snmp
    ~/.snmp

  3. Locate the snmpd.conf file on your Linux server.

  4. In a text editor, open the snmpd.conf file and add the following line:

    dlmod Gwsnmp /opt/novell/gw/agents/lib/libgwsnmp.so

  5. Save the snmpd.conf file and exit the text editor.

  6. Restart the SNMP daemon (snmpd) to put the changes into effect.

  7. Skip to Copying and Compiling the POA MIB File.


Setting Up SNMP Services for the Windows POA

SNMP support is provided for up to eight Windows POAs on the same Windows server. Upon startup, each instance of the POA is dynamically assigned a row in its SNMP table. View the contents of the POA MIB for a description of the SNMP variables in the table. See Copying and Compiling the POA MIB File for more information about MIB files.

To set up SNMP services for the Windows POA, complete the following tasks:


Installing Windows SNMP Support

For Windows, the SNMP service is usually not included during the initial operating system installation. The SNMP service can be easily added at any time. To add or configure the SNMP service, you must be logged in as a member of the Administrator group.

To add the SNMP service to a Windows NT server:

  1. From the Control Panel, double-click Network.

  2. Click Services > Add > select SNMP Service.

  3. Follow the on-screen prompts. You need your original Windows NT media.

    You are given the opportunity to configure the SNMP service. The only required information for GroupWise is the Trap Destination and Community Name.

  4. After the installation is complete, reboot the server.

    For more information about configuring the SNMP service, see your Windows NT documentation.

To add the SNMP service to a Windows 2000 server:

  1. From the Control Panel, double-click Add/Remove Programs.

  2. Click Add/Remove Windows Components.

  3. Select Management and Monitoring Tools.

  4. Click Details, then select Simple Network Management Protocol.

Continue with Installing GroupWise Agent SNMP Support.


Installing GroupWise Agent SNMP Support

The GroupWise Agent Installation program includes an option for installing SNMP support. However, if the server where you installed the agents did not yet have SNMP set up, that installation option was not available. Now that you have set up SNMP, you can install GroupWise agent SNMP support.

At the Windows server where you want to install the GroupWise agent SNMP support:

  1. Run setup.exe at the root of the GroupWise 6.5 Administrator CD. Click Install Products > GroupWise Agents > Install GroupWise Agents.

    or

    Run install.exe from the agents subdirectory on the GroupWise 6.5 Administrator CD or in your software distribution directory if you have updated it with the latest GroupWise software.

  2. In the Installation Path dialog box, browse to and select the path where the agent software is installed, then select Install and Configure SNMP for GroupWise Agents.

  3. To shorten the install time, deselect Install GroupWise Agent Software.

  4. Continue through the rest of the installation process as prompted by the Agent Installation program.

    The Agent Installation program copies the SNMP support files to the agent installation directory, makes the appropriate Windows registry entries, and restarts the Windows SNMP service.

  5. Continue with Copying and Compiling the POA MIB File.


Copying and Compiling the POA MIB File

An SNMP-enabled POA returns information contained in a Management Information Base (MIB). The MIB is an ASCII data structure that defines the information gathered. It also defines the properties that can be monitored and managed on the SNMP-enabled POA.

Before you can monitor an SNMP-enabled POA, you must compile the gwpoa.mib file using your SNMP management program. For NetWare or Windows, the GroupWise MIBs are located on the GroupWise 6.5 Administrator CD in the \agents\snmp directory or in the software_distribution_directory\agents\snmp directory if you have updated it with the latest GroupWise software. For Linux, the GroupWise MIBs are located on the GroupWise 6.5 for Linux Administrator CD in the /agents/snmp directory.

  1. Copy the gwpoa.mib file to the location required by your SNMP management program.

    For example, ManageWise users would copy the gwpoa.mib file to the \mw\nms\snmpmibs\current directory. ZENworks Server Management users can access the gwpoa.mib file in the software distribution directory.

  2. Compile or import the gwpoa.mib file as required by your SNMP management program.

    For example, to compile the gwpoa.mib file for ZENworks Server Management:

    1. In ConsoleOne, right-click the Site Server object, then click Properties > MIB Pool.

    2. Click Modify Pool > Add.

    3. Browse to and select the gwpoa.mib file, then click OK.

    4. Click Compile.

    5. Make sure that the server where the POA is running is configured to send SNMP traps to the ZENworks Server Management Site Server.

      • On a NetWare server, add the IP address or hostname of the ZENworks Server Management Site Server to the traptarg.cfg file in the sys:\etc directory.
      • On a Windows server, add the IP address or hostname of the ZENworks Server Management Site Server to the list of trap destinations.

        From the Windows NT Control Panel, double-click Network; or, from the Windows 2000 Control Panel, double-click Administrative Tools. Then click Services > SNMP Service > Properties > Traps.

    Refer to your SNMP management program documentation for specific instructions.

  3. If you are using Novell ManageWise, continue with Customizing Your ManageWise Installation to Monitor the POA.

    or

    If you are not using ManageWise, skip to Configuring the POA for SNMP Monitoring.


Customizing Your ManageWise Installation to Monitor the POA

The GroupWise agent installation includes files that help ManageWise monitor the GroupWise agents more effectively.

These capabilities are available only with ManageWise, not with ZENworks Server Management.


GroupWise MIB Files

The GroupWise MIB files include the standard SNMP management information. In addition, the files include annotations that enhance the Alert functions of ManageWise.

For example, the Summary provides more detailed information than the Description does in other SNMP management programs. The ManageWise annotations are embedded in comments; therefore, they have no affect on other SNMP management programs.


GroupWise Agent Alarm Help File

When GroupWise alarms appear in ManageWise, you can double-click the alarm to display the alarm information contained in the Agent Alarm help file. To enable this feature, copy the gwalarm.hlp file from the \agents\snmp directory to the \mw\nms\help directory on your ManageWise station. This help file explains the alarms each agent might produce by giving a description, cause, and action for each alarm.


Configuring the POA for SNMP Monitoring

In order for SNMP monitoring programs to monitor the POA, the POA must be configured with a network address and SNMP community string.

  1. Browse to and right-click the POA object, then click Properties.

  2. Click GroupWise > Network Address to display the Network Address page.

  3. Click the pencil icon to provide the TCP/IP address or IPXTM/SPXTM address of the server where the POA runs, then click Apply.

  4. Click GroupWise > Agent Settings page, then scroll to the bottom of the settings list.

  5. Provide your system SNMP community GET string, then click OK.

    ConsoleOne then notifies the POA to restart so the new settings can be put into effect.

    The POA should now be visible to your SNMP monitoring program.