Java CAPS Domain and Runtime Installation

Installing Java CAPS JBI Components on a New Domain

After you install the Java CAPS runtime on your new domain, you can install the JBI components, which includes shared libraries, Service Engines, Binding Components, and so on. These components are all installed individually. The components to install are located in appserver/addons/jbi-components. Install the shared libraries first.

You can install the JBI components using any one or a combination of the following methods:

ProcedureTo Install JBI Components on a New Domain From the Admin Console

Before You Begin

Complete the steps under Adding the New Domain to NetBeans.

  1. Launch the GlassFish Admin Console.

  2. In the navigation panel on the left, expand JBI.

  3. To install the shared libraries, do the following:


    Note –

    Shared libraries must be installed first.


    1. Under JBI, select Shared Libraries.

    2. In the JBI Shared Libraries table, click Install.

    3. Browse to the location of the shared libraries (JavaCAPSHome/appserver/addons/jbi-components), and then select encoderlib.jar.

    4. Click Next and then click Finish.

    5. Repeat the above steps to install the following files:

      • saxonlib.jar

      • wsdlextlib.jar

  4. To install the Service Engines and Binding Components, do the following:

    1. Under JBI on the Admin Console, select Components.

    2. In the JBI Binding Components and Service Engines table, click Install.

    3. Browse to the location of the components (JavaCAPSHome/appserver/addons/jbi-components), and then select bpelserviceengine.jar.

    4. Click Next.

    5. If needed, modify the configuration properties of the component.

    6. Click Finish.

    7. Repeat the above steps to install the following files:

      • databasebc.jar

      • edmse.jar

      • etlserviceengine.jar

      • filebc.jar

      • ftpbc.jar

      • iepserviceengine.jar

      • jmsbc.jar

      • ldapbc.jar

      • schedulerbc.jar

      • xsltserviceengine.jar


      Note –

      Installing Sun Data Integrator (etlserviceengine.jar) on the Admin Console might throw an exception. If you run into this exception, install Data Integrator through NetBeans (described below).


  5. Continue to Finalizing the New Domain Installation.

ProcedureTo Install JBI Components on a New Domain From NetBeans

Before You Begin

Complete the steps under Adding the New Domain to NetBeans.

  1. Launch NetBeans and open the Services window.

  2. Expand Servers, expand the new domain, and then expand JBI.

  3. To install the shared libraries, do the following:


    Note –

    Shared libraries must be installed first.


    1. Right–click Shared Libraries and then select install.

    2. Browse to the location of the shared libraries (JavaCAPSHome/appserver/addons/jbi-components), and then select encoderlib.jar.

    3. Click Next and then click Finish.

    4. Repeat the above steps to install the following files:

      • saxonlib.jar

      • wsdlextlib.jar

  4. To install the Service Engines, do the following:

    1. Right-click Service Engines, and then select Install.

    2. Browse to the location of the components (JavaCAPSHome/appserver/addons/jbi-components), and then select bpelserviceengine.jar.

      The Installation Configuration window appears.

    3. If needed, modify the configuration properties of the component.

    4. Click Install.

    5. Repeat the above steps to install the following files:

      • edmse.jar

      • etlserviceengine.jar

      • iepserviceengine.jar

      • xsltserviceengine.jar

  5. To install the Binding Components, do the following:

    1. Right-click Binding Components, and then select Install.

    2. Browse to the location of the components (JavaCAPSHome/appserver/addons/jbi-components), and then select databasebc.jar.

      The Installation Configuration window appears.

    3. If needed, modify the configuration properties of the component.

    4. Click Install.

    5. Repeat the above steps to install the following files:

      • filebc.jar

      • ftpbc.jar

      • jmsbc.jar

      • ldapbc.jar

      • schedulerbc.jar

  6. Continue to Finalizing the New Domain Installation.

ProcedureTo Install JBI Components on a New Domain From the Command Line


Tip –

To expedite the process of installing components through the command line, create a password file containing the administrator and master password. Otherwise, you will be prompted for login information for each component to install. Enter the following text in the file:

AS_ADMIN_PASSWORD=adminadmin

AS_ADMIN_MASTERPASSWORD=changeit

Remember to replace adminadmin and changeit with the actual passwords if you have changed them.


Before You Begin

Complete the steps under Adding the New Domain to NetBeans.

  1. Navigate to JavaCAPSHome/appserver/bin.

  2. To install the shared libraries, do the following:


    Note –

    Shared libraries must be installed first.


    1. Run the following command:

      asadmin install-jbi-shared-library --port PortNumber --user AdminUser --passwordfile FileName ../addons/jbi-components/encoderlib.jar

      where:

      • PortNumber is the Admin Console port number.

      • AdminUser is the administrator username (admin, by default).

      • FileName is the name of the password file you created.

    2. Repeat the previous step to install the following files:

      • saxonlib.jar

      • wsdlextlib.jar

  3. To install the Service Engines and Binding Components, do the following:

    1. Run the following command:

      asadmin install-jbi-component --port PortNumber --user AdminUser --passwordfile FileName ../addons/jbi-components/bpelserviceengine.jar

    2. Repeat the above steps to install the following files:

      • databasebc.jar

      • edmse.jar

      • etlserviceengine.jar

      • filebc.jar

      • ftpbc.jar

      • iepserviceengine.jar

      • jmsbc.jar

      • ldapbc.jar

      • schedulerbc.jar

      • xsltserviceengine.jar

  4. Continue to Finalizing the New Domain Installation.