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.
The procedure is as follows:
- Organization of this subsection
(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
(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.
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.
- 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 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 Job Management Partner 1/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 Job Management Partner 1/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 Job Management Partner 1/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.
(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 10.2.3(3)(a) Registering agent information in PFM - Web Console.
(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 Job Management Partner 1/Performance Management Reference.