Java Platform, Enterprise Edition 6 SDK - Installation Instructions

Java Platform, Enterprise Edition 6 SDK Update 1- Installation Instructions

These installation instructions describe how to install Java Platform, Enterprise Edition 6 SDK Update 1 and Java Platform, Enterprise Edition 6 Web Profile SDK Update 1. The following topics are discussed:

Solaris, Linux, and  Mac OS X installations support root/superuser and non-root/standard user installations. For Windows installations, users 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 6 (Java EE 6) SDK Update 1
    • GlassFish Server Open Source Edition 3.0.1
    • Your First Cup: An Introduction to the Java EE Platform
    • Java EE 6 Samples
    • Java EE 6 API Documentation
    • Java EE 6 Tutorial

  • Java Platform, Enterprise Edition 6 (Java EE 6) Web Profile SDK Update 1
    • GlassFish Server Open Source Edition 3.0.1 Web Profile
    • Your First Cup: An Introduction to the Java EE Platform
    • Java EE 6 Samples
    • Java EE 6 API Documentation
    • Java EE 6 Tutorial

Visit the Java EE downloads page for more information about each distribution.

Preconfigured Repositories


The functionality offered by The Java EE 6 SDK Update 1 is organized into OSGi modules, or bundles, that are available as components through the image packaging system (IPS). When you install the SDK, it is preconfigured to use several IPS repositories that together house the OSGi modules available in the SDK. These preconfigured repositories are:

Repository URL Description Authority
pkg.sun.com/javaeesdk/6/release/ This is the preferred repository. This repository will host all FCS Java EE SDK packages. release.javaeesdk.sun.com
pkg.sun.com/glassfish/v3/contrib/ This repository hosts all non-open source partner-contributed packages. contrib.glassfish.sun.com
pkg.glassfish.org/v3/contrib/ This repository hosts open source third party-contributed packages (from partners, etc.). contrib.glassfish.org
pkg.sun.com/javaeesdk/6/dev/ This repository hosts pre-FCS packages. dev.javaeesdk.sun.com
 

The first of these, pkg.sun.com/javaeesdk/6/release/, has its publisher designated as the preferred publisher, and so is treated specially by the IPS tools:

  • If an add-on component is available from the preferred publisher as well as from other publishers, the Update Tool GUI and the pkg CLI will list and install the component from the preferred publisher.

  • Once a component has been installed from the preferred publisher, the Update Tool, Software Update, and desktop notifier GUIs will look for updates to that component only from the preferred publisher.

Installing and Registering the Software


Requirements

For a summary of supported platforms and the hardware and software requirements for this release, see the Java EE 6 SDK Update 1 Release Notes . Ensure that your system meets these requirements.

Java EE 6 SDK Update 1 distributions require JDK release 6. The minimum (and certified version) of the JDK that is required for Java EE 6 SDK Update 1 distributions is 1.6.0_20.

Ensure that the required JDK software is installed on your system and that the JAVA_HOME environment variable points to the JDK installation directory, not the Java Runtime Environment (JRE) software.

For Mac OS X systems, the SDK uses the JDK that is part of the Macintosh operating system. If necessary, obtain the required JDK version from the Mac OS X Updates site.

To Install and Register the Software

The following procedure describes how to install the SDK distributions using the GUI-based installation wizard. To install using the non-interactive silent mode, see the Oracle GlassFish Server 3.0.1 Installation Guide for detailed instructions.

  1. Download the distribution file for your platform from the Java EE 6 SDK Update 1 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, Linux, and Mac OS X systems:
      1. If necessary, grant execute permissions to the distribution file: chmod +x ./ distribution-filename
      2. At the command prompt, type: ./ distribution-filename

    • Windows systems: Double-click the executable .exe distribution file.

  4. At the Welcome page of the installation wizard, click Next. Use the Next button to move through the installation process.

  5. Respond to the license agreement.

  6. Specify the installation directory. This directory is referred to as install-dir and will be created if it does not exist.

  7. Specify administration settings for GlassFish Server.

    • Specify port numbers for the Administration Console and HTTP transmissions. The default value for Admin Port is 4848 and for HTTP Port is 8080.
    • To allow access to the Administration Console without a password, leave Username as it is and the Password field empty.
    • To require a password for access to the Administration Console, specify a user name and password in the corresponding fields. User name and password are case sensitive.

  8. Specify whether to install Update Tool, an administrative tool that enables you to install updates and add-on components for GlassFish Server.

    • If you are not installing Update Tool, deselect the Install Update Tool check box. Update Tool can be installed later using the install-dir /bin/updatetool command.
    • If you are installing Update Tool and your system accesses the Internet through a proxy, specify the proxy host and proxy port.
    • If you want to install Update Tool but do not require the automatic notifications of available updates after installation, deselect the Enable Update Tool check box.

    Note: This step might take a while depending on the server environment that serves this request. If it takes considerable time, cancel the installation and run the installation program again, but this time deselect the Install Update Tool check box. Update Tool can be installed later using the updatetool command as described above .

  9. Specify the path to the JDK to be used with this installation.

    JDK requirements are described just prior to this procedure. This JDK page is not presented for Mac OS X installations. The installation uses the value in the JAVA_HOME environment variable.

  10. Review the Ready To Install selections and click Install to proceed with the installation.

  11. After installation, specify whether to register GlassFish Server.

    Registration provides a variety of benefits, including patch information and bug updates, screencasts and tutorials, news and events, and support and training offerings. You must have a Sun Online Account to register.

    • If you want to register GlassFish Server 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 GlassFish Server and already have a Sun Online Account, select I Already Have a Sun Online Account, and provide your user name and password. Your user name is the email address you specified when you created the account.
    • If you do not want to register GlassFish Server at the time of installation, select Skip Registration and click Next. You can register later through the GlassFish Server Administration Console.

  12. Review the Summary page that displays following registration. The page provides installation information and a link to the Oracle GlassFish Server 3.0.1 Quick Start Guide. Make note of this information as desired, then click Exit.

    The names of the installation log and summary files are timestamp- install.log and timestamp- install-summary.html. On Solaris, Linux, and Mac OS X systems, these files are generated in the $TMP directory. On Windows systems, these files are generated in the %TEMP% directory.

Next Steps and Resources


Use the following resources after installation.

  • Quick Start Guide. The Quick Start Guide enables you to become familiar with GlassFish Server. The guide explains how to perform basic tasks such as starting the server, accessing the Administration Console, and deploying a sample application.
  • First Cup. Your First Cup: An Introduction to the Java EE Platform provides a short tutorial for beginning Java EE programmers that shows how to develop a simple enterprise application from scratch. The sample application consists of four main components: a JAX-RS RESTful web service, an enterprise bean, a Java Persistence API entity, and a web application created with JavaServer Faces Facelets technology.
  • Java EE 6 Samples. The Java EE 6 sample applications help you learn more about Java EE 6 technologies. After installation, samples are located in install-dir /glassfish /samples/javaee6. See the index.html file in that location for more information about the samples.
  • Java EE 6 Tutorial. The Java EE 6 Tutorial is a guide to developing enterprise applications for GlassFish Server. The tutorial includes working examples and instructions for creating applications with Java EE 6 technologies, including Java Servlets, JavaServer Faces, Facelets, RESTful Web Services, Enterprise JavaBeans, Java Persistence API, Contexts and Dependency Injection for the Java EE Platform, and more. The tutorial is also available through Update Tool.
  • Java EE 6 API Documentation. View the Java EE 6 API documentation, which provides API reference documentation for GlassFish Server packages and related APIs. This documentation is generated from the source code by the Javadoc tool, and after installation is accessed from install-dir /glassfish /docs /api /index.html.

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, the Update Tool notifier process if present, and any applications using Java SE files.

To stop domains, use the asadmin stop-domain command. For more information about this command, see the Oracle GlassFish Server 3.0.1 Reference Manual . To stop the Update Tool notifier process, use the updatetool --notifier --shutdown command, executed from install-dir /bin . If Update Tool is installed, the notifier is running by default.

If orphaned processes remain, identify and terminate the processes as follows:

  • Solaris, Linux, and Mac OS X 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, and Mac OS X systems:
      1. If necessary, grant execute permissions to the uninstall file : chmod +x uninstall.sh
      2. At the command prompt, type: ./uninstall.sh

    • Windows systems: Double-click the uninstall.exe file.

  3. 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 names of the uninstallation log and summary files are timestamp- remove.log and timestamp- remove-summary.html. On Solaris, Linux, and Mac OS X systems, these files are generated in the $TMP directory. On Windows systems, these files are generated in the %TEMP% directory.

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