Oracle GlassFish Server 3.0.1 Installation Guide

Using GlassFish Server GUI Installation

This section describes how to install GlassFish Server 3.0.1 using the self-extracting installation program. GlassFish Server is installed using a GUI-based installation wizard.

Console installation is not supported in this release. Silent mode installation is available, however. For more information, see Using GlassFish Server Silent Mode Installation.

To Install GlassFish Server Using the Self-Extracting File

Before You Begin

Ensure that your system meets the requirements listed in Hardware and Software Requirements in Oracle GlassFish Server 3.0.1 Release Notes.

Also see Known Issues in Oracle GlassFish Server 3.0.1 Release Notes for known issues related to installation.

Download the desired GlassFish Server 3.0.1 bundle.

See GlassFish Server Download Locations for a list of download locations. See Table 1–3 for a list of available self-extracting bundles.

Change to the directory where you downloaded the self-extracting file.

Start the installer.
- Solaris, Linux, and Mac OS X systems:
  1. If necessary, grant execute permissions to the self–extracting file:
    
    chmod +x ./self-extracting-file-name
    
    self-extracting-file-name is the name of the self-extracting file that you downloaded.
  2. At the command prompt, type:
    
    self-extracting-file-name
    
    For example, start the installer by typing the following:
    ogs-3.0.1-unix.sh
- Windows systems:
  1. Double-click the executable .exe installation file.
    
    For example, double-click:
    
    ogs-3.0.1–windows.exe
    
    On Windows you can also start the installer by typing the file name at the command prompt.
Note –
Additional setup options are available. See Installation Command-Line Options.

If you are installing on a 64–bit Windows system, run the installer with the -j option pointing to a 64–bit JDK.

After starting the installer, the Welcome page is displayed. Use the Next button to move through the installation process.

Respond to the license agreement, if required.

Specify where to install GlassFish Server.

The default installation directory is as follows:
- Solaris, Linux, and Mac OS X systems: user's-home-directory/glassfishv3
- Windows systems: SystemDrive:\glassfishv3
The default installation directory is referred to as as-install-parent throughout GlassFish Server documentation.

Specify administration settings.
- 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 admin 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.

Specify whether to install Update Tool.

Update Tool is an administrative tool that enables you to install updates and add-on components to an existing GlassFish Server 3.0.1 installation. Update Tool can be installed during GlassFish Server installation or at a later time. For more information about Update Tool, see Update Tool in Oracle GlassFish Server 3.0.1 Administration Guide.
- If you are not installing Update Tool, deselect the Install Update Tool check box.
- If you are installing Update Tool and your system accesses the Internet through a proxy, specify the proxy host and proxy port.
- If you are installing Update Tool and do not require the automatic notifications of available updates after installation, deselect the Enable Update Tool check box.
Note –
Update Tool differs from Upgrade Tool, which is used to migrate the configuration and deployed applications from an earlier version of GlassFish Server to the current version. For more information about Upgrade Tool, see the Oracle GlassFish Server 3.0.1 Upgrade Guide.

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

Use a JDK installation detected by the installer or specify the path for a different JDK.

JDK 6 is required. See Installation Requirements for more information.

Note –
This JDK page is not presented for Mac OS X installations. The installation uses the value in the JAVA_HOME environment variable.

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

Determine whether and how to register GlassFish Server.

Note –
It is recommended that you select the Skip Registration option during installation.

Also, installing with Open JDK prevents registration during installation on some Linux platforms. For those environments, use the Administration Console to register GlassFish Server following installation.
- 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 that 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.

Review the summary page that displays after registration and click Exit to exit the installer.

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

(Optional) Start GlassFish Server using the instructions in the Oracle GlassFish Server 3.0.1 Quick Start Guide.

The guide explains how to perform basic tasks such as starting the server, accessing the Administration Console, and deploying a sample application.