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
-
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.
-
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] :
-
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
-
-
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.
-
-
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
-
E.3 Conventions: Folders and directories for Performance Management
-
jpcconf port define in the manual JP1/Performance Management Reference
-
jpcconf port list in the manual JP1/Performance Management Reference
-
1.3.2(2) Changing the monitoring manager's monitoring host names to aliases
(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
-
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.
-
Create a backup directory to save the definition information before host names are changed.
Example of directory creation
d:\backup
-
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
-
-
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
-
E.3 Conventions: Folders and directories for Performance Management
-
jpcconf host hostmode in the manual JP1/Performance Management Reference
(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
-
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.
-
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.
-
Save the jpchosts file.
-
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
-
E.3 Conventions: Folders and directories for Performance Management
-
jpcspm start in the manual JP1/Performance Management Reference
-
jpcspm stop in the manual JP1/Performance Management Reference