test

Sun GlassFish Enterprise Server v3 Installation Guide

Using Enterprise Server GUI Installation

This section describes how to install Enterprise Server v3 using the self-extracting installation program. Enterprise 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 Enterprise Server Silent Mode Installation.

ProcedureTo Install Enterprise Server Using the Self-Extracting File

Before You Begin

Ensure that your system meets the requirements listed in Hardware and Software Requirements in Sun GlassFish Enterprise Server v3 Release Notes.

Also see Known Issues in Sun GlassFish Enterprise Server v3 Release Notes for known issues related to installation.

  1. Go to the Enterprise Server v3 download page:

  2. Download the self-extracting installer file.

    Two distributions are available: Full Platform Profile and Web Profile. For more information about each profile, see Support for Java EE Profiles in Sun GlassFish Enterprise Server v3 Release Notes.

    Download files are as follows:

    • Solaris, Linux, and Mac OS X systems:

      sges-glassfish-v3-unix.sh

      Full Platform Profile distribution from the Sun Download Center

      sges-v3-web-unix.sh

      Web Profile distribution from the Sun Download Center

      glassfish-v3-unix.sh

      Full Platform Profile distribution from the GlassFish Community site

      glassfish-v3-web-unix.sh

      Web Profile distribution from the GlassFish Community site

    • Windows systems:

      sges-v3-windows.exe

      Full Platform Profile distribution from the Sun Download Center

      sges-v3-web-windows.exe

      Web Profile distribution from the Sun Download Center

      glassfish-v3-windows.exe

      Full Platform Profile distribution from the GlassFish Community site

      glassfish-v3-web-windows.exe

      Web Profile distribution from the GlassFish Community site

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

  4. 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 file that you downloaded in Step 2.

      2. At the command prompt, type:

        self-extracting-file-name

        For example, start the installer by typing the following:

        sges-v3-unix.sh

    • Windows systems:

      1. Double-click the executable .exe installation file.

        For example, double-click:

        sges-v3–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 Setup 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.

  5. Respond to the license agreement.

  6. Specify where to install Enterprise Server.

    • Accept the default directory.

      The software will be installed in the following location:

      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 Enterprise Server documentation.

    • Specify the path to a directory other than the default.

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

  8. 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 Enterprise Server v3 installation. Update Tool can be installed during Enterprise Server installation or at a later time. For more information about Update Tool, see Update Tool in Sun GlassFish Enterprise Server v3 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 Enterprise Server to the current version. For more information about Upgrade Tool, see the Sun GlassFish Enterprise Server v3 Upgrade Guide.

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

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

  11. Determine whether and how to register Enterprise 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 Enterprise Server following installation.

    • 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 that 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.

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

  13. (Optional) Start Enterprise Server using the instructions in the Sun GlassFish Enterprise Server v3 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.