Creating and Using Custom Java EE Connector Architecture Adapters - Setup

This is the companion installation guide to "Creating and Using Custom Java EE Connector Architecture Adapters", by Ronald van Luttikhuizen.


Runtime Environment

You can choose either Oracle WebLogic Server 9.2 or Oracle Application Server as the runtime platform for Oracle SOA Suite in this tutorial. This guide provides installation and configuration instructions for both platforms. Project sources are also available for both environments.

The following runtime platforms require a separate installation of Oracle Database that acts as the dehydration store:

  • Oracle SOA Suite installation on Oracle WebLogic running on any supported OS
  • Oracle SOA Suite installation on Oracle Application Server running on any non-Windows OS
  • Advanced Oracle SOA Suite installation on Oracle Application Server running on Microsoft Windows
A basic SOA Suite installation on Windows includes Oracle Lite as the dehydration store.

Installing Oracle Database

Read this section if a separate Oracle Database installation is required. Otherwise proceed to the application server installation and configuration instructions for the appropriate application server: Oracle WebLogic Server 9.2 or Oracle Application Server.

Install either Oracle Database 10g Release 2 (10.2.0.1) or later or Oracle Database 10g XE or later. These products, with installation and configuration instructions, are available at the Oracle Database download page.

Installing Oracle SOA Suite on Oracle WebLogic Server 9.2

The current release of Oracle SOA Suite 10g (10.1.3.4) is certified for Oracle WebLogic Server 9.2 MP 3. The (future at the time of writing) release of Oracle SOA Suite 10g (10.1.3.5) will most likely be certified for Oracle WebLogic Server 10.3.

  1. Download and install Oracle WebLogic Server 9.2 MP 3. This product, with installation and configuration instructions, is available at the Oracle WebLogic Server download page.
  2. Download and install Oracle SOA Suite 10g (10.1.3.3) or later for WebLogic . This product is available at the Oracle SOA Suite download page. Installation and configuration instructions are available at the Oracle Application Server Documentation Library page. This page includes the Oracle SOA Suite for BEA WebLogic Server Installation Guide.

Installing Oracle SOA Suite 10g on Oracle Application Server 10g

Alternatively, Oracle Application Server 10g can be used as the runtime platform for Oracle SOA Suite 10g (10.1.3.3) or later. These products, with installation and configuration instructions, are available at the Oracle SOA Suite download page. Note the SOA application Oracle Application Server Containers for Java Platform, Enterprise Edition (OC4J) instance name specified by the installer, because you will need it in the next step when configuring an Oracle Application Server connection.


Design Time Environment

Oracle JDeveloper 10g (10.1.3.3) or later is used as the design time environment. Additionally, JDeveloper 11g can be used to develop, deploy, run, and test the JCA resource adapter on its integrated Oracle WebLogic 10.3 Server. This guide provides installation and configuration instructions for both design time environments. Project sources are also available for both environments.

Installing Oracle JDeveloper 10g

Install Oracle JDeveloper 10g Release 3 (10.1.3.4) or later. This product, with installation and configuration instructions, is available at the Oracle JDeveloper download page.

Configuring Oracle JDeveloper 10g for Oracle SOA Suite 10g on Oracle WebLogic 9.2

  1. Copy weblogic.jar from the server/lib directory of your Oracle WebLogic 9.2 installation directory to the jdev/lib/ext directory of your JDeveloper installation directory. This library contains the Java classes that are needed to create an Application Server connection in Oracle JDeveloper to Oracle WebLogic Server. Note that this step is needed even when selecting the correct path to weblogic.jar in Step 3i.
  2. Restart JDeveloper if it was already started.
  3. In Oracle JDeveloper 10g, set up an Oracle WebLogic Server connection to the newly installed Oracle SOA Suite components. Open the Connections Navigator tab, and double-click Application Server to launch the Create Application Server Connection wizard. Use the following settings:
    1. Step 1: Connection Name: OWL_SOA_Suite_10g
    2. Step 1: Connection Type: WebLogic Server 9.x
    3. Step 2: Username: weblogic
    4. Step 2: Password: weblogic password entered during the Oracle WebLogic Server installation
    5. Step 2: Select Deploy Password
    6. Step 3: Host Name: host on which your Oracle WebLogic Server is running. Example: localhost
    7. Step 3: Port: port number of the WebLogic server port on which your J2EE applications (.jar, .war, .ear) are deployed. If no port is entered, the port number defaults to 7001.
    8. Step 3: Target Node: Configure this setting only if your WebLogic application server is configured to distinguish non-administrative server nodes by name. You can enter a target node as a comma-separated list of nodes if multiple server nodes (starting with a single admin node) are intended to receive the deployed EJBs. The WebLogic server installation defaults with a single backend node named "myserver" and a listen port of "7001", which are also the defaults on this dialog.
    9. Step 3: Path to weblogic.jar containing WebLogic Client: Enter the fully qualified name for the directory location of the client-side WebLogic instance named weblogic.jar. For example, D:\Oracle\weblogic92
    10. Step 4: Test Connection: should return Success

  4. In Oracle JDeveloper, set up an Oracle Integration Server connection to the newly installed Oracle SOA Suite components. Open the Connections Navigator tab, and double-click Integration Server to launch the Create Integration Server Connection wizard. Use the following settings:
    1. Step 1: Connection Name: IS_SOA_Suite_10g
    2. Step 2: Application Server: select the Application Server connection OWL_SOA_Suite_10g created in the previous step.
    3. Step 2: Host Name: host on which your Oracle Application Server is running; for example, localhost
    4. Step 2: Port Number: HTTP port; for example, 9700 (default when installed according to the Oracle SOA Suite for BEA WebLogic Server Installation Guide).
    5. Step 2: Select Add host name to the list of proxy exceptions if you use a proxy.
    6. Step 3: Test Connection: should return OK for Oracle Application Server, Oracle BPEL Process Manager Server, and Oracle ESB Server.

Configuring Oracle JDeveloper 10g for Oracle SOA Suite 10g on Oracle Application Server 10g

  1. In Oracle JDeveloper 10g, set up an Oracle Application Server connection to the newly installed Oracle SOA Suite components. Open the Connections Navigator tab, and double-click Application Server to launch the Create Application Server Connection wizard. Use the following settings:
    1. Step 1: Connection Name: OAS_SOA_Suite_10g
    2. Step 1: Connection Type: Oracle Application Server 10g 10.1.3
    3. Step 2: Username: oc4jadmin
    4. Step 2: Password: oc4jadmin password entered during the Oracle SOA Suite installation
    5. Step 2: Select Deploy Password
    6. Step 3: Connect To: Single Instance
    7. Step 3: Host Name: host on which your Oracle Application Server is running . Example: localhost
    8. Step 3: OPMN Port: OPMN request port, for example: 6004. Log in to Oracle Application Server Enterprise Manager and navigate to Cluster TopologyRuntime PortsOPMNRequest to see its value.
    9. Step 3: OC4J Instance Name: name of the OC4J container in which Oracle SOA Suite is installed. For a basic install, this is home; the default for an advanced installation is oc4j_soa. This might, however, be different from what you've chosen.
    10. Step 4: Test Connection: should return Success.

  2. In Oracle JDeveloper, set up an Oracle Integration Server connection to the newly installed Oracle SOA Suite components. Open the Connections Navigator tab, and double-click Integration Server to launch the Create Integration Server Connection wizard. Use the following settings:
    1. Step 1: Connection Name: IS_SOA_Suite_10g
    2. Step 2: Application Server: select the Application Server connection OAS_SOA_Suite_10g created in the previous step.
    3. Step 2: Host Name: host on which your Oracle Application Server is running. Example: localhost
    4. Step 2: Port Number: HTTP port, for example: 80. Log in to Oracle Application Server Enterprise Manager and navigate to Cluster Topology → Runtime Ports → OC4J → HTTP to see its value.
    5. Step 2: Select Add host name to the list of proxy exceptions if you use a proxy.
    6. Step 3: Test Connection: should return OK for Oracle Application Server, Oracle BPEL Process Manager Server, and Oracle ESB Server.

Installing JDeveloper 11g

As an alternative to JDeveloper 10g—and only to implement, deploy, and test the JCA resource adapter itself—JDeveloper 11g and its integrated Oracle WebLogic 10.3 Server can be used. This product, with installation and configuration instructions, is available at the Oracle JDeveloper download page.

Additional Tooling

Install Java Apache Mail Enterprise Server (JAMES) 2.3.1 or later. This product is available at the Apache JAMES Project download page. Installation and configuration instructions can be found on the Apache JAMES Project Wiki.

Create the mail user jca@localhost. The Apache JAMES Project Wiki explains how to do this.


Back to article