Hitachi

Job Management Partner 1 Version 10 Job Management Partner 1/Performance Management Planning and Configuration Guide

6.1.5 PFM - Web Console setup procedure

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

Tip

The initialization file (config.xml) is used to set up the operating environment for PFM - Web Console.

Organization of this subsection

(1) Setting the LANG environment variable

Before assigning a value to the LANG environment variable, make sure that the language environment you specify is installed and configured correctly. If the language is not installed and configured correctly, you might encounter issues such as characters appearing garbled or definition data being overwritten erroneously.

Note:

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

The following table shows LANG environment variables available in PFM - Web Console.

Table 6‒6: LANG environment variables available in PFM - Web Console

OS

Language

LANG environment variable

Linux

Japanese

UTF-8 encoding

  • ja_JP.UTF-8

  • ja_JP.utf8

English (no Japanese)

C

Chinese (Simplified Chinese)

GB18030

zh_CN.gb18030

UTF-8 encoding

  • zh_CN.utf8

  • zh_CN.UTF-8

If the language setting of the system locale of the server differs from that of the usrconf.cfg file, PFM - Web Console may not operate properly. Before setting up PFM - Web Console, check the system locale and the usrconf.cfg file, and if the language setting differs from each other, change the setting in the usrconf.cfg file.

Important note

Perform the settings after PFM - Web Console service is stopped.

(a) Changing the settings in the usrconf.cfg file

  1. Use a text editor or a similar tool to open the usrconf.cfg file.

    The usrconf.cfg file is stored in the following folder:

    /opt/jp1pcwebcon/CPSB/CC/web/containers/PFMWebConsole/usrconf/

  2. Edit the usrconf.cfg file.

    You need to modify the parameters if the language setting was changed as follows:

    • From Japanese to a language other than Japanese

    • From a language other than Japanese to Japanese

    • From English to Chinese

    • From Chinese to English

    For details about setting each parameter, see 6.1.5(1)(b) Parameters of the usrconf.cfg file.

  3. Save usrconf.cfg by overwriting the file.

(b) Parameters of the usrconf.cfg file

You need to modify the following parameters when changing the language setting.

Item

Description

add.jvm.arg=-Duser.language

The default language setting used for PFM - Web Console. Values are as follows:

  • en

  • ja

For Japanese, specify "ja". For others, specify "en".

add.jvm.arg=-Duser.country

The default country setting used for PFM - Web Console. Values are as follows:

  • US

  • JP

For Japan, specify "JP". For others, specify "US".

add.jvm.arg=-DprGB18030check

The setting to use GB18030 as the encoding format of PFM - Web Console. Values are as follows:

  • true

  • false

When using Chinese (Simplified Chinese) and performing encoding in the GB18030 format, specify "true". In other cases, specify "false".

To Page Top

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

You must register PFM - Agent or PFM - RM in PFM - Web Console 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 - Web Console is 09-00 or later, PFM - Agent or PFM - RM is automatically registered, following the instructions described here are unnecessary. However, for PFM - Agent or PFM - RM released after PFM - Web Console, you might need to perform manual registration. For details about whether you need to manually register PFM - Agent or PFM - RM, see the PFM -Web Console Release Notes.

Figure 6‒4: Process flow for registering PFM - Agent or PFM - RM

[Figure]
Notes:

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

  • Set up the latest version of PFM - Agent or PFM - RM if you install a different version of PFM - Agent or PFM - RM with the same product ID on a different host.

(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 - Web Console installed.

To copy the PFM - Agent setup file:

  1. Stop PFM - Web Console if it is running.

  2. Copy the setup file of PFM - Agent or PFM - RM in binary mode.

    The following table gives the locations where the files are stored, and the location where the files are to be copied.

    Table 6‒7: Setup files to be copied

    Copy from

    Copy to

    Host

    File

    Host

    File

    PFM - Agent, PFM - RM

    • In UNIX:

      /opt/jp1pc/setup/jpcxxxxu.Z

    PFM - Web Console

    /opt/jp1pcwebcon/setup/
    Legend:

    xxxx indicates the service key of each PFM - Agent or PFM - RM. For details about service keys, see the appropriate PFM - Agent or PFM - RM documentation.

(b) Executing the setup command on the PFM - Web Console host

Execute the following command on PFM - Web Console to set up PFM - Agent or PFM - RM.

jpcwagtsetup

You can delete the PFM - Agent or PFM - RM setup file on the PFM - Web Console host after this procedure has finished.

Note:

Even though PFM - Web Console is installed on the same host as PFM - Agent or PFM - RM, you must execute the jpcwagtsetup command.

To Page Top

(3) Specifying settings for the network [Figure]

The settings described in this subsection are required when adjusting the network configuration of PFM - Agent to match that used by Performance Management.

You can set the following item for network settings:

To Page Top

(4) Specifying settings in the initialization file (config.xml) [Figure]

The settings required for operating PFM - Web Console are defined in the initialization file (config.xml). The settings described in this subsection are required when you want to change the initial settings in the file.

The config.xml file contains settings related to the log files for PFM - Web Console and the amount of data that can be displayed in the console window. For details, see the section that describes the initialization file (config.xml) in the appendix of the manual Job Management Partner 1/Performance Management Reference.

To Page Top

(5) Creating an authentication key file for PFM - Web Console[Figure]

If you want to execute the PFM - Web Console commands, you must first execute the jpcmkkey command. For details about the jpcmkkey command, see the chapter describing the command in the manual Job Management Partner 1/Performance Management Reference.

To Page Top

(6) Setting the connection-target PFM - Manager for PFM - Web Console[Figure]

To set the connection-target PFM - Manager, edit the initialization file (config.xml).

For details, see the section that describes the initialization file (config.xml) in the appendix of the manual Job Management Partner 1/Performance Management Reference.

To Page Top

(7) Setting the starting user and group for PFM - Web Console[Figure]

By default, the PFM - Web Console services are started with nobody/root permissions. If you fail to start PFM - Web Console with this user and group, the message KAVJT0003-E is output.

In this case, change the User and Group settings in the /opt/jp1pcwebcon/CPSB/httpsd/conf/httpsd.conf file to a system user (other than root) and the group to which that user belongs, respectively. In the following example, the words in italics indicate the points to be changed: 

User nobody
Group root

To Page Top

Trademarks

All Rights Reserved. Copyright (C) 2013, 2014, Hitachi, Ltd.

(C)opyright 2000-2009, by Object Refinery Limited and Contributors.