4.1.4 PFM - Manager setup procedure
indicates setup items required according to each environment and optional setup items used to change default settings.
- Point:
-
The start information file (jpccomm.ini) is used to configure the operation of Performance Management.
- Organization of this subsection
(1) Registering PFM - Agent or PFM - RM
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 manual registration. For details, see the PFM - Manager Release Notes.
- Note
-
The information on the automatically registered PFM - Agent or PFM - RM is displayed in PFM - Web Console at the following time:
- 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 about the jpcconf agent setup command, see the chapters that describe commands in the manual JP1/Performance Management Reference.
- 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 about how to execute commands, see the chapters that describe commands in the manual JP1/Performance Management Reference.
-
- Supplemental information:
-
Note the information that follows about performing manual registration (jpcconf agent setup -key agtX (with the -register option omitted)) on the PFM - Manager host.
- Executing jpcconf agent setup -key agtX (with the -register option omitted) when PFM - Manager is a physical environment:
-
The registered PFM - Agent or PFM - RM information is displayed on the PFM - Web Console at the following time.
-
PFM - Web Console version 09-00 or later
The next time the user logs on to PFM - Web Console.
-
PFM - Web Console version 08-11 or earlier
When PFM - Web Console is restarted.
-
- Executing jpcconf agent setup -key agtX (with the -register option omitted) on the executing host and the standby host when PFM - Manager is a logical host:
-
The registered PFM - Agent or PFM - RM information is displayed on PFM - Web Console at the following time.
-
PFM - Web Console version 09-00 or later
After the registered PFM - Agent or PFM - RM has started or the next time the user executes jpcconf agent setup -key agtX -register on the executing host and the standby host to which the shared disk is connected and logs on to PFM - Web Console.
-
PFM - Web Console version 08-11 or earlier
After the registered PFM - Agent or PFM - RM has started or the next time the user executes jpcconf agent setup -key agtX -register on the executing host and the standby host to which the shared disk is connected and restarts PFM - Web Console.
-
(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:
-
Copy the setup file of PFM - Agent or PFM - RM in binary mode.
The following table shows the locations where files are stored and the location where files are to be copied.
Table 4‒3: Setup files to be copied Copy from
Copy to
Host
File
Host
File
PFM - Agent, PFM - RM
-
In Windows
installation-folder\setup\jpcxxxxw.EXE
PFM - Manager
installation-folder\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 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 details about service keys, see the appropriate PFM - Agent or PFM - RM manual.
For example, execute the following command to set up PFM - Agent for Oracle:
jpcconf agent setup -key Oracle
This example executes the jpcconf agent setup command in the interactive mode, but this command can also be executed in the non-interactive mode. For details about the jpcconf agent setup command, see the chapter that describes commands in the manual JP1/Performance Management Reference.
- 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.
(2) Specifying settings for the network
The settings described in this subsection are required if you change settings according to the network configuration on which Performance Management is used.
You can set the following four items for network settings:
-
Setting IPv6 communication
This setting is required if you use IPv6 communication in Performance Management. To use IPv6 communication, execute the jpcconf ipv6 enable command on the PFM - Agent, PFM - RM, and PFM - Manager that will be using IPv6 communication.
In a cluster system, this setting must be specified in both the executing system and the standby system.
Note that only IPv4 communication is supported between PFM - Manager and PFM - Web Console.
For details, see 4.3.1(1)(a) Setting IPv6 communication.
-
Setting IP addresses
Set this item when Performance Management is used in a network with multiple LANs connected. To set multiple IP addresses, define the host name and IP address in the jpchosts file. Confirm that the settings in jpchosts files are the same throughout the entire Performance Management system.
For details, see 4.3.1(1)(b) Setting IP addresses.
-
Setting port numbers
You can set the port numbers used by Performance Management. Use the same port numbers and service names for the entire Performance Management system to avoid any confusion during operations.
For details about setting port numbers, see 4.3.1(1)(c) Setting port numbers.
- Note
-
By setting fixed ports for the PFM - Manager's Master Manager service and Correlator service, you can start up Performance Management more quickly in large environments.
-
Setting the host name or IP address used for communication with PFM - Web Console and JP1/SLM
Define the host name or IP address of PFM - Manager in the jpcvsvr.ini file on the PFM - Manager host in the following cases:
-
IP address translation (NAT) is performed between the PFM - Manager host and the PFM - Web Console host.
-
Multiple IP addresses are used between the PFM - Manager host and the PFM - Web Console host.
-
JP1/SLM is linked and IP address translation (NAT) is performed between the PFM - Manager host and the JP1/SLM host.
-
JP1/SLM is linked and multiple IP addresses are used between the PFM - Manager host and the JP1/SLM host.
For details, see 4.3.1(1)(d) Setting the host name or IP address used for communication with PFM - Web Console and JP1/SLM.
-
(3) Changing the log file size
The operating status of Performance Management is output to a Performance Management-specific log file. This log file is called the common message log. This setting is required when you wish to change this file size.
For details, see 4.4.1 Setting the size of the log file for the common message log.
(4) Specifying settings for the authentication mode
These settings are required 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 and business groups in the JP1/Performance Management User's Guide.
(5) Setting the access control function based on business groups
These settings are required if you want to use business groups to manage users of Performance Management. Specify in the start information file (jpccomm.ini) whether the access control function based on business groups is to be used.
For details, see the chapter that describes user accounts and business groups in the JP1/Performance Management User's Guide.
(6) Changing the storage locations of event data
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:
-
Data storage folder: installation-folder\mgr\store\
-
Backup folder: installation-folder\mgr\store\backup\
-
Export folder: installation-folder\mgr\store\dump\
- Note:
-
For the default folders when running Performance Management on a logical host, read installation-folder as environment-directory\jp1pc\.
For details, see 4.4.2 Changing the storage location of event data.
(7) Specifying settings for action log output
These settings are required when you wish to output an action log when an alarm is issued. An action log is log information output in conjunction with the alarm function, when an aspect of the system such as the system load exceeds a threshold. For details, see Appendix H. Outputting Action Log Data.
(8) Configuring the health check function
These settings are required when you wish to check the operating status of monitoring agents and their hosts. For details about how to specify these settings, see the chapter that describes detecting problems in Performance Management in the JP1/Performance Management User's Guide.
(9) Configuring the PFM service automatic restart function
This setting is required if you want PFM services to automatically restart if they terminate abnormally. For details about how to specify this setting, see the chapter that describes detecting problems in Performance Management in the JP1/Performance Management User's Guide.
(10) Configuring the product name display function
These settings are required if you want to enable the product name display function when you upgrade from a version earlier than 08-11, or when you perform a new installation. For details about this function, see 3.1.2 Displaying and specifying services (the product name display function). For details about how to configure this function, see 4.4.10 Configuring the product name display function.
(11) Configuring the auto alarm bind function
The setting described here is necessary when you want to change the default setting (enabled or disabled) of the auto alarm bind function. When you install or upgrade to Performance Management version 11-50 or later, the auto alarm bind function is enabled by default. For details about the auto alarm bind function, see the section describing auto alarm bind in the JP1/Performance Management User's Guide.
You can edit the default setting as follows:
- Note
-
If you are using a multiple monitor configuration, edit this setting on both the primary and secondary hosts.
-
Stop Performance Management programs and services.
If there are any Performance Management programs and services running, stop all of them by using the jpcspm stop command. If you are using a cluster configuration, first stop the cluster software.
-
Use a text editor or a similar tool to edit the jpccomm.ini file that defines the operating environment for the PFM - Manager hosts (physical and logical hosts).
Under the [Common Section] section of the jpccomm.ini file, edit and then save the setting as follows:
- To enable the auto alarm bind function:
-
Auto Alarm Bind Mode=1
- To disable the auto alarm bind function:
-
Auto Alarm Bind Mode=0
After editing the above setting, save and then close the jpccomm.ini file.
-
Start Performance Management programs and services.
Start Performance Management programs and services by using the jpcspm start command. If you are using a cluster configuration, first start the cluster software.