IBM Support

Steps to change the WebSphere Portal v7.0 host name or node name

Question & Answer


Question

What steps can be taken to change the host name or node name of the server IBM® WebSphere® Portal v7.0 resides on?

Answer

To change the host name or node name of your WebSphere Portal server, please follow these steps:

Standalone WebSphere Portal server instructions

1. To change the hostname with WebSphere Application Server v7, execute the wsadmin command from the <profile root>/bin directory:

    Windows: wsadmin.bat -user your_admin_id -password your_password -c "$AdminTask changeHostName {-nodeName node_name -hostName new_host_name}"

    UNIX: ./wsadmin.sh -user your_admin_id -password your_password -c "\$AdminTask changeHostName {-nodeName node_name -hostName new_host_name}"

2. If you want to change the node name, follow these steps.
    a. Execute the following wsadmin command from the <profile root>/bin directory.
      Windows: wsadmin.bat -user your_admin_id -password your_password-c "$AdminTask renameNode {-nodeName old_node_name -newNodeName new_node_name}"

      UNIX: ./wsadmin.sh -user your_admin_id -password your_password-c "\$AdminTask renameNode {-nodeName old_node_name -newNodeName new_node_name}"
    b. Edit the setupCmdLine.sh/bat file, located in the <profile root>/bin directory and modify the SET WAS_NODE=node_name entry to specify the updated node name.

    c. Execute the following ConfigEngine script to update the Node Name in ConfigEngine's registry:
      Windows: ConfigEngine.bat rename-node-in-cell-registry -DWasPassword=<password> -DpreviousNodeName=old_node_name
      UNIX:
      ./ConfigEngine .sh rename-node-in-cell-registry -DWasPassword=<password> -DpreviousNodeName=old_node_name


3. Download the attached zip file (portal_cloning_files.zip) and extract it into your <profiles_root>/wp_profile/ConfigEngine directory.

4. Execute the following ConfigEngine script from the <wp_profile root>/ConfigEngine directory:
    Windows: ConfigEngine.bat localize-clone -DWasPassword=<password>
    UNIX:
    ./ConfigEngine .sh localize-clone -DWasPassword=<password>
5. Verify that the <profile>/ConfigEngine/properties/wkplc.properties has been updated with the new hostname and node name.
    WpsHostName=<new host name>
    NodeName=<new node name>

6. Execute the following ConfigEngine script from the <wp_profile root>/ConfigEngine directory to clear any potential references to the hostname from the scheduled tasks in the database:
    Windows: ConfigEngine.bat action-clean-scheduled-tasks -DWasPassword=<password>
    UNIX:
    ./ConfigEngine .sh action-clean-scheduled-tasks -DWasPassword=<password>


portal_cloning_files.zip


Cluster WebSphere Portal instructions:

Note: The 'localize-clone' ConfigEngine script is not supported in a cluster.

1. To change the hostname with WebSphere Application Server v7, execute the wsadmin command from the <profile root>/bin directory:
    Windows: wsadmin.bat -user your_admin_id -password your_password -c "$AdminTask changeHostName {-nodeName node_name -hostName new_host_name}"

    UNIX: ./wsadmin.sh -user your_admin_id -password your_password -c "\$AdminTask changeHostName {-nodeName node_name -hostName new_host_name}"
2. If you want to change the node name, follow these steps.
    a. Execute the following wsadmin command from the <profile root>/bin directory.
      Windows: wsadmin.bat -user your_admin_id -password your_password-c "$AdminTask renameNode {-nodeName old_node_name -newNodeName new_node_name}"

      UNIX: ./wsadmin.sh -user your_admin_id -password your_password-c "\$AdminTask renameNode {-nodeName old_node_name -newNodeName new_node_name}"

    b. Edit the setupCmdLine.sh/bat file, located in the <profile root>/bin directory and modify the SET WAS_NODE=node_name entry to specify the updated node name.

    c. Execute the following ConfigEngine script to update the Node Name in ConfigEngine's registry:
      Windows: ConfigEngine.bat rename-node-in-cell-registry -DWasPassword=<password> -DpreviousNodeName=old_node_name
      UNIX:
      ./ConfigEngine .sh rename-node-in-cell-registry -DWasPassword=<password> -DpreviousNodeName=old_node_name

3. Login to your DMGR

4. Navigate to Environment -> WebSphere Variables

5. Set scope to the WebSphere_Portal server on your first node

6. Edit the WCM_HOST variable to be the new hostname of your first node.

7. Repeat steps 6-7 for each Portal server in your cluster that has a new hostname.

8. Set scope to the Node for your first node.

9. Edit the WAS_NODE_NAME variable and set it to the new node name.

10. Repeat steps 9-10 for each node name that has been changed.

11. Save changes and log out of the DMGR.

12. On node 1, edit the wkplc.properties file and set WpsHostName to the new hostname and NodeName to the new node name.

13. Repeat step 13 for each node in your cluster.

14. Execute the following ConfigEngine script from the <wp_profile root>/ConfigEngine directory on your primary node to clear any potential references to the hostname from the scheduled tasks in the database. This only needs to be executed on the primary node:
    Windows: ConfigEngine.bat action-clean-scheduled-tasks -DWasPassword=<password>
    UNIX:
    ./ConfigEngine .sh action-clean-scheduled-tasks -DWasPassword=<password>

[{"Product":{"code":"SSHRKX","label":"WebSphere Portal"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Component":"Installation \u0026 Configuration","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"7.0","Edition":"Enable;Server","Line of Business":{"code":"LOB31","label":"WCE Watson Marketing and Commerce"}}]

Document Information

Modified date:
03 December 2021

UID

swg21390600