You can change the IP address and host name of the Performance Management server at any time. If you
change the IP address and host name of the server, you must also change the IP address and host name
that all of the agents use to connect to the Performance Management server.
Before you begin
If you change the IP address and host name of the Performance Management server and you plan
to install new agents, create new configuration packages for the agent images (see step
2 in
Configuring the installation images). Otherwise, the agents will not connect to the
Performance Management server or show in the
Performance Management console.
Procedure
Complete the following steps as the root user on the Performance Management server:
- Stop all of the server components by entering the following command in the
/usr/bin directory:
apm stop_all
- Change the IP address and host name of the server that is used to start the Performance Management console. This is the address that users enter to start
the console from their web browsers. Change to the install_dir/ccm directory and run the following
command:
configure_server_address.sh
You are prompted for the following values: - Fully qualified domain name, for example: myserver.example.com.
- Short host name
- IP address
Tip: The fully qualified domain name and short host name are resolved using DNS. If
your system does not have good DNS resolution, enter the IP for all three values.
- Update the server agent file names. The server agents include the Synthetic Events agent, the
Transaction Events agent, and optionally, the Bluemix® Integration agent. Change to the install_dir/serveragents/bin directory and run
the following command:
update_config_files.sh
- Change the Performance Management server references on the DB2® server to the new IP address and host name:
- Update the DB2SYSTEM registry variable to match the new host name of the
Performance Management server:
source /home/db2apm/sqllib/db2profile
db2set -g DB2SYSTEM=host_name
where
host_name is the new host name of the server.
- If your DB2 database is on a local system, modify the host name on the Performance Management server by editing the
/home/db2apm/sqllib/db2nodes.cfg file and replacing the old server host name
with the new server host name.
- If your DB2 database is on a local system, update the DB2 administrator's configuration file by entering the following commands:
su - db2apm -c 'db2 update admin cfg using DB2SYSTEM host_name'
su - db2apm -c 'db2 update admin cfg using SMTP_SERVER host_name'
where host_name is the new host name of the server.
- Verify that the server agents that were installed with the Performance Management server are configured to use
localhost to communicate with the server. Open the install_dir/serveragents/config/global.environment file and locate the
IRA_ASF_SERVER_URL and IRA_API_DATA_BROKER_URL properties.
Complete one of the following steps:
- If the properties specify localhost in the URL string, no change is
required.
- If the properties contain the IP address of the Performance Management server, which is likely if you
configured the agents to communicate using HTTPS, change the IP addresses to
localhost.
- Restart the server components by entering the following command in the
/usr/bin directory:
apm start_all
- Override the host name of the Performance Management server in the Central Configuration Services component.
- If you are not already logged in to the Performance Management console, log in now. (See Starting the Performance Management console.)
- Click
and click Agent Central Configuration.
- In the Host Name Override field, enter the new IP address or fully
qualified host name of the Performance Management server.
After you click Save, the new host name is updated in the Central
Configuration Services component.
- On the systems where your agents are installed, connect the agents to the new server IP address
and host name. See Connecting agents to a different server.
- If you have reports packages for the Response Time Monitoring Agent and the WebSphere® Applications agent installed, you must reinstall the reports packages for both agents. For more information, see Installing reports.
Results
The IP address and host name of the server is changed.