SDK Update 5 Installation Instructions

SDK Update 5 Installation Instructions


These installation instructions provide the steps required for installing the Java Application Platform SDK Update 5 bundle and the Java Platform, Enterprise Edition 5 SDK Update 5 bundle. The following topics are discussed:

 
-  Types of Bundles and Their Components
-  SDK with Tools Bundle
-  Installing the Software
-  Registering the Software
-  Uninstalling the Software
 

Solaris, Linux, and Macintosh installations support root/superuser and non-root/standard user installations. Users of Windows installations should have power user or administrator access.

Types of Bundles and Their Components

The following bundles are available:

  • Java Platform, Enterprise Edition 5 SDK Update 5 bundle includes these components:
    • Sun Java System Application Server 9.1 Update 2
    • Java Platform, Enterprise Edition 5 Samples
    • Java BluePrints
    • API documentation (Javadocs)
    • Your First Cup: An Introduction to the Java EE Platform

  • Java Application Platform SDK Update 5 bundle includes these components:
    • All contents of Java Platform, Enterprise Edition 5 SDK Update 5
    • Portlet Container 2.0
    • Web Services for Remote Portlets 1.0
    • Open ESB v2
    • Sun Java System Access Manager 7.1 Patch 1

  • Tools download additionally includes:
    • All contents of Java Application Platform SDK Update 5
    • Portal Pack 2.0
    • NetBeans IDE 6.1

Developers have the option to download the SDK with JDK or Tools (NetBeans).

SDK with Tools Bundle

The SDK with tools bundle includes NetBeans IDE 6.1, which provides development tools for building composite applications.

Consult the Java EE 5 Tools Bundle Resources and Documentation page for detailed installation instructions and additional resources:

Installing the Software

To install on Solaris or Linux platforms:

  1. Navigate to the directory where you downloaded the distribution file.
  2. Change the permission of the distribution file so that you have execute access:
    chmod +x <distribution_filename>
  3. Run the installation program.
    At the command prompt, type the name of the distribution file: ./<distribution_filename>
  4. At the Welcome page of the installation wizard, click Next.
  5. Respond to the license agreement and click Next.
  6. Identify a directory location for the installation and click Next.
  7. If you are installing the bundle without the JDK you will need to identify the path to the JDK 5.0 or greater. Click Next.
  8. In the Administration Configuration page, enter the following:
    • Admin User Name: Name of the user who administers the server. The default is admin.
    • Password: Admin user's password to access the Admin Server (8-character minimum).
    • Prompt or Don't Prompt for Administrator User Name: The user name can be stored in a preferences file so that you do not have to provide it to perform administrative tasks.
    • Admin Port: Administration port number for initial server instance. The default number is 4848.
    • HTTP Port: Port number to access the default server instance. The default number is 8080.
    • HTTPS Port: Secure port number to access the default server instance. The default number is 8181.
  9. Click Next.
  10. In the Installation Options page, select the options that you want.
    • If you select the Upgrade from Previous Version checkbox, the upgrade wizard begins after installation is completed. Upgrades from 8.0, 8.1, 8.2, 9.0, and 9.1 Platform Editions; as well as 9.1 Update 1 are supported. For information about upgrading, see Chapter 3: Upgrading an Application Server Installation, in Sun Java System Application Server Upgrade and Migration Guide.
    • If you select the Enable Update Center Client checkbox, the Update Center will periodically check for available updates and prompts you when an update is available for download.
  11. For the Java Application Platform SDK Update 5, in the Configure Available Add-ons page, select to install Open ESB v2, Portlet Container 2.0, Web Services for Remote Portlets 1.0, and Sun Java System Access Manager 7.1 Patch 1.

    Open ESB v2 implements an Enterprise Service Bus (ESB) runtime using Java Business Integration (JBI) as the foundation. Open ESB is an open standard, open-source product that offers a platform to build integration solutions based on service-oriented architecture (SOA).

    Portlet Container 2.0 provides the implementation of the Java Portlet Specification 2.0 (JSR 286), which is the next version of the Java Portlet Specification 1.0 (JSR 168). JSR 286 adds features like Eventing, Public render parameters, Resource Serving and Portlet filter. Portlet Container 2.0 also provides a portlet driver, a lightweight portlet rendering environment.

    Web Services for Remote Portlets 1.0 s a standard that provides web service-based access capability to portlets and enables interoperability among different portal server solutions.

    Sun Java System Access Manager 7.1 Patch 1 is a security foundation that helps organizations manage secure access to an enterprises' web applications both within the enterprise and across business-to-business (B2B) value chains.

  12. On the Ready to Install page, review the list of components to be installed and click Install Now.

After the installation completes:

  • Select Start Server to start the Sun Java Application Server from the install-dir/bin directory. If you have problems starting the server, see the Sun Java System Application Server Troubleshooting Guide.
  • Start the Application Server domain by executing the asadmin utility from the install-dir/bin/asadmin directory and launching the start domain command: start-domain domain1.
  • Launch the Admin Console in a browser using the URL http://localhost:4848.
  • Verify the installation by following the instructions in the Sun Java System Application Server Quick Start Guide.

Consult the Sun Java System Application Server Installation Guide for information on installing using the silent installer.

To install on Windows platform:

  1. Navigate to the directory where you downloaded the executable .exe file.
  2. Double-click the executable file to start the installation program.
  3. Follow the instructions on the wizard screens of the installation program.
  4. If you are installing the bundle without the JDK you will need to identify the path to the JDK 5.0 or greater.
  5. In the Administration Configuration page, enter the following:
    • Admin User Name: The name of the user who administers the server. The default is admin.
    • Password: The administrator user's password to access the Admin Server (8-character minimum).
    • Prompt or Don't Prompt for Administrator User Name: The user name can be stored in a preferences file so that you do not have to provide it to perform administrative tasks.
    • Admin Port: Administration port number for initial server instance. The default number is 4848.
    • HTTP Port: Port number to access the default server instance. The default number is 8080.
    • HTTPS Port: Secure port number to access the default server instance. The default number is 8181.
  7. Click Next.
  8. In the Installation Options page, select the options that you want.
    • If you select the Upgrade from Previous Version checkbox, the upgrade wizard begins after installation is completed. Upgrades from 8.0, 8.1, 8.2, 9.0, and 9.1 Platform Editions; as well as 9.1 Update 1 are supported. For information about upgrading, see Chapter 3: Upgrading an Application Server Installation, in Sun Java System Application Server Upgrade and Migration Guide.
    • If you select the Enable Update Center Client checkbox, the Update Center will periodically check for available updates and prompts you when an update is available for download.

    • To create a Windows service, the sc.exe utility must be available on the system. Windows 2000 users may need to install the Windows 2000 Resource Kit to get this utility. For other supported Windows versions, the utility is included in the operating system.

  10. For the Java Application Platform SDK Update 5, in the Configure Available Add-ons page, select to install Open ESB v2 , Portlet Container 2.0, Web Services for Remote Portlets 1.0, and Sun Java System Access Manager 7.1 Patch 1.

    Open ESB v2 implements an Enterprise Service Bus (ESB) runtime using Java Business Integration (JBI) as the foundation. Open ESB is an open standard, open-source product that offers a platform to build integration solutions based on service-oriented architecture (SOA).

    Portlet Container 2.0 provides the implementation of the Java Portlet Specification 2.0 (JSR 286), which is the next version of the Java Portlet Specification 1.0 (JSR 168). JSR 286 adds features like Eventing, Public render parameters, Resource Serving and Portlet filter. Portlet Container 2.0 also provides a portlet driver, a lightweight portlet rendering environment.

    Web Services for Remote Portlets 1.0 s a standard that provides web service-based access capability to portlets and enables interoperability among different portal server solutions.

    Sun Java System Access Manager 7.1 Patch 1 is a security foundation that helps organizations manage secure access to an enterprises' web applications both within the enterprise and across business-to-business (B2B) value chains.

  12. On the Ready to Install page, review the list of components to be installed and click Install Now.

    After the installation completes:

    • Select Start Server to start the Sun Java Application Server from the install-dir/bin directory. If you have problems starting the server, see the Sun Java System Application Server Troubleshooting Guide.
    • Start the Application Server domain by executing the asadmin utility from the install-dir/bin/asadmin directory and launching the start domain command: start-domain domain1.
    • Launch the Admin Console in a browser using the URL http://localhost:4848.
    • Verify the installation by following the instructions in the Sun Java System Application Server Quick Start Guide. set the PATH environment variable to include the Application Server install-dir/bin directory.

Consult the Sun Java System Application Server Installation Guide for information on installing using the silent installer.

To install on Macintosh platform:

The Macintosh installation bundle does NOT include the JDK. The SDK uses the JDK that is part of the Macintosh operating system.

  1. Navigate to the directory where you downloaded the distribution file.
    It is recommended that this download directory should be a dedicated temporary directory containing only downloaded distribution file.
  2. Unzip the distribution file by typing: unzip ./<distribution_filename>.
  3. Change the permission of the distribution file so that you have execute access: chmod +x ./setup
  4. Run the installation program.
    At the command prompt, type: ./setup.
  5. At the Welcome page of the installation wizard, click Next.
  6. Respond to the license agreement and click Next.
  7. Identify a directory location for the installation and click Next.
  8. In the Administration Configuration page, enter the following:
    • Admin User Name: Name of the user who administers the server. The default is admin.
    • Password: Admin user's password to access the Admin Server (8-character minimum).
    • Prompt or Don't Prompt for Administrator User Name: The user name can be stored in a preferences file so that you do not have to provide it to perform administrative tasks.
    • Admin Port: Administration port number for initial server instance. The default number is 4848.
    • HTTP Port: Port number to access the default server instance. The default number is 8080.
    • HTTPS Port: Secure port number to access the default server instance. The default number is 8181.
  9. Click Next.
  10. In the Installation Options page, select the options that you want.
    • If you select the Upgrade from Previous Version checkbox, the upgrade wizard begins after installation is completed. Upgrades from 8.0, 8.1, 8.2, 9.0 , and 9.1 Platform Editions; as well as 9.1 Update 1 are supported. For information about upgrading, see Chapter 3: Upgrading an Application Server Installation, in Sun Java System Application Server Upgrade and Migration Guide.
    • If you select the Enable Update Center Client checkbox, the Update Center will periodically check for available updates and prompts you when an update is available for download.
  11. For the Java Application Platform SDK Update 5, in the Configure Available Add-ons page, select to install Open ESB v2, Portlet Container 2.0, Web Services for Remote Portlets 2.0, and Sun Java System Access Manager 7.1 Patch 1.

    Open ESB v2 implements an Enterprise Service Bus (ESB) runtime using Java Business Integration (JBI) as the foundation. Open ESB is an open standard, open-source product that offers a platform to build integration solutions based on service-oriented architecture (SOA).

    Portlet Container 2.0 provides the implementation of the Java Portlet Specification 2.0 (JSR 286), which is the next version of the Java Portlet Specification 1.0 (JSR 168). JSR 286 adds features like Eventing, Public render parameters, Resource Serving and Portlet filter. Portlet Container 2.0 also provides a portlet driver, a lightweight portlet rendering environment.

    Web Services for Remote Portlets 1.0 s a standard that provides web service-based access capability to portlets and enables interoperability among different portal server solutions.

    Sun Java System Access Manager 7.1 Patch 1 is a security foundation that helps organizations manage secure access to an enterprises' web applications both within the enterprise and across business-to-business (B2B) value chains.

  12. On the Ready to Install page, review the list of components to be installed and click Install Now.

After the installation completes:

  • Select Start Server to start the Sun Java Application Server from the install-dir/bin directory. If you have problems starting the server, see the Sun Java System Application Server Troubleshooting Guide.
  • Start the Application Server domain by executing the asadmin utility from the install-dir/bin/asadmin directory and launching the start domain command: start-domain domain1.
  • Launch the Admin Console in a browser using the URL http://localhost:4848.
  • Verify the installation by following the instructions in the Sun Java System Application Server Quick Start Guide.

Consult the Sun Java System Application Server Installation Guide for information on installing using the silent installer.

Registering the Software

Installation is not finished until you respond to the Registration screen. You can elect to register the SDK now, or register later. Registering the SDK requires a Sun Online Account. If you do not have a Sun Online Account, you can create one during the registration process.

The Registration page appears as the final screen of the installation.

  1. In the Registration page, provide Sun Online Account details or create an account.
    If you create a Sun Online Account while registering the Application Server, you are prompted for only the required information. To provide additional, optional information for your Sun Online Account, use the registration page on Sun's web site to create your account.

    • If you already have a Sun Online Account,

      1. Select the I Already Have a Sun Online Account option.
      2. In the User Name field, type the user name that you specified when registered for your Sun Online Account.
      3. In the Password field, type that you specified when registered for your Sun Online Account.
      4. Click Register.

    • If you do not have a Sun Online Account,

      1. Select the I Don't Have a Sun Online Account option and click Next.
      2. In the Email Address field, type your email address.
        Your email address will be your Sun Online Account user name.
      3. In the Password field, type the password to use for your Sun Online Account.
        The password is case-sensitive and must be 6-10 characters long.
      4. In the Retype Password field, retype the password that you typed in the preceding step.
      5. In the First Name field, type your first name.
      6. In the Last Name field, type your last name.
      7. In the Company field, type the name of your company.
      8. From the drop down list, select the country or territory where you reside.
      9. Click Register.

  3. Choose the Skip Registration option if you want to register later through the Admin Console or through the Update Center.

Uninstalling the Software

To uninstall the SDK software, complete one of the following procedures:

To Run the Uninstallation Program on Solaris or Linux platforms:

Make sure that you have stopped all domains and other related processes, including command prompts using the installation directory or its subdirectories and any applications using Java SE files.

If you do not stop all domains before the uninstallation, orphaned processes might exist on your system after the uninstallation. Identify the processes using the ps -ef command and terminate them using the kill command.

  1. Navigate to the installation directory.
  2. Run the uninstallation program.

    At the command prompt, type: ./uninstall

The uninstallation program removes the SDK components. Some files and directories remain after running the uninstallation program. Carefully examine the remaining files and directories and clean them up. It is safe to remove uninstallation and installation log files after you have examined them. The installation directory is not automatically removed.

To Run the Uninstallation Program on Windows platform:

Make sure that you have stopped all domains and other related processes, including command prompts using the installation directory or its subdirectories and any applications using Java SE files.

If you do not stop all domains before the uninstallation, orphaned processes might exist on your system after the uninstallation. On Windows, these processes interfere with the uninstallation, because the uninstallation program is unable to remove files that are in use. Identify the processes using the Task Manager and terminate them using the End Task or End Process buttons.

  1. Navigate to the Control Panel.
  2. Choose Add/Remove Programs.
  3. From the list of installed programs, select Java Platform, Enterprise Edition 5 SDK.
  4. Click Remove.

    The uninstallation program removes the SDK and all its components. Some files and directories remain after running the uninstallation program. Carefully examine the remaining files and directories and clean them up. It is safe to remove uninstallation and installation log files after you have examined them. The installation directory is not automatically removed.

To Run the Uninstallation Program on Macintosh platform:

Make sure that you have stopped all domains and other related processes, including command prompts using the installation directory or its subdirectories and any applications using Java SE files.

If you do not stop all domains before the uninstallation, orphaned processes might exist on your system after the uninstallation. On Windows, these processes interfere with the uninstallation, because the uninstallation program is unable to remove files that are in use. Identify the processes using the Task Manager and terminate them using the End Task or End Process buttons.

  1. Navigate to installation directory.
  2. Run the uninstallation program.

    At the command prompt, type: ./uninstall

The uninstallation program removes the SDK and all its components. Some files and directories remain after running the uninstallation program. Carefully examine the remaining files and directories and clean them up. It is safe to remove uninstallation and installation log files after you have examined them. The installation directory is not automatically removed.

Rate and Review
Tell us what you think of the content of this page.
Excellent   Good   Fair   Poor  
Comments: