Java Platform, Enterprise Edition 6 SDK Preview - Installation Instructions

These installation instructions provide the steps required for installing Java Platform, Enterprise Edition 6 SDK Preview and Java Platform, Enterprise Edition 6 Web Profile SDK Preview. The following topics are discussed:

• Distributions and Their Components
• Installing and Registering the Software
• Next Steps and Resources
  
• Uninstalling the Software
  

Solaris Linux, and MacOS 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 Preview
• Sun GlassFish Enterprise Server v3 Preview
  
• Your First Cup: An Introduction to the Java EE Platform
• Java EE 6 Samples
• Java EE 6 API Documentation
• Java Platform, Enterprise Edition 6 (Java EE 6) Web Profile SDK Preview
• Sun GlassFish Enterprise Server v3 Web Profile Preview
  
• Your First Cup: An Introduction to the Java EE Platform
• Java EE 6 Samples
• Java EE 6 API Documentation

Visit the Java EE 6 SDK Preview download page for more information about each distribution.

Installing and Registering the Software

For a summary of supported platforms and hardware and software requirements for this release, see the Java EE 6 SDK Preview Release Notes.

Java EE 6 SDK Preview distributions require JDK release 6. The minimum (and certified version) of the JDK that is required for the SDK distributions depends on the operating system:

• For supported operating systems except MacOS, the minimum required version is 1.6.0_13.
• For the MacOS operating system, the minimum required version is 1.6.0_07.

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

For MacOS X systems, the SDK uses the JDK that is part of the Macintosh operating system. If necessary, obtain the required JDK 1.6 version from the Apple web site.

To Install and Register the Software

The following procedure describes how to install the SDK distribution using the GUI-based installation wizard. To install using the non-interactive silent mode, see the Sun GlassFish Enterprise Server v3 Preview Installation Guide for detailed instructions.

1. Download the distribution file for your platform from the Java EE 6 SDK Preview 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, or MacOS X systems:


1. If necessary, grant execute permissions to the .sh 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. Identify a directory location for the installation. This directory is referred to as install-dir and will be created if it does not exist.


7. Specify administration settings for Enterprise Server.

• To allow access to the Administration Console without a password, select Configure as Anonymous User.


• To require a password for access to the Administration Console, select Provide Username and Password.


• Specify port numbers for the Administration Console and HTTP transmissions. The default value for Admin Port is 4848, and for HTTP Port is 8080. 


• Specify the administrator user name and password. These values are case sensitive.

8. Specify whether to install Update Tool, a graphical interface for adding components to Enterprise Server.
   
   
   • If you are not installing Update Tool, deselect the Install Update Tool check box.
   
   
   • If you are installing Update Tool and your computer 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 manually later from install-dir/bin/.

9. Specify the path to the JDK to be used with this installation. JDK requirements are described just prior to this procedure.
   
   Note: This JDK page is not presented for MacOS X installations. The SDK uses the JDK that is part of the Macintosh operating system. If necessary, obtain the required JDK 1.6 version from the Apple web site.

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


11. After installation, specify whether to register Enterprise Server with Sun Connection. Sun Connection provides a variety of benefits to registered users.

• If you want to register Enterprise 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 Enterprise 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 Enterprise Server 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.

12. Review the Summary page that displays following registration. The page provides installation information and a link to the Sun GlassFish Enterprise Server v3 Preview Quick Start Guide. Make note of this information as desired, and 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 MacOS 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 helps you become familiar with Enterprise Server and explains how to perform basic tasks such as starting the server, accessing the Administration Console, and deploying a sample application.

• Product Documentation. The online product documentation provides more information about Enterprise Server, including the latest Release Notes.

• 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 is a web application that consists of an Enterprise JavaBean, a JAX-RS web service, and a JavaServer Faces Facelet web front end.

• Java EE 6 Samples. Java EE 6 samples demonstrate Java EE 6 technologies and help you learn more about them. 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. Java EE 6 Tutorial, Volume I provides a beginner's guide to developing enterprise applications for Enterprise 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, the Java Persistence API, and more.
  

• Java EE 6 API Documentation. Java EE 6 API documentation provides API reference documentation for Enterprise 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 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 and Update Tool (including the notifier) 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 MacOS 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.

1. Navigate to the installation directory.


2. Start the uninstallation program:

• Solaris, Linux, or MacOS 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, and 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 MacOS 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.