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.

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

• To Upload Additional Repository-Based Java CAPS Components to the Repository

• To Install Repository-Based Java CAPS Components to the NetBeans IDE

• To Download and Expand ZIP Files Using the Java CAPS Uploader

• To Install Java CAPS Plugins Using the Enterprise Manager Web Applications Manager

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

1. Start the Repository and GlassFish Server 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 (by default, this is 12000).

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.

To 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:
    • If the components you are installing include downloadable files, continue to To Download and Expand ZIP Files Using the Java CAPS Uploader.
    • If the components you are installing do not include downloadable files, continue to To Install Java CAPS Plugins Using the Enterprise Manager Web Applications Manager.

To 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, the Siebel Adapter includes sample workflows, and the Oracle Applications Adapter includes command-line scripts.

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.

To 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.