IBM Performance Management

Changing the server IP address and host name

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:

  1. Stop all of the server components by entering the following command in the /usr/bin directory:
    apm stop_all
  2. 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.
  3. 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
  4. Change the Performance Management server references on the DB2® server to the new IP address and host name:
    1. 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.
    2. 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.
    3. 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.
  5. 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.
  6. Restart the server components by entering the following command in the /usr/bin directory:
    apm start_all
  7. Override the host name of the Performance Management server in the Central Configuration Services component.
    1. If you are not already logged in to the Performance Management console, log in now. (See Starting the Performance Management console.)
    2. Click System Configuration > Advanced Configuration and click Agent Central Configuration.
    3. 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.
  8. 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.
  9. 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.