SDK Update 8 Installation Instructions

SDK Update 8 Installation Instructions


These installation instructions describe how to install Java Platform, Enterprise Edition 5 (Java EE 5) SDK Update 8 and Java Application Platform SDK Update 8. The following topics are discussed:

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.

Distributions and Their Components


The following distributions are available and include the components listed:

  • Java Platform, Enterprise Edition 5 SDK Update 8
    • Sun GlassFish Enterprise Server v2.1.1
    • Java EE 5 Samples
    • Java BluePrints
    • Java EE 5 API Documentation
    • JDK 6 Update 20 Software (+ JDK download version only)
    • Your First Cup: An Introduction to the Java EE Platform

  • Java Application Platform SDK Update 8
    • Sun GlassFish Enterprise Server v2.1.1
    • Open ESB v2
    • Sun Java System Access Manager 7.1 Patch 1
    • OpenPortal Portlet Container 2.1
    • Web Services for Remote Portlets 2.0 Beta 2
    • Java EE 5 Samples
    • Java BluePrints
    • Java EE 5 API Documentation
    • JDK 6 Update 20 Software (+ JDK download version only)
    • Your First Cup: An Introduction to the Java EE Platform

For the most current listing of available distributions and components, see the Java EE downloads page.

Installing and Registering the Software


For a summary of hardware and software requirements for this release, see the SDK Release Notes . The Release Notes also contain known issues related to installation.

The SDK requires JDK 5 or JDK 6. For Macintosh systems, the SDK uses the JDK that is part of the Macintosh operating system. If necessary, obtain the required JDK version from the Apple web site. For Mac OS X systems, JDK 1.5.x must be installed in order to install the SDK.

To Install and Register the Software

The following procedure describes how to install the SDK distribution using the GUI-based installation wizard.

  1. Download the distribution file for your platform from the SDK download page. The self-extracting file provides a graphical installation wizard.
  2. Navigate to the directory where you downloaded the file.
  3. Start the installation program:
  • Solaris and Linux
    1. If necessary, grant execute permissions to the distribution file: chmod +x ./ distribution-filename
    2. At the command prompt, type: ./ distribution-filename
  • Macintosh systems (installation requires JDK 1.5.x):
    1. Unzip the distribution file by typing: unzip ./ distribution-filename
    2. If necessary, grant execute permissions to the distribution file: chmod +x ./setup
    3. At the command prompt, type: ./setup  
  • Windows systems: Double-click the executable .exe distribution file.
  1. At the Welcome page of the installation wizard, click Next. Use the Next button to move through the installation process.
  2. Respond to the license agreement.
  3. Identify a directory location for the installation. This directory is referred to as install-dir and will be created if it does not exist.
  4. If you are installing the distribution without the JDK, specify the path to the JDK to be used with this installation. JDK 5 or JDK 6 is required.
  5. On the Admin Configuration page, specify administration settings for Sun GlassFish Enterprise Server (Enterprise Server)

      • Admin User Name: Name of the user who administers the server. The default is admin.
      • Password: Administrator user's password to access the server (8-character minimum).
      • Don't Prompt or Prompt for Admin User Name and Password: Determines whether the administrator user name and password must be provided when performing administrative tasks.
      • Admin Port: Administration port number for the initial server instance. The default value is 4848.
      • HTTP Port: Port number to access the default server instance. The default value is 8080.
      • HTTPS Port: Secure port number to access the default server instance. The default value is 8181.

    • Select the desired installation options.

      • If you select Upgrade from Previous Version, an upgrade wizard is provided at the end of the installation process. The wizard enables you to upgrade from a previous version of the Java EE 5 SDK. For more information about upgrading, see the Sun GlassFish Enterprise Server Upgrade Guide.
      • If you select Enable Updatecenter Client, Update Center will periodically check for available updates and notify you when an update is available for download.

          • For Java Application Platform SDK Update 8, on the Configure Available Add-ons page, select to install Open ESB v2, Portlet Container 2.1, Web Services for Remote Portlets 2.0 Beta 2, and Sun Java System Access Manager 7.1 Patch 1 (selected by default). 
  • 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.1 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 such as eventing, public render parameters, resource serving, and portlet filter. Portlet Container 2.1 also provides a portlet driver, a lightweight portlet rendering environment.
  • Web Services for Remote Portlets 2.0 Beta 2 is 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.
  1. On the Ready to Install page, review the list of components to be installed and click Install Now to proceed.
  2. Specify whether to register Enterprise Server. Registration provides a variety of benefits, including patch information and bug updates, screencasts and tutorials, news and events, and support and training offerings.

      • If you want to register but do not yet have a Sun Online Account, select I Don't Have a Sun Online Account, click Next, and provide the requested information.
      • If you want to register and already have a Sun Online Account, select I Already Have a Sun Online Account, and provide your user name and password.
      • If you do not want to register at the time of installation, select Skip Registration and click Next. You can register later through the Enterprise Server Administration Console or through the Update Center.

    • On the Installation Complete page: 

        • If you selected Upgrade from a Previous Version during the installation process, click Start Upgrade Wizard to launch the upgrade wizard and start the upgrade process (a page listing SDK resources is also displayed after the upgrade wizard button is clicked). Use Next to move through the wizard. Click the Help button for more information about each screen.

        • If you are not upgrading, click Finish to exit the installation program (the Finish button is visible if you chose not to upgrade). To start Enterprise Server before exiting, click Start Server before Finish and wait for confirmation that the server has started. This starts the default Enterprise Server domain, domain1. After confirmation is received that the server has started, click Finish to exit. A page listing SDK resources is displayed.  
After the installation completes:
  • If necessary, start the default Enterprise Server domain, domain1. Change to install-dir /bin and type asadmin start-domain to start domain1. If you have problems starting the server, see the Sun GlassFish Enterprise Server Troubleshooting Guide.
  • Start the Administration Console in a browser with the URL http://localhost:4848 (an Enterprise Server domain must be started first).
  • See the Sun GlassFish Enterprise Server Quick Start Guide for more information about basic tasks and getting started with Enterprise Server. 

Note: See the Sun GlassFish Enterprise Server Installation Guide for information about installing Enterprise Server using the silent installer.

Uninstalling the Software


Before you uninstall the software, make sure 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 want to reinstall the software after running the uninstallation program, ensure that processes related to Enterprise Server are stopped. If not, orphaned processes might interfere with uninstallation, or exist on your system after uninstallation. To identify these processes if necessary:

  • Solaris, Linux, or Macintosh systems: Use the ps -ef command and terminate the processes using the kill command.
  • Windows systems: Use the Task Manager and terminate the processes using the End Task or End Process buttons.


To Uninstall the Software
  1. Navigate to the installation directory.
  2. Start the uninstallation program:
  • Solaris, Linux, or Macintosh systems:
    1. If necessary, grant execute permissions to the uninstall file : chmod +x ./uninstall
    2. At the command prompt, type: ./uninstall
  • Windows systems: Double-click the uninstall.exe file.
  1. Review the Summary page that displays following uninstallation. The page provides summary details and log information. Make note of this information as desired, then click Exit.

The installation directory is not automatically removed by the uninstallation program. Examine the installation directory contents and remove any remaining files or directories that you do not want, including hidden directories prefixed with a dot ( . ) , for example . directory. It is safe to remove uninstallation and installation log files after you have examined them.

Left Curve
Java SDKs and Tools
Right Curve
Left Curve
Java Resources
Right Curve
Java 8 banner (182)



Java One 2014 RHS Banner