Job Management Partner 1/Performance Management User's Guide

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

9.3.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 a kind of information 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 if 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 a case, first make sure that all services have been 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-16 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) Performing an additional setup for PFM - Agent or PFM - RM information in PFM - Manager
(3) Performing an additional setup for PFM - Agent or PFM - RM in PFM - Web Console
(4) Checking PFM - Agent or PFM - RM that was 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 the installation procedure, see the chapter describing installation and setup (in Windows) in the Job Management Partner 1/Performance Management Planning and Configuration Guide.

(2) Performing an additional setup for PFM - Agent or PFM - RM information in PFM - Manager

The process flow for performing an additional setup for 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 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-17 Process flow for performing an additional setup for PFM - Agent or PFM - RM information in PFM - Manager

[Figure]

Notes:
  • If you add PFM - Agent or PFM - RM to the same host as PFM - Manager and PFM - Web Console, 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 performing an additional setup for PFM - Agent or PFM - RM agent information is explained below.

To add and set up the PFM - Agent information in PFM - Manager:

The image [Figure] means the procedure used on the executing node, and the image [Figure] means the 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 Windows) 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 to add and set up the new agent.
    Execute the command as follows: 
     
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.

  3. Making sure the shared disk is online [Figure]
    Make sure that the shared disk is online on the execution node. With the additional setup procedure, write the agent information to the shared disk. Use either operations from the cluster software or the volume manager to check if the shared disk is online.

  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 node 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) Performing an additional setup for PFM - Agent or PFM - RM in PFM - Web Console

Perform an additional setup for PFM - Agent or PFM - RM information in instances of PFM - Web Console 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 that was added and set up

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

To check the added PFM - Agent:

  1. Start the services on the PFM - Agent or PFM - RM nodes.
    Start the Performance Management programs and services on 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.