Installing Java CAPS Using the Java CAPS Installer

This procedure installs the Sun Java System Application Server 9.1 (SJSAS), NetBeans IDE 6.1 ML, Java CAPS core products such as the Sun Enterprise Service Bus, and Java CAPS add-on components such as adapters, Sun Java Repository version 6, Sun Java Enterprise Manager version 6, Sun JMS IQ Manager version 6, and the UDDI Server using Java CAPS Installer. The Sun Uninstallation software is also installed.

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

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

Note - Certain adapters require additional installation procedures. For details, see Installing Third-Party JAR Files.

To Install Java CAPS Components Using Java CAPS Installer

Before You Begin

When installing Java CAPS on UNIX systems, such as Solaris machines, you need to set the DISPLAY variable to install in GUI mode. How you do this is dependent upon how you connect to your system.

• If you receive the error message “No X11 DISPLAY variable was set, but this program performed an operation which requires it” and you use the SSH command to connect to your system from another UNIX machine, you need to set the DISPLAY variable.

  • C shell with localhost as the host name

    setenv DISPLAY localhost:0.0

  • Korn shell with localhost as the host name

    DISPLAY localhost:0.0

    export DISPLAY

• If you use X Windows software, such as Exceed, the DISPLAY variable is set for you automatically.

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

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

   You can download the file from the following media:

   • The Sun Download Center (SDLC) URL supplied by Sun Support

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

2. Extract the JavaCAPS.zip file to a temporary directory.

   Note - If a /tmp directory is not accessible, 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:

   • Solaris, AIX, or Linux: sh JavaCAPS.bin

   • Macintosh: JavaCAPS.app or sh ./JavaCAPS.app

   • Windows: JavaCAPS.exe

5. When the Java CAPS Installer wizard appears, click Next on the Introduction page to begin the installation.

   Tip - Use the Next and Previous buttons to navigate forward and backward in 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 another directory.

   Note - 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 click Next.
9. If you selected Custom, on Choose Components deselect any of the components you do not want to install.

   Note - You should install all the components. Sun JMS IQ Manager 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, click Choose to navigate to the directory where your JDK software is located, and then select it.

    The Sun Java System Application Server requires the JDK software for installation. For more information, see Installing the JDK Software and Setting JAVA_HOME.

    Caution - If you select a Java Runtime Environment (JRE), you cannot install or configure the Sun Java System Application Server.

11. On the Java CAPS Repository Input page, accept the default port number.

    The default value is 12000. This port assignment requires ten consecutive available ports. Therefore, during installation, the system selects nine additional port numbers that sequentially follow the initial port number (12001-12009 for the default). Because port checking performed at installation only detects ports in use at that time, the installation will not detect ports that are configured to be used by other applications that are not running at that time. Consequently, be careful if you choose to change the default port value.

    Note - If a security alert appears on your system, you must unblock the tagged program to continue the installation.

12. Determine whether to install predefined Java CAPS components (non-JBI based Java CAPS components) from the Repository into NetBeans.

    The Sun Java System Application Server Input page appears. This server is the Java EE and JBI server on which you create and deploy Java CAPS applications.

13. Determine the settings for the Sun Java System Application Server.

    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. adminadmin Master password for the SSL certificate for AS Admin operations The key used to protect data in the Sun Java System Application Server, that is, the password of the secure keystore. The password must be at least 8 characters long. changeit Admin port number The port on which the Sun Java System Application Server listens for administrative HTTP requests. 4848 HTTP port number The port on which the Sun Java System Application Server listens for HTTP requests for web applications that you deploy. 8080 Secure HTTPS port number The port on which the Sun Java System Application Server listens for HTTPS requests for web applications that you deploy. 8181 JMS port number The port on which the Sun Java System Application Server listens for JMS IQ Manager requests. 7676 JMX admin port number The port on which the Sun Java System Application Server listens for JMX administration requests. 8686 IIOP port number The port on which the Sun Java System Application Server listens for CORBA requests. 3100 Secure IIOP port number for the initial server instance The port on which the Sun Java System Application Server listens for secure CORBA requests. 3820 Mutual Authentication IIOP port number for the initial server instance 3920

    Tip - Record the administrator name, password, and master password, as well as the port numbers, for later use. The Sun Java System Application Server asks for the administrator name, password, and master password when you start it using the start_appserver_domain1 script. When you start the server from AS Admin or NetBeans IDE the administrator name, password, and master password are not required.

14. On the Sun JMS IQ Manager Input page, choose how you want 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 the Sun Java System Application Server.

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

    1. The JMS IQ Manager binary defaults to the operating system on which you are installing Java CAPS, but you can change it by using the drop-down list.

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

       Note - You must install the Sun Java System Application Server if you install the Sun JMS IQ Manager. You can also install JMS IQ Manager manually to a different Sun Java System Application Server after this installation completes.

    2. Accept the Port number that JMS IQ Manager will listen on or change the default of 18007.
    3. Accept the Secure SSL port number that JMS IQ Manager will listen on or change the default of 18008.
    4. If you want 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.
15. On the Java CAPS Enterprise Manager Input page, accept the Host Name and Admin Port defaults or change them.

    Note - Enterprise Manager is the management server that you use to manage deployed Java CAPS applications and alerts.

    • The Host Name is the name of the computer on which you are installing. Other components, such as the Sun Java System Application Server, use this name to access Enterprise Manager. Enterprise Manager relays this name to other components. 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. Therefore, during installation, the system selects four additional port numbers that sequentially follow the initial port number (15001-15004 for the default). Because port checking performed at installation only detects ports in use at that time, the installation will not detect ports that are configured to be used by other applications that are not running at that time. Consequently, be careful if you choose to change the default port value.

    Record the port number for later use.

16. When the Pre-Installation Summary page appears, if you are satisfied with your selections click Install. 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 displays. While the suite is installed on your system, you will see a number of pages that supply information about what you are installing, for example, the Sun Java Enterprise Service Bus Suite and the Sun Java System Application Server. Also listed are links to pertinent Open Source web sites.

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

    Java CAPS is configured for your system. For additional details about the installation, see the installation logs.

    The Java CAPS Installer closes and a “Register Now!” page opens on your browser. When you register Java CAPS with the Sun Developer Network, the following benefits become available to you:

    • Notification of new versions, patches, and updates

    • Special offers on Sun developer products, services, and training

    • Access to early releases and documentation

    • Ability to track and manage your registered products on the Sun Inventory site

18. Register Java CAPS.
    1. (Optional) If you do not already have a Sun account, under Create An Account click Sign Up Now to Register for a Sun Online Account.

       The Registration form appears. It 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 Submit.

       Note - You must have a Sun account set up before you can register Java CAPS and receive the benefits of registration.

    2. To register, under Use My Account, enter your User Name and Password, select “I accept the terms of use for registering Sun programs,” and click Register Now.

    Note - You can register at a later time. To do this, navigate to the base directory where you installed Java CAPS and initiate register.html. When a Sun Product Registration screen appears, click Register to access the “Register Now!” page.

19. Start the Java CAPS Repository and run the Java CAPS EE Update Center in NetBeans IDE to download modules from the Repository into NetBeans.

    Note - See Installing Java CAPS Components Using the NetBeans IDE Update Center for details.

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