Oracle GlassFish Server 3.0.1 Installation Guide

Using GlassFish Server Silent Mode Installation

This section describes how to install GlassFish Server 3.0.1 using silent mode installation. Silent mode is a non-interactive installation based on user-defined parameters captured in an answer file. The answer file can be used later to install GlassFish Server on one or more systems. The following topics are addressed in this section:

Creating the Installation Answer File

The answer file forms the template for silent installation. The file is created when you use the trial mode (-n) option to start an interactive installation. In trial mode, actual installation does not take place.

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, which is then used to install GlassFish Server. You can use the answer file as it is or you can modify the file before using it.

ProcedureTo Create the Installation Answer File

The installation wizard is used to create the answer file. Actual installation does not take place.

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.

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

  2. Start the installation in trial mode.

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

    2. On Solaris, Linux, and Mac OS X systems, grant execute permissions to the self–extracting file if necessary:

      chmod +x ./self-extracting-file-name

    3. From the command line, type:

      self-extracting-file-name -n answer-file

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

      -n specifies trial mode installation.

      answer-file is the name you assign to the answer file. If you do not include a path to the file, the file is created under the directory from which the installation program is run.

      For example:


      ogs-3.0.1-unix.sh -n 3.0.1-answer
      

    The Welcome page is displayed. Use the Next button to move through the installation process.

  3. Respond to the license agreement.

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

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

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


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


  8. Review the Ready to Install selections and click Install to proceed with trial mode installation and create the answer file.

    Unless a path to the file was specified in Step 2, the answer file is created under the directory from which the installation program is run.

Reviewing the Installation Answer File

The answer file provides a number of system-specific parameters as well as parameters that you selected during trial mode installation. Values for some parameters can be edited as described in To Edit the Answer File.

The following example shows the contents of an answer file that was created during a trial mode installation. Default values were accepted during the installation.


Example 1–1 Example Answer File

#openInstaller Dry Run Answer File. This File can be used as input to
the openInstaller engine using the -a option.
#Tue Nov 10 19:25:05 PST 2009
RegistrationOptions.regoptions.CREATE_NEWACCT=CREATE_NEWACCT
glassfish.Administration.HTTP_PORT=8080
updatetool.Configuration.PROXY_PORT=
glassfish.Administration.ADMIN_PASSWORD=
JDKSelection.directory.JDK_FROM_LIST_CHOICE=true
RegistrationOptions.regoptions.SKIP_REGISTRATION=SKIP_REGISTRATION
updatetool.Configuration.PROXY_HOST=
SOAccountCreation.accountinfo.COUNTRY=
InstallHome.directory.INSTALL_HOME=C\:\\glassfishv3
RegistrationOptions.regoptions.USE_EXISTINGACCT=USE_EXISTINGACCT
SOAccountCreation.accountinfo.FIRSTNAME=
updatetool.Configuration.ALLOW_UPDATE_CHECK=true
glassfish.Administration.ADMIN_USER=admin
JDKSelection.directory.JDK_LIST=JDK-location
SOAccountCreation.accountinfo.PASSWORD=
SOAccountCreation.accountinfo.COMPANYNAME=
JDKSelection.directory.HIDDEN_JDK=JDK-location
SOAccountCreation.accountinfo.COUNTRY_DROP_DOWN=
SOAccountCreation.accountinfo.REENTERPASSWORD=
License.license.ACCEPT_LICENSE=0
RegistrationOptions.regoptions.USERNAME=
updatetool.Configuration.BOOTSTRAP_UPDATETOOL=true
SOAccountCreation.accountinfo.LASTNAME=
glassfish.Administration.ADMIN_PORT=4848
RegistrationOptions.regoptions.USERPASSWORD=
JDKSelection.directory.JDK_TYPED_IN_CHOICE=false
SOAccountCreation.accountinfo.EMAIL=
JDKSelection.directory.JDK_TYPE_IN=
RegistrationOptions.regoptions.DUMMY_PROP=

ProcedureTo Edit the Answer File

Some values in the answer file can be changed if desired. Such editing is strictly optional.

Before You Begin

Create the answer file as described in To Create the Installation Answer File.

  1. Review the answer file.

    Review the values that will be used for silent installation.

  2. Edit the answer file.

    Only the following default values can be changed:

    InstallHome.directory.INSTALL_HOME=as-install-parent

    Provide another directory name for GlassFish Server 3.0.1 installation files.

    glassfish.Administration.ADMIN_PASSWORD=

    Provide a password for access to the Administration Console. This password is case sensitive.

    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.JDK_TYPE_IN=jdk-location

    Can be set to a location that contains a required JDK 6 installation.

    glassfish.Administration.JDK_TYPED_IN_CHOICE=true

    Can be set to true or false. Always set this value to true if you are using the answer file for silent installation.

    glassfish.Administration.HIDDEN_JDK=jdk-location

    Not to be used for this release. Ignore this variable.

    updatetool.Configuration.ALLOW_UPDATE_CHECK=true

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

    updatetool.Configuration.BOOTSTRAP_UPDATE=true

    Change value to false if you do not want to install the 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 not listed are system specific. Do not change system-specific parameters. Doing so will cause problems with the installation program.


Installing in Silent Mode

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

ProcedureTo Install Using Silent Mode

Before You Begin

Create the answer file as described in To Create the Installation Answer File.

Verify that the parameters in the answer file are set to the values that you want to use for silent installation.

  1. Navigate to the directory that contains the self-extracting installer file and the installation answer file.

  2. From the command line, type:

    self-extracting-file-name -a answer-file -s

    self-extracting-file-name is the name of the file that you downloaded during Creating the Installation Answer File. Ensure that you provide the complete path to the answer file.

    -a specifies the name of the answer-file. If you do not include a path to the file, the file is created under the directory from which the installation program is run.

    -s specifies running in silent mode.

    For example:


    ogs-3.0.1-unix.sh -a 3.0.1-answer -s
    

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

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