test

Sun GlassFish Enterprise Server v3 Prelude Installation Guide

Chapter 1 Installing Sun GlassFish v3 Prelude Enterprise Server

This chapter provides instructions for installing Sun GlassFishTM Enterprise Server v3 Prelude on SolarisTM, Linux, MacOS X, and Windows systems. The following topics are provided:

Installation Files for Sun GlassFish Enterprise Server v3 Prelude

Download installation files for Enterprise Server v3 Prelude are available from the following locations:

Table 1–1 lists installation choices that are available and provides approximate files sizes and a link to the instructions for installing each option.

Table 1–1 Download Options for Enterprise Server v3 Prelude

Download Option 

File Size 

Installation Steps 

Multi-platform ZIP file  

29 MB 

Using Enterprise Server v3 Prelude ZIP File Installation.

Solaris, Linux, MacOS, UNIX file 

26 MB 

Using Enterprise Server v3 Prelude GUI Installation.

Windows file 

26 MB 

Using Enterprise Server v3 Prelude GUI Installation.

For a summary of hardware and software requirements for this release, see Hardware and Software Requirements in Sun GlassFish Enterprise Server v3 Prelude Release Notes.

Using Enterprise Server v3 Prelude ZIP File Installation

The section describes how to use the multi-platform file to install Enterprise Server v3 Prelude on all supported platforms.

ProcedureTo Install Enterprise Server From the ZIP File

Before You Begin

Ensure that your system meets the requirements that are stated in Required JDK Version in Sun GlassFish Enterprise Server v3 Prelude Release Notes.

  1. Go to the Enterprise Server v3 Prelude download page.

  2. Download the ZIP file.

  3. Change to the directory where you downloaded the ZIP file.

    This document refers to the directory you choose for installing as as-install .

  4. Install Enterprise Server v3 Prelude.


    unzip zip-file-name

    zip-file-name is the name of the file that you downloaded.

    sges-v3–prelude.zip

    Sun Download Center

    glassfish-v3-prelude.zip

    GlassFish Community

    The v3 Prelude distribution is installed into a new glassfishv3-prelude directory under your current directory.

  5. (Optional) Try the installation by following the procedures in Sun GlassFish Enterprise Server v3 Prelude Quick Start Guide.

Using Enterprise Server v3 Prelude GUI Installation

This section describes how to install Enterprise Server v3 Prelude on Solaris, Linux, MacOS X, and Windows systems. A self-extracting file used for this installation provides a GUI-based installation wizard. The wizard's graphical interface provides an easy-to-use installation based on user responses.

Requirements for Installing on Linux Systems

If Enterprise Server v3 Prelude will be installed on a Linux system, read this section for important information about some Linux environments.

Installing with Open JDK prevents registration during installation on some Linux platforms.

Use the Administration Console to register your Enterprise Server v3 Prelude installation.

ProcedureTo Install Enterprise Server From the Self-Extracting File

Before You Begin

If you will be installing the self-extracting file on a Linux system, read Requirements for Installing on Linux Systems.

Ensure that your system meets the requirements that are stated in Required JDK Version in Sun GlassFish Enterprise Server v3 Prelude Release Notes.

  1. Go to the Enterprise Server v3 Prelude download page.

  2. Download the self-extracting installer file.

    • Solaris, Linux, and MacOS X systems

      sges-v3-prelude-unix.sh

      Sun Download Center

      glassfish-v3-prelude-unix.sh

      GlassFish Community

    • Windows systems

      sges-v3-prelude-windows.exe

      Sun Download Center

      glassfish-v3-prelude-windows.exe

      GlassFish Community

  3. Start the installer.

    1. Change to the directory where you downloaded the self–extracting file.

    2. If necessary, grant execute permissions to the self–extracting file.

    3. Extract the contents of the self extracting file.

      self-extracting-file-name

      self-extracting-file-name is the name of the file that you downloaded in Step 2.

      For example:

      sges-v3-prelude-unix.sh

    The Welcome screen of the Enterprise Server v3 Prelude installer appears.

  4. Click Next.

  5. Read and accept the terms of the license agreement.

  6. Specify where to install Enterprise Server.

    • To use the default directory, click Next.

      The software will be installed in the following directory:

      user's-home-directory/glassfishv3-prelude

    • To use another directory for installing Enterprise Server, type the installation directory path that you set up, and click Next.

    This document refers to the directory you choose for installing as as-install

  7. Specify the Administration Settings.

    1. Select the type of user.

      • To allow access to the Administration Console without a password, select the Configure as anonymous user button.

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

        Note –

        Username and password are case sensitive.

    2. Type port numbers for the Administration Console and HTTP transmissions.

    3. If you selected the Provide username and password button, type the user name.

    4. If you selected the Provide username and password button, type the password.

  8. (Optional) Specify whether to install Update Tool.

    Update Tool provides a graphical interface for adding components to Enterprise Server.

    1. If you are not installing Update Tool, clear the Install Update Tool check box.

    2. If you are installing Update Tool and your machine accesses the Internet through a proxy, specify the proxy host and proxy port.

    3. If you do not require the automatic notifications of available updates after installation, clear the Enable Update Tool check box.

    Note –

    If you plan to register Enterprise Server with Sun Connection, specify the proxy host and proxy port, even if you are not installing Update Tool.

  9. Review the Ready to Install selections, and click Install.

    After installation, the installer prompts you to register Enterprise Server with Sun Connection.

  10. Determine whether and how to register Enterprise Server with Sun Connection.

    To register your installation of Enterprise Server v3 Prelude with Sun Connection, you must have a Sun Online Account. If you do not have a Sun Online Account, the Enterprise Server installer enables you to create an account while registering Enterprise Server.

    Note –

    If you create a Sun Online Account while registering Enterprise Server v3 Prelude, you are prompted only for the required information. You can provide additional, optional information by updating your Sun Online Account.

    • If you already have a Sun Online Account, register Enterprise Server with Sun Connection.

      1. In the Product Registration window, select the I Already Have a Sun Online Account option.

      2. In the User Name field, type the user name that you specified when registered for your Sun Online Account.

      3. In the Password field, type the password that you specified when registered for your Sun Online Account.

      4. Click Next.

        After the registration is complete, the Summary page shows the status of the installation. You can view the installation summary and installation log.

    • If you do not already have a Sun Online Account, create an account and register Enterprise Server with Sun Connection.

      1. In the Product Registration window, select the I Don't Have a Sun Online Account option.

      2. Click Next.

        The Account Creation window opens.

      3. In the Account Creation window, provide the required information.

        Your email address will be your Sun Online Account user name.

        The password is case sensitive and must be 6 to 10 characters long.

      4. Click next.

        After the registration is complete, the Summary page shows the status of the installation. You can view the installation summary and installation log.

    • If you decline to register Enterprise Server with Sun Connection, complete the installation as follows:

      1. In the Product Registration window, select the Skip Registration option.

      2. Click Next.

        The Summary page shows the status of the installation. You can view the installation summary and installation log.

  11. Click Exit.

  12. Review the installation log files.

    The names of the installation log files are timestamp-install.log and timestamp-install-summary.html.

    Solaris, Linux, and MacOS X systems: Installation log files are generated in the $TMP directory.

    Windows systems: Installation log files are generated in the %TEMP% directory.

  13. (Optional) Try out the installation by following the procedures in Sun GlassFish Enterprise Server v3 Prelude Quick Start Guide.

Using Enterprise Server v3 Prelude Silent Mode Installation

This section describes how to install Enterprise Server v3 Prelude on Solaris, Linux, MacOS X, and Windows systems by using silent mode. Silent mode is a non-interactive installation based on user-defined parameters in an answer file. This section provides the following topics:

Setting up the Installation Answer File

The answer file forms the template for silent installation, which you can use later to install the software on one or more machines. The installation answer file is created when you use a trial mode (-n) option when you start an interactive installation. In trial mode, actual installation does not happen.

During the interactive installation, you can accept the default values presented, or you can change them. Your input is collected and stored in the answer file, and you can use the answer file as is, or you can modify the answer file before you use it.

ProcedureTo Create the Installation Answer File

When you perform this task, you will see the installation wizard, which is used to generate the answer file. Actual installation will not happen.

Before You Begin

Ensure that your system meets the requirements that are stated in Required JDK Version in Sun GlassFish Enterprise Server v3 Prelude Release Notes.

  1. Go to the Enterprise Server v3 Prelude download page.

  2. Download the self-extracting installer file.

    • Solaris, Linux, and MacOS X systems

      sges-v3-prelude-unix.sh

      Sun Download Center

      glassfish-v3-prelude-unix.sh

      GlassFish Community

    • Windows systems

      sges-v3-prelude-windows.exe

      Sun Download Center

      glassfish-v3-prelude-windows.exe

      GlassFish Community

  3. Start an installation in trial mode.

    1. Change to the directory where you downloaded the self–extracting file.

    2. If necessary, grant execute permissions to the self–extracting file.

    3. From the command line, type:

      distribution-file -n answer-file

      distribution-file is the name of the file that you downloaded in Step 2.

      -n option specifies trial mode to create a save file to use for silent mode.

      answer-file is the name you assign to your answer file. If you do not include a path to the installation answer file, the file is created in the directory where you run the installation program.

      For example:

      sges-v3-prelude-unix.sh -n v3–prelude-answer

    The Welcome screen of the Enterprise Server v3 Prelude installer appears.

  4. Click Next.

  5. Read and accept the terms of the license agreement.

  6. Specify where to install Enterprise Server.

    • To use the default directory, click Next.

      The software will be installed in one of the following directories:

      • Solaris, Linux, and MacOS X systems: user's-home-directory/glassfishv3-prelude

      • Windows systems: C:\glassfishv3-prelude

    • To use another directory for installing Enterprise Server, type the installation directory path that you set up, and click Next.

    This document refers to the directory you choose for installing as as-install .

  7. Specify the Administration Settings.

    1. Select the type of user.

      • To allow access to the Administration Console without a password, select the Configure as anonymous user button.

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

        Note –

        Username and password are case sensitive.

    2. Type port numbers for the Administration Console and HTTP transmissions.

    3. If you selected the Provide username and password button, type the user name.

    4. If you selected the Provide username and password button, type the password.

  8. (Optional) Specify whether to install Update Tool.

    Update Tool provides a graphical interface for adding components to Enterprise Server.

    1. If you are not installing Update Tool, clear the Install Update Tool check box.

    2. If you are installing Update Tool and your machine accesses the Internet through a proxy, specify the proxy host and proxy port.

    3. If you do not require the automatic notifications of available updates after installation, clear the Enable Update Tool check box.

    Note –

    If you plan to register Enterprise Server with Sun Connection, specify the proxy host and proxy port, even if you are not installing Update Tool.

  9. Review the Ready to Install selections, and click Install.

Verifying the Installation Answer File

The default answer file provides a number of system-specific parameters as well as the parameters that you selected during your installation. After your installation, you can change the values of those parameters that you can edit.

Example 1–1 The Default Answer File

The following example shows the contents of a default answer file created during a silent mode installation that accepted default values.


#Fri Oct 24 12:00:54 PDT 2008
#openInstaller Dry Run Answer File.  This File can be used as input to 
the openInstaller engine using the -a option.
InstallHome.directory.INSTALL_HOME=/glassfishv3-prelude
License.license.ACCEPT_LICENSE=0
RegistrationOptions.regoptions.CREATE_NEWACCT=CREATE_NEWACCT
RegistrationOptions.regoptions.DUMMY_PROP=
RegistrationOptions.regoptions.SKIP_REGISTRATION=SKIP_REGISTRATION
RegistrationOptions.regoptions.USERNAME=
RegistrationOptions.regoptions.USERPASSWORD=
RegistrationOptions.regoptions.USE_EXISTINGACCT=USE_EXISTINGACCT
SOAccountCreation.accountinfo.COMPANYNAME=
SOAccountCreation.accountinfo.COUNTRY=
SOAccountCreation.accountinfo.COUNTRY_DROP_DOWN=
SOAccountCreation.accountinfo.EMAIL=
SOAccountCreation.accountinfo.FIRSTNAME=
SOAccountCreation.accountinfo.LASTNAME=
SOAccountCreation.accountinfo.PASSWORD=
SOAccountCreation.accountinfo.REENTERPASSWORD=
glassfish.Administration.ADMIN_PASSWORD=adminadmin
glassfish.Administration.ADMIN_PORT=4848
glassfish.Administration.ADMIN_USER=admin
glassfish.Administration.ANONYMOUS=ANONYMOUS
glassfish.Administration.LOGIN_MODE=true
glassfish.Administration.HTTP_PORT=8080
glassfish.Administration.NON_ANONYMOUS=NON_ANONYMOUS
updatetool.Configuration.ALLOW_UPDATE_CHECK=true
updatetool.Configuration.BOOTSTRAP_UPDATETOOL=true
updatetool.Configuration.PROXY_HOST=
updatetool.Configuration.PROXY_PORT=

Procedure(Optional) To Edit the Answer File

Before You Begin

Make sure that the answer file was created.

  1. Review the answer file.

    Verify that it the values that you want to use for your silent installation.

  2. Edit the answer file.

    You can change these default values only:

    InstallHome.directory.INSTALL_HOME=/glassfishv3-prelude

    Provide another directory name for Enterprise Server v3 Prelude installation files.

    glassfish.Administration.ADMIN_PASSWORD=adminadmin

    Provide another password for access to the Administration Console. This password is case sensitive and must be 6 to 10 characters long.

    glassfish.Administration.ADMIN_PORT=4848

    Assign another port number to the Administration Console.

    glassfish.Administration.ADMIN_USER=admin

    Provide another user name for the administrator. This name is case sensitive.

    glassfish.Administration.HTTP_Port=8080

    Assign another port number to HTTP connections.

    glassfish.Administration.login_mode=anonymous

    Can be set to anonymous or non_anonymous, to require administrator to log in with user name and password.

    updatetool.Configuration.ALLOW_UPDATE_CHECK=true

    Change value to false if you do not want notifications of Update Tool checks.

    updatetool.Configuration.BOOTSTRAP_UPDATE=true

    Change value to false if you do not want to install standalone Update Tool.

    updatetool.Configuration.PROXY_HOST=

    Assign a name to the proxy host.

    updatetool.Configuration.PROXY_PORT=

    Assign a port number to the proxy host.

    Note –

    Parameters that are not in this list are system-specific. Do not change system-specific parameters.

Installing in Silent Mode

The non-interactive installation program reads the specified answer file, checks for adequate disk space, and installs Enterprise Server based on the data in the answer file.

Using the Silent Mode Installation Command

You can use the following options when you run the command for silent mode installations:

-a answer-file

Run this program in silent mode using the answer file specified. Use this option with -s option.

-l log-directory

Write log information to this directory.

-q

Set logging level to WARNING.

-v

Set logging level to FINEST.

-s

Run this application in silent mode.

-j javahome

Use this directory for the JDK software installation.

-n answer-file

Run program in trial mode to generate an answer file to use for silent mode.

[-h | -help]

Display this help message.

ProcedureTo Install in Silent Mode

Before You Begin

Verify that the parameters in the answer file are set to values that you want to use for your silent installation. For more information about the file, see Example 1–1.

  1. Navigate to the directory where you copied the distribution file and your installation answer file.

  2. From the command line, type:

    distribution-file -a answer-file -s

    distribution-file is the name of the file that you downloaded during the Setting up the Installation Answer File process.

    -a option specifies the name of your answer-file. If you do not include a path to the installation answer file, the file is created in the directory where you run the installation program.

    -s option specifies running in silent mode.

    For example:

    sges-v3-prelude-unix.sh -a v3–prelude-answer -s

    When the prompt is returned, the silent installation is complete, and the installation components are installed on your system.

  3. Start Enterprise Server.

    For instructions, see To Start a Domain (or Server) in Sun GlassFish Enterprise Server v3 Prelude Administration Guide.