Applications

The following procedure describes how to use the Administration Console to set the attributes for deploying and configuring a new Enterprise Application. The deployment instructions also apply to Web services that are packaged in an .ear file or exploded .ear directory.

 

---

Overview

An enterprise J2EE application can contain Web Application, EJB, and resource adaptor components, deployment descriptors, and archive files. These components are packaged in an Enterprise Archive (EAR) file with an .ear extension, or can exist on a file system in exploded .ear format.

An EAR file contains all of the JAR, WAR, and RAR component archive files for an application and deployment descriptor that describes the bundled components. The META-INF/application.xml deployment descriptor contains an entry for each Web and EJB component, and additional entries to describe security roles and application resources such as databases.

From the WebLogic Administration Server you use the Administration Console or the weblogic.Deployer command line utility to deploy an EAR file on one or more WebLogic Server instances and clusters in a domain.

 

---

Tasks

Deploying a New Enterprise Application or Web Service

To deploy a new Enterprise Application or Web Service (archived in an .ear file or exploded .ear format) using the Administration Console:

1. Open the Deployments folder in the left pane of the Console.
2. In the left pane of the Console, right-click Applications, and select Deploy a New Application. This initiates the Enterprise Application Deployment Assistant in the right panel.
3. Use links in the Location field to select the .ear file or exploded .ear directory you would like to deploy. If the files do not reside on the Administration Server, use the upload link to upload them to the Administration Server machine.
4. When you have selected the archive file or directory to deploy, click one of the available buttons to continue:
   • Target Application—Click this button if you want to deploy all of the Enterprise Application's modules to the same servers or clusters; each selected server will deploy the full contents of the .ear.
   • Target Each Module—Click this button if you want to place individual components of the Enterprise Application—EJBs, Web applications, or resource adaptors—on different server instances in the domain.
5. If your domain contains multiple WebLogic Server instances, the Deployment Assistant displays a list of server to which you can deploy the Enterprise Application.

   Select the individual servers to which you will deploy the new application. If you want to deploy to all server instances in a cluster, select the name of the cluster and ensure that the All servers in the cluster option is chosen. Click Continue when you have selected all servers and clusters.

6. Review the selected deployment targets for the Enterprise Application. If you need to change a target server, use your browser's Back button.
7. Choose one of the available options from the Source accessibility header:
   • Copy this application onto every target for me—This option is selected by default if you targeted the application to a cluster or to multiple server instances. This corresponds to "Stage" mode where the Administration Server copies the application files to each targeted server; and the target servers then deploy the application using their copy of the files.
   • I will make the application accessible from the following location—This option is selected by default if you targeted the application to a single server instance. This corresponds to the "Nostage" mode where the server deploys an application from a single directory; all targeted servers must be able to access the directory to deploy the application.
8. Enter a unique name for the Enterprise Application in the Name field.
9. Click Deploy. The Console displays the Deploy panel, which lists deployment status and deployment activities for the Enterprise Application.
10. Use the available tabs to enter the following information as necessary:
    • Configuration—Define the general configuration of this Application.
    • Targets—Define the servers or clusters on which you would like to deploy all of the modules in this Application.
    • Deploy—View the deployment status of each module in the application, and to stop or redeploy individual modules.
    • Notes—Include any additional information that describes the configuration of this Application.

Viewing Deployed Enterprise Applications

To view a deployed Enterprise Application in the Administration Console:

1. In the Console, open the Deployments folder.
2. Click the Applications folder.
3. View the list of deployed Applications in the table displayed in the right side of the Console.

Stopping Deployed Enterprise Applications

To stop a deployed Enterprise Application:

1. In the Console, open the Deployments folder.
2. Click the Applications folder.
3. In the displayed table, click the name of the Application you wish to stop.
4. Select the Deploy tab.
5. Click Stop to stop an individual application module, or Stop All to stop all modules in the Enterprise Application.

Adding or Editing Application Deployment Notes

1. In the left pane of the Console, open the Deployments folder.
2. Under the Deployments folder, click the Applications folder. A table is displayed in the right pane of the Console showing all the deployed Applications.
3. Locate the .ear, .war, .jar, or .rar file for which you will add notes. The Application Deployment page displays in the right pane.
4. Click the Notes tab.
5. Add or edit the optional information in the Notes scroll box.
6. Click Apply.

Deleting an Application or Application Module

To delete an Application, proceed as follows:

1. In the left pane of the Console, click the Deployments folder.
2. Under the Deployments folder, click the Applications folder. A table is displayed in the right pane of the Console showing all the deployed Applications and Application Modules.
3. In this table, locate the Application you want to delete. (To delete a module of the application, click the Module link to display a table containing individual Application Modules.)
4. Click the Garbage Can icon to the right of the Application or Application Module.
5. You are asked to confirm your decision. Click Yes.
6. Click Continue to return to the previous screen.

Monitoring Enterprise Applications

To monitor active Applications in the Console, proceed as follows:

1. In the left pane of the Console, open the Deployments folder.
2. Under the Deployments folder, click the Applications folder.
3. Under the Applications folder, select the Application Module you wish to monitor.
4. In the right pane, select the Monitoring tab.
5. Use the Select Servers pull-down to select the server for which you wish to monitor active applications and application modules.
6. Click Customize This View to customize the available monitoring features. You can choose which items to monitor, determine how to sort these options, and set this view as your default view.
7. Click Apply to save your settings.