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:
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 | |
Solaris, Linux, MacOS, UNIX file |
26 MB | |
Windows file |
26 MB |
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.
The section describes how to use the multi-platform file to install Enterprise Server v3 Prelude on all supported platforms.
Ensure that your system meets the requirements that are stated in Required JDK Version in Sun GlassFish Enterprise Server v3 Prelude Release Notes.
Go to the Enterprise Server v3 Prelude download page.
Download the ZIP file.
Change to the directory where you downloaded the ZIP file.
This document refers to the directory you choose for installing as as-install .
Install Enterprise Server v3 Prelude.
unzip zip-file-name |
zip-file-name is the name of the file that you downloaded.
Sun Download Center
GlassFish Community
The v3 Prelude distribution is installed into a new glassfishv3-prelude directory under your current directory.
(Optional) Try the installation by following the procedures in Sun GlassFish Enterprise Server v3 Prelude Quick Start Guide.
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.
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.
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.
Go to the Enterprise Server v3 Prelude download page.
Download the self-extracting installer file.
Start the installer.
Change to the directory where you downloaded the self–extracting file.
If necessary, grant execute permissions to the self–extracting file.
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.
Click Next.
Read and accept the terms of the license agreement.
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
Specify the Administration Settings.
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.
Username and password are case sensitive.
Type port numbers for the Administration Console and HTTP transmissions.
If you selected the Provide username and password button, type the user name.
If you selected the Provide username and password button, type the password.
(Optional) Specify whether to install Update Tool.
Update Tool provides a graphical interface for adding components to Enterprise Server.
If you are not installing Update Tool, clear the Install Update Tool check box.
If you are installing Update Tool and your machine accesses the Internet through a proxy, specify the proxy host and proxy port.
If you do not require the automatic notifications of available updates after installation, clear the Enable Update Tool check box.
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.
Review the Ready to Install selections, and click Install.
After installation, the installer prompts you to register Enterprise Server with Sun Connection.
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.
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.
In the Product Registration window, select the I Already Have a Sun Online Account option.
In the User Name field, type the user name that you specified when registered for your Sun Online Account.
In the Password field, type the password that you specified when registered for your Sun Online Account.
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.
In the Product Registration window, select the I Don't Have a Sun Online Account option.
Click Next.
The Account Creation window opens.
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.
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:
Click Exit.
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.
(Optional) Try out the installation by following the procedures in Sun GlassFish Enterprise Server v3 Prelude Quick Start Guide.
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:
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.
When you perform this task, you will see the installation wizard, which is used to generate the answer file. Actual installation will not happen.
Ensure that your system meets the requirements that are stated in Required JDK Version in Sun GlassFish Enterprise Server v3 Prelude Release Notes.
Go to the Enterprise Server v3 Prelude download page.
Download the self-extracting installer file.
Start an installation in trial mode.
Change to the directory where you downloaded the self–extracting file.
If necessary, grant execute permissions to the self–extracting file.
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.
Click Next.
Read and accept the terms of the license agreement.
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 .
Specify the Administration Settings.
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.
Username and password are case sensitive.
Type port numbers for the Administration Console and HTTP transmissions.
If you selected the Provide username and password button, type the user name.
If you selected the Provide username and password button, type the password.
(Optional) Specify whether to install Update Tool.
Update Tool provides a graphical interface for adding components to Enterprise Server.
If you are not installing Update Tool, clear the Install Update Tool check box.
If you are installing Update Tool and your machine accesses the Internet through a proxy, specify the proxy host and proxy port.
If you do not require the automatic notifications of available updates after installation, clear the Enable Update Tool check box.
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.
Review the Ready to Install selections, and click Install.
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.
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= |
Make sure that the answer file was created.
Review the answer file.
Verify that it the values that you want to use for your silent installation.
Edit the answer file.
You can change these default values only:
Provide another directory name for Enterprise Server v3 Prelude installation files.
Provide another password for access to the Administration Console. This password is case sensitive and must be 6 to 10 characters long.
Assign another port number to the Administration Console.
Provide another user name for the administrator. This name is case sensitive.
Assign another port number to HTTP connections.
Can be set to anonymous or non_anonymous, to require administrator to log in with user name and password.
Change value to false if you do not want notifications of Update Tool checks.
Change value to false if you do not want to install standalone Update Tool.
Assign a name to the proxy host.
Assign a port number to the proxy host.
Parameters that are not in this list are system-specific. Do not change system-specific parameters.
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.
You can use the following options when you run the command for silent mode installations:
Run this program in silent mode using the answer file specified. Use this option with -s option.
Write log information to this directory.
Set logging level to WARNING.
Set logging level to FINEST.
Run this application in silent mode.
Use this directory for the JDK software installation.
Run program in trial mode to generate an answer file to use for silent mode.
Display this help message.
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.
Navigate to the directory where you copied the distribution file and your installation answer file.
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.
Start Enterprise Server.
For instructions, see To Start a Domain (or Server) in Sun GlassFish Enterprise Server v3 Prelude Administration Guide.