Job Management Partner 1/Performance Management Planning and Configuration Guide

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

6.1.4 PFM - Manager setup procedure

This subsection describes how to set up PFM - Manager installed on the 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) Setting the LANG environment variables
(2) Registering PFM - Agent or PFM - RM
(3) Specifying settings for the network
(4) Changing the log file size
(5) Specifying settings for the authentication mode
(6) Changing the storage locations of event data
(7) Specifying settings for action log output
(8) Configuring the health check function
(9) Configuring the PFM service automatic restart function
(10) Configuring the product name display function

(1) Setting the LANG environment variables

The following table lists the possible values that can be set to the LANG environment variables in Performance Management:

Before setting the LANG environment variables, verify that the language environment to set is properly installed and configured. If the language is not installed and configured properly, text might be garbled and definition data might be overwritten erroneously.

Note:
The LANG environment variables set at the time of service startup or command execution determines the language of the common message log. Therefore, the log might contain a mixture of text with different language codes.

Table 6-3 LANG environment variables available in Performance Management

OS Language LANG environment variable value
Linux English C
Solaris# English C
AIX English C

#
If you link with Network Node Manager (NNM), you can only use the following LANG environment variables in the setup script.

Table 6-4 LANG environment variables available in the setup script when linking with NNM

OS Language LANG environment variable value
Solaris English C

(2) 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 a 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 timing:

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 6-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 the commands, see the chapters that describe commands in the 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 gives the locations where files are stored, and the location where files are to be copied.

    Table 6-5 Setup files to be copied

    Copy from Copy to
    Host File Host File
    PFM - Agent, PFM - RM
    • In Windows:
      installation-folder\setup\jpcxxxxu.Z
    • In UNIX:
      /opt/jp1pc/setup/jpcxxxxu.Z
    		 PFM - Manager /opt/jp1pc/setup

    Legend:
    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

xxxx indicates the service key of each PFM - Agent or PFM - RM.

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.

(3) 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:

(4) 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 6.4.1 Setting the size of the log file for the common message log.

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

(6) 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 /opt/jp1pc as environment-directory\jp1pc.

For details on changing the settings, see 6.4.2 Changing the storage location of event data.

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

This setting is required when you wish to output action log data when an alarm is issued. Action log data is output in cooperation 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.

(8) Configuring the health check function [Figure]

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

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

(10) 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 version 08-11 or earlier, or when you perform a new installation. For details on this function, see 4.1.2 Displaying and specifying services. For details specifying this setting, see 6.4.8 Configuring the product name display function.

[Contents][Back][Next]

[Trademarks]

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