Job Management Partner 1/Performance Management User's Guide

[Contents][Glossary][Index][Back][Next]

9.5.1 Adding PFM - Agent or PFM - RM

PFM - Agent or PFM - RM might be added in order to monitor the performance of servers or applications that are newly added to a system.

When you add PFM - Agent or PFM - RM with a new product ID that has not previously been used in the Performance Management system, you need to set up the agent information in PFM - Manager and PFM - Web Console.

For details on product IDs, see the appropriate PFM - Agent or PFM - RM manual.

Point:
Agent information is used by PFM - Manager and PFM - Web Console to manage and display PFM - Agent or PFM - RM.

Notes:
  • Stop PFM - Manager and all Performance Management programs and services on that node before adding PFM - Agent or PFM - RM. For details on how to stop services, see 1. Starting and Stopping Performance Management.
  • It is also necessary to stop PFM - Manager used on a logical host while work is being performed. An error might occur if you execute the jpcconf agent setup command or the jpcwagtsetup command to add PFM - Agent or PFM - RM before the Performance Management programs and services are completely stopped. In such cases, first make sure that all services have completely stopped, and then re-execute the jpcconf agent setup command or the jpcwagtsetup command.

The following figure shows the process flow for adding PFM - Agent or PFM - RM to a Performance Management system in a logical host environment.

Figure 9-26 Process flow for adding PFM - Agent or PFM - RM to a Performance Management system in a logical host environment

[Figure]

The procedure is as follows:

Organization of this subsection
(1) Installing PFM - Base and either PFM - Agent or PFM - RM
(2) Adding and setting up the PFM - Agent or PFM - RM information in PFM - Manager
(3) Adding and setting up PFM - Agent or PFM - RM in PFM - Web Console
(4) Checking PFM - Agent or PFM - RM added and set up

(1) Installing PFM - Base and either PFM - Agent or PFM - RM

Perform a new installation of PFM - Base and either PFM - Agent or PFM - RM on the host where Performance Management will be used to monitor performances.

For details on how to install, see the chapter describing installation and setup (in UNIX) in the Job Management Partner 1/Performance Management Planning and Configuration Guide.

(2) Adding and setting up the PFM - Agent or PFM - RM information in PFM - Manager

The process flow for adding and setting up the agent information of PFM - Agent or PFM - RM into PFM - Manager used on a logical host in a cluster system is described below.

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.

Perform the addition and setup of the agent information on the standby node first. When the addition and setup are completed on the standby node, next perform setup on the executing node.

Figure 9-27 Process flow for adding and setting up PFM - Agent or PFM - RM into PFM - Manager

[Figure]

Notes:
  • If you add another PFM - Agent or PFM - RM to the same host as PFM - Manager, an additional setup is not required.
  • If you install a different version of PFM - Agent or PFM - RM with the same product ID on a different host, first set up the older version of PFM - Agent or PFM - RM, and then set up the newer version of PFM - Agent or PFM - RM.

The procedure for adding and setting up agent information for PFM - Agent or PFM - RM is explained below.

The image [Figure] indicates a procedure used on the executing node, and the image [Figure] indicates a procedure used on the standby node.

  1. Copying the setup files [Figure] [Figure]
    Copy the PFM - Agent or PFM - RM setup files to the executing and standby nodes of PFM - Manager.
    For details, see the chapter describing installation and setup (in UNIX) in the Job Management Partner 1/Performance Management Planning and Configuration Guide.

  2. Executing the setup command [Figure]
    Execute the jpcconf agent setup command on the standby node, and then perform additional setup for the new agent.
    Execute the following command: 
     
jpcconf agent setup -key xxxx
    xxxx indicates the service key of each PFM - Agent or PFM - RM. For details on service keys, see the appropriate PFM - Agent or PFM - RM manual.
    For example, execute the following command to set up PFM - Agent for Oracle: 
     
jpcconf agent setup -key Oracle
    For details on the jpcconf agent setup command, see the chapter that describe commands in the manual Job Management Partner 1/Performance Management Reference.

  3. Making sure the shared disk is mounted [Figure]
    Make sure that the shared disk has been mounted on the executing node. Write the agent information to the shared disk with the additional setup procedure. Use the cluster software or the volume manager to check that the shared disk has been mounted.

  4. Stopping services [Figure]
    Stop the Performance Management programs and services on the executing node. Use the cluster software to stop the programs and services.

  5. Executing setup commands [Figure]
    Execute the jpcconf agent setup command on the executing node in the same manner as for the standby mode in order to add and set up the new agent.
     
jpcconf agent setup -key xxxx
    xxxx indicates the service key of each PFM - Agent or PFM - RM. For details on service keys, see the appropriate PFM - Agent or PFM - RM manual.
    For example, execute the following command to set up PFM - Agent for Oracle: 
     
jpcconf agent setup -key Oracle
    For details on the jpcconf agent setup command, see the chapters that describe commands in the manual Job Management Partner 1/Performance Management Reference.

  6. Starting services [Figure]
    Start the Performance Management programs and services that were stopped on the executing node.

(3) Adding and setting up PFM - Agent or PFM - RM in PFM - Web Console

Perform additional setup for PFM - Agent or PFM - RM information in PFM - Web Consoles that are used on a logical host in a cluster system.

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.

For details on the additional setup procedure, see 9.2.3(3)(a) Performing an additional setup for PFM - Agent or PFM - RM information .

(4) Checking PFM - Agent or PFM - RM added and set up

Check PFM - Agent or PFM - RM that was added and set up.

  1. Start the services in the nodes of PFM - Agent or PFM - RM.
    Start the Performance Management programs and services in the nodes of the newly added PFM - Agent or PFM - RM.

  2. Check if PFM - Agent or PFM - RM has been added correctly.
    Execute the jpctool service list command to check if PFM - Manager has been connected correctly.
    Execute the command as follows: 
     
jpctool service list -id "*"
    For details on the jpctool service list command, see the chapters that describe commands in the manual Job Management Partner 1/Performance Management Reference.

[Contents][Back][Next]

[Trademarks]

All Rights Reserved. Copyright (C) 2009, Hitachi, Ltd.