Managing the WebLogic J2EE Connector Architecture
Based on the Sun Microsystems J2EE Connector Specification, Version 1.0, Proposed Final Draft 2, the WebLogic J2EE Connector Architecture integrates the J2EE Platform with one or more heterogeneous Enterprise Information Systems (EIS). The following sections explain how to manage and administer the WebLogic J2EE Connector Architecture:
For more information on the BEA WebLogic J2EE Connector Architecture, refer to Programming the WebLogic J2EE Connector Architecture.
Overview of WebLogic J2EE Connector Architecture
BEA WebLogic Server continues to build upon the implementation of the Sun Microsystems J2EE Platform Specification, Version 1.3. The J2EE Connector Architecture adds simplified Enterprise Information System (EIS) integration to the J2EE platform. The goal is to leverage the strengths of the J2EE platform—including component models, and transaction and security infrastructures—to address the challenges of EIS integration.
The J2EE Connector Architecture provides a Java solution to the problem of connectivity between the multitude of application servers and EISes. By using the J2EE Connector Architecture, it is no longer necessary for EIS vendors to customize their product for each application server. An application server vendor (such as BEA WebLogic Server) that conforms to the J2EE Connector Architecture also does not need to add custom code whenever it wants to extend its application server to support connectivity to a new EIS.
The J2EE Connector Architecture enables an EIS vendor to provide a standard resource adapter (also referred to as a connector) for its EIS; the resource adapter plugs into an application server such as WebLogic Server and provides the underlying infrastructure for the integration between an EIS and the application server.
An application server vendor (BEA WebLogic Server) extends its system only once to support the J2EE Connector Architecture and is then assured of connectivity to multiple EISes. Likewise, an EIS vendor provides one standard resource adapter and it has the capability to plug in to any application server that supports the J2EE Connector Architecture.
Installing a New Resource Adapter
This section discusses how to connect a new connector (resource adapter) to WebLogic Server by using the Administration Console.
Configuring and Deploying a New Connector
This section discusses how to configure and deploy a new connector using the Administration Console.
For more deployment-related information, see Chapter 3, "Resource Adapters," in Programming the WebLogic J2EE Connector Architecture.
Configuring and Deploying Resource Adapters
To configure and deploy a connector using the WebLogic Server Administration Console:
Viewing Deployed Resource Adapters
To view a deployed connector in the Administration Console:
Undeploying Deployed Resource Adapters
To undeploy a deployed connector from the WebLogic Server Administration Console:
Undeploying a resource adapter does not remove the resource adapter name from WebLogic Server. The resource adapter remains undeployed for the duration of the Server session, as long as you do not change it once it has been undeployed. You cannot reuse the deployment name with the deploy argument until you reboot the server. You can re-use the deployment name to update the deployment, as described in Updating Deployed Resource Adapters.
Updating Deployed Resource Adapters
When you update the contents of the resource adapter .rar file or deployment directory that has been deployed to WebLogic Server, those updates are not reflected in WebLogic Server until:
From the WebLogic Server Administration Console:
To monitor all connection pool run times for a connector, proceed as follows:
Connection pool run-time information is provided in the right pane for the selected connector.
Note: You can also select access the this information using the right pane of the Console. Select the specific connector that you want to monitor in the table of connectors located in the right pane. Then, select the Monitoring tab and select Monitor all Connector..."
Deleting a Connector
To delete a connector, proceed as follows:
The following message is displayed in the right pane:
Are you sure you want to permanently delete <Connector Name> from the domain configuration?
Editing Resource Adapter Deployment Descriptors
This section describes the procedure for editing the following resource adapter (connector) deployment descriptors using the Administration Console Deployment Descriptor Editor:
For detailed information about the elements in the resource adapter deployment descriptors, refer to Programming the WebLogic J2EE Connector Architecture.
To edit the resource adapter deployment descriptors, follow these steps:
where host refers to the name of the computer upon which WebLogic Server is running and port refers to the port number to which it is listening.
The Administration Console window appears in a new browser. The left pane contains a tree structure that lists all the elements in the two resource adapter deployment descriptors and the right pane contains a form for the descriptive elements of the ra.xml file.
Copyright © 2001 BEA Systems, Inc. All rights reserved.