This chapter provides instructions for installing Oracle GlassFish Server 3.0.1 and GlassFish Server Open Source Edition 3.0.1 on SolarisTM, Linux, Mac OS X, and Windows systems.
The following topics are addressed:
Ensure that your system meets the requirements listed in Hardware and Software Requirements in Oracle GlassFish Server 3.0.1 Release Notes. Problems are likely to arise if you attempt to install on a platform that is not supported or on a system that in some other way does not meet release requirements. Also see Known Issues in Oracle GlassFish Server 3.0.1 Release Notes for known issues related to installation.
GlassFish Server 3.0.1 requires JDKTM release 6. The minimum (and certified) version of the JDK software that is required for GlassFish Server depends on the operating system:
For supported operating systems except Mac OS X, the minimum required version is 1.6.0_17.
For the Mac OS X operating system, the minimum required version is 1.6.0_15.
If necessary, download and install the required JDK software.
On Solaris, Linux, and Windows systems, JDK software is available from the Java SE downloads page.
For Mac OS X systems, GlassFish Server uses the JDK that is part of the Macintosh operating system. If necessary, obtain the required JDK version from the Mac OS X Updates site.
The following topics are addressed here:
GlassFish Server Installation files are available by download from the following locations:
GlassFish Server 3.0.1 is also part of the Java EE 6 SDK distributions. The SDK distributions are available from the Java EE downloads page and are not described in this document.
After downloading the installation file, set JAVA_HOME and $JAVA_HOME/bin in the PATH to point to the supported JDK version.
Table 1–1 lists the various GlassFish Server installation methods. The table also provides links to installation instructions for each method.
Table 1–1 GlassFish Server 3.0.1 Installation Methods
Installation Method |
Installation Instructions |
---|---|
Multi-platform ZIP file | |
Solaris, Linux, Mac OS, UNIX, or Windows self-extracting bundle in graphical mode | |
Solaris, Linux, Mac OS, UNIX, or Windows self-extracting bundle in silent mode |
The GlassFish Server multi-platform ZIP files are compatible with Solaris, Linux, Mac OS, UNIX, and Windows operating systems. See GlassFish Server Download Locations for a list of download locations.
Table 1–2 lists the available ZIP file downloads.
Table 1–2 GlassFish Server Downloadable ZIP Files
ZIP File |
Description |
---|---|
ogs-3.0.1.zip |
Full Platform distribution of Oracle GlassFish Server |
ogs-3.0.1-web.zip |
Web Profile distribution of Oracle GlassFish Server |
glassfish-3.0.1.zip |
Full Platform distribution of GlassFish Server Open Source Edition |
glassfish-3.0.1-web.zip |
Web Profile distribution GlassFish Server Open Source Edition |
For more information about profiles, see Support for Java EE Profiles in Oracle GlassFish Server 3.0.1 Release Notes.
The GlassFish Server self-extracting bundles are platform-specific, and are available for Solaris, Linux, Mac OS, UNIX, and Windows operating systems. See GlassFish Server Download Locations for a list of download locations.
Table 1–3 lists the available self-extracting bundles.
Table 1–3 GlassFish Server Self-extracting Bundles
ZIP File |
Description |
---|---|
ogs-glassfish-3.0.1-unix.sh ogs-glassfish-3.0.1-windows.exe |
Full Platform distribution of Oracle GlassFish Server for Solaris, Linux, and Mac OS X systems (*-unix.sh) and Windows (*-windows.exe) |
ogs-3.0.1-web-unix.sh ogs-3.0.1-web-windows.exe |
Web Profile distribution of Oracle GlassFish Server for Solaris, Linux, and Mac OS X systems (*-unix.sh) and Windows (*-windows.exe) |
glassfish-3.0.1-unix.sh glassfish-3.0.1-windows.exe |
Full Platform distribution of GlassFish Server Open Source Edition for Solaris, Linux, and Mac OS X systems (*-unix.sh) and Windows (*-windows.exe) |
glassfish-3.0.1-web-unix.sh glassfish-3.0.1-web-windows.exe |
Web Profile distribution GlassFish Server Open Source Edition for Solaris, Linux, and Mac OS X systems (*-unix.sh) and Windows (*-windows.exe) |
For more information about profiles, see Support for Java EE Profiles in Oracle GlassFish Server 3.0.1 Release Notes.
This section describes how to install GlassFish Server 3.0.1 using the multi-platform ZIP file. GlassFish Server is installed by unzipping the file in the installation directory of your choice.
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.
Download the desired GlassFish Server 3.0.1 ZIP file.
See GlassFish Server Download Locations for a list of download locations. See Table 1–2 for a list of available ZIP files.
Change to the directory where you downloaded the ZIP file.
Unzip the file.
Solaris, Linux, and Mac OS X systems:
unzip zip-file-name |
zip-file-name is the name of the file that you downloaded.
For example:
unzip ogs-3.0.1-unix.zip
Windows systems:
Unzip using your favorite file compression utility.
GlassFish Server 3.0.1 is installed into a new glassfishv3 directory under your current directory.
(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.
This section describes how to install GlassFish Server 3.0.1 using the self-extracting installation program. GlassFish 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 GlassFish Server Silent Mode Installation.
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.
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.
Change to the directory where you downloaded the self-extracting file.
Start the installer.
Solaris, Linux, and Mac OS X systems:
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 self-extracting file that you downloaded.
At the command prompt, type:
self-extracting-file-name
For example, start the installer by typing the following:
ogs-3.0.1-unix.sh |
Windows systems:
Additional setup options are available. See Installation Command-Line 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.
Respond to the license agreement, if required.
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.
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.
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.
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.
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.
This JDK page is not presented for Mac OS X installations. The installation uses the value in the JAVA_HOME environment variable.
Review the Ready To Install selections and click Install to proceed with the installation.
Determine whether and how to register GlassFish Server.
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 GlassFish Server following installation.
If you want to register GlassFish 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 GlassFish 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 GlassFish Server at the time of installation, select Skip Registration and click Next. You can register later through the GlassFish Server Administration Console.
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.
(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.
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:
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.
The installation wizard is used to create the answer file. Actual installation does not take place.
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.
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.
Start the installation in trial mode.
Change to the directory where you downloaded the self–extracting file.
On Solaris, Linux, and Mac OS X systems, grant execute permissions to the self–extracting file if necessary:
chmod +x ./self-extracting-file-name
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.
Respond to the license agreement.
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.
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.
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.
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.
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.
This JDK page is not presented for Mac OS X installations. The installation uses the value in the JAVA_HOME environment variable.
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.
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.
#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=
Some values in the answer file can be changed if desired. Such editing is strictly optional.
Create the answer file as described in To Create the Installation Answer File.
Review the answer file.
Review the values that will be used for silent installation.
Edit the answer file.
Only the following default values can be changed:
Provide another directory name for GlassFish Server 3.0.1 installation files.
Provide a password for access to the Administration Console. This password is case sensitive.
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 a location that contains a required JDK 6 installation.
Can be set to true or false. Always set this value to true if you are using the answer file for silent installation.
Not to be used for this release. Ignore this variable.
Change value to false if you do not want Update Tool notifications.
Change value to false if you do not want to install the standalone Update Tool.
Assign a name to the proxy host.
Assign a port number to the proxy host.
Parameters not listed are system specific. Do not change system-specific parameters. Doing so will cause problems with the installation program.
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.
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.
Navigate to the directory that contains the self-extracting installer file and the installation answer file.
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.
(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.
The following options can be used when you run the installation program from the command line using the self-extracting installation file (.sh or .exe). Specify the desired options after typing the installation file name at the command prompt.
For example:
ogs-3.0.1-unix.sh -a 3.0.1-answer -l log-directory -s |
The options are as follows:
Run the installation program in silent mode using the answer file specified. Use this option with the -s option.
Write log information to this directory.
Set logging level to WARNING.
Set logging level to FINEST.
Run the installation program in silent mode.
Use this directory for the JDK software installation.
Run the installation program in trial mode to generate the answer file for silent mode installation.
Display the help message listing these options.