UNIX Server Discovery Process

Home | Previous Page | Next Page IBM Informix Implementation of SNMP > Using SNMP on UNIX >

UNIX Server Discovery Process

The runsnmp.ksh script automatically starts the UNIX server discovery process, as The runsnmp.ksh Script describes. This section provides procedures for working manually with onsrvapd. Some of these procedures include instructions on how to configure OnSNMP.

The principles for starting and stopping onsrvapd manually are the same as those for a master agent: start onsrvapd before you start an Informix database server or coserver, and stop all Informix database servers and coservers on a workstation before you stop onsrvapd.

Preparing onsrvapd Manually

If you do not use runsnmp.ksh to automatically prepare and start onsrvapd, perform the steps in this section.

To prepare onsrvapd

Make sure that the owner of onsrvapd is root and that the group is informix.
Make sure that the setuid (sticky) bit is set for the onsrvapd file.

Issuing the onsrvapd Command

You can specify the onsrvapd command-line options that Figure 10 shows. Some of these options affect OnSNMP.

Figure 10. onsrvapd Command

>>-onsrvapd--+-----------------------+-------------------------><
             +- -d-------------------+
             +- -g--logginglevel-----+
             +- -k--lingermnts-------+
             +- -l--pathname---------+
             +- -p--pollsecs---------+
             +- -r--server_disc_args-+
             +- -s--level------------+
             '- -V-------------------'

Option: Description
-d: Flag that tells UNIX to run onsrvapd once and terminate it instead of starting it as a daemon.
-g logginglevel: Logging level to which OnSNMP logs debug information. Valid values are 2, 4, 8, 16, 32, and 64. The default value is 32. The lower the value, the higher the amount of logging. The onsrvapd daemon passes this value to OnSNMP.
-k lingermnts: Number of minutes that onsrvapd waits after a database server or coserver goes down before onsrvapd kills the corresponding OnSNMP. If lingermnts is 0, onsrvapd waits indefinitely.
-l pathname: Directory for the error log files. The filename of the OnSNMP error log is onsnmp.servername.log. For example, if your server name is MyServer, the filename of the OnSNMP error log is onsnmp.MyServer.log. The filename of the onsrvapd error log is onsrvapd.log.
-p pollsecs: Frequency, in seconds, with which OnSNMP polls the database server or coserver. The default value is 5 seconds. The onsrvapd daemon passes this value to OnSNMP.
-r level: Refresh control value. For a description, see Refresh Control Value.
-V: Prints the OnSNMP version number.

To start onsrvapd manually

Stop or kill any daemons that are running on the workstation.
Enter the following command:
```
onsrvapd
```

To stop onsrvapd manually, kill the onsrvapd process.

To make sure that onsrvapd is running correctly

Check the log file to verify that onsrvapd has not generated any errors. The log file is located in the /tmp directory.
Verify that onsrvapd is running.

Choosing an Installation Directory

When you have multiple Informix installation directories on a host computer, you must set the latest installation directory as INFORMIXDIR before you run the runsnmp.ksh script to start OnSNMP. If all the directories are for the same type of database server, use the installation directory that has the latest database server version number.

One way to determine the latest directory to use with different types of database server lines is to find the latest version of the SNMP master agent.

The EMANATE master agent displays the version when you run it.
The BMC Patrol agent also displays a version number.