Previous Next Contents Index


Chapter 4

Monitoring NAS with Third-Party Tools

This chapter describes how to monitor Netscape Application Server using the Simple Network Management Protocol (SNMP).

The following topics are included in this chapter:


About SNMP
SNMP is a protocol used to exchange data about network activity. With SNMP, data travels between your application server and a workstation where network management software is installed. From this workstation, you can remotely monitor your network and exchange information about network activity between servers. For example, using an application like HP OpenView, you can monitor which Netscape Application Server (NAS) machines are running, as well as the number and type of error messages your application servers receive.

Your network management workstation exchanges information with the application servers in your enterprise through two types of agents: the subagent and the master agent. The subagent gathers information about an application server and passes that information to the master agent. The master agent exchanges information between the various subagents and the network management workstation. The master agent runs on the same host machine as the subagents with which it communicates.


Working with the Master Agent and Subagent
Master agent operation is defined in an agent configuration file called CONFIG. You can edit the CONFIG file manually.

To configure the master SNMP agent, perform the following steps:

  1. Log in as root.
  2. Check to see if there is a Solaris SNMP daemon (snmpd) running on port 161.
  3. Edit the Solaris SNMP daemon start-up file s76snmpdx in /etc/rc3.d to modify the port to which the daemon listens.
  4. Edit the CONFIG file located in server4/nas/snmp in the server root directory.
  5. (Optional) Define sysContact and SysLocation variables in the CONFIG file.
The encapsulator forwards requests from the master agent to the Solaris agent that now listens on port 1161.

  1. Edit the file CONFIG_SAGT, modifying the following lines:
Starting the SNMP Master Agent Once you have installed the SNMP master agent, you can start it manually or by using Netscape Console.

To start the master agent manually, enter the following at the command prompt:

# magt CONFIG INIT& 
The INIT file is a nonvolatile file that contains information from the MIB-II system group, including system location and contact information. If INIT doesn't already exist, starting the master agent for the first time will create it. An invalid manager name in the CONFIG file will cause the master agent start up to fail.

Note. INIT contains information about the local system. This file is created the first time you start the master agent. You should not copy this file across machines.

To automatically start the master agent when you start the server, perform the following steps:

  1. Edit the files nas/snmp/k75snmpmagt and nas/snmp/s75snmpmagt.
  2. Change $GX_ROOTDIR to the NAS installation directory path if this variable is not yet defined in the root's environment.
  3. Copy k75snmpmagt in /etc/rc2.d and s75snmpmagt in /etc/rc3.d.
To start a master agent manually on a nonstandard port, use one of two methods:

After editing the CONFIG file manually, you should start the master agent manually by typing the following at the command prompt:

# magt CONFIG INIT& 
Enabling Statistics Collection The subagent does not report SNMP statistics to the network management workstation unless you enable statistics collection on the SNMP Settings form, which is part of Netscape Console. If statistics collection is not enabled, the subagent cannot be started.

Note. If the network management workstation experiences difficulty obtaining SNMP statistics, check the server log information:

NAS install directory/mail-instanceName/log/default
If the SNMP data collection process (snmpcoll), is not running, check the Administration Server Console to see whether the SNMP enable flag is on. For more information, see Managing Servers with Netscape Console on the Netscape documentation web site (http://home.netscape.com/eng/server/console/).

If you disable the start-up server, this collection process is also disabled.

To enable data collection, perform the following steps:

  1. Check the Enable Statistics Collection box.
  2. Restart the subagent by clicking the Start button.
Your configuration information is stored in Directory Server, the subagent starts, and statistics collection begins.


About the Management Information Base (MIB)
Netscape Application Server (NAS) stores variables pertaining to network management in a tree-like hierarchy known as the server's management information base (MIB). NAS reports significant events to the network management workstation by sending messages containing these variables. The network management workstation can also query the server's MIB for data or can remotely change variables stored in the MIB.

You can find the NAS MIB in the following location:

NAS install directory\plugins\snmp\
Formatting MIB Entries The MIB file contains the definitions for managed objects, or variables, that store network information for the server. Each variable definition includes the variable name, its data type and read/write access level, a brief description, and a permanent object identifier.

This sample entry shows the definition for the nsmailEntityDescr variable:

nasKesMaxThread    OBJECT-TYPE     / object type
SYNTAX INTEGER (SIZE (1..512)) / syntax

ACCESS read-write / read/write access level

STATUS mandatory / status

DESCRIPTION / description

"The maximum number of threads used to serve requests."

::= { kes 4 } / object identifier

This definition contains the following information:

 

© Copyright 1999 Netscape Communications Corp.