Installing the Oracle Java CAPS JCA Adapters

There are three components to install for the Oracle Java CAPS JCA Adapters: design–time components in NetBeans, runtime components in GlassFish, and third-party JAR files.

Perform the following steps to install the Adapters:

• Installing the NetBeans Modules

• Installing the Runtime Components for Oracle Java CAPS JCA Adapters

• Installing Third-Party JAR Files

Installing the NetBeans Modules

This topic describes installation instructions for the NetBeans modules. A common library package (contained in the commonLib directory) is a prerequisite before installing any individual components.

Installing the Modules Pack

1. Extract the contents of the AdapterPack.zip file to a local directory.
2. To install the common library modules (NBMs) launch NetBeans.
3. Click the Tools menu and then select Plugins.
4. Click on the Downloaded tab, and then click Add Plugins.
5. Navigate to the ZipFile\AdapterPack\NetBeansModules\CommonLib directory, where ZipFile is the directory where the AdapterPack.zip file was extracted, and select all the available NBM files.

   ---

   Note - If you are installing the NBMs into a Java CAPS environment, you should only need to install com-sun-soabi-common-wizard-library.nbm. The remaining libraries should be pre-installed.

   ---

6. Right-click in the Plugins list and click Select All.
   
7. Click Install at the bottom of the window.
8. Follow the steps on the NetBeans IDE Installer. Ignore any warnings that may appear.
   
9. When the installation is complete, allow NetBeans to restart.
10. Repeat the above steps, selecting all the NBM files in ZipFile\AdapterPack\NetBeansModules directory, where ZipFile is the directory where the AdapterPack.zip file was extracted.

    This installs the necessary Wizards and tools. The image below shows the Oracle OTD Wizard as an example.

    
    

    ---

    Note - If you are installing the JCA Adapters into a Java CAPS environment, many of the NBMs in this directory are pre-installed; however, you do need to install the wizards and certain support modules. If you select all NBMs to add, the installer will only install the ones that are not already installed.

    ---

11. Restart NetBeans when the installation is complete.

Installing the Runtime Components for Oracle Java CAPS JCA Adapters

Follow the instructions below to install the required base components for Oracle Java CAPS JCA Adapters.

To Install Runtime Components

1. Stop all running GlassFish domains.
2. Extract the contents of the AdapterPack.zip file to a local directory.
3. Do the following to install the JBI core components:

   ---

   Note - You only need to perform this step if you are installing the runtime components on a GlassFish server that was not installed with Java CAPS.

   ---

   1. Download the JBI core installer from http://download.java.net/jbi/binaries/open-esb/main/nightly/latest/CORE/jbi-core-installer.jar or use the jbi-core-installer.jar file available in your GlassFish installation.
   2. Run the JBI Core Installer by executing the following command:

      java -jar jbi-core-installer.jar GlassfishHome install

      where GlassFishHome is the full path to the GlassFish directory.

4. Start the GlassFish Server.
5. In the directory where you extracted the Adapter Pack, navigate to Runtime/install and open install.properties in a text editor.
6. Modify the properties for your GlassFish installation, and then save and close the file. Be sure to uncomment the line that specifies your operating system.
7. Run the following command from GlassFishHome/bin:

   asant -f AdapterPack/Runtime/install.xml

   where AdapterPack is the directory where you extracted the Adapter Pack.

Installing Third-Party JAR Files

JCA Adapters for certain systems, such as SAP and Siebel, require that third-party JAR files be installed. The Adapter Pack provides a JAR file installer that you can access by extracting com-sun-adapters-thirdpartylib-installer.zip. The extracted files include a readme file to help you through the installation You can also find additional information and instructions at Installing Third-Party JAR Files for Oracle Java CAPS.