14.2.3 Setup for linking with NNM

(1) Executing setup to add an agent

Execute setup to add an agent to be monitored through NNM linkage. Skip this procedure if PFM - Manager has been installed on a host that has NNM, and PFM - Agent or PFM - RM is already registered when PFM - Manager is setup.

PFM - Manager version 09-00 or later automatically registers PFM - Agent or PFM - RM, so no additional setup is required for the PFM - Agent or PFM - RM information. However, if the release date of PFM - Agent or PFM - RM is later than that of PFM - Manager, PFM - Agent or PFM - RM must be registered manually. For details on the release dates for PFM - Manager, PFM - Agent, and PFM - RM, see the Release Notes for each program.

When PFM - Manager has not been installed and PFM - Base has been installed instead on a host that has NNM, copy the setup files for PFM - Agent or PFM - RM onto a host that has NNM, and then execute the setup command in the same way as you would to register PFM - Agent or PFM - RM during the setup of PFM - Manager.

jpcconf agent setup -key xxxx

jpcconf agent setup -key Oracle

To Page Top

(2) Setting up the destination of SNMP traps

Set up the required alarms in the window of PFM - Web Console in order to manage networks by using NNM. Set up the destination of SNMP traps in the alarm settings.

1. Log on to PFM - Web Console from the Web browser of the monitoring console.

   You must log on with a user account that has administrator user permissions.

2. In the navigation frame of the Main window, select the Services tab.

3. In the navigation frame of the Services window, select the PFM - Manager folder.

4. From the list of PFM - Manager services, select a Trap Generator service.

   A Trap Generator service is a service whose name begins from PC, or <Trap Generator>.

   The selected Trap Generator service is marked with a checkmark.

5. Select the Properties method in the method frame.

6. In the Properties window for the Trap Generator service, select the ADD OR DELETE A TRAP DESTINATION folder from the properties tree.

7. In the Value field for the ADD A DESTINATION property at the bottom of the information frame, specify the host name or IP address of the destination for SNMP traps.

8. Click the Finish or Apply button.

9. Select the destination folder for SNMP traps which now appears below the Trap Destinations folder.

10. Change the settings for the property at the bottom of the information frame.

    You can specify the contents as follows:

    Retry Count

    Specify an integer from 0 to 32767 for the number of times a SNMP trap is transmitted. The default value is 1 (time). The default value is used if you specify 0.

    Retry Interval

    Specify an integer from 0 to 32767 for the interval (seconds) between retransmissions of SNMP traps. The default value is 5 (seconds). The default value is tentatively used if you specify 0.

    Trap Port

    Specify a number from 1 to 32767 for the port number of the destination of SNMP traps. The default value is 162. The default value is tentatively used if you specify 0.

    Enabled

    Select Yes or No to specify whether or not to transmit SNMP traps. The default value is Yes.

11. Click the Finish or Apply button.

    The settings are saved.

To Page Top

(3) Modifying the NNM linkage definition file

Modify the NNM linkage definition file (jpcnnm.ini) to establish linkage with NNM.

The NNM linkage definition file provided by Performance Management is stored in the following directory on a host that contains NNM:

• In Windows:

  installation-folder\NNMEx\jpcnnm.ini

• In UNIX:

  /opt/jp1pc/NNMEx/jpcnnm.ini

  Define the sections listed in the following table for the jpcnnm.ini file.

  Table 14‒4: Sections to be set up in jpcnnm.ini and their settings

  Role	Section name	Setting
  Associates PFM - Manager host name with PFM - Web Console host name and port numbers	[Manager Definitions]	PFM - manager-host-name=PFM - Web- Console-host-name: PFM - Web- Console-port-number You can omit the PFM - Web Console port number but not the PFM - Web Console host name. The port number that is set as a default for clients is used if you omit a port number. Host names of PFM - Manager are case-insensitive. Although you can define multiple host names, you cannot define the same host.
  Paths to Web browsers	[Commons]	browserpath=path-to-Web-browser This item cannot be omitted. If the Web browser path contains a space, enclose the path in double quotation marks ("").

  Important note

  • Lines are ignored if you enter any blank characters (such as spaces) in front of sections or labels.

  • Lines are ignored if there are no equal signs (=) after labels.

  • The setting will not work properly if you enter any blank characters (such as spaces) after port numbers.

The following table lists examples of settings in the jpcnnm.ini file.

Note:

Define multiple PFM - Managers in the Manager Definition section of the jpcnnm.ini file as follows if multiple PFM - Managers exist in the systems.

For multiple monitoring, define multiple PFM - Managers as follows:

If multiple PFM - Managers are defined, the window for selecting PFM - Manager for the connection destination appears when you start the window of PFM - Web Console from NNM. Select PFM - Manager to be connected in the window to display the Login window of PFM - Web Console. If a single PFM - Manager has been specified in the Manager Definition section of the jpcnnm.ini file, the window for selecting PFM - Manager for the connection destination does not appear and the Login window of PFM - Web Console appears.

To Page Top

(4) Executing the setup command

Execute the setup command provided by Performance Management. The environment setup for linking with NNM is performed and the services of the NNM linkage function are started when you execute the command.

Execute the jpcconf ov enable command.

Note:

Perform the following setup procedure if you specify multiple PFM - Managers in the Manager Definition section of the jpcnnm.ini file.

1. Execute the jpcconf ov enable -mkhtml command.

   An HTML file for the window to select PFM - Manager is created.

2. Execute the jpcconf ov enable command.

To Page Top

(5) Modifying the NNM linkage definition file again (only for multiple monitoring)

For multiple monitoring, you must specify the settings so that only one PFM - Web Console window starts when connecting to PFM - Manager on either of the primary Manager or the secondary Manager. Therefore, you need to modify the jpcnnm.ini file modified in 14.2.3(3) Modifying the NNM linkage definition file so that only the primary PFM - Web Console host name is specified as follows:

Also, when you switch the primary Manager with the secondary Manager, change the definition so that PFM - Web Console will start on the new primary Manager.

To Page Top

(6) Associating alarms with SNMP traps and reports

Set up the following items in the Alarms window of PFM - Web Console:

• Set up issuing of SNMP traps as an action.

  Set up issuing of SNMP traps as an action to be performed when an alarm is issued.

• Associating alarms with reports

  Enable displaying of reports in the window of PFM - Web Console from NNM.

The following procedure mainly describes operations for setting up SNMP traps to be issued and for associating alarms with reports.

1. Log on to PFM - Web Console as a user with administrator user permissions.

2. In the navigation frame of the Main window, click the Alarms tab.

3. In the navigation frame of the Alarms window, select the alarm definition for which you want to issue SNMP traps.

   The selected alarm is marked with a checkmark.

4. Select the Edit method in the method frame.

5. In the Edit > Main Information window in the information frame, click the Next button.

6. In the Actions to be executed area of the Edit > Action window select the SNMP check box.

   Select the check boxes for the alarm statuses (Abnormal, Warning, or Normal) for which you want to issue SNMP traps.

7. In Report to be displayed, click the Browse button to select the report to be associated with the alarm.

8. Click the Finish button.

   SNMP traps are defined as alarm action, and the selected report is associated.

For details on defining alarms, see 6. Monitoring Operations with Alarms.

To Page Top