Sun Microsystems GlassFish Enterprise Server, GlassFish 3 Installation Manual

Sun GlassFish Enterprise Server v3 Installation Guide

Sun Microsystems, Inc. 4150 Network Circle Santa Clara, CA 95054 U.S.A.

Part No: 820–7690–11 December 2009

Sun Microsystems, Inc. has intellectual property rights relating to technology embodied in the product that is described in this document. In particular, and without limitation, these intellectual property rights may include one or more U.S. patents or pending patent applications in the U.S. and in other countries.

U.S. Government Rights – Commercial software. Government users are subject to the Sun Microsystems, Inc. standard license agreement and applicable provisions of the FAR and its supplements.

This distribution may include materials developed by third parties.

Parts of the product may be derived from Berkeley BSD systems, licensed from the University of California. UNIX is a registered trademark in the U.S. and other countries, exclusively licensed through X/Open Company, Ltd.

Sun, Sun Microsystems, the Sun logo, the Solaris logo, the Java Coee Cup logo, docs.sun.com, Enterprise JavaBeans, EJB, GlassFish, J2EE, J2SE, Java Naming and Directory Interface, JavaBeans, Javadoc, JDBC, JDK, JavaScript, JavaServer, JavaServer Pages, JMX, JRE, JSP, JVM, MySQL, NetBeans, OpenSolaris, SunSolve, Sun GlassFish, Java, and Solaris are trademarks or registered trademarks of Sun Microsystems, Inc. or its subsidiaries in the U.S. and other countries. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARCInternational, Inc. in the U.S. and other countries. Products bearing SPARC trademarks are based upon an architecture developed by Sun Microsystems, Inc.

The OPEN LOOK and Sun

Graphical User Interface was developed by Sun Microsystems, Inc. for its users and licensees. Sun acknowledges the pioneering eorts of Xerox in researching and developing the concept of visual or graphical user interfaces for the computer industry. Sun holds a non-exclusive license from Xerox to the Xerox Graphical User Interface, which license also covers Sun's licensees who implement OPEN LOOK GUIs and otherwise comply with Sun's written license agreements.

Products covered by and information contained in this publication are controlled by U.S. Export Control laws and may be subject to the export or import laws in other countries. Nuclear, missile, chemical or biological weapons or nuclear maritime end uses or end users, whether direct or indirect, are strictly prohibited. Export or reexport to countries subject to U.S. embargo or to entities identied on U.S. export exclusion lists, including, but not limited to, the denied persons and specially designated nationals lists is strictly prohibited.

DOCUMENTATION IS PROVIDED “AS IS” AND ALL EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES, INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT, ARE DISCLAIMED, EXCEPT TO THE EXTENT THAT SUCH DISCLAIMERS ARE HELD TO BE LEGALLY INVALID.

Sun Microsystems, Inc. détient les droits de propriété intellectuelle relatifs à la technologie incorporée dans le produit qui est décrit dans ce document. En particulier, et ce sans limitation, ces droits de propriété intellectuelle peuvent inclure un ou plusieurs brevets américains ou des applications de brevet en attente aux Etats-Unis et dans d'autres pays.

Cette distribution peut comprendre des composants développés par des tierces personnes.

Certaines composants de ce produit peuvent être dérivées du logiciel Berkeley BSD, licenciés par l'Université de Californie. UNIX est une marque déposée aux Etats-Unis et dans d'autres pays; elle est licenciée exclusivement par X/Open Company, Ltd.

Sun, Sun Microsystems, le logo Sun, le logo Solaris, le logo Java Coee Cup, docs.sun.com, Enterprise JavaBeans, EJB, GlassFish, J2EE, J2SE, Java Naming and Directory Interface, JavaBeans, Javadoc, JDBC, JDK, JavaScript, JavaServer, JavaServer Pages, JMX, JRE, JSP, JVM, MySQL, NetBeans, OpenSolaris, SunSolve, Sun GlassFish, Java et Solaris sont des marques de fabrique ou des marques déposées de Sun Microsystems, Inc., ou ses liales, aux Etats-Unis et dans d'autres pays. Toutes les marques SPARCsont utilisées sous licence et sont des marques de fabrique ou des marques déposées de SPARCInternational, Inc. aux Etats-Unis et dans d'autres pays. Les produits portant les marques SPARCsont basés sur une architecture développée par Sun Microsystems, Inc.

L'interface d'utilisation graphique OPEN LOOK et Sun a été développée par Sun Microsystems, Inc. pour ses utilisateurs et licenciés. Sun reconnaît les eorts de pionniers de Xerox pour la recherche et le développement du concept des interfaces d'utilisation visuelle ou graphique pour l'industrie de l'informatique. Sun détient une licence non exclusive de Xerox sur l'interface d'utilisation graphique Xerox, cette licence couvrant également les licenciés de Sun qui mettent en place l'interface d'utilisation graphique OPEN LOOK et qui, en outre, se conforment aux licences écrites de Sun.

Les produits qui font l'objet de cette publication et les informations qu'il contient sont régis par la legislation américaine en matière de contrôle des exportations et peuvent être soumis au droit d'autres pays dans le domaine des exportations et importations. Les utilisations nales, ou utilisateurs naux, pour des armes nucléaires, des missiles, des armes chimiques ou biologiques ou pour le nucléaire maritime, directement ou indirectement, sont strictement interdites. Les exportations ou réexportations vers des pays sous embargo des Etats-Unis, ou vers des entités gurant sur les listes d'exclusion d'exportation américaines, y compris, mais de manière non exclusive, la liste de personnes qui font objet d'un ordre de ne pas participer, d'une façon directe ou indirecte, aux exportations des produits ou des services qui sont régis par la legislation américaine en matière de contrôle des exportations et la liste de ressortissants spéciquement designés, sont rigoureusement interdites.

LA DOCUMENTATION EST FOURNIE "EN L'ETAT" ET TOUTES AUTRESCONDITIONS, DECLARATIONS ET GARANTIES EXPRESSES OU TACITES SONT FORMELLEMENT EXCLUES, DANS LA MESURE AUTORISEE PAR LA LOI APPLICABLE, Y COMPRIS NOTAMMENT TOUTE GARANTIE IMPLICITE RELATIVE A LA QUALITE MARCHANDE, A L'APTITUDE A UNE UTILISATION PARTICULIEREOU A L'ABSENCE DE CONTREFACON.

091224@23031

Contents

Preface .....................................................................................................................................................5

1 Installing Sun GlassFish Enterprise Server v3 ................................................................................ 11

Installation Requirements .................................................................................................................. 11

Installation Files for Enterprise Server v3 ......................................................................................... 12

Using Enterprise Server ZIP File Installation ................................................................................... 12

▼ To Install Enterprise Server Using the ZIP File ........................................................................ 12

Using Enterprise Server GUI Installation ......................................................................................... 14

▼ To Install Enterprise Server Using the Self-Extracting File ..................................................... 14

Using Enterprise Server Silent Mode Installation ........................................................................... 18

Creating the Installation Answer File ........................................................................................ 18

Reviewing the Installation Answer File ..................................................................................... 21

Installing in Silent Mode ............................................................................................................. 23

Installation Setup Options .................................................................................................................. 24

2 Uninstalling Sun GlassFish Enterprise Server v3 ........................................................................... 25

Removing an Enterprise Server Installation .................................................................................... 25

▼ To Uninstall Enterprise Server Software ................................................................................... 25

Index ......................................................................................................................................................29

Preface

This document contains instructions for installing and uninstalling Sun GlassFishTMEnterprise Server v3.

This preface contains information about and conventions for the entire Sun GlassFish Enterprise Server (Enterprise Server) documentation set.

Enterprise Server v3 is developed through the GlassFish project open-source community at

https://glassfish.dev.java.net/. The GlassFish project provides a structured process for

developing the Enterprise Server platform that makes the new features of the Java EE platform available faster, while maintaining the most important feature of Java EE: compatibility. It enables Java developers to access the Enterprise Server source code and to contribute to the development of the Enterprise Server. The GlassFish project is designed to encourage communication between Sun engineers and the community.

The following topics are addressed here:

■

“Enterprise Server Documentation Set” on page 5

■

“Related Documentation” on page 7

■

“Typographic Conventions” on page 8

■

“Symbol Conventions” on page 8

■

“Default Paths and File Names” on page 9

■

“Documentation, Support, and Training” on page 10

■

“Searching Sun Product Documentation” on page 10

■

“Third-Party Web Site References” on page 10

■

“Sun Welcomes Your Comments” on page 10

Enterprise Server Documentation Set

The Enterprise Server documentation set describes deployment planning and system installation. The Uniform Resource Locator (URL) for Enterprise Server documentation is

http://docs.sun.com/coll/1343.9. For an introduction to Enterprise Server, refer to the

books in the order in which they are listed in the following table.

TABLE P–1 Books in the Enterprise Server Documentation Set

Book Title Description

Release Notes Provides late-breaking information about the software and the

documentation. Includes a comprehensive, table-based summary of the supported hardware, operating system, Java

Development Kit (JDKTM),

and database drivers.

Quick Start Guide Explains how to get started with the Enterprise Server product.

Installation Guide Explainshow to install the software and its components.

Upgrade Guide Explains how to upgrade to the latest version of Enterprise Server. This guide

also describes dierences between adjacent product releases and conguration options that can result in incompatibility with the product specications.

Administration Guide Explains how to congure, monitor, and manage Enterprise Server

subsystems and components from the command line by using the

asadmin(1M) utility. Instructions for performing these tasks from the

Administration Console are provided in the Administration Console online help.

Application Deployment Guide Explains how to assemble and deploy applications to the Enterprise Server

and provides information about deployment descriptors.

Your First Cup: An Introduction to the Java EE Platform

Provides a short tutorial for beginning Java EE programmers that explains the entire process for developing a simple enterprise application. The sample application is a web application that consists of a component that is based on the Enterprise JavaBeans

specication, a JAX-RS web service, and a

JavaServer

Faces component for the web front end.

Application Development Guide Explainshow to create and implement Java Platform, Enterprise Edition

(Java EE platform) applications that are intended to run on the Enterprise Server. These applications follow the open Java standards model for Java EE components and APIs. This guide provides information about developer tools, security, and debugging.

Add-On Component Development Guide

Explains how to use published interfaces of Enterprise Server to develop add-on components for Enterprise Server. This document explains how to perform only those tasks that ensure that the add-on component is suitable for Enterprise Server.

Embedded Server Guide Explains how to run applications in embedded Enterprise Server and to

develop applications in which Enterprise Server is embedded.

Scripting Framework Guide Explains how to develop scripting applications in languages such as Ruby on

Rails and Groovy on Grails for deployment to Enterprise Server.

Troubleshooting Guide Describes common problems that you might encounter when using

Enterprise Server and how to solve them.

Preface

Sun GlassFish Enterprise Server v3 Installation Guide • December 20096

TABLE P–1 Books in the Enterprise Server Documentation Set (Continued)

Book Title Description

Error Message Reference Describes error messages that you might encounter when using Enterprise

Server.

Reference Manual Provides reference information in man page format for Enterprise Server

administration commands, utility commands, and related concepts.

Domain File Format Reference Describes the format of the Enterprise Server conguration le, domain.xml.

Java EE 6 Tutorial, Volume I Explains how to use Java EE 6 platform technologies and APIs to develop

Java EE applications.

Message Queue Release Notes Describes new features, compatibility issues, and existing bugs for Sun

GlassFish Message Queue.

Message Queue Administration Guide

Explains how to set up and manage a Sun GlassFish Message Queue messaging system.

Message Queue Developer's Guide for JMX Clients

Describes the application programming interface in Sun GlassFish Message Queue for programmatically conguring and monitoring Message Queue resources in conformance with the Java Management Extensions (JMX).

System Virtualization Support in Sun Java System Products

Summarizes Sun support for Sun Java System products when used in conjunction with system virtualization products and features.

Related Documentation

The Java EE 6 Tutorial, Volume II (https://www.sun.com/offers/details/ java_ee6_tutorial.xml)

contains all the topics in Java EE 6 Tutorial, Volume I and adds advanced topics, additional technologies, and case studies. The document is available to registered users of Enterprise Server.

Javadoc

tool reference documentation for packages that are provided with Enterprise Server is

available as follows:

■

The API specication for version 6 of Java EE is located at http://java.sun.com/javaee/

6/docs/api/

■

The API specication for Enterprise Server v3, including Java EE 6 platform packages and nonplatform packages that are specic to the Enterprise Server product, is located at:

https://glassfish.dev.java.net/nonav/docs/v3/api/.

Additionally, the following resources might be useful:

■

The Java EE Specications (http://java.sun.com/javaee/technologies/index.jsp)

■

The Java EE Blueprints (http://java.sun.com/reference/blueprints/index.html)

For information about creating enterprise applications in the NetBeansTMIntegrated Development Environment (IDE), see

http://www.netbeans.org/kb/60/index.html.

Preface

For information about the Java DB for use with the Enterprise Server, see

http://developers.sun.com/javadb/.

The sample applications demonstrate a broad range of Java EE technologies. The samples are bundled with the Java EE Software Development Kit (SDK).

Typographic Conventions

The following table describes the typographic changes that are used in this book.

TABLE P–2 TypographicConventions

Typeface Meaning Example

AaBbCc123 The names of commands, les, and

directories, and onscreen computer output

Edit your .login le.

Use ls -a to list all les.

machine_name% you have mail.

AaBbCc123 What you type, contrasted with onscreen

computer output

machine_name% su

Password:

AaBbCc123 A placeholder to be replaced with a real

name or value

The command to remove a le is rm lename.

AaBbCc123 Book titles, new terms, and terms to be

emphasized (note that some emphasized items appear bold online)

Read Chapter 6 in the User's Guide.

A cache is a copy that is stored locally.

Do not save the le.

Symbol Conventions

The following table explains symbols that might be used in this book.

TABLE P–3 SymbolConventions

Symbol Description Example Meaning

[] Contains optional arguments

and command options.

ls [-l] The -l option is not required.

{|} Contains a set of choices for a

required command option.

-d {y|n} The -d option requires that you use either the y argument or the n argument.

Preface

Sun GlassFish Enterprise Server v3 Installation Guide • December 20098

TABLE P–3 SymbolConventions (Continued)

Symbol Description Example Meaning

${ } Indicates a variable

reference.

${com.sun.javaRoot} References the value of the

com.sun.javaRoot variable.

- Joins simultaneous multiple keystrokes.

Control-A Press the Control key while you press

the A key.

+ Joins consecutive multiple

keystrokes.

Ctrl+A+N Press the Control key, release it, and

then press the subsequent keys.

→ Indicates menu item

selection in a graphical user interface.

File → New → Templates From the File menu, choose New.

From the New submenu, choose Templates.

Default Paths and File Names

The following table describes the default paths and le names that are used in this book.

TABLE P–4 Default Paths and File Names

Placeholder Description Default Value

as-install Represents the base installation directory for

Enterprise Server.

In conguration les, as-install is represented as follows:

${com.sun.aas.installRoot}

Installations on the Solaris

operating system, Linux operating

system, and Mac operating system:

user’s-home-directory/glassfishv3/glassfish

Windows, all installations:

SystemDrive:\glassfishv3\glassfish

as-install-parent Represents the parent of the base installation

directory for Enterprise Server.

Installations on the Solaris operating system, Linux operating system, and Mac operating system:

user’s-home-directory/glassfishv3

Windows, all installations:

SystemDrive:\glassfishv3

domain-root-dir Represents the directory in which a domain is

created by default.

as-install/domains/

domain-dir Represents the directory in which a domain's

conguration is stored.

In conguration les, domain-dir is represented as follows:

${com.sun.aas.instanceRoot}

domain-root-dir/domain-name

Preface

Documentation, Support, and Training

The Sun web site provides information about the following additional resources:

■

Documentation (http://www.sun.com/documentation/)

■

Support (http://www.sun.com/support/)

■

Training (http://www.sun.com/training/)

Searching Sun Product Documentation

Besides searching Sun product documentation from the docs.sun.comSMweb site, you can use a search engine by typing the following syntax in the search eld:

search-term site:docs.sun.com

For example, to search for “broker,” type the following:

broker site:docs.sun.com

To include other Sun web sites in your search (for example, java.sun.com, www.sun.com, and

developers.sun.com), use sun.com in place of docs.sun.com in the search eld.

Third-Party Web Site References

Third-party URLs are referenced in this document and provide additional, related information.

Note – Sun is not responsible for the availability of third-party web sites mentioned in this

document. Sun does not endorse and is not responsible or liable for any content, advertising, products, or other materials that are available on or through such sites or resources. Sun will not be responsible or liable for any actual or alleged damage or loss caused or alleged to be caused by or in connection with use of or reliance on any such content, goods, or services that are available on or through such sites or resources.

Sun WelcomesYour Comments

Sun is interested in improving its documentation and welcomes your comments and suggestions. To share your comments, go to http://docs.sun.com and click Send Comments. In the online form, provide the full document title and part number. The part number is a 7-digit or 9-digit number that can be found on the book's title page or in the document's URL. For example, the part number of this book is 820-7690.

Preface

Sun GlassFish Enterprise Server v3 Installation Guide • December 200910

Installing Sun GlassFish Enterprise Server v3

This chapter provides instructions for installing Sun GlassFishTMEnterprise Server v3 (Enterprise Server) on Solaris

, Linux, Mac OS X, and Windows systems.

The following topics are addressed:

■

“Installation Requirements” on page 11

■

“Installation Files for Enterprise Server v3” on page 12

■

“Using Enterprise Server ZIP File Installation” on page 12

■

“Using Enterprise Server GUI Installation” on page 14

■

“Using Enterprise Server Silent Mode Installation” on page 18

■

“Installation Setup Options” on page 24

Installation Requirements

Ensure that your system meets the requirements listed in “Hardware and Software

Requirements” in Sun GlassFish Enterprise Server v3 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 Sun GlassFish Enterprise Server

v3 Release Notes

for known issues related to installation.

Enterprise Server v3 requires JDK

release 6. The minimum (and certied) version of the JDK

software that is required for Enterprise 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 (http://java.sun.com/javase/downloads/index.jsp).

CHAPTER 1

For Mac OS X systems, Enterprise 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

(http://www.apple.com/downloads/macosx/apple/macosx_updates/)

Installation Files for Enterprise Server v3

Installation les are available by download from the following locations:

■

Sun Download Center (http://www.sun.com/software/products/appsrvr/)

■

GlassFish Community site (http://download.java.net/glassfish/v3/release/)

Table 1–1

lists the download options. The table also provides links to installation instructions

for each option.

TABLE 1–1 Download Options for Enterprise Server v3

Download Option Installation Instructions

Multi-platform ZIP le “Using Enterprise Server ZIP File Installation” on page 12.

Solaris, Linux, Mac OS, UNIX le

“Using Enterprise Server GUI Installation” on page 14.

Windows le

“Using Enterprise Server GUI Installation” on page 14.

Enterprise Server v3 is also part of the Java EE 6 SDK distributions. The SDK distributions are available from the

Java EE downloads page (http://java.sun.com/javaee/downloads/

index.jsp)

and are not described in this document.

Note – After downloading the installation le, set JAVA_HOME and $JAVA_HOME/bin in the PATH to

point to the supported JDK version.

Using Enterprise Server ZIP File Installation

This section describes how to install Enterprise Server v3 using the multi-platform ZIP le. Enterprise Server is installed by unzipping the le in the installation directory of your choice.

▼

To Install Enterprise Server Using the ZIP File

Ensure that your system meets the requirements listed in “Hardware and Software

Requirements” in Sun GlassFish Enterprise Server v3 Release Notes

Also see

“Known Issues” in Sun GlassFish Enterprise Server v3 Release Notes for known issues

related to installation.

BeforeYou Begin

Installation Files for Enterprise Server v3

Sun GlassFish Enterprise Server v3 Installation Guide • December 200912

Go to the Enterprise Server v3 download page:

■

Sun Download Center (http://www.sun.com/software/products/appsrvr/)

■

GlassFish Community site (http://download.java.net/glassfish/v3/release/)

Download the ZIP le to the desired installation directory.

Two distributions are available: Full Platform Prole or Web Prole. For more information about each prole, see

“Support for Java EE Proles” in Sun GlassFish Enterprise Server v3

Release Notes

Download les are as follows:

sges-v3.zip Full Platform Prole distribution from the Sun Download Center

sges-v3-web.zip Web Prole distribution from the Sun Download Center

glassfish-v3.zip Full Platform Prole distribution from the GlassFish Community

site

glassfish-v3-web.zip Web Prole distribution from the GlassFish Community site

Change to the directory where you downloaded the ZIP le.

Unzip the le.

■

Solaris, Linux, and Mac OS X systems:

unzip zip-le-name

zip-le-name is the name of the le that you downloaded.

For example:

unzip sges-v3-unix.zip

■

Windows systems:

Unzip using your favorite le compression utility.

Enterprise Server v3 is installed into a new glassfishv3 directory under your current directory.

(Optional) Start Enterprise Server using the instructions in the

Sun GlassFish Enterprise Server

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

Using Enterprise ServerZIP File Installation

Chapter 1 • Installing Sun GlassFish Enterprise Serverv3 13

Using Enterprise Server GUI Installation

This section describes how to install Enterprise Server v3 using the self-extracting installation program. Enterprise 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 Enterprise Server Silent Mode Installation” on

page 18.

▼

To Install Enterprise Server Using the Self-Extracting File

Ensure that your system meets the requirements listed in “Hardware and Software

Requirements” in Sun GlassFish Enterprise Server v3 Release Notes

Also see

“Known Issues” in Sun GlassFish Enterprise Server v3 Release Notes for known issues

related to installation.

Go to the Enterprise Server v3 download page:

■

Sun Download Center (http://www.sun.com/software/products/appsrvr/)

■

GlassFish Community site (http://download.java.net/glassfish/v3/release/)

Download the self-extracting installer le.

Two distributions are available: Full Platform Prole and Web Prole. For more information about each prole, see

“Support for Java EE Proles” in Sun GlassFish Enterprise Server v3

Release Notes

Download les are as follows:

■

Solaris, Linux, and Mac OS X systems:

sges-glassfish-v3-unix.sh Full Platform Prole distribution from the Sun

Download Center

sges-v3-web-unix.sh Web Prole distribution from the Sun Download Center

glassfish-v3-unix.sh Full Platform Prole distribution from the GlassFish

Community site

glassfish-v3-web-unix.sh Web Prole distribution from the GlassFish Community

site

■

Windows systems:

sges-v3-windows.exe Full Platform Prole distribution from the Sun

Download Center

BeforeYou Begin

Using Enterprise ServerGUI Installation

Sun GlassFish Enterprise Server v3 Installation Guide • December 200914

sges-v3-web-windows.exe Web Prole distribution from the Sun Download

Center

glassfish-v3-windows.exe Full Platform Prole distribution from the GlassFish

Community site

glassfish-v3-web-windows.exe Web Prole distribution from the GlassFish

Community site

Change to the directory where you downloaded the self-extracting le.

Start the installer.

■

Solaris, Linux, and Mac OS X systems:

a. Ifnecessary, grant execute permissions to the self–extracting le:

chmod +x ./self-extracting-le-name

self-extracting-le-name is the name of the le that you downloaded in

Step 2.

b. At the command prompt, type:

self-extracting-le-name

For example, start the installer by typing the following:

sges-v3-unix.sh

■

Windows systems:

a. Double-click the executable .exe installation le.

For example, double-click:

sges-v3–windows.exe

On Windows you can also start the installer by typing the le name at the command prompt.

Note – Additional setup options are available. See “Installation Setup Options” on page 24.

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.

Using Enterprise ServerGUI Installation

Chapter 1 • Installing Sun GlassFish Enterprise Serverv3 15

Specify where to install Enterprise Server.

■

Accept the default directory.

The software will be installed in the following location:

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 Enterprise Server documentation.

■

Specify the path to a directory other than the default.

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 eld empty.

■

To require a password for access to the Administration Console, specify a user name and password in the corresponding elds. 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 Enterprise Server v3 installation. Update Tool can be installed during Enterprise Server installation or at a later time. For more information about Update Tool, see

“Update Tool” in Sun GlassFish Enterprise Server v3 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 notications of available updates after installation, deselect the Enable Update Tool check box.

Note – Update Tool diers from Upgrade Tool, which is used to migrate the conguration and

deployed applications from an earlier version of Enterprise Server to the current version. For more information about Upgrade Tool, see the

Sun GlassFish Enterprise Server v3 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 dierent JDK.

JDK 6 is required. See

“Installation Requirements” on page 11 for more information.

Using Enterprise ServerGUI Installation

Sun GlassFish Enterprise Server v3 Installation Guide • December 200916

Note – 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 Enterprise Server.

Note – 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 Enterprise Server following installation.

■

If you want to register Enterprise 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 Enterprise 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 specied when you created the account.

■

If you do not want to register Enterprise Server at the time of installation, select Skip Registration and click Next. You can register later through the Enterprise Server Administration Console.

Review the summary page that displays after registration and click Exit to exit the installer.

Installation information is captured in log les. The names of the les are timestamp-install.log and timestamp-install-summary.html. On Solaris, Linux, and Mac OS X systems, these les are generated under the $TMP directory. On Windows systems, these les are generated under the %TEMP% directory.

(Optional) Start Enterprise Server using the instructions in the

Sun GlassFish Enterprise Server

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

Using Enterprise ServerGUI Installation

Chapter 1 • Installing Sun GlassFish Enterprise Serverv3 17

Using Enterprise Server Silent Mode Installation

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

■

“Creating the Installation Answer File” on page 18

■

“Reviewing the Installation Answer File” on page 21

■

“Installing in Silent Mode” on page 23

Creating the Installation Answer File

The answer le forms the template for silent installation. The le 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 le, which is then used to install Enterprise Server. You can use the answer le as it is or you can modify the le before using it.

▼

To Create the Installation Answer File

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

Ensure that your system meets the requirements listed in

“Hardware and Software

Requirements” in Sun GlassFish Enterprise Server v3 Release Notes

Also see

“Known Issues” in Sun GlassFish Enterprise Server v3 Release Notes for known issues

related to installation.

Go to the Enterprise Server v3 download page:

■

Sun Download Center (http://www.sun.com/software/products/appsrvr/)

■

GlassFish Community site (http://download.java.net/glassfish/v3/release/)

Download the self-extracting installer le.

Two distributions are available: Full Platform Prole or Web Prole. For more information about each prole, see

“Support for Java EE Proles” in Sun GlassFish Enterprise Server v3

Release Notes

Download les are as follows:

■

Solaris, Linux, and Mac OS X systems:

BeforeYou Begin

Using Enterprise ServerSilent Mode Installation

Sun GlassFish Enterprise Server v3 Installation Guide • December 200918

sges-glassfish-v3-unix.sh Full Platform Prole distribution from the Sun

Download Center

sges-v3-web-unix.sh Web Prole distribution from the Sun Download Center

glassfish-v3-unix.sh Full Platform Prole distribution from the GlassFish

Community site

glassfish-v3-web-unix.sh Web Prole distribution from the GlassFish Community

site

■

Windows systems:

sges-v3-windows.exe Full Platform Prole distribution from the Sun

Download Center

sges-v3-web-windows.exe Web Prole distribution from the Sun Download

Center

glassfish-v3-windows.exe Full Platform Prole distribution from the GlassFish

Community site

glassfish-v3-web-windows.exe Web Prole distribution from the GlassFish

Community site

Start the installation in trial mode.

a. Changeto the directorywhere you downloaded the self–extracting le.

b. On Solaris,Linux, and Mac OS X systems, grant execute permissions to the self–extracting

le if necessary:

chmod +x ./self-extracting-le-name

c. From the command line, type:

self-extracting-le-name -n answer-le

self-extracting-le-name is the name of the le that you downloaded in

Step 2.

-n species trial mode installation.

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

For example:

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

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

Respond to the license agreement.

Using Enterprise ServerSilent Mode Installation

Chapter 1 • Installing Sun GlassFish Enterprise Serverv3 19

Specify where to install Enterprise Server.

■

Accept the default directory.

The software will be installed in the following location:

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 Enterprise Server documentation.

■

Specify the path to a directory other than the default.

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 eld empty.

■

To require a password for access to the Administration Console, specify a user name and password in the corresponding elds. User name and password are case sensitive.

Specify whether to install Update Tool.

“Update Tool” in Sun GlassFish Enterprise Server v3 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 notications of available updates after installation, deselect the Enable Update Tool check box.

Note – Update Tool diers from Upgrade Tool, which is used to migrate the conguration and

deployed applications from an earlier version of Enterprise Server to the current version. For more information about Upgrade Tool, see the

Sun GlassFish Enterprise Server v3 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 dierent JDK.

JDK 6 is required. See

“Installation Requirements” on page 11 for more information.

Using Enterprise ServerSilent Mode Installation

Sun GlassFish Enterprise Server v3 Installation Guide • December 200920

Note – 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 le.

Unless a path to the le was specied in

Step 3, the answer le is created under the directory

from which the installation program is run.

Reviewing the Installation Answer File

The answer le provides a number of system-specic 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” on page 22.

The following example shows the contents of an answer le 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=

Using Enterprise ServerSilent Mode Installation

Chapter 1 • Installing Sun GlassFish Enterprise Serverv3 21

EXAMPLE 1–1 Example Answer File (Continued)

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=

▼

To Edit the Answer File

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

Create the answer le as described in

“To Create the Installation Answer File” on page 18.

Review the answer le.

Review the values that will be used for silent installation.

Edit the answer le.

Only the following default values can be changed:

InstallHome.directory.INSTALL_HOME=as-install-parent

Provide another directory name for Enterprise Server v3 installation les.

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 le for silent installation.

glassfish.Administration.HIDDEN_JDK=jdk-location

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

BeforeYou Begin

Using Enterprise ServerSilent Mode Installation

Sun GlassFish Enterprise Server v3 Installation Guide • December 200922

updatetool.Configuration.ALLOW_UPDATE_CHECK=true

Change value to false if you do not want Update Tool notications.

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 specic. Do not change system-specic parameters.

Doing so will cause problems with the installation program.

Installing in Silent Mode

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

▼

To Install Using Silent Mode

Create the answer le as described in “To Create the Installation Answer File” on page 18.

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

Navigate to the directory that contains the self-extracting installer le and the installation answer le.

From the command line, type:

self-extracting-le-name -a answer-le -s

self-extracting-le-name is the name of the le that you downloaded during

“Creating the

Installation Answer File” on page 18

. Ensure that you provide the complete path to the answer

le.

-a species the name of the answer-le. If you do not include a path to the le, the le is created under the directory from which the installation program is run.

-s species running in silent mode.

For example:

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

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

BeforeYou Begin

Using Enterprise ServerSilent Mode Installation

Chapter 1 • Installing Sun GlassFish Enterprise Serverv3 23

(Optional) Start Enterprise Server using the instructions in the Sun GlassFish Enterprise Server

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

Installation Setup Options

The following options can be used when you run the installation program from the command line using the self-extracting installation le (.sh or .exe). Specify the desired options after typing the installation le name at the command prompt.

For example:

sges-v3-unix.sh -a v3-answer -l log-directory -s

The options are as follows:

-a answer-le

Run the installation program in silent mode using the answer le specied. Use this option with the -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 the installation program in silent mode.

-j javahome

Use this directory for the JDK software installation.

-n answer-le

Run the installation program in trial mode to generate the answer le for silent mode installation.

-h or -help Display the help message listing these options.

Installation Setup Options

Sun GlassFish Enterprise Server v3 Installation Guide • December 200924

Uninstalling Sun GlassFish Enterprise Server v3

This chapter describes how to uninstall Sun GlassFish Enterprise Server v3 and remove its components.

Removing an Enterprise Server Installation

This section describes how to remove Enterprise Server software that was installed using the self-extracting le. During installation, a script for uninstalling Enterprise Server is placed in the installation directory. This section provides instructions for removing the software using this script. If you attempt to remove the software using another method, problems are likely to arise when you try to reinstall the same version of Enterprise Server or when you install a new version.

Note – To uninstall a ZIP installation, manually remove the contents of the installation directory

after making sure that there are no les that you want to keep.

▼

To Uninstall Enterprise Server Software

Stop all domains and other related processes, including command prompts using the installation directory or its subdirectories, the Update Tool notier process if present, and any applications using Java SE les.

To stop domains, use the asadmin stop-domain command. For more information about stopping a domain, see

“To Stop a Domain” in Sun GlassFish Enterprise Server v3

Administration Guide.

To stop the Update Tool notier process, use the updatetool --notifier --shutdown command, executed from as-install-parent/bin. If Update Tool is installed, the notier is running by default.

CHAPTER 2

BeforeYou Begin

If orphaned processes remain, identify and terminate the processes as follows:

■

Solaris, Linux, and Mac OS X systems:

Use the ps -ef command and terminate the processes using the kill command.

■

Windows systems:

Use the Task Manager and terminate the processes.

Also see

“Known Issues” in Sun GlassFish Enterprise Server v3 Release Notes for known issues

related to uninstallation.

Navigate to the directory where Enterprise Serverv3 is installed.

The default installation directory is as follows:

Solaris, Linux, and Mac OS X systems: user's-home-directory/glassfishv3

Windows systems: SystemDrive:\glassfishv3

Start the uninstallation program and remove the software.

■

Solaris, Linux, and Mac OS X systems:

a. Ifnecessary, grant execute permissions to the uninstall le.

chmod +x ./uninstall.sh

b. At the command prompt, type:

./uninstall.sh

■

Windows systems:

a. Double-click the uninstall.exe le.

On Windows you can also start the uninstaller by typing the le name at the command prompt.

Note – To uninstall in silent (non-interactive) mode, use the -s option after the le name. For

example: ./uninstall.sh -s or uninstall.exe -s

Review the summary page that displays following uninstallation and click Exit to exit the uninstaller.

Uninstallation information is captured in log les. The names of the les are timestamp

-remove.log and timestamp-remove-summary.html. On Solaris, Linux, and Mac OS X

systems, these les are generated under the $TMP directory. On Windows systems, these les are generated under the %TEMP% directory.

Removing an Enterprise Server Installation

Sun GlassFish Enterprise Server v3 Installation Guide • December 200926

Examine the contents of the remaining installation directories and remove any les or directories that you do not want.

Note – Not all Enterprise Server directories are automatically removed by the uninstallation

program. Remove the remaining contents as desired, including hidden directories prexed with a dot. It is safe to remove uninstallation and installation log les after you have examined them.

Removing an Enterprise Server Installation

Chapter 2 • Uninstalling Sun GlassFish Enterprise Serverv3 27

Index

adding components, 16 answer le

See also silent mode installation creating, 18 editing, 22 example, 21 reviewing, 21 using to install, 23

components

adding and updating, 16 removing, 25-27

default installation directories, 16 directories, removing, 27 download locations, 12

execute permissions, 15

les

answer, 18 installation, 12 self-extracting (GUI), 12, 14 silent mode, 12, 18 size of, 12 ZIP, 12, 13

Full Platform prole, 13

getting started with Enterprise Server, 17 GlassFish Community downloads, 12 graphical installation, 14

hardware requirements, 11

installation

default directories, 16 log les, 17 requirements, 11 types, 12

installing

using silent mode, 18 using the self-extracting (GUI) le, 14

installing (Continued)

using the ZIP le, 12

Java EE 6 proles, 13 Java EE 6 SDK distributions, 12 JAVA_HOME setting, 12 JDK issues, 11 JDK requirements, 11

known issues, 11

Linux installation

graphical interface and, 14 multi-platform le and, 12 silent mode and, 18 uninstalling, 25-27

log les, 17, 26

Mac OS X installation

graphical interface and, 14 JDK and, 12, 17 multi-platform le and, 12 silent mode and, 18 uninstalling, 25-27

multi-platform installation, 12

platform-independent installation, 12 platform options

Linux, 12 Mac OS X, 12

platform options (Continued)

multi-platform, 12 Solaris, 12

Windows, 12 platforms, supported, 11 processes, stopping, 25 proles, Full Platform and Web, 13

Quick Start Guide, 17

registering Enterprise Server, 17 removing an installation, 25 requirements, 11

self-extracting le installation, 14 setup options, 24 silent mode, uninstalling in, 26 silent mode installation

answer le, 18

overview, 18

running, 23 software requirements, 11 Solaris installation

graphical interface and, 14

multi-platform le and, 12

silent mode and, 18

uninstalling, 25-27 starting Enterprise Server, 17 stopping processes, 25 Sun Download Center, 12 Sun Online Account, 17 supported platforms, 11 system requirements, 11

Index

Sun GlassFish Enterprise Server v3 Installation Guide • December 200930

trial mode, 18

uninstallation log les, 26 uninstalling the software, 25 Update Tool, 16 Update Tool notier process, 25 updating components, 16 Upgrade Tool, 16

Web prole, 13 Windows installation

graphical interface and, 14 multi-platform le and, 12 silent mode and, 18 uninstalling, 25-27

wizard installation, 14

ZIP le installation, 12

Index

Sun Microsystems GlassFish Enterprise Server, GlassFish 3 Installation Manual

Specifications and Main Features

Frequently Asked Questions

User Manual