Job Management Partner 1/Performance Management User's Guide

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


9.2.2 Installing and setting up PFM - Manager

This subsection describes the methods for installing and setting up PFM - Manager in a cluster system.

Organization of this subsection
(1) Process flow for installation and setup
(2) Installation procedure
(3) Setup procedure
(4) Cluster software setting procedure

(1) Process flow for installation and setup

The following figure shows the process flow for installation and setup of PFM - Manager used on a logical host.

Figure 9-10 Process flow for installation and setup of PFM - Manager used on a logical host (in Windows)

[Figure]

Notes:
  • When PFM - Manager in a logical host environment is set up, PFM - Manager on the physical host environment can no longer be executed. However, the Action Handler service can still be executed, because it uses PFM - Agent or PFM - RM in the physical host environment.
    When unsetup is performed on PFM - Manager in a logical host environment, PFM - Manager in the physical host environment can once again be executed.
  • When PFM - Manager is set up in a logical host environment, the logical host environment inherits the PFM - Manager definitions from the physical host environment. However, the content of the Store database is not inherited. If unsetup is performed on PFM - Manager in the logical host environment, the definitions for the logical host environment and the Store database are deleted, and therefore switching to the physical host environment is not possible.
  • Do not manually set JPC_HOSTNAME as an environment variable, because JPC_HOSTNAME is used by Performance Management as an environment variable. If you specify this setting, Performance Management will not run correctly.
  • For PFM - Manager version 09-00 or later, when you set up a new instance of PFM - Manager in a logical host environment, the settings of the health check function in the physical host environment are inherited by the logical host environment. If necessary, you must modify the settings of the health check function.
  • In a logical host environment, the function for setting monitoring-host names cannot be used. The jpccomm.ini file on a logical host is ignored, and the host name for the logical host is used.

The installation and setup procedures for PFM - Manager and the setting procedures for the cluster software are explained below.

In the procedure explanation, the image [Figure] indicates items to be performed on the executing node, and the image [Figure] indicates items to be performed on the standby node. In addition, the image [Figure] indicates setup items that are either required depending on the environment or can be performed if you want to set a value other than the default settings.

(2) Installation procedure [Figure] [Figure]

Perform a new installation of PFM - Manager on the executing node and the standby node. The installation procedure is the same as for a non-cluster system. For details, see the chapter describing installation and setup (in Windows) in the Job Management Partner 1/Performance Management Planning and Configuration Guide.

Note:
The installation destination is the local disk. Do not install PFM - Manager on the shared disk.

(3) Setup procedure

Perform PFM - Manager setup on the executing node first. Next, export the logical host environment definitions for the executing node to a file. Finally, import the file containing the environment definitions to the standby node to apply the setup content from the executing node to the standby node.

Figure 9-11 Method for applying the content set up on the executing node to the standby node

[Figure]

Each setup procedure is explained below.

(a) Performing an additional setup for PFM - Agent or PFM - RM information[Figure] [Figure] [Figure]

To perform integrated management of PFM - Agent or PFM - RM in a cluster system, register the agent information of PFM - Agent or PFM - RM in PFM - Manager for the executing node and the standby node.

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.

The setup procedure is the same as for a non-cluster system. For details, see the chapter describing installation and setup (in Windows) in the Job Management Partner 1/Performance Management Planning and Configuration Guide.

Note:
If you add another PFM - Agent or PFM - RM to the same host as PFM - Manager, an additional setup is not required.

(b) Making sure the shared disk is online [Figure]

Make sure that the shared disk is online on the executing node. If the shared disk is not online, place it online by using the cluster software and the volume manager.

(c) Setting up a logical host for PFM - Manager [Figure]

Set up the logical host environment for PFM - Manager on the executing node. Before performing setup, stop all the Performance Management programs and services throughout the entire system.

To set up a logical host:

  1. Create a logical host environment.
    Execute the jpcconf ha setup command to create a logical host environment for PFM - Manager.
    Use -lhost to specify the logical host name. For DNS operations, specify a logical host name that does not include a domain name. Specify the -d environment directory name for the directory name of the shared disk.
    For example, execute the following command to set up a logical host with jp1-ha1 as the logical host name and S:\jp1 as the environment directory.
     
    jpcconf ha setup -key Manager -lhost jp1-ha1 -d S:\jp1
     
    When this command is executed, the jp1pc directory is created under S:\jp1, and the files required in the logical environment are copied to the environment directory. The following figure shows an example.

    Figure 9-12 Execution example of the jpcconf ha setup command

    [Figure]

    When the command is executed, the required data is copied from the local disk of the executing node to the shared disk, and the settings required for use on the logical host are performed.
    For details on the jpcconf ha setup command, see the chapters that describes commands in the manual Job Management Partner 1/Performance Management Reference.
  2. Check the settings for the logical host environment.
    Execute the jpcconf ha list command to check the settings for the logical host, and make sure that the logical host environment that has been created is correct.
     
    jpcconf ha list -key all
     
    An example of executing this command is as follows:

    [Figure]

    For details on the jpcconf ha list command, see the chapters that describes commands in the manual Job Management Partner 1/Performance Management Reference.

(d) Performing a setup for a logical host of PFM - Agent or PFM - RM[Figure] [Figure]

This procedure is required only when PFM - Agent or PFM - RM needs to be set up on the same logical host as PFM - Manager.

For details on the setup procedure, see the chapters that describe operations on cluster systems in the appropriate PFM - Agent or PFM - RM manual.

(e) Specifying network settings [Figure]

To use the logical host names for communications between PFM - Manager and PFM - Web Console, add the following line to the environment-directory\jp1pc\mgr\viewsvr\jpcvsvr.ini file.

 
java.rmi.server.hostname=logical-host-name
 

For details on host names used for communications between PFM - Manager and PFM - Web Console, see the sections that describe port numbers in an appendix of the manual Job Management Partner 1/Performance Management Reference.

In addition, use the following procedure when changing IP addresses and port numbers according to the network configuration:

(f) Changing the log file size [Figure]

The operating status of Performance Management is output to a dedicated log file called the common message log. By default, the common message log uses two 2,048-KB files. This setting is required only if you want to change this file size.

For details, see the chapter describing installation and setup (in Windows) in the Job Management Partner 1/Performance Management Planning and Configuration Guide.

(g) Specifying settings for the authentication mode [Figure]

This setting is required only if you want to change the authentication mode of Performance Management from PFM authentication mode to JP1 authentication mode.

For details, see 2. Managing User Accounts.

(h) Changing the storage locations of event data [Figure]

The settings below are required if you want to change the storage destination, backup destination, or export destination of the event data managed by PFM - Manager.

By default, event data is stored in the following locations:

For details on how to change a destination, see the chapter describing installation and setup (in Windows) in the Job Management Partner 1/Performance Management Planning and Configuration Guide.

(i) Specifying settings for action log output [Figure]

This setting is required if you want to output an action log when an alarm is issued. An action log is log information output in conjunction with the alarm function, when an aspect of the system (such as the system load) exceeds a threshold. For details on how to set this option, see the section describing action log output in an appendix of the Job Management Partner 1/Performance Management Planning and Configuration Guide.

(j) Configuring the health check function [Figure] [Figure]

To configure the health check function:

  1. Check the settings of the health check function.
    Execute the following command on the PFM - Manager host on the executing node to display the setting of the health check function.
     
    jpcconf hc display
     
    When the command is executed, the setting for the health check function appears as follows:
    • If the health check function is enabled: available
    • If the health check function is disabled: unavailable
    For details on the jpcconf hc display command, see the chapters that describe commands in the manual Job Management Partner 1/Performance Management Reference.
  2. Change the setting of the health check function.
    Execute the following command on the PFM - Manager host on the executing node to set up the health check function, if necessary.
    • To enable the health check function: jpcconf hc enable
    • To disable the health check function: jpcconf hc disable
    For details on the jpcconf hc enable and jpcconf hc disable commands, see the chapter explaining the commands in the manual Job Management Partner 1/Performance Management Reference.

(k) Exporting the logical host environment definitions [Figure]

When a logical host environment for PFM - Manager is created on the executing node, apply the settings information for the executing node to the standby node. First, export the logical host environment definitions for the executing node to a file. To set up a different instance of Performance Management on the same logical host, perform an export after all setup procedures are completed.

To export the environment definitions:

  1. Execute the jpcconf ha export command.
    Export the logical host environment definitions to the desired file.
    For example, execute the following command to export the logical host environment definitions to the lhostexp.conf file.
     
    jpcconf ha export -f lhostexp.conf
     
    If the health check function is enabled for the PFM - Manager in the logical host environment you are exporting, the health check agent will be set up on the logical host. In this case, information relating to the health check agent will be exported.
    For details on the jpcconf ha export command, see the chapters that describe commands in the manual Job Management Partner 1/Performance Management Reference.

(l) Copying the file containing the logical host environment definitions to the standby node [Figure] [Figure]

Copy the file that has been exported in step (f) from the executing node to the standby node, so that it will be applied on the standby node.

Next, use operations of the cluster software or volume manager software to place the shared disk online, and finish the operations on the executing node. If this shared disk will continue to be used, it is not necessary to take it offline.

(m) Importing the file containing the logical host environment definitions [Figure]

Import the exported file copied from the executing node to the standby node.

To import the exported file containing the logical host environment definitions:

  1. Execute the jpcconf ha import command.
    Import the logical host environment definitions to the standby node.
    For example, execute the following command if the export file name is lhostexp.conf.
     
    jpcconf ha import -f lhostexp.conf
     
    When the jpcconf ha import command is executed, the environment settings for the standby node are changed to the same environment as for the executing node. Therefore, the necessary settings are made to use PFM - Manager on a logical host.
    If the health check function is enabled for the PFM - Manager in the logical host environment you are importing, the health check agent will be set up on the logical host. In this case, information relating to the health check agent will be imported.
    For details on the jpcconf ha import command, see the chapters that describe commands in the manual Job Management Partner 1/Performance Management Reference.
  2. Check the settings for the logical host environment.
    Execute the jpcconf ha list command in the same manner as for the executing node, to check the settings of the logical host.
    Execute the command as follows:
     
    jpcconf ha list -key all
     
    For details on the jpcconf ha list command, see the chapters that describe commands in the manual Job Management Partner 1/Performance Management Reference.

(4) Cluster software setting procedure

Cluster software settings are required for both the executing node and the standby node.

The procedure is as follows:

(a) Registering PFM - Manager in the cluster software [Figure] [Figure]

To use PFM - Manager on a logical host, register it in the cluster software, and set the cluster software to control the starting and stopping of PFM - Manager.

For details on how to register PFM - Agents or PFM - RM in the cluster software, see the chapters that describe operations in cluster systems in the appropriate PFM - Agent or PFM - RM manual.

The setting contents for registering PFM - Manager in the cluster software are described below by using items for registration in Windows MSCS as examples. For PFM - Manager, register the services listed in the following table in the cluster.

Table 9-2 PFM - Manager services to be registered in the cluster software

No. Name Service name Dependencies
1 PFM - Name Server [LHOST] JP1PCMGR_PN [LHOST] IP address resources
Physical disk resources#
2 PFM - Name Server [LHOST] JP1PCMGR_PN [LHOST] #1 cluster resources
3 PFM - Master Store [LHOST] JP1PCMGR_PS [LHOST] #2 cluster resources
4 PFM - View Server [LHOST] JP1PCMGR_PP [LHOST] #5 cluster resources
5 PFM - Correlator [LHOST] JP1PCMGR_PE [LHOST] #3 cluster resources
6 PFM - Trap Generator [LHOST] JP1PCMGR_PC [LHOST] #5 cluster resources
7 PFM - Action Handler [LHOST] JP1PCMGR_PH [LHOST] #3 cluster resources
8 PFM - Agent Store for HealthCheck [LHOST] JP1PCAGT_0S [LHOST] #3 cluster resources
9 PFM - Agent for HealthCheck [LHOST] JP1PCAGT_0A [LHOST] #8 cluster resources

#: The shared disk drive that hosts the logical host environment directory created according to (c) in (3) above.


Place the logical host name wherever [LHOST] appears. The following is an example for a Name Server service for which the logical host name is jp1-ha1:

For MSCS, these services are registered as MSCS resources. The settings for each resource are as follows. The setting items for MSCS are indicated by [ ].

(b) Checking starting and stopping from the cluster software [Figure] [Figure]

Perform operations to start and stop PFM - Manager from the cluster software in each node, and make sure that the operations are normal.

[Contents][Back][Next]


[Trademarks]

All Rights Reserved. Copyright (C) 2009, Hitachi, Ltd.