Troubleshooting deployment

When you are having problems deploying an application, perform some basic diagnostics and verify the system configuration to solve the problem.

Try to install the application on a product server or cluster. Ensure that the application can be installed to the deployment target. For example, if the application contains modules that support JEE (Java EE) 6 or use a Version 8.0 product feature or API, install the application to a Version 8.0 or later deployment target.

Determine which of the following steps apply to the deployment problem and read the suggested topics.

• If we cannot install the application, troubleshoot problems deploying applications.

  See the topics on application deployment problems and troubleshooting tips.

• If we can install the application but it does not start, troubleshoot problems starting applications.

  See the topics on application deployment and startup problems.

• If the application contains many classes with annotations and takes a long time to deploy, reduce annotation searches to speed up deployment.

  See the topic on reducing annotation searches during application deployment.

• If we cannot uninstall the application, see the topic on application uninstallation problems.

What to do next

If the topics in this information center do not resolve the deployment problem, examine current information available from IBM Support on known problems and their resolution. IBM Support has documents that can save you time gathering information needed to resolve this problem. Before opening a PMR, see topic on troubleshooting help from IBM.

Subtopics

• Application deployment problems
  We might encounter problems when deploying, installing, or promoting applications. This topic suggests ways to resolve the problems.

• Application deployment troubleshooting tips
  When you first test or run a deployed application, you might encounter problems.

• Application startup errors
  Use this information for troubleshooting problems that occur when starting an application.

• Application startup problems
  When an application is not starting or starting with errors, the problem could be from one of various sources.

• Reducing annotation searches during application deployment
  Enterprise applications containing many classes and are enabled for annotations processing (are not marked as "metadata-complete") take extra time to deploy. Extra time is necessary to scan application binaries for annotations that were introduced by Java EE 5. If there are no additional options to limit which classes are scanned, when scanning is enabled for a module all classes in the module must be scanned. A scan of all classes is necessary even when only a small subset of classes within a given module has annotations.

• A client program does not work
  

• Web resource is not displayed
  Use this information to troubleshoot problems that occur when attempting to display a resource in a browser.

• Application uninstallation problems
  When you try to uninstall an application or node, you might encounter problems. This topic suggests ways to resolve uninstallation problems.

Related concepts

Installable enterprise module versions

Troubleshooting help from IBM

Related tasks

Troubleshooting web services

Application deployment troubleshooting tips