Hitachi

JP1 Version 12 JP1/Performance Management User's Guide


10.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.

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.

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

    [Figure]

Organization of this subsection

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

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

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

(a) Process flow of additional PFM - Agent or PFM - RM information setup 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.

If the conditions for registering agent information that are described in 10.4.2(3)(b) Performing an additional setup for PFM - Agent or PFM - RM information apply, you have to register PFM - Agent or PFM - RM in PFM - Manager.

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 10‒27: Additional PFM - Agent or PFM - RM information setup in 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.

(b) Additional PFM - Agent or PFM - RM information setup procedure in PFM - Manager

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 JP1/Performance Management Planning and Configuration Guide.

  2. Stopping services on the standby node [Figure]

    Stop all physical host services on the standby node.

  3. 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

    In this example, the jpcconf agent setup command is executed in interactive mode. However, the command can also be executed in non-interactive mode. For details on the jpcconf agent setup command, see the chapter that describe commands in the manual JP1/Performance Management Reference.

  4. 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.

  5. Stopping services [Figure]

    Stop all Performance Management programs and services in the physical and logical host environments on the standby node. Use the cluster software to stop the programs and services.

  6. 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

    In this example, the jpcconf agent setup command is executed in interactive mode. However, the command can also be executed in non-interactive mode. For details on the jpcconf agent setup command, see the chapters that describe commands in the manual JP1/Performance Management Reference.

  7. Starting services [Figure]

    Start the Performance Management programs and services that were stopped on the executing node.

  8. Starting services on the standby node [Figure]

    On the standby node, start the Performance Management programs and services that you stopped earlier.

(3) Adding and setting up 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.

If the conditions for registering agent information that are described in 10.4.3(3)(b) Registering agent information in PFM - Web Console apply, you have to register PFM - Agent or PFM - RM in PFM - Web Console.

For details on the additional setup procedure, see 10.4.3(3)(b) Registering agent information in PFM - Web Console and 10.4.3(3)(k) Performing an additional setup for PFM - Agent or PFM - RM information.

(4) Checking PFM - Agent or PFM - RM 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 JP1/Performance Management Reference.