Skip navigation.
Downloads | Product Documentation | Support

Administration Console Online Help

# Enterprise Applications

[Attributes and Console Screen Reference for Applications]

# Overview

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

An EAR file contains all 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.

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

## Configuring and Deploying a New Enterprise Application or Web Service

The following procedure describes how to use the Administration Console to set the attributes for deploying and configuring a new Enterprise Application. For additional information about configuring and deploying Web Services, refer to Web Services.

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

1. In the left pane of the Console, expand the Deployments folder, right-click Applications, and select Deploy a New Application. This initiates the Deployment Assistant in the right panel.
2. Using the Deployment Assistant, locate the EAR file you would like to configure for use with WebLogic Server. You can also configure an "exploded" Enterprise Application or component directory. Note that WebLogic Server will deploy all components it finds in and below the specified directory.
3. When you have located the archive file to configure, click Target Application.
4. If you have more than one server or cluster in your domain, select the one on which you want to deploy your new Enterprise Application and click Continue. If you have just one server in your domain, go to the next step.
5. Enter a name for the Enterprise Application in the Name field.

If you have more than one server or cluster in your domain, click whether you want to copy the file to each server.

6. Click Deploy. The Console will display the Deploy panel, which lists deployment status and deployment activities for the Enterprise Application.
7. Using the available tabs, enter the following information:

- Configuration—Define the general configuration of this Enterprise Application.
- Targets—Define the servers or clusters on which you would like to deploy all of the modules in this Enterprise Application.
- Deploy—View the deployment status of each module in the Enterprise Application, and to undeploy or redeploy individual modules.
- Notes—Include any additional information that describes the configuration of this Enterprise Application.

8. Click Apply.

## Viewing Deployed Enterprise Applications

To view a deployed Enterprise Application in the Administration Console:

1. In the left pane of the Console, expand the Deployments folder and click on the folder name Applications.
2. Use the links in the table to view information about the deployed applications.

## Stopping Deployed Enterprise Applications

Stopping an Enterprise Application makes the application unavailable to WebLogic Server clients. Stopping an application does not remove the deployment files from the server; you can later redeploy a stopped application by clicking its redeploy button in the Administration Console.

To stop a deployed Enterprise Application:

1. In the left pane of the Console, expand Deployments and click on the folder name Applications.
2. In the displayed table, click the name of the Application you wish to stop.
3. On the Deploy tab, click Stop to stop an individual application module, or Stop All to stop all modules in the Enterprise Application.

## Adding or Editing Enterprise Application Deployment Notes

1. In the left pane of the Console, expand Deployments and click on the folder name Applications. A table displays all deployed Applications.
2. Click the name of the .ear file for which you will add notes. The Deploy tab displays in the right pane.
3. Select the Notes tab.
4. Add or edit the optional information in the Notes scroll box.
5. Click Apply.

## Deleting an Enterprise Application or Application Module

To delete an Enterprise Application, proceed as follows:

1. In the left pane of the Console, expand Deployments and click the folder name Application. A table displays all deployed Enterprise Applications and Application Modules.
2. In this table, locate the Enterprise Application you want to delete. (To delete a module of the application, click the Module link to display a table containing individual Application Modules.)
3. Click the Garbage Can icon to the far right of the Enterprise Application or Application Module.
4. Click Yes to confirm your decision.
5. 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, expand Deployments and click the folder name Applications.
2. Under the Modules column, click the link for the application you wish to monitor
3. Click the name of the module you wish to monitor.
4. 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.

## Viewing and Updating Run-Time Deployment Descriptors

This release of WebLogic Server deprecates the Administration Console Deployment Descriptor Editor and replaces it with a new Descriptor tab. Using the Descriptor tab, you can view, modify, and persist deployment certain descriptor elements to the descriptor file within an exploded Enterprise Application in the same manner that they were persisted using the Deployment Descriptor Editor.

These descriptor elements are engaged dynamically at runtime without requiring the Application to be redeployed. The descriptor elements contained in the Descriptor tab are limited to only those descriptor elements that may be dynamically changed at runtime.

The Administration Console allows you to modify these deployment descriptor elements and their attributes for applications that are deployed as exploded archive files. (You cannot edit these descriptors for applications packaged as `.EAR` archives.) If you alter the value of any of these elements and select Apply, then the Application deployment descriptor file is updated and deployed to all of the appropriate server machines.

To view and edit descriptor information in the Console:

1. In the left pane of the Console, expand Deployments and click the Applications folder name.
2. Click on the name of the application in the Name column.
3. Select the Configuration tab followed by the Descriptor tab.
4. Click on a deployment descriptor link and define the configuration of the deployment descriptor file that is associated with this Application module by changing the provided attribute values as needed.