Localizing a new virtual machine instance on Windows

If you are using VMware ESX, you can create a virtual environment that allows you to create virtual instance. When a new virtual instance is created, you must update IBM® WebSphere® Portal with the machine-specific information, such as the host and node names of the instance.

1. Stop the WebSphere_Portal server running on the virtual machine.
2. Update the host name for the virtual machine instance per the instructions of the operating system.
3. Run the wsadmin -c "$AdminTask changeHostName {-nodeName node_name -hostName new_host_name}" -conntype NONE command from the wp_profile_root/bin directory to update the WebSphere Portal host name in the IBM WebSphere Application Server configuration.

   node_name is the node name of the current configuration and new_host_name is the TCP/IP host name of the new virtual machine instance.

4. Optional: Complete the following steps to update the node name in the IBM WebSphere Application Server configuration:
   1. Run the wsadmin.bat -c "$AdminTask renameNode {-nodeName old_node_name -newNodeName new_node_name}" -conntype NONE command to update the node name in the IBM WebSphere Application Server configuration.

      old_node_name is the original node name of the current configuration and new_node_name is the new node name you use for this instance.

      Remember: This step is necessary to create a unique node name if you are federating and clustering this node.
   2. Edit the setupCmdLine.bat file, located in the wp_profile_root\bin directory and modify the SET WAS_NODE=node_name entry to specify the updated node name.
5. Run the ConfigEngine.bat localize-clone -DWasPassword=password command from the wp_profile_root\ConfigEngine directory to update WebSphere Portal with the information from the IBM WebSphere Application Server configuration.
6. Run the ConfigEngine.bat action-clean-scheduled-tasks -DWasPassword=password command to clear any scheduled tasks. Existing scheduled tasks might reference the old hostname.
7. Optional: If you had an existing Windows Service set up for the WebSphere_Portal server, it will still reference the old host name and node name. If you want to continue using the Windows Service to start and stop your servers, you must re-create the services using the WASService command. See the 'WASService Command' link for information.
8. Start the WebSphere_Portal server on the virtual machine.