Chapter 1: Command Line Utilities

SNMP

To run any of the SNMP commands distributed with e-Biz Impact, use the ims.sr wrapper script provided in the \Sybase\Impact-5_4\bin directory. This ensures that the environment is set correctly. To run commands, pass the command as an argument to the script. For example, to run the SNMP daemon, use the ims.sr snmpdm -tcpany command. To run the daemon in debug mode, run the ims.sr snmpdm -d -tcpany command. Running the daemon in debug mode is useful for debugging setup issues.

Wrappers and scripts

The following table lists and describes the SNMP scripts.

Script	Description
ims.sr	A general wrapper script for SNMP commands.
ims.setsrdir	Sets the SNMP directory.
ims.setsrports.sh	Sets port environment variables using UNIX Bourne shell.
ims.setsrports.csh	Sets port environment variables using UNIX C shell.

Starting SNMP

Windows

To install the daemon as a service, enter:

ims.sr snmpdm -install -tcpany

To start a Windows service, do one of the following:

Enter the command:
```
ims.sr snmpdm -start
```
From the Windows Services control panel (Start | Settings | Control Panel | Administrative Tools | Services) window, start the SNMP EMANATE Master Agent service.

UNIX

To start the daemon, enter the following on the command line:

ims.sr snmpdm -tcpany

To start the daemon in the foreground, specify the -d option on the command line:

ims.sr snmpdm -d -tcpany

Working with the Microsoft agent

To configure SNMP to run in conjunction with the Microsoft agent, complete these steps:

Stop the Microsoft SNMP service using the Windows Services control panel (Start | Settings | Control Panel | Administrative Tools | Services).

Go to C:\WINNT\system32\drivers\etc\. Open the services file in a text editor and change this line:

snmp              161/udp              #SNMP

to this:

snmp              8161/udp             #SNMP

Save the file and close the text editor.
Use Start | Settings | Control Panel | Administrative Tools | Services to restart the Microsoft service.

Stopping SNMP

Windows

To stop a Windows service do one of the following:

Open a command line window and enter this command at the prompt:
```
ims.sr snmpdm -stop
```
Select Start | Settings | Control Panel | Administrative Tools | Services. When the Services window opens, right-click the SNMP EMANATE Master Agent service and select Stop.

UNIX

Find the SNMP process ID using the ps command, then use the kill command with the SIGKILL (9) signal.

For example:

kill -KILL <pid>

kill -9 <pid>

Where pid is the process ID that you identified from the ps command.

Other SNMP commands

To set up the standard port, enter:

ims.setsrdir 161

When installing a service, you must include the -tcpany option on the command line. For example, ims.sr snmpdm -install -tcpany.

Using alternate SNMP ports

Set the SNMP-related environment variables before you run the SNMP daemon, snmpdm.

If you use the Bourne shell, use the ims.setsrports.sh script to set the port environment variables—SR_SNMP_TEST_PORT and SR_TRAP_TEST_PORT. The script takes the two ports values as command line arguments. For example, to use 5161 for the SNMP port and 5162 for the trap port, enter:
```
. ims.setsrports.sh 5161 5162
```
If you use the C shell, copy the ims.setsrports.csh script to another name, for example a name that goes with the port values, then modify the values in the script values to the port values that you want to use.

For detailed instructions on using SNMP, see the e-Biz Impact Monitoring Guide.

View this book as PDF