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

Tip: 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 10‒16: Process flow for adding PFM - Agent or PFM - RM to a Performance Management system in a logical host environment

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

To Page Top

(2) Performing an additional setup for 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.2.2(3)(a) 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 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‒17: Additional PFM - Agent or PFM - RM information setup in PFM - Manager

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.

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

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 means the procedure used on the standby node.

Copying the setup files

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 JP1/Performance Management Planning and Configuration Guide.
Stopping services on the standby node

Stop all physical host services on the standby node.
Executing the setup command

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
```
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 on commands in the manual JP1/Performance Management Reference.
Making sure the shared disk is online

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.
Stopping services

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.
Executing setup commands

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
```
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.
Starting services

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

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

To Page Top

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

If the conditions for registering agent information that are described in 10.2.3(3)(a) 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.2.3(3)(a) Registering agent information in PFM - Web Console and 10.2.3(3)(j) Performing an additional setup for PFM - Agent or PFM - RM information.

To Page Top

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

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

To Page Top