bea.com | products | dev2dev | support | askBEA

Download Docs | Site Map | Glossary
Search

Administration Console Online Help

EJB

Enterprise JavaBeans (EJB) are reusable Java components that implement business logic and enable you to develop component-based distributed business applications. EJBs reside in an EJB container, which provides a standard set of services such as persistence, security, transactions, and concurrency. Enterprise JavaBeans are the standard for defining server-side components. WebLogic Server's implementation of the Enterprise JavaBeans component architecture is based on Sun Microsystems EJB specification.

The EJB specification defines the following four types of Enterprise JavaBeans:

- Stateless session. These non-persistent EJBs provide a service without storing an interaction or conversation state between methods.

- Stateful session. These non-persistent EJBs maintain state across methods and transactions. Each instance is associated with a particular client.

- Entity. These persistent EJBs represent an object view of the data, usually rows in a database. An entity bean has a primary key as a unique identifier.

- Message-driven. These EJBs are integrated with the Java Message Service (JMS) to enable message-driven beans to act as a standard JMS message consumer and perform asynchronous processing between the server and the JMS message producer. The WebLogic Server container directly interacts with a message-driven bean by creating bean instances and passing JMS messages to those instances as necessary.

From the EJB sub-node, of the Deployments node of the Administration Console, you can update or configure EJBs deployed on WebLogic Server or monitor the their performance.

Tasks

Configuring EJBs

To configure an EJB for deployment to the WebLogic Server Administration Console:

1. Start the WebLogic Server Administration Console.

2. Select the Domain in which you will be working.

3. In the left pane of the Console, click Deployments.

4. In the left pane of the Console, click EJB. A table is displayed in the right pane of the Console showing all the deployed EJBs.

5. Select the Configure a new EJB option.

6. Locate the EAR, WAR or JAR file you would like to configure. You can also configure an exploded application or component directory. Note that WebLogic Server will deploy all components it finds in and below the specified directory.

7. Click [select] to the left of a directory or file to choose it and proceed to the next step.

8. Select a Target Server from among Available Servers.

9. Enter a name for the EJB or application in the provided field.

10. Click Configure and Deploy. The Console will display the Deploy panel, which lists deployment status and deployment activities for the EJB.

11. Using the available tabs, enter the following information:

    - Configuration—Edit the staging mode and enter the deployment order.

    - Targets—Indicate the Targets-Server for this configured EJB or application by moving the server from the Available list to the Chosen list.

    - Deploy—Deploy the EJB or application to all or selected targets or undeploy it from all or selected targets.

    - Monitoring—Enable session monitoring for the EJB or application.

    - Notes—Enter notes related to the EJB or application.

Installing New EJBs

1. Start the WebLogic Server Administration Console.

2. Select the Domain in which you will be working.

3. In the left pane of the Console, click Deployments.

4. In the left pane of the Console, click EJB. A table displays in the right pane of the Console showing all the deployed EJBs.

5. Select the Configure a new EJB option.

6. Locate the EAR, WAR or JAR file you would like to configure. You can also configure an exploded application or component directory. Note that WebLogic Server will deploy all components it finds in and below the specified directory.

7. Click [select] to the left of a directory or file to choose desired file and proceed to the next step.

8. Select a Target Server from among Available Servers.

9. Enter a name for the EJB or application in the provided field.

10. Click Configure and Deploy to install the EJB or application. The Console will display the Deploy panel, which lists deployment status and deployment activities for the EJB.

11. Using the available tabs, enter the following information:

    - Configuration—Edit the staging mode and enter the deployment order.

    - Targets—Indicate the Targets-Server for this configured EJB or application by moving the server from the Available list to the Chosen list.

    - Deploy—Deploy the EJB or application to all or selected targets or undeploy it from all or selected targets.

    - Monitoring—Enable session monitoring for the EJB or application.

    - Notes—Enter notes related to the EJB or application.

Configuring EJB General Options

1. Click the Deployments node in the left pane and then choose the EJB sub-node. A list of EJBs deployed on your domain displays under EJB and in the right pane.

2. Click the Configure a New EJB option in the right pane to create a new EJB or choose an existing EJB from the list to modifying its existing configuration. The EJB Deployments page displays in the right pane.

3. Select the Configuration tab.

4. Select the General tab.

5. Enter the name of the EJB.

6. Enter the path to be used for this component.

7. Enter the deployment for this component.

8. Check the box to indicate whether the component is to be deployed on the target.

9. Click Create to configure the General options or Apply to modify options already specified for an existing EJB component.

Configuring EJBC Options

1. Click the Deployments node in the left pane and then choose the EJB sub-node. A list of EJBs deployed on your domain displays under EJB and in the right pane.

2. Click the Configure a New EJB option in the right pane to create a new EJB or choose an existing EJB from the list to modifying its existing configuration. The EJB Deployments page displays in the right pane.

3. Select the Configuration tab.

4. Select the EJBC Options tab.

5. Enter the Java compiler to be used for the component.

6. Enter the path used for this component.

7. Enter any extra RMIC options to be used.

8. Check the box to enables or disables the ability to keep generated source files

9. Click Create to configure the EJBC Options or Apply to modify options already specified for an existing EJB component.

Setting the EJB's Target Server

1. Click the Deployments node in the left pane and then choose the EJB sub-node. A list of EJBs deployed on your domain displays under EJB and in the right pane.

2. Click the Configure a New EJB option in the right pane to create a new EJB or choose an existing EJB from the list to modifying its existing configuration. The EJB Deployments page displays in the right pane.

3. Before setting the target server, configure new EJBs using instructions in Configuring EJBs.

4. Click the Targets tab in the right pane.

5. Click the Servers tab.

6. Click the arrow to move the name of the target server from the Available box to the Chosen box.

7. Click Apply.

Setting the EJB's Target Cluster

1. Click the Deployments node in the left pane and then choose the EJB sub-node. A list of EJBs deployed on your domain displays under EJB and in the right pane.

2. Click the Configure a New EJB option in the right pane to create a new EJB or choose an existing EJB from the list to modifying its existing configuration. The EJB Deployments page displays in the right pane.

3. Before setting the target cluster, configure new EJBs using instructions in Configuring EJBs.

4. Click the Targets tab in the right pane.

5. Click the Clusters tab.

6. Click the arrow to move the name of the target cluster from the Available box to the Chosen box.

7. Click Apply.

Monitoring Stateless Session EJBs

To monitor applications containing stateless session EJBs:

1. Click the Deployments node in the left pane and then choose the EJB sub-node. A list of EJBs deployed on your domain displays under EJB and in the right pane.

2. Click the name of the deployed EJB or application that you want to monitor. The EJB Deployment page displays in the right pane.

3. Click the Monitoring tab.

4. Click Monitoring All Stateless EJBRuntimes for the application that you want to monitors. A table listing all stateless session EJBs in the application displays in the right pane.

5. View the statistics for each stateless session EJBs.

Monitoring Stateful Session EJBs

To monitor applications containing stateful session EJBs:

1. Click the Deployments node in the left pane and then choose the EJB sub-node. A list of EJBs deployed on your domain displays under EJB and in the right pane.

2. Click the name of the deployed EJB or application that you want to monitor. The EJB Deployment page displays in the right pane.

3. Click the Monitoring tab.

4. Click Monitoring All Stateful EJBRuntimes for the application that you want to monitors. A table listing all stateful session EJBs in the application displays in the right pane.

5. View the statistics for each stateful session EJBs.

Monitoring Entity EJBs

To monitor applications containing entity EJBs:

1. Click the Deployments node in the left pane and then choose the EJB sub-node. A list of EJBs deployed on your domain displays under EJB and in the right pane.

2. Click the name of the deployed EJB or application that you want to monitor. The EJB Deployment page displays in the right pane.

3. Click the Monitoring tab.

4. Click Monitoring All Entity EJBRuntimes for the application that you want to monitors. A table listing all entity EJBs in the application displays in the right pane.

5. View the statistics for each entity EJBs.

Monitoring Message-Driven EJBs

To monitor applications containing message-driven EJBs:

1. Click the Deployments node in the left pane and then choose the EJB sub-node. A list of EJBs deployed on your domain displays under EJB and in the right pane.

2. Click the name of the deployed EJB or application that you want to monitor. The EJB Deployment page displays in the right pane.

3. Click the Monitoring tab.

4. Click Monitoring All Message Driven EJBRuntimes for the application that you want to monitors. A table listing all message-driven EJBs in the application displays in the right pane.

5. View the statistics for each message-driven EJBs.

Deploying EJBs

1. Expand the Deployments node in the left pane.

2. Right-click on the EJB node.

3. Select Configure a new EJB.

4. Locate the .war file you would like to configure. You can also configure an exploded application or component directory. Click [select] to the left of a directory or file to choose it and proceed to the next step.

5. Select a Target Server from among Available Servers.

6. Enter a name for the EJB or application in the provided field.

7. Click Configure and Deploy. The Console will display the Deploy panel, which lists deployment status and deployment activities for the EJB or application.

8. Use the Deploy button to deploy the application to all or selected targets or undeploy it from all or selected targets.

Deploying EJBs to a Target Server

1. Click the Servers node in the left pane.

2. Click the server instance to which you want to deploy the EJBs. The Servers page for the selected server instance displays in the right pane.

3. Click the Deployments tab.

4. Click the EJB tab.

5. Chose the EJBs for this server instance by moving the deployment units from the Available box to the Chosen box.

6. Click Apply

UnDeploying EJBs

1. Click the name of the EJB or application you want to undeploy from the list of EJBs in the left pane.

2. Click the Targets tab in the right pane.

3. Click the Servers tab.

4. Click the arrow to move the name of the target server from the Chosen box to the Available box.

5. Click Apply to undeploy the EJB or application.

Adding or Editing EJB Deployment Notes

1. Click the Deployments node in the left pane and then choose the EJB sub-node. A list of EJBs deployed on your domain displays under EJB and in the right pane.

2. Click the name of the deployed EJB or application for which you want to add notes. The EJB Deployment page displays in the right pane.

3. Click the Notes tab.

4. Add or edit the optional information in the Notes scroll box.

5. Click the Create button to enter the information or the Apply button to update the information.