Job Management Partner 1/Performance Management Planning and Configuration Guide

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

5.1.4 PFM - Manager setup procedure

This subsection describes how to set up PFM - Manager installed on monitoring managers.

[Figure] indicates setup items required according to each environment and optional setup items used to change default settings.

Organization of this subsection
(1) Registering PFM - Agent or PFM - RM
(2) Specifying settings for the network
(3) Changing the log file size
(4) Specifying settings for the authentication mode
(5) Changing the storage locations of event data
(6) Specifying settings for action log output
(7) Configuring the health check function
(8) Configuring the PFM service automatic restart function
(9) Configuring the product name display function

(1) Registering PFM - Agent or PFM - RM[Figure]

You must register PFM - Agent or PFM - RM in PFM - Manager in order to perform integrated management of PFM - Agent or PFM - RM by using PFM - Manager and PFM - Web Console.

If the version of PFM - Manager is 09-00 or later, the registration is performed automatically, making the instructions described here unnecessary.

However, for PFM - Agent or PFM - RM released after PFM - Manager, you might need to perform manual registration. For details, see the PFM - Manager Release Notes.

Reference note
The information on the automatically registered PFM - Agent or PFM - RM is displayed in PFM - Web Console at the following time:

If the version of PFM - Web Console is 09-00 or later:
The information is displayed when you log into PFM - Web Console again after starting the registered PFM - Agent or PFM - RM.

If the version of PFM - Web Console is 08-11 or earlier:
The information is displayed when you restart PFM - Web Console after starting the registered PFM - Agent or PFM - RM.
If you want to register PFM - Agent or PFM - RM before starting the console, execute the jpcconf agent setup command with the -register option specified. For details on the jpcconf agent setup command, see the chapters that describe commands in the manual Job Management Partner 1/Performance Management Reference.

The following figure shows the process flow for PFM - Agent or PFM - RM registration.

Figure 5-3 Process flow for PFM - Agent or PFM - RM registration

[Figure]

Note
  • Register PFM - Agent or PFM - RM before setting the instance environment of PFM - Agent or PFM - RM.
  • You do not need to register PFM - Agent or PFM - RM when you add the same version of PFM - Agent or PFM - RM with the same product ID to a Performance Management system in which the PFM - Agent or PFM - RM information has been already registered.
  • 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.
  • If you install PFM - Agent or PFM - RM on the same host that has PFM - Manager installed, the jpcconf agent setup command is executed automatically. In PFM - Agent or PFM - RM, the execution results are logged as KAVE05908-I New agent setup (pfm-agent-service-key) ended successfully. (version=version) to the common message log. Check the results. If the command has not been executed correctly, execute the command again. For details on how to execute commands, see the chapters that describe commands in the manual Job Management Partner 1/Performance Management Reference.

(a) Copying the PFM - Agent or PFM - RM setup file

Copy the setup file on a host that has PFM - Agent or PFM - RM onto a host that has PFM - Manager installed.

To copy the PFM - Agent setup file:

  1. Copy the setup file of PFM - Agent or PFM - RM in binary mode.
    The following table shows the locations where files are stored and the location where files are to be copied.

    Table 5-3 Setup files to be copied

    Copy from Copy to
    Host File Host File
    PFM - Agent, PFM - RM
    • In Windows
      installation-folder\setup\jpcxxxxw.EXE#
    • In UNIX
      /opt/jp1pc/setup/jpcxxxxw.EXE#
    		 PFM - Manager installation-folder\setup

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

(b) Executing the setup command on the PFM - Manager host

Execute the following command on the PFM - Manager host to set up PFM - Agent or PFM - RM.

 
jpcconf agent setup -key

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

Note:
An error might occur if you execute the jpcconf agent setup command when Performance Management programs and services have not completely stopped on the local host where you want to execute the command. In such cases, make sure that the Performance Management programs and services have completely stopped and then execute the jpcconf agent setup command again.

You can delete the setup file of PFM - Agent or PFM - RM after this procedure has finished.

(2) Specifying settings for the network [Figure]

Settings described in this subsection are only required if you change settings according to the network configuration on which Performance Management is used.

You can set the following two items for network settings:

(3) Changing the log file size [Figure]

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

For details, see 5.4.1 Setting the size of the log file for the common message log.

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

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

For details, see the chapter that describes management of user accounts in the Job Management Partner 1/Performance Management User's Guide.

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

The settings below are required when you wish 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:

Note:
For the default folders when running Performance Management on a logical host, read installation-folder as environment-directory\jp1pc.

For details, see 5.4.2 Changing the storage locations of event data.

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

This setting is required when you wish 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, see G. Outputting Action Log Data.

(7) Configuring the health check function [Figure]

This setting is required when you wish to check the operating status of monitoring agents and their hosts. For details on setting procedure, see the chapter that describes detecting problems in Performance Management in the Job Management Partner 1/Performance Management User's Guide.

(8) Configuring the PFM service automatic restart function[Figure]

This setting is required if you want PFM services to automatically restart if they terminate abnormally. For details on specifying this setting, see the chapter that describes detecting problems in Performance Management in the Job Management Partner 1/Performance Management User's Guide.

(9) Configuring the product name display function[Figure]

This setting is required if you want to enable the product name display function when you upgrade from a version earlier than 08-11, or when you perform a new installation. For details on this function, see 4.1.2 Displaying and specifying services. For details on setting procedure, see 5.4.9 Configuring the product name display function.

[Contents][Back][Next]

[Trademarks]

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