5.3.4 Setup procedure in a cluster system (for Windows)
This subsection describes the setup needed for running Performance Management in a cluster system.
To run Performance Management in a cluster system, you must set up both the executing node and the standby node. Set up the executing node first, and then set up the standby node.
![[Figure]](GRAPHICS/ZUI03001.GIF)
indicates an item that is to be executed at the executing node, and ![[Figure]](GRAPHICS/ZUI03002.GIF)
indicates an item that is to be executed at the standby node. ![[Figure]](GRAPHICS/ZUI02001.GIF)
indicates the following setup items:
-
Setup item that is required depending on the environment in use
-
Setup item for changing the default settings
- Important
-
Do not set JPC_HOSTNAME as an environment variable because it is used by Performance Management. If it is set as an environment variable by mistake, Performance Management will not function correctly.
- Organization of this subsection
(1) Registering PFM - RM for Platform
To achieve central management of PFM - RM for Platform in the Performance Management system, you must register PFM - RM for Platform into PFM - Manager and PFM - Web Console.
The conditions and procedure for registering PFM - RM for Platform are the same as when a cluster system is not used. For details about the conditions and procedure for registering PFM - RM for Platform, see 3.1.4(1) Registering PFM - RM for Platform.
(2) Placing the shared disk online
Make sure that the shared disk is online.
If the shared disk is not in online status, use a program such as the cluster software or a volume manager to place it online.
(3) Setting up a logical host environment for PFM - RM for Platform
Execute the jpcconf ha setup command to create a logical host environment.
This command creates a logical host environment by copying necessary data to the shared disk and setting definitions for a logical host.
- Note
-
Before you execute the command, stop all Performance Management programs and services in the entire Performance Management system. For details about how to stop services, see the chapter that describes startup and termination of Performance Management in the JP1/Performance Management User's Guide.
To set up a logical host environment for PFM - RM for Platform:
-
Execute the jpcconf ha setup command to create a logical host environment for PFM - RM for Platform.
Execute the following command:
jpcconf ha setup -key RMPlatform -lhost jp1-halrmp -d S:\jp1
Use the -lhost option to specify the logical host name. This example specifies jp1-halrmp as the logical host name. If you employ DNS operations, specify the logical host name without the domain name.
Specify in the -d option a folder name on the shared disk within the environment folder. For example, if -d S:\jp1 is specified, S:\jp1\jp1pc is created, and then files for the logical host environment are created.
-
Execute the jpcconf ha list command to check the logical host settings.
Execute the following command:
jpcconf ha list -key all
Make sure that the created logical host environment is correct.
(4) Setting the connection-target PFM - Manager
Execute the jpcconf mgrhost define command to set the PFM - Manager that manages PFM - RM for Platform.
To set the connection-target PFM - Manager:
-
Execute the jpcconf mgrhost define command to set the connection-target PFM - Manager.
Execute the following command:
jpcconf mgrhost define -host jp1-hal -lhost jp1-halrmp
Specify in the -host option the host name of the connection-target PFM - Manager. If the connection-target PFM - Manager is to run on a logical host, specify in the -host option the logical host name of the connection-target PFM - Manager. This example specifies jp1-hal as the PFM - Manager's logical host name.
Use the -lhost option to specify the logical host name of PFM - RM for Platform. This example specifies jp1-halrmp as the logical host name of PFM - RM for Platform.
The example above shows execution in the interactive mode, but you can also execute the jpcconf mgrhost define command in the non-interactive mode. For details about this command, see the chapter that describes commands in the manual JP1/Performance Management Reference.
(5) Setting up an instance environment
Execute the jpcconf inst setup command to set up an instance environment for PFM - RM for Platform.
The setup procedure is the same as when a cluster system is not employed. However, in the case of a cluster system, you must specify the logical host name in the -lhost option when you execute the jpcconf inst setup command.
The following shows how to specify the jpcconf inst setup command for a cluster system:
jpcconf inst setup -key RMPlatform -lhost logical-host-name -inst instance-name
The example above shows execution in the interactive mode, but you can also execute the jpcconf inst setup command in the non-interactive mode. For details about this command, see the chapter that describes commands in the manual JP1/Performance Management Reference.
For details about the settings and procedure, see 3.1.4(2) Setting up an instance environment.
(6) Setting the monitoring target
Execute the jpcconf target setup command to set information about the monitored host for PFM - RM for Platform.
The setting procedure is the same as when a cluster system is not employed.
However, in the case of a cluster system, you must specify the logical host name in the -lhost option when you execute the jpcconf target setup command.
The following shows how to specify the jpcconf target setup command for a cluster system:
jpcconf target setup -key RMPlatform -lhost logical-host-name -inst instance-name -target monitoring-target-name
This example shows execution in the interactive mode, but you can also execute the jpcconf target setup command in the non-interactive mode. For details about this command, see the chapter that describes commands in the manual JP1/Performance Management Reference.
For details about the settings and procedure, see 3.1.4(3) Setting the monitored host.
(7) Setting up the logical host for other Performance Management programs
If you have other PFM - Manager, PFM - Agent, or PFM - RM programs to be set up on the same logical host in addition to PFM - RM for Platform, set them up at this stage.
For details about the setup procedure, see the chapter that describes the configuration and operation of cluster systems in the JP1/Performance Management User's Guide.
(8) Setting up a network
You specify network settings if you need to change the network environment settings as appropriate to the network configuration where Performance Management is used.
The two network environment settings are described below. Change these settings if necessary.
-
Setting IP addresses
Set this information to use Performance Management in a network that is connected to multiple LANs. To specify an IP address to be used, directly edit the contents of the jpchosts file.
Copy the edited jpchosts file from the executing node to the standby node under physical-host-installation-folder\jp1pc\.
For details about how to set IP addresses, see the chapter that describes installation and setup in the JP1/Performance Management Planning and Configuration Guide.
-
Setting port numbers
If you establish communication between Performance Management programs via a firewall, use the jpcconf port define command to set the port numbers.
For details about how to set port numbers, see the chapter that describes installation and setup in the JP1/Performance Management Planning and Configuration Guide and the chapter that describes configuration and operation of cluster systems in the JP1/Performance Management User's Guide.
(9) Changing the log file size
The operation status of Performance Management is output to a log file unique to Performance Management. This log file is called the common message log. This setting is required only when you wish to change this file size.
For details, see the chapter that describes installation and setup in the JP1/Performance Management Planning and Configuration Guide.
(10) Changing the performance data storage locations
This setting is used to change the storage locations, backup folder, export folder, or import folder for the performance data that is managed by PFM - RM for Platform.
For details about the setting method, see 3.6.1 Changing performance data storage locations.
(11) Action log output setting
This setting is required in order to output action logs in the event of an alarm.
An action log consists of log information about exceeded threshold values caused by factors such as system loading; its output is linked with the alarm function. For details about the setting method, see J. Outputting Action Log Data.
(12) Exporting the logical host environment definition file
After you have created a logical host environment for PFM - RM for Platform, export the environment definition to a file.
This export process involves output of the definition information for the Performance Management program that has been set up on the logical host to a file in the batch mode. If you are setting up other Performance Management programs on the same logical host, export the environment definition after all the setup processes are completed.
To export the logical host environment definition:
-
Execute the jpcconf ha export command to export the logical host environment definition.
Output the definition information for the logical host environment that has been created so far to an export file. You can assign any name to the export file.
For example, to export the logical host environment definition to the lhostexp.txt file, execute the following command:
jpcconf ha export -f lhostexp.txt
This example shows execution in the interactive mode, but you can also execute the jpcconf ha export command in the non-interactive mode. For details about this command, see the chapter that describes commands in the manual JP1/Performance Management Reference.
(13) Copying the logical host environment definition file to the standby node
Copy from the executing node to the standby node the logical host environment definition file exported in (12) Exporting the logical host environment definition file.
(14) Placing the shared disk offline
Use a program such as the cluster software or a volume manager to place the shared disk offline and finish the procedure.
If you will be using the shared disk after you complete this procedure, there is no need to place it offline.
(15) Importing the logical host environment definition file
Import to the standby node the export file that was copied from the executing node.
Use the jpcconf ha import command to specify settings for executing at the standby node the Performance Management program on the logical host that was created at the executing node. If multiple Performance Management programs have been set up on the same logical host, the settings for all the programs are imported in the batch mode.
When you execute this command, there is no need to keep the shared disk in online status.
To import the logical host environment definition file:
-
Execute the jpcconf ha import command to import the logical host environment definition.
Execute the following command:
jpcconf ha import -f lhostexp.txt
This example shows execution in the interactive mode, but you can also execute the jpcconf ha import command in the non-interactive mode. For details about this command, see the chapter that describes commands in the manual JP1/Performance Management Reference.
This command changes settings in such a manner that the environment for the standby node becomes the same as for the export file. As a result, the setup for starting PFM - RM for Platform on the logical host is performed.
If a fixed port number has been set by the jpcconf port define command during the setup, it is also set in the same manner.
-
Execute the jpcconf ha list command to check the logical host settings.
Execute the following command:
jpcconf ha list -key all
Make sure that the displayed information is the same as when the jpcconf ha list command is executed at the executing node.
(16) Registering PFM - RM for Platform into the cluster software
To run a Performance Management program in a logical host environment, you must register the program into the cluster software and set up the environment in such a manner that the Performance Management program is started and terminated from the cluster software.
For details about how to register PFM - RM for Platform into the cluster software, see the cluster software documentation.
This subsection describes the settings for registering PFM - RM for Platform into the cluster software using an example of items that are registered into Windows WSFC.
For PFM - RM for Platform, register the services shown in the table below into the cluster software.
For dependency settings when PFM - RM for Platform coexists with PFM - Manager's logical host, see the chapter that describes planning and operation in the JP1/Performance Management User's Guide.
|
No. |
Name |
Service name |
Resource dependencies |
|---|---|---|---|
|
1 |
PFM - RM Store for Platform instance-name [LHOST] |
JP1PCAGT_7S_instance-name [LHOST] |
|
|
2 |
PFM - RM for Platform instance-name [LHOST] |
JP1PCAGT_7A_instance-name [LHOST] |
|
|
3 |
PFM - Action Handler [LHOST] |
JP1PCMGR_PH [LHOST] |
|
Replace [LHOST] with the logical host name. If the instance name is SDC1 and the logical host name is jp1-halrmp, then the name of the service is PFM - RM Store for Platform SDC1 [jp1-halrmp], and the service name is JP1PCAGT_7S_SDC1 [jp1-halrmp].
In the case of WSFC, register these services as WSFC resources. Set each resource as follows:
-
In Resource type, register as Generic Service.
-
Set Resource Dependencies as shown in Table 5-2 PFM - RM for Platform services to be registered into the cluster software.
-
Do not set Startup parameters or Registry Replication.
-
In the Policies tab in the properties window, specify the settings according to whether you want a failover to occur in the event of a Performance Management program failure.
-
For example, if you want a failover to occur in the event of a PFM - RM for Platform failure, specify the following settings:
-
Select the If resource fails, attempt restart on current node radio button.
-
Select the If restart is unsuccessful, fail over all resources in this service or application check box#.
-
As a guide, specify 3 for Maximum restarts in the specified period.
- #
-
In Windows Server 2012 or later, this check box is If restart is unsuccessful, fail over all resources in this Role.
-
- Note
-
A service registered in the cluster is started and stopped from the cluster. Therefore, set Startup type to Manual so that the service will not be started automatically during OS startup. Immediately after the setup is performed by the jpcconf ha setup command, the service is set to Manual.
Make sure that you do not use the following command to forcibly stop services:
jpcspm stop -key all -lhost logical-host-name -kill immediate
(17) Checking start and stop from the cluster software
Make sure that the Performance Management programs function normally by starting and terminating the programs from the cluster software at each node.
(18) Setting up an environment in the cluster system
After you have finished setting up the Performance Management programs, set up an environment for them so that PFM - Web Console can be used to display the monitoring target's operation status as a report according to the operating procedures and can send notifications to the user in the event of problems at the monitoring target.
For details about how to set up an environment for the Performance Management programs, see the chapter that describes the configuration and operation of cluster systems in the JP1/Performance Management User's Guide.