I.2 Setting the SNMP trap converter

The following explains the procedures for starting the SNMP trap converter, changing the settings, and stopping the SNMP trap converter.

Organization of this subsection

(1) Setup
(2) Starting the SNMP trap converter
(3) Changing a setting while a trap is active
(4) Stopping the SNMP trap converter
(5) Clearing the SNMP trap converter

(1) Setup

Set up the SNMP trap converter before using it. Setup is also required if you re-install JP1/Base over a previous installation.

Execute the imevtgw_setup command to register the SNMP trap converter in NNM.
- In Windows:
  
  At the command prompt, execute the following command:
```
cd installation-folder\bin
imevtgw_setup.exe 
```
- In UNIX:
  
  Execute the command as follows:
```
/opt/jp1base/bin/imevtgw_setup 
```
The SNMP trap converter is registered in the NNM process management.
Make sure that the SNMP trap converter is registered correctly.

Check the NNM process as follows.
- In Windows:
  
  From the Windows Start menu, choose Programs, Network Node Manager, Network Node Manager Admin, NNM Services - Status.
- In UNIX:
  
  Execute the command as follows:
```
/opt/OV/bin/ovstatus 
```
If the IMEvtgw process appears under the ovw process, the SNMP trap converter has been registered correctly.

To Page Top

(2) Starting the SNMP trap converter

To start the SNMP trap converter:

Edit the action definition file for converting SNMP traps (imevtgw.conf).

For details on the action definition file, see I.4(1) Action definition file for converting SNMP traps (imevtgw.conf).
Edit the SNMP trap conversion filter file (snmpfilter.conf).

Specify the conditions for all SNMP traps to be converted into JP1 events, using the appropriate enterprise and event names listed in trapd.conf. For details on how to do this, see I.4(2) SNMP trap conversion filter file (snmpfilter.conf).
Start NNM.

SNMP trap converter begins when NNM starts.
- In Windows:
  
  From the Windows Start menu, choose Programs, Network Node Manager, Network Node Manager Admin, and then NNM Services - Start.
- In UNIX:
  
  To start the NNM background process, execute the following command:
```
/opt/OV/bin/ovstart 
```
Confirm that the converter functions normally.

Generate an SNMP trap that can be converted, and then confirm that the trap was successfully converted into a JP1 event.

To Page Top

(3) Changing a setting while a trap is active

If you change the settings in the action definition file for converting (imevtgw.conf) SNMP traps or filter file for converting SNMP traps (snmpfilter.conf), apply the new settings as follows.

If you edit the SNMP trap conversion action definition file: After editing the definition file, restart the SNMP trap converter.
If you edit the SNMP trap conversion filter file: You can apply the new settings without stopping the SNMP trap converter by executing the xnmevents command (provided by NNM) with the -event option.

To Page Top

(4) Stopping the SNMP trap converter

To stop the SNMP trap converter:

In Windows:

From the Windows Start menu, choose Programs, Network Node Manager, Network Node Manager Admin, and then NNM Services - Stop.
In UNIX:

Execute the command as follows:
```
/opt/OV/bin/ovstop 
```

To Page Top

(5) Clearing the SNMP trap converter

Before you uninstall JP1/Base, clear the SNMP trap converter registered in the NNM process management.

In Windows:

From the Windows Start menu, choose Programs, Network Node Manager, Network Node Manager Admin, and then NNM Services - Status. Check whether IMEvtgw (the SNMP trap converter) is inactive.

If IMEvtgw is running, from the Start menu choose Programs, Network Node Manager, Network Node Manager Admin, and then NNM Services - Stop to end the service.
At the command prompt, execute the following command:

cd installation-folder\bin

imevtgw_setup.exe -d

This command deletes the imevtgw.exe file from the NNM folder, and clears the setting for starting the SNMP trap converter from the NNM process management.

In UNIX:

Execute the /opt/OV/bin/ovstatus command and make sure that IMEvtgw (the SNMP trap converter) is inactive.

If IMEvtgw is running, execute the /opt/OV/bin/ovstop command to end the NNM daemon processes.
Execute the following command:

/opt/jp1base/bin/imevtgw_setup -d

This command deletes the imevtgw.exe file and imevtgw file from the NNM directory, and clears the setting for starting the SNMP trap converter from the NNM process management.

To Page Top