Limitation on the workbench to work with a WebSphere Application Server that changed its host name
Important: Applicable to WebSphere®
Application Server traditional
After a change in the host name of the server, this product
might fail to work properly with the server in any of the following
manners:
- If you start the server by using the workbench, the server status in the Servers view does not go beyond Starting. However, the server is started.
- If you start the server outside the development environment, for example by usingstartServer.bat (in Linux, startServer.sh) or wsadmin script, the workbench cannot connect to the server and the server status in the Servers view is Stopped.
- If the server is started and the server status in the Servers view is Started, the output in the Console view is not available.
To update server configuration
files with the changes in the host name of the server:
- On the machine where the host name is changed, start the server.
- After the server is started, open the administrative console.
- Open a web browser with the following address: http://<machine_name>:<WC_adminhost>/ibm/console, where the machine_name is the host name or IP address of the machine where the server is running and WC_adminhost is the value of WC_adminhost port. You can find the value of the WC_adminhost port in the serverindex.xml file available in the <WAS_install_directory>\profiles\<profileName>\config\cells\<cellName>\nodes\<nodeName> directory, where WAS_install_directory is the installation directory of the WebSphere Application Server.
- Log in to the administrative console.
- On the administrative console, select Server > Application servers.
- On the administrative console, verify that the Configuration tab is open.
- Under the Communications section, select the Ports link.
- The Host column shows the current host name setting for the server.
- Change all occurrences of the old machine name to the new fully
qualified host name (or 127.0.0.1).Tip: If you use the IP address, 127.0.0.1, instead of the fully qualified host name, some functions on the server might not function; for example, when you try to do a JNDI lookup from a remote machine by using this server.
- Under the Port name column, click the port_name link that requires an update of the host name.
- In the Host field, specify the new fully qualified host name.
- Apply and save your changes in the administrative console.