There may come a time when you need to change the hostname of your IBM Maximo WebSphere Application Server. This could be due to migrating the configuration to another machine, changing domain/subnet information, or copying a virtual machine for development purposes. Whatever the reason, this article aims to help get Maximo back up and running after a hostname change on the IBM WebSphere Application Server.

For example, let’s assume the old hostname is, and we want to change it to in a WebSphere v8.5.5 environment.

Step 1: Change the Host Name for the Cell Manager and Node

  1. Sign into the IBM WebSphere Application Server machine as an administrative user.
  2. Stop the IBM Cell Manager and Node Agent Windows Services if they are running.
  3. Open a command prompt as an administrator and navigate to the C:\IBM\WebSphere\AppServer\bin directory (substitute your WebSphere folder if necessary).
  4. Run the following command: wsadmin.bat -conntype NONE -lang jython
  5. At the wsadmin> prompt, issue the following command: AdminConfig.list('ServerIndex')
    This will list out the existing servers (typically the Cell Manager and Node). The results will look like:
  6. For each of the entries returned in the previous step, issue the following command:
    AdminConfig.modify('(cells/ctgCell01/nodes/ctgCellManager01|serverindex.xml#ServerIndex_1)', "[[hostName]]")
    AdminConfig.modify('(cells/ctgCell01/nodes/ctgNode01|serverindex.xml#ServerIndex_1)', "[[hostName]]")
  7. Save the changes by running:
  8. Exit the wsadmin> prompt by running: exit
  9. Start the IBM Cell Manager Windows Service. This should enable you to log into the IBM WebSphere Console.

Step 2: Change the Host Name for the various Ports

  1. Sign into the IBM WebSphere Console as the wasadmin user.
  2. Open the Servers > Server Types > WebSphere application servers page.
  3. Click on the MXServer application server.
  4. Click on the Ports link under Communications.
  5. Click on each address that has the old hostname and change it to the new hostname. Click OK.
  6. Open the System administration > Deployment manager page.
  7. Click on the Ports link under Additional Properties
  8. Click on each address that has the old hostname and change it to the new hostname. Click OK.
  9. Open the System administration > Node agents page.
  10. Click on the nodeagent Node agent.
  11. Click on the Ports link under Additional Properties
  12. Click on each address that has the old hostname and change it to the new hostname. Click OK.
  13. Click the Save to master configuration file link.
  14. Synchronize changes back to the cell.
  15. Log out of the IBM WebSphere Console
  16. Restart the IBM Cell Manager Windows Service.
  17. Start the IBM Node Agent Windows Service.
  18. Depending on whether the MXServer application server is set to start automatically, you may need to log back into the IBM WebSphere Console to start it.

Maximo should now be running on a new host name!

Alex Walter is the Chief Innovation Officer at the A3J Group, a company he formed to address the need for innovative software solutions and integrated consulting services within the EAM industry. Alex brings 17 plus years of experience in business consulting in various industries including Life Sciences, Oil and Gas, Water and Waste Management, Education, Government Facilities, among others. Alex lives in Tampa, FL with his wife, two sons, and dogs. In his free time, he enjoys running half marathons, making space in his garage for new camping and outdoor equipment, traveling to far off places with the Walter Circus, and remaining hopeful that his NY Jets' best days are ahead of them and not behind.

7 Thoughts on “Changing the hostname of a Maximo WebSphere Application Server”

  • Hi, thanks for this article. how about when the domain name changes? After changing the domain name from the default name of ‘WorkGroup’, Maximo stopped working.

    • Changing the domain name effectively changes the fully qualified host name of the server. Even if the computer name remains the same, WebSphere wants that fully qualified host name (or an IP address). You should be able to follow these same steps, but be sure to input the fully qualified name.

    • The Maximo application should not need to be redeployed, but all of the WebSphere-related services need to be restarted for the change to take effect.

  • Hi Alex,
    Are there other changes needed like regenerating or recreating security certificates or changing the HTTP Server configurations or anything else?

    • Certainly. There are several System Properties in the Maximo database that store the host name, such as Integration Framework URLs and attached document mapping. Also if you are using SSL and change the host name of the machine, you’ll need to generate and import a new certificate.

  • Thanks for the article. Unfortunately looks likes it is not working for version. After those steps (after bounce cell and node services), if you are back to wsadmin and run the following‘(cells/ctgCell01/nodes/ctgCellManager01|serverindex.xml#ServerIndex_1)’, ‘hostName’)

    you still get the IP address instead of the name. Also, if you are back to ” Servers > Server Types > WebSphere application servers ” you will see the hostname is still the IP address.

Leave a Reply

Your email address will not be published.