5.3.9 Changing the physical host name of PFM - Manager
You must perform operations on the following hosts when changing the PFM - Manager host name:
-
PFM - Manager host
-
PFM - Web Console host
-
PFM - Agent or PFM - RM host
-
Monitoring console
The following figure shows the process flow.
If Performance Management is linked with JP1/ITSLM, before you start the procedure described below, see the section in the Job Management Partner 1/Performance Management User's Guide that describes the general procedure for changing host names after Performance Management has been linked with JP1/ITSLM.
|
Use the following procedure to set the display conditions (Each step corresponds to the step number in the figure above):
-
Suspend monitoring for the PFM - Manager host whose host name is to be changed.
If you do not want health check events to occur while changing the host name, suspend monitoring for the host whose name is to be changed. You can do so by using the jpctool monitor suspend command of the PFM - Manager host or from the monitoring console.
In a multiple-monitoring configuration, perform this step on the primary manager.
For details about suspending monitoring, see the chapter that describes suspending and resuming of monitoring in the Job Management Partner 1/Performance Management User's Guide.
-
Suspend monitoring with the new host name specified.
If you suspended monitoring in step 1, you also need to suspend monitoring with the new host name specified.
In this case, use the -force option of the jpctool monitor suspend command of the PFM - Manager host.
In a multiple-monitoring configuration, perform this step on the primary manager.
-
Delete the settings for the health check agent.
If you have been using the health check function, use the PFM - Web Console to delete the definition for the health check agent. (To delete an agent definition, delete the agent definition from a management folder in the Agents tree, and then delete the linkage with an alarm table.)
In a multiple-monitoring configuration, perform this step on the primary manager.
For details about the procedure for changing the agent definition, see the chapter that describes monitoring agents or the operation monitoring with alarms in the Job Management Partner 1/Performance Management User's Guide.
-
Delete the settings for PFM - Agent or PFM - RM.
Use PFM - Web Console to delete the agent definition of the PFM - Agent or PFM - RM host that is installed on the same host as the PFM - Manager whose host name is to be changed (delete the definition from the management folder in the Agents tree and delete the alarm table associations).
In a multiple-monitoring configuration, perform this step on the primary manager.
For details about the procedure for changing the agent definition, see the chapter that describes monitoring agents or operation monitoring with alarms in the Job Management Partner 1/Performance Management User's Guide.
-
Stop the services on the PFM - Web Console host.
On the PFM - Web Console host connected to PFM - Manager for which you intend to change the host name, stop all Performance Management programs and services. To stop the services, use the jpcwstop command.
In a multiple-monitoring configuration, perform this step on both the primary and secondary managers.
-
Stop the services on the PFM - Agent or PFM - RM host.
On the PFM - Agent or PFM - RM host connected to PFM - Manager for which you intend to change the host name, stop all Performance Management programs and services. To stop the services, use the jpcspm stop command.
-
Stop the services on the PFM - Manager host.
Stop all Performance Management programs and services on the PFM - Manager host for which you intend to change the host name. To stop the services, use the jpcspm stop command.
In a multiple-monitoring configuration, perform this step on both the primary and secondary managers.
-
Change the monitoring host name of the PFM - Manager host.
Execute the jpcconf host hostname command on the PFM - Manager host whose host name is to be changed to change the monitoring host name.
To change a physical host name to hostB:
jpcconf host hostname -newhost hostB -d d:\backup -dbconvert convert
- Note:
-
After you execute the above command, do not execute any other Performance Management commands until you change the physical host name in the next step.
If you execute the jpcconf host hostname command, all existing information, such as definition and performance information, is inherited. For details about the jpcconf host hostname command, see the chapters that describe commands in the manual Job Management Partner 1/Performance Management Reference.
- Reference note
-
As a guideline, the folder specified for the -d option in the jpcconf host hostname command must have empty disk space that is equal to or greater than the sum of the total size of the PFM - Agent and PFM - RM Store databases on the specified host and the total size of the databases in the import directories. If the Store database storage directory and the import directory have been changed, determine the required disk space based on the sizes of the databases in the new directories.
For example, if the health check agent, PFM - Agent for Platform, and PFM - Agent for Oracle are on the specified host, empty disk space equal to or greater than the sum of the total size of the Store databases of those agents and the total size of the databases in the import directories is required. However, you do not need to include the size of Store database for the PFM - Manager Master Store service in the total size.
-
Change the physical host name of the PFM - Manager host.
Change the physical host name of the PFM - Manager host.
In a multiple-monitoring configuration, on the PFM - Manager host whose name will not be changed, change the settings of the PFM - Manager for the connection destination. For details, see the chapter that describes how to make the PFM - Manager for the connection destination redundant in the Job Management Partner 1/Performance Management User's Guide.
-
Change the settings in the jpchosts file, the hosts file, or the DNS server as necessary so that the new host names in the Performance Management system can be resolved to IP addresses.
If the machines need to be restarted, change the settings of the Performance Management programs and services so that they will not start automatically when the machines restart. After the PFM - Manager host operation has finished, return the settings so that the Performance Management programs and services start automatically.
-
Perform the Agent-specific procedure, if necessary.
If PFM - Agent is installed on the PFM - Manager host whose name has been changed, the PFM - Agent-specific procedure might be necessary.
Table 5‒13: Necessity of the PFM - Agent-specific procedure Configuration
Necessity and reference
The version of PFM - Agent installed on the PFM - Manager host is 09-00 or later.
Whether the PFM - Agent-specific procedure is necessary depends on PFM - Agent. For details about the PFM - Agent-specific procedure, see the chapters describing the installation and setup in the PFM - Agent manuals.
The version of PFM - Agent installed on the PFM - Manager host is earlier than 09-00.
The following PFM-Agent:
-
PFM - Agent for Enterprise Applications
-
PFM - Agent for Microsoft SQL Server
The Agent-specific procedure is necessary. For details about the PFM - Agent-specific procedure, see 5.3.13 Optional PFM - Agent-specific procedure to be performed when the physical host name is changed.
For all other cases
Agent-specific procedure is not necessary.
If the PFM - Agent-specific procedure is necessary, perform the procedure indicated in the table above, and then proceed to the following steps.
-
-
Start the services on the PFM - Manager host.
Start the Performance Management programs and services on the PFM - Manager host. To start the services, use the jpcspm start command.
In a multiple-monitoring configuration, perform this step on both the primary and secondary managers.
-
Delete service information on the PFM - Manager host.
Even though the PFM - Manager host name is changed, the service information of the Performance Management programs with the previous host name remains the same. Therefore, you need to delete unnecessary information. In a multiple-monitoring configuration, perform this step on both the primary and secondary managers.
The types of service information that you need to delete and the method of checking the service information are described as follows:
Service information on the host with the previous host name
All the items that are displayed by executing the following command must be deleted:
jpctool service list -id * -host previous-host-name
Service information whose service ID contains the previous host name
Items whose Service ID column contains the previous host name of the items that are displayed by executing the following command must be deleted:
jpctool service list -id *
Service information can be deleted by using the jpctool service delete command.
Delete service information on the host with the previous host name by using the following command:
jpctool service delete -id * -host previous-host-name
Additionally, delete service information whose service ID contains the previous host name by using the following command:
jpctool service delete -id ???previous-host-name -host new-host-name
If the KAVE05233-W message is issued during command execution because of a service information deletion error, re-execute the command as follows:
jpctool service delete -id * -host previous-host-name -force jpctool service delete -id ???previous-host-name -host new-host-name -force
- Reference note
-
Even though you execute the jpctool service list command, old service information that contains the previous host name might not be displayed. Because such service information also needs to be deleted from the database, you must execute the jpctool service delete command shown above.
For details about the commands, see the chapter that describes the commands in the manual Job Management Partner 1/Performance Management Reference.
-
Apply PFM - Manager's service information.
To apply the deletion of service information to PFM - Web Console, synchronize the service information between PFM - Manager and PFM - Web Console. Use the jpctool service sync command to synchronize service information.
In a multiple-monitoring configuration, perform this step on both the primary and secondary managers.
The time when the service information, which is synchronized by using the jpctool service sync command, is applied to PFM - Web Console differs depending on the version of PFM - Web Console. For details about the jpctool service sync command, see the chapter describing commands in the manual Job Management Partner 1/Performance Management Reference.
-
Change the configuration of the business groups, if necessary.
If a PFM - Manager host whose host name has been changed has been assigned to business groups, you need to change the configuration of the business groups.
In a multiple-monitoring configuration, perform this step on the primary manager.
For details about the procedure, see the chapter that describes management of user accounts and business groups in the Job Management Partner 1/Performance Management User's Guide.
-
Change the settings for PFM - Manager for the connection destination on the PFM - Agent or PFM - RM host.
Change the settings for PFM - Manager for the connection destination on the PFM - Agent or PFM - RM host connected to PFM - Manager for which you have changed the host name. Use the jpcconf mgrhost define command to change the settings for PFM - Manager for the connection destination. For example, if the host name of PFM - Manager for the connection destination is changed to hostB, specify and execute the command as follows:
jpcconf mgrhost define -host hostB
This example executes the jpcconf mgrhost define command in the interactive mode. You can also execute this command in the non-interactive mode. For details about the jpcconf mgrhost define command, see the chapters that describe commands in the manual Job Management Partner 1/Performance Management Reference.
-
Start the services on the PFM - Agent or PFM - RM host.
Start the Performance Management programs and services on the PFM - Agent or PFM - RM host connected to PFM - Manager for which you have changed the host name. To start services, use the jpcspm start command.
-
Change the settings of PFM - Manager for the connection destination on the PFM - Web Console host.
Change the settings for PFM - Manager for the connection destination on the PFM - Web Console host connected to PFM - Manager for which you have changed the host name. Change the information in the Windows initialization file (config.xml) to change the settings for PFM - Manager for the connection destination. 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.
-
Start the services on the PFM - Web Console host.
Start the Performance Management programs and services on the PFM - Web Console host connected to PFM - Manager for which you have changed the host name. To start the services, use the jpcwstart command.
-
Reconfigure the definition for the health check agent.
If you have been using the health check function, reconfigure the definition (that was deleted in step 3) of the health check agent after changing the host name.
In a multiple-monitoring configuration, perform this step on the primary manager.
-
Reconfigure the definition for PFM - Agent or PFM - RM.
Reconfigure the definition of PFM - Agent or PFM - RM (the definition that was deleted in step 4) that is installed on the same host running PFM - Manager whose host name has been changed.
In a multiple-monitoring configuration, perform this step on the primary manager.
-
Update the alarm settings.
In the following cases, you must update the alarm settings by using the jpctool alarm command of the PFM - Manager host or the monitoring console.
In a multiple-monitoring configuration, perform this step on the primary manager.
-
The action handler of the PFM - Manager host is specified for the action handler that executes actions.
Edit the alarm to set PH1<new-pfm-manager-host-name> for the action handler that executes actions.
-
JP1 events are issued by actions.
Set the JP1 event settings in the action again.
For details about how to edit alarms, see the chapter that describes the operation monitoring with alarms in the Job Management Partner 1/Performance Management User's Guide.
-
-
Update the JP1 system event settings.
If one of the following conditions is met, you need to update the JP1 system event settings by using the PFM - Web Console:
In a multiple-monitoring configuration, perform this step on the primary manager.
-
The previous host name has been specified as the name of the event server to which JP1/Base connects.
-
The previous host name has been specified as the host name of the monitoring console for JP1 system events.
For details on JP1 system events, see the chapter that explains operation monitoring linked with the integrated management program (JP1/IM) in the Job Management Partner 1/Performance Management User's Guide.
-
-
Resume monitoring with the previous host name specified.
If you suspended monitoring in step 1, you need to resume monitoring with the previous host name specified to delete the settings information of monitoring suspension for the previous host name.
In this case, use the -force option of the jpctool monitor resume command of the PFM - Manager host.
In a multiple-monitoring configuration, perform this step on the primary manager.
-
Resume monitoring for the PFM - Manager host whose host name was changed.
If you suspended monitoring in step 2, use the jpctool monitor resume command of the PFM - Manager host or use the monitoring console to resume monitoring for the PFM - Manager host.
In a multiple-monitoring configuration, perform this step on the primary manager.
-
Match the definitions on the primary manager and the secondary manager (in a multiple-monitoring configuration).
Export the definitions for the multiple-monitoring configuration from the primary manager and import them to the secondary manager so that the primary manager and the secondary manager have the same definitions.
For details about how to match definitions on the primary and secondary managers, see the description regarding duplication of definitions in the Job Management Partner 1/Performance Management User's Guide.
-
Check whether the JP1 system event settings have been properly updated.
Check the following items after changed the settings:
-
Collection of performance data
Make sure that performance data can be collected for a period at least twice as long as the time period specified as the collection interval (Collection Interval).
-
Execution of the jpcrpt command
Make sure that there is no problem in outputting the collected performance data.
-
Check of the report definition and alarm definition
Make sure that there is no problem with the report definition and alarm definition created in the Web browser.
-
Check of the actions
Make sure that there is no problem in executing the created actions.
-
-
If operation monitoring is performed with a network node manager (NNM) linked, restart the NNM.
If Performance Management is linked with a network node manager (NNM), restart the network node manager.
For details about the NNM linkage facility, see the chapter that describes operation monitoring linked with a network node manager (NNM) in the Job Management Partner 1/Performance Management User's Guide.