[AIX Solaris HP-UX Linux Windows]

Application Server start or restart problems

If a server process does not start or starts with errors, the following topics might help you to diagnose the problem.

Installation program completes successfully, but an application server does not start, or starts with errors

Tip: This topic references one or more of the application server log files. As a recommended alternative, you can configure the server to use the High Performance Extensible Logging (HPEL) log and trace infrastructure instead of using SystemOut.log , SystemErr.log, trace.log, and activity.log files on distributed and IBM® i systems. You can also use HPEL in conjunction with your native z/OS® logging facilities. If you are using HPEL, you can access all of your log and trace information using the LogViewer command-line tool from your server profile bin directory. See the information about using HPEL to troubleshoot applications for more information on using HPEL.
  • Browse the Application Server log files for clues. The log files are located by default in:
    • [AIX HP-UX Solaris][Linux]profile_root/logs/server_name/SystemErr.log and SystemOut.log
    • [Windows]profile_root\logs\server_name\SystemErr.log and SystemOut.log
    Several applications deployed on an application server or node can take time to start. Browse the SystemOut.log periodically and look at the most recent updates to see if the server is still starting up.
  • [AIX HP-UX Solaris][Linux]The tail -f profile_root/ logs/server_name/SystemOut.log command is a convenient way to watch the progress of the server.
  • Look for any errors or warnings relating to specific resources with the module, such as web modules, enterprise beans and messaging resources. If you find any, examine the application server configuration file for the configuration settings of that resource. Then restart the server to see if this component causes the problem.

    [AIX Solaris HP-UX Linux Windows]For example, in a base or non-distributed configuration on Windows systems, browse profile_root\config\cells/ApplicationServerCell\nodes\node_name\servers\server_name\server.xml, and examine the XML tags for the properties of that resource. Change its initialState value from START to STOP.

  • Look up any error or warning messages in the message reference table by clicking the Reference view of the documentation navigation and expanding Messages in the navigation tree.
  • After you create an application server, you must synchronize the nodes before saving the configuration settings for the new server. If you do not synchronize the nodes, your new server might not start.
    1. On the Applications server page listing all of your application server, click Preferences.
    2. Select Synchronize changes with Nodes, if it is not already selected.
    3. Click Apply and then click Application servers to return to your list of application servers.
    4. Click Save to save the configuration settings for the new server.
  • Verify that the logical name that you specified to appear on the console for your application server does not contain invalid characters like: - / \ : * ? " < > and leading or trailing spaces.
  • If you are using Apache Derby and receive an ERROR XSDB6: Another instance of Apache Derby might have already booted the database databaseName error when starting the application server, consult the topic Data access problems for more information.
  • [AIX Solaris HP-UX Linux Windows]When using a non-root user ID to run application servers, verify that:
    • The non-root user has write access to the app_server_root/temp directory.
    • The JVM has write access to app_server_root/config/plugin-cfg.xml file.
    • The non-root user has access to the logs directory.
  • The application server might not start in the restricted mode. You can configure an application server to allow or restrict access to internal server classes. The default is to allow access. If access is restricted, the server might not start. If the application server does not start in Restrict mode, change the access to internal classes to Allow.

An error message might appear in the SystemOut.log after restarting an application server

The following error message might appear in the SystemOut.log after restarting an application server:
The socket bind failed for host hostname and port portnumber.  The port may already be in use.

This problem might occur if the network is slow, and the port listed in the message text did not finish listening when the application was stopped and restarted.

To verify that this is the problem, check the port status.

To correct this problem, wait for a few minutes after stopping the server:
  1. [AIX Solaris HP-UX Linux Windows]Verify that no ports are listening. Use the command:
    netstat -a 
  2. Restart the server

Message "DiscoveryService.sendQuery" exception appears in the FFDC log file

When you start a deployment manager, the deployment manager attempts to discover any configured node agents within its cell. If the deployment agent does not discover the node agents in the cell, it writes an exception to the first failure data capture (FFDC) log file for each node agents that the deployment manager does not discover. If the node agents are not suppose to be running, you can ignore the exception. If the node agents are suppose to be running, the FFDC log file might contain additional information that will help you determine why the deployment manager cannot discover the node agents even though the node agents are suppose to be running.

IBM Support has documents and tools that can save you time gathering information needed to resolve problems. Before opening a problem report, see the product Support page: https://www.ibm.com/mysupport/s/topic/0TO500000001DQQGA2/websphere-application-server.