test

Sun GlassFish Enterprise Server v3 Prelude Installation 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.