Hitachi

JP1 Version 12 Performance Management: Getting Started


1.3.2 Setting up PFM - Manager (Windows)

After you have finished installing PFM - Manager, change port numbers and change monitoring host names to aliases, if necessary. If you have changed monitoring host names to aliases, specify settings so that the monitoring manager host can resolve names by using aliases.

Organization of this subsection

(1) Specifying the port numbers to be used by PFM - Manager

If you want to change port numbers that will be used by PFM - Manager or fix port numbers to permit firewall passage, specify the port number settings again. This task is not needed if you use the default port numbers.

Prerequisites

The commands used for this task are stored at the following location.

Windows:

PFM-Manager-installation-folder\tools

Linux:

/opt/jp1pc/tools

Procedure

  1. Log in to the host on which PFM - Manager 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.

  2. Execute the jpcconf port define command.

    Example of command execution:

    jpcconf port define -key all

    You can execute the jpcconf port define command to display the port numbers that are set currently. For example, if the current port number for the Name Server service is 22285, the following is displayed:

    Component[Name Server]
    ServiceID[PN1001]
    Port[22285]
         :
  3. Set port numbers for the individual services.

    The action depends on how you are setting the port number. The table below lists and describes the settings and actions. As long as there will not be any duplication of a port number in the host, use the port numbers displayed by the jpcconf port define command as is.

    Setting

    Action

    To use the displayed number as the fixed port number for a service

    Press the Enter key.

    To change the displayed port number to another number

    Enter a port number between 1024 and 65535.

    Do not specify a port number that is already being used by the system.

    Port number that is not to be fixed

    Enter 0.

    You cannot fix port numbers for the following services; you must enter 0 to set the default value:

    • Name Server service

    • View Server service (between PFM - Web Console and View Server service)

    • Status Server service

  4. Execute the jpcconf port list command to check if the port numbers have been set correctly.

    Example of command execution:

    jpcconf port list -key all

    If <error> is displayed in the Service area or the Port area, port numbers have not been set correctly. Set the port numbers again. One of the following could be the cause of the error:

    • A port number is not set.

    • The same port number is already set.

  5. In a firewall environment, specify the settings so that communication using the port numbers set in steps 2 through 4 is permitted.

Postrequisites

If you will not be using the real host names as the monitoring manager's monitoring host names, change the monitoring host names to aliases. Otherwise, install PFM - Web Console.

Related topics

(2) Changing the monitoring manager's monitoring host names to aliases

You can change the monitoring manager's monitoring host names from the real host names to aliases. To use aliases for the monitoring host names, change the type of monitoring host names and the monitoring host name settings.

Prerequisites

The commands used for this task are stored at the following location.

Windows:

PFM-Manager-installation-folder\tools

Linux:

/opt/jp1pc/tools

Procedure

  1. Log in to the host on which PFM - Manager 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.

  2. Create a backup directory to save the definition information before host names are changed.

    Example of directory creation

    d:\backup
  3. Execute the jpcconf host hostmode command to change the type of monitoring host names and the monitoring host names.

    Example of command execution:

    jpcconf host hostmode -mode alias -aliasname aliasmgr -d d:\backup
    • The -mode option specifies the type of monitoring host names. If you specify alias, you can set aliases.

    • The -aliasname option specifies monitoring host names. You can specify any names.

    • The -d option specifies the name of the directory created in step 2 (the directory to which definition information is to be backed up before host names are changed). Specify 1 to 130 bytes of single-byte alphanumeric characters, single-byte symbols, and the space character. Note that ;, ,, *, ?, ', ", <, >, and | cannot be specified.

      Important

      The jpcconf host hostmode command cannot be executed while Performance Management services are running. If an attempt is made to execute the command while Performance Management services are running, an error occurs and the processing is terminated. If that happens, execute the jpcspm stop command as follows to stop PFM - Manager services:

      jpcspm stop -key all

  4. Re-execute the jpcconf host hostmode command to check whether the settings have been specified correctly.

    Example of command execution:

    jpcconf host hostmode -display

    The jpcconf host hostmode command displays the monitoring host name type that is set currently and the current monitoring host names in the format shown below. Check whether the displayed information matches the settings specified in step 3.

    hostmode: Type of monitoring host name
    hostname: Monitoring host name

Postrequisites

Specifying settings so that aliases can resolve to IP addresses.

Related topics

(3) Using aliases to resolve names

If the monitoring host names are changed to aliases, the monitoring manager host and each monitoring agent host must be able to use those aliases to resolve names. This subsection explains how to edit the Performance Management's settings file (jpchosts file) to resolve names. This task is not needed if name resolution has already been set up by using a method such as DNS.

Prerequisites

The commands used for this task are stored at the following location.

Windows:

PFM-Manager-installation-folder-or-PFM-Base-installation-folderr\tools

Linux:

/opt/jp1pc/tools

Procedure

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

    The jpchosts file is stored in the PFM - Manager installation folder or the PFM - Base installation folder.

  2. Enter the aliases and IP addresses in the jpchosts file.

    Enter this information for all hosts whose monitoring host name is changed to an alias in the Performance Management system.

    The following table shows an example of aliases and the corresponding IP addresses:

    Role in the Performance Management system

    Alias

    IP address

    Monitoring manager

    aliasmgr

    20.108.41.1

    Monitoring agent (Windows)

    aliasagt1

    20.108.41.2

    aliasagt2

    20.108.41.3

    aliasagt3

    20.108.41.4

    Monitoring agent (Linux)

    aliasagt4

    20.108.41.5

    aliasagt5

    20.108.41.6 and 20.108.41.7

    In this example, the following information is entered in the jpchosts file:

    aliasmgr 20.108.41.1
    aliasagt1 20.108.41.2
    aliasagt2 20.108.41.3
    aliasagt3 20.108.41.4
    aliasagt4 20.108.41.5
    aliasagt5 20.108.41.6,20.108.41.7
    Important

    A loopback address cannot be specified as the IP address of a host name that is to be resolved.

    Tip

    You can specify multiple IP addresses for a single alias by separating them with a comma (,).

    A definition of one alias cannot be specified over multiple lines. If there is more than one line that defines the same alias, only the definition on the first line is used.

  3. Save the jpchosts file.

  4. Execute the jpcspm start command and verify that PFM - Manager services have started.

    Example of command execution:

    jpcspm start -key all

Postrequisites

Install PFM - Web Console.

Related topics