Hitachi

JP1 Version 12 Performance Management: Getting Started


1.3.4 Setting up PFM - Web Console (Windows)

After you have finished installing PFM - Web Console, you might need to specify some port number settings again. You will also create user accounts and an authentication key file for PFM - Web Console.

Organization of this subsection

(1) Specifying the port number to be used by the Web Service in PFM - Web Console

If the default port number for the Web Service in PFM - Web Console is already in use, you must specify the port number again. This task is not needed if you use the default port number.

Procedure

  1. Change the port number in Performance Management's settings file (httpsd.conf file) on the host on which PFM - Web Console is installed.

    The httpsd.conf file is stored in the following folder.

    Windows:

    PFM-Web-Console-installation-folder\CPSB\httpsd\conf

    Linux:

    /opt/jp1pcwebcon/CPSB/httpsd/conf

    In the httpsd.conf file, change the value on the following line:

    LISTEN 20358
  2. Execute the jpcwstart command and verify that PFM - Web Console services have started.

    Command storage location:

    PFM-Web-Console-installation-folder\tools

    Example of command execution:

    jpcwstart

    If PFM - Web Console services have already been running, stop them and then start them again.

Postrequisites

If you want to change the port number that will be used by another PFM - Web Console service, set that port number. Otherwise, log in to Performance Management from the monitoring console.

Related topics

(2) Specifying the port number (AJP communication port) to be used by the Web Console service in PFM - Web Console

If the default port number (AJP communication port) for the Web Console service in PFM - Web Console is already in use, you must specify the port number again. This task is not needed if you use the default port number.

Procedure

  1. Change the port number in Performance Management's settings file (usrconf.properties file) on the host on which PFM - Web Console is installed.

    The usrconf.properties file is stored in the following folder.

    Windows:

    PFM-Web-Console-installation-folder\CPSB\CC\server\usrconf\ejb\PFMWebConsole

    Linux:

    /opt/jp1pcwebcon/CPSB/CC/server/usrconf/ejb/PFMWebConsole

    In the usrconf.properties file, change the value on the following line (value following the equal sign (=)):

    webserver.connector.ajp13.port=20359
  2. Change the port number in Performance Management's settings file (workers.properties file).

    The workers.properties file is stored in the following folder.

    Windows:

    PFM-Web-Console-installation-folder\CPSB\CC\web\redirector

    Linux:

    /opt/jp1pcwebcon/CPSB/CC/web/redirector

    In the workers.properties file, change the value on the following line (value following the equal sign (=)):

    worker.worker1.port=20359
  3. Execute the jpcwstart command and verify that PFM - Web Console services have started.

    Command storage location:

    PFM-Web-Console-installation-folder\tools

    Example of command execution:

    jpcwstart

    If PFM - Web Console services have already been running, stop them and then start them again.

Postrequisites

If you want to change the port number that will be used by another PFM - Web Console service, set that port number. Otherwise, log in to Performance Management from the monitoring console.

Related topics

(3) Specifying the port number (RMI registry port) to be used by the Web Console service in PFM - Web Console

If the default port number (RMI registry port) for the Web Console service in PFM - Web Console is already in use, you must specify the port number again. This task is not needed if you use the default port number.

Procedure

  1. Change the port number in Performance Management's settings file (usrconf.properties file#) on the host on which PFM - Web Console is installed.

    #

    You must edit the user properties file (usrconf.properties) and the system property file for server management commands (usrconf.properties).

    The usrconf.properties file is stored in the following folder.

    Windows:

    - The user properties file is stored in the following folder:

    PFM-Web-Console-installation-folder\CPSB\CC\server\usrconf\ejb\PFMWebConsole

    - The system property file for server management commands is stored in the following folder:

    PFM-Web-Console-installation-folder\CPSB\CC\admin\usrconf

    Linux:

    - The user properties file is stored in the following folder:

    /opt/jp1pcwebcon/CPSB/CC/server/usrconf/ejb/PFMWebConsole

    - The system property file for server management commands is stored in the following folder:

    /opt/jp1pcwebcon/CPSB/CC/admin/usrconf

    In the usrconf.properties file, change the value on the following line (value following the equal sign (=)):

    ejbserver.rmi.naming.port=20369
  2. Execute the jpcwstart command and verify that PFM - Web Console services have started.

    Command storage location:

    PFM-Web-Console-installation-folder\tools

    Example of command execution:

    jpcwstart

    If PFM - Web Console services have already been running, stop them and then start them again.

Postrequisites

If you want to change the port number that will be used by another PFM - Web Console service, set that port number. Otherwise, log in to Performance Management from the monitoring console.

Related topics

(4) Specifying the port number (management server port) to be used by the Web Console service in PFM - Web Console

If the default port number (management server port) for the Web Console service in PFM - Web Console is already in use, you must specify the port number again. This task is not needed if you use the default port number.

Procedure

  1. Change the port number in Performance Management's settings file (usrconf.properties file) on the host on which PFM - Web Console is installed.

    The usrconf.properties file is stored in the following folder.

    Windows:

    PFM-Web-Console-installation-folder\CPSB\CC\server\usrconf\ejb\PFMWebConsole

    Linux:

    /opt/jp1pcwebcon/CPSB/CC/server/usrconf/ejb/PFMWebConsole

    In the usrconf.properties file, change the value on the following line (value following the equal sign (=)):

    ejbserver.http.port=20368
  2. Execute the jpcwstart command and verify that PFM - Web Console services have started.

    Command storage location:

    PFM-Web-Console-installation-folder\tools

    Example of command execution:

    jpcwstart

    If PFM - Web Console services have already been running, stop them and then start them again.

Postrequisites

If you want to change the port number that will be used by another PFM - Web Console service, set that port number. Otherwise, log in to Performance Management from the monitoring console.

Related topics

(5) Specifying the port number (management command port) to be used by the Web Console service in PFM - Web Console

If you want to use a fixed port number (management command port) for the Web Console service in PFM - Web Console, you must specify the port number again. By default, the system automatically allocates an unused port number to the service. This task is not needed if you use the automatically-allocated port number.

Procedure

  1. Change the port number in Performance Management's settings file (usrconf.properties file) on the host on which PFM - Web Console is installed.

    The usrconf.properties file is stored in the following folder.

    Windows:

    PFM-Web-Console-installation-folder\CPSB\CC\server\usrconf\ejb\PFMWebConsole

    Linux:

    /opt/jp1pcwebcon/CPSB/CC/server/usrconf/ejb/PFMWebConsole

    Edit the usrconf.properties file to uncomment the following line (by deleting the hash mark (#) at the beginning of the line) and change the value, which follows the equal sign (=):

    #ejbserver.rmi.remote.listener.port=0

    If you specify a port number for the Web Console service, a value of 0, the system automatically allocates an unused port number to the service. If you specify a port number for the Web Console service, a value other than 0, that port number to the service is allocated.

  2. Execute the jpcwstart command and verify that PFM - Web Console services have started.

    Command storage location:

    PFM-Web-Console-installation-folder\tools

    Example of command execution:

    jpcwstart

    If PFM - Web Console services have already been running, stop them and then start them again.

Postrequisites

If you want to change the port number that will be used by another PFM - Web Console service, set that port number. Otherwise, log in to Performance Management from the monitoring console.

Related topics

(6) Logging in to Performance Management from the monitoring console

Log in to Performance Management by specifying its URL in the Web browser.

Procedure

  1. In the Web browser, specify the following URL:

    http://name-of-the-host-on-which-PFM-Web-Console-is-installed:port-number-of-Web-Service-service/PFMWebConsole/login.do

    The Login window is displayed. If the Login window is not displayed, PFM - Manager and PFM - Web Console might not be set up correctly. Check and correct their settings as necessary.

    Note

    20358 is the default the port number for the Web Service service.

    Important

    Do not log in more than once on the same host. If you log in again, the session that has already started might be disabled.

  2. In the Login window, enter the login credentials for User Name and Password.

    By default, the following user account is set:

    User Name: ADMINISTRATOR

    Password: None

    [Figure]

  3. Click the Login button.

    You are now logged in to Performance Management, and the Main window is displayed.

  4. If this is the first time you have logged in, use the Change Password menu to change the password.

    [Figure]

    Specify a password in Password, and then enter it again in Confirm password. Specify the password by taking into account the following:

    Specify the password as 1 to 16 single-byte characters. The permitted characters include alphabetic characters (uppercase and lowercase), numeric characters, and symbols (! " # $ % & ' ( ) * + , - . / : ; < = > ? @ [ \ ] ^ _ ` { | } ~ space). Alphabetic characters are case sensitive.

    Any single-byte space entered before or after an input character string is deleted.

Postrequisites

Create user accounts.

Related topics

(7) Creating user accounts

To run the operation monitoring system securely, create the ADMINISTRATOR user that is set by default and the user accounts that will be used during operation.

Background

Performance Management supports two user account management methods. One is the PFM authentication mode for managing user accounts only within the Performance Management system. The other is the JP1 authentication mode, in which JP1/Base is used to achieve central management of user accounts. The setup procedure explained in this manual is based on use of the PFM authentication mode. For details about the setup method when the JP1 authentication mode is used, see the topic Tasks involved in user account setup in the JP1/Performance Management User's Guide.

Procedure

  1. Log in to Performance Management from the monitoring console.

  2. In the Main window, select the Users tab.

    [Figure]

  3. In the Users window, select New User.

  4. In the New User window, specify information about the user account.

    Specify the following items:

    User name

    Specify a user name as 1 to 16 single-byte characters. The permitted characters include alphabetic characters (uppercase and lowercase), numeric characters, and symbols (! " # $ % & ' ( ) * + , - . / : ; < = > ? @ [ \ ] ^ _ ` { | } ~ space). Alphabetic characters are not case sensitive.

    Any single-byte space entered before or after the input character string is deleted.

    Password and Confirm password

    Specify a password as 1 to 16 single-byte characters. The permitted characters include alphabetic characters (uppercase and lowercase), numeric characters, and symbols (! " # $ % & ' ( ) * + , - . / : ; < = > ? @ [ \ ] ^ _ ` { | } ~ space). Alphabetic characters are case sensitive.

    Any single-byte space entered before or after the input character string is deleted.

    Tip

    We recommend that you specify a password that satisfies the following conditions:

    • Consists of at least six characters.

    • Includes at least one alphabetic character, numeric character, and symbol.

    • Is not the same as the user name.

    Selection of authority and Assignment of business groups

    Select one of the following authorities:

    Management user: This authority can reference and manage the entire system.

    Ordinary user: This authority can reference the entire system.

    Business group ordinary user: This authority can reference only the monitoring agents in the business group.

    Note

    If you configure business groups, you can limit the users who are permitted to reference performance data for each business system. You use business groups so that multiple system administrators monitor specific systems assigned to them or for monitoring of very large systems. For details, see Functions monitored in a business group in the JP1/Performance Management Planning and Configuration Guide.

  5. Click the OK button.

    The user name is displayed in the tree for the created user account.

  6. Click the Logout menu to log out from the monitoring console.

  7. Check if the created user account can be used to log in.

Postrequisites

Create an authentication key file for PFM - Web Console.

Related topics

(8) Creating an authentication key file for PFM - Web Console

Create an authentication key file that can be used during command execution so that the PFM - Web Console commands can be executed once Performance Management operation has begun. The PFM - Web Console commands include commands for specifying definitions of the database recording methods and for specifying report definition information.

Prerequisites

The user accounts that will be used for running Performance Management must have already been created.

Procedure

  1. Execute the jpctool service list command on the host on which PFM - Manager is installed and verify that the View Server service is running.

    Command storage location:

    Windows:

    PFM-Manager-installation-folder\tools

    Linux:

    /opt/jp1pc/tools

    Example of command execution:

    jpctool service list -id * -host *

    In Linux, wildcards might be analyzed by the shell, resulting in a command execution error. If this happens, enclose wildcards in double-quotation marks ("), such as "*".

    The service is running if Active is displayed for Status in the execution results, as shown in the following:

    [Figure]

  2. If the View Server service is stopped, execute the jpcspm start command to start the View Server service.

    Command storage location:

    Windows:

    PFM-Manager-installation-folder\tools

    Linux:

    /opt/jp1pc/tools

    Example of command execution:

    jpcspm start -key all
  3. Log in to the host on which PFM - Web Console is installed.

    In Windows, log in as a member of the Administrators group.

    In Linux, log in as a root user or use the su command to change the user account to a root user.

  4. Execute the jpcmkkey command and specify the user name and password for the user account that will be used for Performance Management operation.

    Command storage location:

    Windows:

    PFM-Web-Console-installation-folder\tools

    Linux:

    /opt/jp1pcwebcon/tools

    Example of command execution:

    jpcmkkey -user "ADMINISTRATOR" -password "xxxxxx"
    • In the -user option, specify the user name.

      To include a single-byte space in the user name, enclose the user name in double quotation marks ("). To specify a single-byte symbol, use the escape representation supported by the OS, if necessary. To specify a backslash (\) at the end of the entry string, specify \\\\.

    • In the -password option, specify the password.

      If this option is omitted, Performance Management assumes that there is no password. To include a single-byte space in the user name, enclose the user name in double quotation marks ("). To specify a single-byte symbol, use the escape representation supported by the OS, if necessary. To specify a backslash (\) at the end of the entry string, specify \\\\.

    The authentication key file used for executing PFM - Web Console commands is created.

Postrequisites

Start the Performance Management services on the monitoring manager.

Related topics