Administration and administrative console troubleshooting tips

In WAS products, administrative functions are supported by:

  • The application server (such as server1) process

  • The deployment manager (dmgr) process in the Network Deployment product

The process must be running to use the administrative console. The wsadmin command line utility has a local mode that use to perform some administrative functions, even when the server process is not running.

When starting or stopping a server using a wsadmin interactive scripting session, you receive an exception indicating read timed out, for example

WASX7015E: Exception running command: "$AdminControl startServer server1 Node1"; 
exception information:  com.ibm.websphere.management.exception.ConnectorException 
org.apache.soap.SOAPException: [SOAPException: faultCode=SOAP-ENV:Client; msg=Read 
timed out; targetException=java.net.SocketTimeoutException: Read timed out]
This exception occurs because the timeout value is too small. To fix this, increase the timeout value specified by the com.ibm.SOAP.requestTimeout property in the soap.client.props file in the install_root/profiles/profile/properties directory for a single server edition or in the install_root/profiles/profile/properties directory for a network deployment installation. The value you should choose depends on a number of factors such as the size and the number of the applications installed on the server, the speed of your machine, and the level of usage of your machine. The default value of the com.ibm.SOAP.requestTimeout property is 180 seconds.

If you have problems starting or using the administrative console or wsadmin utility, verify that the supporting server process is started and that it is healthy.

  • For the application server process, look at these files:

    • install_root/profiles/profile/logs/servername/startServer.log for the message that indicates that the server started successfully: ADMU3000I: Server server1 open for e-business; process id is nnnn..

    • install_root/profiles/profile/logs/servername/SystemOut.log for the message that indicates that the server started successfully: WSVR0001I: Server server open for e-business.

  • For the Network Deployment product, look at these files:

    • install_root/profiles/profile/logs/dmgr/startServer.log for the message that indicates that the server started successfully: ADMU3000I: Server dmgr open for e-business; process id is nnnn..

    • install_root/profiles/profile/logs/dmgr/SystemOut.log for the message that indicates that the server started successfully: ADMU3000I: Server dmgr open for e-business; process id is nnnn.

  • Look up any error messages in these files in the message reference table. Select the Reference view in the information center navigation, then click Messages.

  • A message like WASX7213I: This scripting client is not connected to a server process when trying to start wsadmin indicates that either the server process is not running, the host machine where it is running is not accessible, or that the port or server name used by wsadmin is incorrect.

  • Verify that you are using the right port number to communicate with the administrative console or wsadmin server using the following steps:

    • Look in the SystemOut.log file.

    • The line ADMC0013I: SOAP connector available at port nnnn indicates the port that the server is using to listen for wsadmin functions.

    • The property com.ibm.ws.scripting.port in the install_root/profiles/profile/properties/wsadmin.properties file controls the port used by wsadmin to send requests to the server. If it is different from the value shown in the SystemOut.log file , either change the port number in the wsadmin.properties file, or specify the correct port number when starting wsadmin by using the -port port_number property on the command line.

    • The message SRVE0171I: Transport http is listening on port nnnn (default 9060) indicates the port the server uses to listen for administrative console requests. If it is different than the one specified in the URL for the administrative console, change the URL in the browser to the correct value. The default value is http://localhost:9060/ibm/console.

  • Use the telnet command to test that the host name where the application server or deployment manager is running, is reachable from the system where the browser or wsadmin program are being used. If you are able to ping the host name, this indicates that there are no firewall or connectivity issues.

  • If the host where the application server or deployment manager is running is remote to the machine from which the client browser or wsadmin command is running, ensure that the appropriate host name parameter is correct:

  • Tracing the administrative component: WebSphere Application Server technical support might ask you to trace the administrative component for detailed problem determination. The trace specification for this component is com.ibm.websphere.management.*=all=enabled:com.ibm.ws.management.*=all=enabled"

If none of these steps solves the problem, see if the specific problem you are having is addressed in the Installation completes but the administrative console does not start topic. Check to see if the problem has been identified and documented using the links in the Diagnosing and fixing problems: Resources for learning topic. If you do not see a problem that resembles yours, or if the information provided does not solve your problem, contact IBM support for further assistance.

For current information available from IBM Support on known problems and their resolution, see the following topics on the IBM support page:

IBM Support has documents that can save you time gathering information needed to resolve this problem. Before opening a PMR, see the following topics on information gathering on the IBM support page:


 

Related Tasks


Troubleshooting by task

 

See Also


Troubleshooting installation problems