Installing Additional Components for Java CAPS 6

Installing Additional Components for Java CAPS 6

The topics listed below provide information about installing additional JavaTM Composite Application Platform Suite (Java CAPS) components after you have completed the initial Java CAPS installation. With the initial installation, you get all of the JBI components, several Repository-based core components (such as Enterprise Service Bus and Business Process Manager), and several Adapters. Additional products are included on your installation media so you can use all components of Java CAPS.

For additional installation information, see Planning for Java CAPS Installation, which provides information such as supported platforms, operating system limitations, and parameter definitions.

To access all the Java CAPS documentation in HTML and PDF format, go to the Sun Java Composite Application Platform Suite documentation page at docs.sun.com.

What You Need to Know

These topics provide conceptual information about the installations.

What You Need to Do

These topics provide instructions on how to install additional Java CAPS components.

Overview of the Installation Process

The initial Java CAPS installation installs everything you need for your integrated, visual development environment for developing composite applications, Java EE applications, web applications, mobile applications, or web services. After setting up your Java Composite Application Platform Suite, you may decide you need to install additional Repository–based Java CAPS components, JBI-based Java CAPS components, or updates to the components you have already installed on your system. Java CAPS provides two tools to upload and install additional components or updates to the components already installed on your system:

To install Repository-based components, you need to use both of these tools. You load the new product information into the Repository using the Suite Uploader, and then you install the component into the NetBeans IDE using the Update Center. In addition, several components include downloadable files that you can access from the Download tab of the Suite Uploader. Most components include an Enterprise Manager plug-in that appears on the Download tab but that can be installed using the Enterprise Manager.

You can install JBI components using command-line functions, the NetBeans IDS, or the GlassFish Admin Console.

Installing Additional Repository-Based Java CAPS Components

This topic provides instructions on how to install additional Repository-based components after the initial installation. It assumes that you have successfully installed Java CAPS, GlassFish Enterprise Server, and Enterprise Manager.


Note –

Adapters that do not include a static OTD, such as database adapters, will not appear in the NetBeans IDE Projects window under Adapters in the CAPS Components Library. However, they do appear in the list of installed plugins.


Perform the following steps to install additional Repository-based components. The last two steps may be optional for some components.

ProcedureTo Upload Additional Repository-Based Java CAPS Components to the Repository

  1. Start the Repository and GlassFish by navigating to the directory where you installed Java CAPS and starting the appropriate executable files.

  2. In a browser window, go to http://HostName:PortNumber, where:

    • HostName is the TCP/IP host name of the server where you installed the Repository and not the name of the Repository itself.

    • PortNumber is the port number that you specified during the installation of the Repository.

  3. On the Java CAPS Uploader login page, enter your username and password.


    Note –

    The defaults are admin for username and adminadmin for password.


    The Java CAPS Uploader displays a list of components you have already installed.

  4. To install additional Java CAPS components, select Click to Install Additional Products.

  5. Under Select Java Composite Application Platform Suite Products to Install, expand a Product Name category such as Core Product or OTD.

  6. Make your selections by selecting the box to the left of the component.


    Note –

    “eGate” and “eWay” are pre-Release 6 terms. To see their current equivalents, refer to Planning for Java CAPS Installation.


  7. When you have selected all the components you want to install, click Next.

  8. On the Selecting Files to Install page, browse to and select the appropriate SAR file, and then click Next.

    For information about the location of the SAR files, see Planning for Java CAPS Installation.


    Note –

    If you decide you do not want to upload a particular component, click Skip to move on to the next component. However, sometimes you cannot skip an upload due to dependencies.


  9. Repeat the previous step until you have selected all the necessary SAR files.

    The Java CAPS Uploader uploads the selected components to the Repository.

  10. Continue to the next procedure, To Upload Additional Repository-Based Java CAPS Components to the Repository.

ProcedureTo Install Repository-Based Java CAPS Components to the NetBeans IDE

  1. To start Repository and NetBeans IDE, navigate to the base directory where you installed Java CAPS and start the appropriate executable files.

  2. In NetBeans, connect to the CAPS Repository (select Tools > CAPS Repository > Connect).

  3. From the NetBeans IDE menu bar choose Tools and then Plugins.

  4. On the Plugins window, click the Settings tab.

  5. In the Configuration of Update Centers panel, select CAPS Repository Update Center and deselect the remaining options.

    If CAPS Repository Update Center does not appear in the list, do the following:

    1. On the Settings page, click Add.

      The Update Center Customizer dialog box appears.

    2. In the Name field, enter CAPS Repository Update Center.

    3. In the URL field, enter the following:

      http://HostName:PortNo/repository/RepName/data/files/InstallManager/catalog.xml

      where HostName is the name of the Repository server (or localhost), PortNo is the Repository base port number, and RepName is the name of the Repository.

    4. Click OK.


    Tip –

    You might need to click Reload Catalog on the Installed tab in order to see the available Java CAPS plugins.


  6. Click the Available Plugins tab.

    The components you installed in the previous procedure should appear in the list.

  7. Select the individual components to install, or right-click any of the entries and select Check All.

  8. Click Install.

  9. On the NetBeans IDE Installer, click Next, accept the license, and click Install.


    Note –

    Ignore any validation or unsigned warnings and continue with the installation.


  10. When the installation completes, click Finish.

  11. If an additional wizard appears before NetBeans IDE refreshes, follow the onscreen steps to install the plugin.

  12. Do one of the following:

ProcedureTo Download and Expand ZIP Files Using the Java CAPS Uploader

Some Java CAPS components are delivered as ZIP files. When you copy the Java CAPS executable file to your installation directory, these ZIP files become available under the Downloads tab in the Java CAPS Uploader. For some components, tools or sample files are also delivered in this manner. For example, Business Process Manager includes Instance Manager and Workflow Service APIs, the HL7 Adapter includes sample projects, and the Oracle Applications Adapter includes command-line scripts.


Note –

SeeTo Install Java CAPS Plugins Using the Enterprise Manager Web Applications Manager for information about how to install adapter plugins and some of the other plugins listed under the Downloads tab.


Before You Begin

This task assumes that the Repository is running and that you have started the Java CAPS Uploader.

  1. On the Java CAPS Uploader, click the Downloads tab.

    A list of components that are available to download from the Repository appear.

  2. In the list of components to download, click a component to download and extract, such as CommandLineCodegen.

  3. On the dialog box that appears, choose to save or open the file.

  4. If you saved the file, open it in an extraction program, such as WinZip.

  5. Extract all the files to a target directory.

    For example, you might extract the files to InstallDirectory\repository, where the InstallDirectory is the directory where you installed Java CAPS.

  6. Continue to the next procedure, To Install Java CAPS Plugins Using the Enterprise Manager Web Applications Manager.

ProcedureTo Install Java CAPS Plugins Using the Enterprise Manager Web Applications Manager

  1. Start Enterprise Manager by navigating to the directory where you installed Java CAPS and starting the appropriate executable file.

  2. In a browser window, go to http://HostName:PortNumber, where:

    • HostName is the TCP/IP host name of the server where you installed Enterprise Manager.

    • PortNumber is the port number that you specified for Enterprise Manager during installation (the default port number is 15000).

  3. In the Explorer pane on the left, click the Configuration icon.

    A series of tabs appears in the right pane.

  4. In the right pane, click the Web Applications Manager tab.

    The Specify Repository Connection Properties page appears.

  5. Enter the following values:

    • Host Address – The Repository address in the format http://HostName:PortNumber, where HostName is the name of the computer where the Repository is installed, and PortNumber is the Repository port number (12000, by default).

    • User Name – The Java CAPS administrator user name.

    • Password – The Java CAPS administrator password.

  6. Click Connect.

    A table appears with a list of plugins that are available to install.

  7. Select the application plugins you want to install or click Select All.

  8. Click Install.

    After installation is complete, the results appear at the bottom of the page.

Installing Additional JBI-Based Components

This topic provides instructions on how to install additional Java CAPS and non-Java CAPS JBI-based components after the initial installation. It assumes that you have successfully installed Java CAPS, GlassFish , and the NetBeans IDE.

ProcedureTo Install Java CAPS JBI-Based Components

All the JBI-based components of Java CAPS are installed with the initial installation. If you uninstall any of these components, you can easily reinstall them


Note –

The following procedure describes how to install these components using NetBeans. For instructions on using a command line or the GlassFish Admin Console, see Installing Java CAPS JBI Components on a New Domain in Java CAPS Domain and Runtime Installation.


  1. Launch NetBeans and open the Services window.

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

  3. To install shared libraries, do the following:

    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 any of the following files:

      • encoderlib.jar

      • saxonlib.jar

      • wsdlextlib.jar

    3. Click Next and then click Finish.

    4. Repeat the above steps to install any additional shared libraries.

  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 any of the following components:

      • bpelserviceengine.jar

      • edmse.jar

      • etlserviceengine.jar

      • iepserviceengine.jar

      • xsltserviceengine.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 additional Service Engines.

  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 any of the following files:

      • databasebc.jar

      • filebc.jar

      • ftpbc.jar

      • jmsbc.jar

      • ldapbc.jar

      • schedulerbc.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 additional Binding Components.

ProcedureTo Install Non–Java CAPS JBI–Based Components

  1. From the NetBeans IDE menu bar choose Tools and then Plugins.

  2. On the Plugins page, click the Settings tab.

  3. From the Configuration of Update Centers pane select the type of components you want to install.

  4. Click the Available Plugins tab.

  5. Select each module you want to install, or right-click in the list and select Check All to select all modules to install.

  6. To begin the installation, click Install.

  7. When the NetBeans IDE Installer appears, click Next, accept the license, and click Install.

  8. When the installation completes, select whether to restart the IDE and then click Finish.

    You are now ready to continue using Java CAPS.

Installing DDL Scripts for the Oracle Applications Adapter

This topic provides instructions on how to install and run the DDL Scripts required to generate OTDs for the Oracle Application Adapter. It assumes that you have successfully installed Java CAPS, GlassFish, and the NetBeans IDE.

ProcedureTo Install DDL Scripts for the Oracle Applications Adapter

  1. On the Java CAPS Uploader, click the Downloads tab.

  2. In the List of Components to Download, click Oracle Applications eWay User Privileges Configuration and DDL Scripts.

  3. Extract the SQL_Scripts.zip file into a working directory .

  4. From a SQL editor, connect to the Oracle database as the specified user and run the following scripts in Admin directory in the order given.

    1. As the SYSTEM user, run Run01_Create_TableSpace_as_User_SYSTEM.sql.

    2. As the APPS user, run Run02_Create_Views_as_User_APPS.sql.

    3. As the APPS user, run Run03_Create_Synonyms_as_User_APPS.sql.

    4. As the APPS user, run Run04_Create_Packages_as_User_APPS.sql.

    5. As the APPS user, run Run05_Create_Synonyms_for_Views_as_User_APPS.sql.

    6. As the APPS user, run Run06_Create_Synonyms_for_Synonyms_as_User_APPS.sql.

    7. As the APPS user, run Run07_Create_Synonyms_for_Packages_as_User_APPS.sql.

    8. As the APPS user, run Run08_Grant_Permission_to_Interface_Tables_as_User_APPS.sql.

    9. As the APPS user, run Run09_Grant_Select_to_Concurrent_Manager_as_User_APPS.sql.

    10. As the JCAPS user, run Run10_Create_Synonyms_for_Concurrent_Manager_Part1_as_User_JCAPS.sql.

    11. As the APPS user, run Run11_Grant_Execute_to_Concurrent_Manager_as_User_APPS.sql.

    12. As the JCAPS user, run Run12_Create_Synonyms_for_Concurrent_Manager_Part2_as_User_JCAPS.sql.

    13. As the APPS user, run Run13_Grant_Insert_Select_to_Concurrent_Manager_as_User_APPS.sql.

    When the installation of DDL Scripts is complete, all required Staging tables are created.