JavaScript is required to for searching.
Skip Navigation Links
Exit Print View
Using the Oracle Java CAPS 6.3 Installation GUI     Java CAPS Documentation
search filter icon
search icon

Document Information

Using the Java CAPS 6.3 Installation GUI

Overview of Installation

Installing the JDK Software and Setting JAVA_HOME

To Install the JDK Software and Set JAVA_HOME on a UNIX System

To Install the JDK Software and Set JAVA_HOME on a Windows System

Installing Java CAPS Using the Java CAPS Installer

To Install Java CAPS Components Using the Java CAPS Installer

Enabling Oracle Advanced Queueing

To Create the Java CAPS Advanced Queue User

To Install Advanced Queueing Support After Installing Java CAPS

To Allow Enterprise Manager to Delete Advanced Queue Messages

Enabling WebLogic JMS for Java CAPS

To Install WebLogic JMS Support After Installing Java CAPS

Adding the GlassFish Server to the NetBeans IDE

To Add the GlassFish Server

Installing Components Using the NetBeans IDE Update Center

To Install Components Using the NetBeans IDE Update Center

Installing Java CAPS Components Using the Java CAPS Uploader

To Install Java CAPS Components Using the Java CAPS Uploader

To Download and Expand ZIP Files Using the Java CAPS Uploader

Installing Plugins Using Enterprise Manager Web Applications Manager

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

Starting and Stopping Java CAPS

Connecting to the Java CAPS Repository From the NetBeans IDE

To Connect to Java CAPS Repository from the NetBeans IDE

Creating a Windows Service for the GlassFish Domain

To Create the Windows Service

To Start, Stop, and Delete the Service

Increasing the NetBeans IDE Heap Size

To Increase the Heap Size in NetBeans IDE

Importing Java CAPS Sample Projects

To Import a Repository Sample Project

Installing Java CAPS Using the Java CAPS Installer

This procedure installs the GlassFish Enterprise Server, NetBeans IDE, Java CAPS core products such as the Oracle Java CAPS Enterprise Service Bus, and Java CAPS add-on components such as adapters, Oracle Java CAPS Java Repository, Oracle Java CAPS Java Enterprise Manager, Oracle Java CAPS JMS IQ Manager, and the UDDI Server using Java CAPS Installer. The uninstallation software is also installed.

Although you can change the defaults, accepting most of them is a good practice, especially the port numbers.


Caution

Caution - Java CAPS Release 6.3 does not support spaces in the installation directory path. Certain adapters require additional installation procedures. For details, see Installing Third-Party JAR Files.


To Install Java CAPS Components Using the Java CAPS Installer

Before You Begin

Do not use telnet if you install on a Windows system.


Note - A security alert may appear during installation. If so, unblock the tagged program to continue the installation.


This installation includes installing support for WebLogic JMS and Oracle Advanced Queueing. If you elect not to install this support during installation, you can install it from a command line at a later time.

  1. Download the installation executable file from the delivery media to the installation directory.

    You can download the file from the following media:

    • The Oracle download URL supplied by Oracle Support

    • The DVDs that come with the Java Composite Application Platform Suite Media Kit

  2. For some operating systems, the installation files are packaged inside a ZIP file. Extract JavaCAPS.zip to a temporary directory.

    Note - If a /tmp directory is not accessible or there is not enough space to extract the installation files and install, the Java CAPS Installer asks for a new directory.


  3. Exit from all programs prior to beginning the installation.

    You can cancel the installation at any time during the process.

  4. To start the installation, initiate the appropriate executable file:
    • UNIX or Linux: sh JavaCAPS-OS.bin, where OS is the name of the operating system.

    • Windows: JavaCAPS-Windows.exe

  5. When the Java CAPS Installer wizard appears, click Next on the Introduction page to begin the installation.
  6. On the License Agreement page, select “I accept the terms of the License Agreement” and then click Next.
  7. On the Choose Install Directory page, accept the default or click Choose to browse to and select another directory. Click Next.

    Caution

    Caution - Java CAPS Release 6.3 does not support spaces in the installation directory path.


    If you select the default directory and it does not exist, the Installer creates it for you. If you select another directory and want to return to the default directory, click Restore Default Folder.

  8. On the Choose Install Set page, select the type of installation you want to perform (Complete or Custom) and then click Next.
  9. If you selected Custom, on the Choose Install Set page deselect any of the components you do not want to install, and then click Next.

    Note - You should install all the components. Java CAPS JMS IQ Manager (STCMS) is required if you have Projects from any product releases between version 5.0.5 and version 5.1.3. The JMS IQ Manager is not an option on Macintosh installations.


  10. On the Choose Java Developer Kit (JDK) page, accept the default location, or click Choose to navigate to the directory where your JDK software is located and then select it. Click Next.

    You need to select a JDK directory and not a Java Runtime Environment (JRE).

  11. On the Java CAPS Repository Input page, do the following:
    1. Enter a unique name for the Repository.
    2. Accept the default port number or enter a new port number.
    3. Click Next.

    Caution

    Caution - The default port number is 12000. This port assignment requires ten consecutive available ports, and during installation the system selects nine additional port numbers that sequentially follow the initial port number (12001–12009 for the default). Port checking only detects ports in use at the time, so the installation will not detect ports used by other applications that are not currently running. Use caution if you change the default port value.


  12. On the NetBeans IDE Input page, deselect Install Repository NBMs only if you do not want to install Repository–based Java CAPS components such as Adapters. Click Next.
  13. On the Oracle GlassFish Server Input page, accept or change the default values and then click Next.

    This server is the GlassFish Java EE and JBI server on which you create and deploy Java CAPS applications. The fields are described below.


    Note - In previous versions of Java CAPS, default Admin and Master passwords were automatically created. Beginning with Java CAPS 6.3, no default passwords are set and you need to define them manually. The passwords you specify must adhere to Oracle standards, containing at least eight characters, at least one number, and at least one lowercase and one uppercase character.



    Setting
    Description
    Default
    Admin User Name
    The name you use when you log in as administrator.
    admin
    Admin Password
    The password you use when you log in as administrator.
    None
    Master Password (for the SSL certificate for AS Admin operations)
    The key used to protect data in GlassFish, that is, the password of the secure keystore. The password must be at least 8 characters long.
    None

    When installing on AIX, use changeit as the initial master password. You can customize the password after installation by running the mp_aix.sh script located at JavaCAPS_Home\appserver.

    Admin Port
    The port on which GlassFish listens for administrative HTTP requests.
    4848
    HTTP Port
    The port on which GlassFish listens for HTTP requests for web applications that you deploy.
    8080
    HTTPS Port
    The port on which GlassFish listens for HTTPS requests for web applications that you deploy.
    8181
    JMS Port
    The port on which GlassFish listens for JMS IQ Manager requests.
    7676
    JMX Admin Port
    The port on which GlassFish listens for JMX administration requests.
    8686
    IIOP Port
    The port on which GlassFish listens for CORBA requests.
    3100
    IIOP SSL Port
    The port on which GlassFish listens for secure CORBA requests.
    3820
    IIOP Mutual Auth Port
    The port on which GlassFish listens for mutual authentication requests.
    3920

    Tip - Record the administrator name, password, and master password, as well as the port numbers, for later use. You need the passwords when starting the GlassFish Admin Console, among other things.


  14. On the Oracle AQ Support page, select the check box if you want to install support for Oracle Advanced Queueing.

    This allows you to administer and monitor an Oracle Advanced Queue instance from Java CAPS. It creates a lifecycle module named OracleAQ in the GlassFish server and copies the aqapi.jar file to the domain's \lib directory.

  15. If you selected to install support for Oracle Advance Queueing, the Oracle AQ Input page appears. Fill in the fields described in the following table, and then click Next.

    Note - If you choose to install support, be sure to follow the additional steps under To Allow Enterprise Manager to Delete Advanced Queue Messages after the installation is complete.



    Setting
    Description
    Name
    A descriptive name for the Advanced Queue. This name appears on the Enterprise Manager with OracleAQ prepended to it.
    Host
    The name of the server on which the Advanced Queue is stored.
    Port
    The port number for the Advanced Queue database.
    Username
    The user name to use to log in to the Advanced Queue database.
    Password/Confirm Password
    The password to use to log in to the Advanced Queue database.
    SID
    The Oracle SID name of the Advanced Queue database.
  16. On the WebLogic JMS Support page, select the check box if you want to install support for WebLogic JMS.

    This allows you to administer and monitor WebLogic JMS resources from Java CAPS. It creates a lifecycle module named in the GlassFish server and copies the wlthint3client.jar file to the domain's \lib directory.

  17. If you selected to install support for WebLogic JMS, the WebLogic JMS Input page appears. Fill in the fields described in the following table, and then click Next.

    Note - If you install support, configure WebLogic by following the instructions under Enabling WebLogic JMS for Java CAPS after the Java CAPS installation is complete.



    Setting
    Description
    Name
    A descriptive name for the WebLogic JMS server. This name appears on the Enterprise Manager with WebLogicMQ prepended to it.
    Host
    The name of the computer on which the WebLogic JMS server is located.
    Port
    The port number for the JMS server. The default is 7001.
    Username
    The user name to use to log in to the JMS server.
    Password/Confirm Password
    The password to use to log in to the JMS server.
    JMS Module Name
    The name of the JMS Module containing the system resources and configuration.
    JMS Server Name
    The name of the WebLogic JMS Server. This is optional, and if not specified defaults to the first JMS server at the given host and port.
    Sub Depl Name
    The name of the JMS sub-deployment within the given module. This is optional, and if not specified defaults to the first sub-deployment in the module.
  18. On the JMS IQ Manager Input page, specify how to install JMS IQ Manager.

    Use the JMS IQ Manager for Java CAPS projects that require the same messaging behavior found in releases 5.0.5 through 5.1.3. It can be installed in addition to JMQ, the JMS server that ships with GlassFish. You can also install JMS IQ Manager manually to a different instance of GlassFish after this installation completes.


    Note - The JMS IQ Manager is not an option on Macintosh systems.


    1. Select the operating system for the JMS IQ Manager, or, if you do not want to install JMS IQ Manager, select Do Not Install.

      The Oracle Java CAPS JMS IQ Manager uses native binaries, which are different for different operating systems and processor architectures. Choose the binary that matches the platform on which you want to install JMS IQ Manager.

    2. Specify the Port number that JMS IQ Manager will listen on or accept the default.
    3. Specify the SSL port number that JMS IQ Manager will listen on or accept the default.
    4. To migrate the JMS IQ Manager from a previous version of Java CAPS, type the root directory of the previous installation in the Migration From Directory field.
    5. Click Next.
  19. On the Java CAPS Enterprise Manager Input page, specify the Host Name and Admin Port or accept the default values. Click Next.
    • The Host Name is the name of the computer on which you are installing. Although this is usually the name of the computer Enterprise Manager is running on, you can specify the name of a proxy server.

    • The Admin Port is the port on which Enterprise Manager listens to HTTP requests. The default value is 15000. This port assignment requires five consecutive available ports. During installation, the system selects four additional port numbers that sequentially follow the initial port number (15001–15004 for the default). Port checking only detects ports in use at the time, so the installation will not detect ports used by other applications that are not currently running. Use caution if you change the default port value.

      Record the port number for later use.

    • Two default users are created for Enterprise Manager: admin (password adminadmin) and STC (password Administrator).

      You should create new, unique users for your production environment.

  20. On the Pre-Installation Summary page, click Install if you are satisfied with your selections. Otherwise, use the Previous button to change your selections.

    Note - If a firewall blocks any of the components from installing, remove the block and continue installing the component.


    The Installing Java CAPS page appears.

  21. When the Installation Complete page appears, read the comments before you click Done to exit the Installer.

    For additional details about the installation, see the installation logs, located in JavaCAPS_Home\install\logs.

    The Java CAPS Installer finalizes the configuration and then closes. A “Register Now!” page opens on your browser.

  22. Register Java CAPS.
    1. (Optional) If you do not already have an account, under Create An Account click Create.

      The Registration form appears and asks for general information, such as name, email address, and so on. It requires that you set up a password for your account. Once you have filled out the form to your satisfaction, click Create.

    2. If you have an account, select “I accept the terms of use for registering Oracle programs,” and click Register Now. Enter your login information and click Go.

    Note - You can register at a later time. To do this, navigate to the base directory where you installed Java CAPS and run register.html. When a product registration screen appears, click Register.


  23. The default domain is not registered in the NetBeans IDE. In order to access the application server and any JBI runtime components, you need to add the server to the IDE as described in Adding the GlassFish Server to the NetBeans IDE.
  24. If you deselected Install Repository NBMs on the NetBeans IDE Input page, you can install them now. See Installing Components Using the NetBeans IDE Update Center for details.

    However, if you chose to install the Repository NBMs as part of the initial Java CAPS installation, all the modules have already been downloaded from the Repository to the NetBeans IDE.