Deploy

Deploy an enterprise application file consists of installing an application file on a server configured to hold installable Java EE modules.

Before installing an enterprise application or other installable module on an application server, you must develop the module, assemble the module, and configure the target server or cluster. Before choosing a deployment target for the module, ensure that the target version is compatible with the module.

During installation, we can configure the module enough to enable it to run on the server. After installation, we can configure the module further, start or stop the application, and otherwise manage its activity.

The topics in this section describe how to deploy and administer applications or modules using the administrative console. We can also use scripting or administrative programs (JMX).

• Install Java EE application files on an application server.

• Edit the administrative configuration for an application.

• Optional: View the deployment descriptor for an application or module.

• Start and stop enterprise applications.

• Export enterprise applications.

• Export a file in a Java EE application or module.

• Export DDL files.

• Update a Java EE application or module.

• Uninstall enterprise applications using the console.

• (dist)(zos) Uninstall enterprise applications by removing them from a monitored directory.

• Remove a file from a Java EE application or module.

What to do next

If a changed application or module is deployed on a cluster, click Rollout Update on the Enterprise applications page to propagate the changed configuration on all cluster members of the cluster on which the application or module is deployed. Rollout Update sequentially updates the configuration on the nodes containing cluster members.

Use Rollout Update if the application is deployed on one or more clusters spread across multiple nodes. This action reduces the amount of time that any single cluster member is unavailable to serve requests to the smallest interval possible. Pending IIOP transactions will complete before a cluster member stops; in-flight HTTP and Java Message Service (JMS) transactions might be lost while the cluster member is stopping. If the administrative console session times out during a rollout updating, ensure that the changed configuration was propagated to each node. For an application server without clusters, use Update and then save and synchronize the node instead. For a stand-alone application server, simply update and save.

After making changes to administrative configurations of the applications in the administrative console, ensure that you save the changes.

Subtopics

• Enterprise (Java EE) applications
  Enterprise applications (or Java EE applications) are applications that conform to the Java EE specification. Prior to Java EE 5, the specification name was J2EE. The term Java EE includes Java EE 5 and J2EE specifications.

• Install enterprise application files
  As part of deploying an application, you install application files on a server configured to hold installable modules.

• Install enterprise application files with the console
  Installing Java EE application files consists of placing assembled enterprise application, Web, enterprise bean (EJB), or other installable modules on a server or cluster configured to hold the files. Installed files that start and run properly are considered deployed.

• Install enterprise modules with JSR-88
  We can install Java EE modules on an application server provided by a WAS product using the Java EE Application Deployment API specification (JSR-88).

• Customize modules using DConfigBeans
  We can configure JEE (Java EE) applications or stand-alone modules during deployment using the DConfigBean class in the Java EE Application Deployment API specification (JSR-88).

• Configure enterprise application files
  We can change the configuration of a Java EE application or module deployed on a server.

• View deployment descriptors
  A deployment descriptor is an extensible markup language (XML) file that specifies configuration and container options for an application or module.

• Start or stop enterprise applications
  We can start an application that is not running (has a status of Stopped) or stop an application running (has a status of Started).

• Update enterprise application files
  We can update Java EE application files deployed on a server.

• Resolve application configuration conflicts
  In a shared environment with multiple administrative users, it is possible that different administrative users might attempt concurrent updates of the same WebSphere Application Server configuration documents. The following information should help you detect and deal with any exceptions that might occur if multiple administrative users attempt to concurrently update the same configuration documents.

• Export enterprise applications
  We can export an enterprise application to a location of the choice.

• Export enterprise application files
  We can export individual files of a Java EE application or module.

• Export DDL files
  We can export DDL files in the enterprise bean (EJB) modules of an application.

• Uninstall enterprise applications using the console
  After an application no longer is needed, we can uninstall it.

• Remove enterprise files
  After a file is no longer needed, we can remove the file from a Java EE application or module deployed on a server.

• (dist)(zos) Uninstall enterprise application files by dragging them from a monitored directory
  After an application file no longer is needed, we can uninstall it by removing its EAR, WAR, JAR, or Session Initiation Protocol(SIP) archive (SAR) from a monitored directory. An enterprise application file must conform to the Java EE specification.

• Deploy and administering applications: Resources for learning
  Use the following links to find relevant supplemental information about deploying and administering applications using the administrative console. The information resides on IBM and non-IBM Internet sites, whose sponsors control the technical accuracy of the information.

Related concepts

Business-level applications

How do I develop applications?

Related tasks

Assembling applications

Administer application servers

Use wsadmin scripting

Use administrative programs (JMX)

Deploy and administering business-level applications

Enterprise application collection