OracleGlassFish Server 3.1 Installation Guide

8/2/2019 OracleGlassFish Server 3.1 Installation Guide

http://slidepdf.com/reader/full/oracleglassfish-server-31-installation-guide 1/54

Oracle® GlassFish Server 3.1InstallationGuide

Part No:821–2427–12July2011



Copyright© 2010, 2011, Oracleand/or itsafliates. Allrights reserved.

This so tware and related documentationare provided undera license agreementcontainingrestrictions on use and disclosure and areprotectedby intellectualproperty laws. Exceptas expresslypermitted in your license agreementor allowed by law, youmay notuse, copy, reproduce, translate, broadcast, modi y, license,transmit,distribute,exhibit,per orm,publish or display anypart,in any orm,or by anymeans. Reverse engineering,disassembly,or decompilation o this so tware,unless required by law or interoperability, is prohibited.

Thein ormationcontained hereinis subject to changewithout noticeand is notwarranted to be error- ree. I you nd anyerrors,please reportthem to us in writing.

I this is so tware or related documentation that is deliveredto theU.S. Government or anyonelicensing it on behal o theU.S. Government, the ollowing noticeisapplicable:

U.S.GOVERNMENTRIGHTS

Programs, so tware, databases, and related documentation and technicaldata deliveredto U.S. Governmentcustomersare"

commercialcomputerso tware"

or" commercial technicaldata " pursuant to the applicableFederalAcquisition Regulationand agency-speci c supplemental regulations. As such, the use, duplication,disclosure, modi cation,and adaptation shall be subject to therestrictions andlicense terms set orthin theapplicable Government contract,and, to theextentapplicable by the termso the Governmentcontract,the additionalrights set orthin FAR 52.227-19, CommercialComputerSo tware License (December 2007).Oracle America, Inc.,500 Oracle Parkway,Redwood City,CA 94065.

This so tware or hardware is developed or general usein a variety o in ormation management applications. Itis notdeveloped or intended oruse in anyinherently dangerousapplications, includingapplications that maycreate a risk o personal injury. I youuse this so tware or hardware in dangerousapplications, then youshallbe responsible to take allappropriate ail-sa e, backup, redundancy, andothermeasuresto ensure itssa e use. OracleCorporationand itsafliatesdisclaimany liability or anydamagescausedby useo this so tware or hardware in dangerousapplications.

Oracleand Java areregistered trademarks o Oracleand/or itsafliates. Other names maybe trademarks o their respective owners.

Inteland Intel Xeon aretrademarks or registered trademarks o Intel Corporation.All SPARCtrademarks areused under license andare trademarks or registeredtrademarks o SPARCInternational,Inc. AMD, Opteron, theAMD logo, andthe AMDOpteron logo aretrademarksor registered trademarks o AdvancedMicroDevices. UNIX is a registered trademarko TheOpen Group.

This so tware or hardware anddocumentation mayprovide accessto or in ormation on content, products,and services rom third parties. OracleCorporationanditsafliates arenot responsible orand expresslydisclaimall warranties o anykind with respect to third-party content, products,and services.Oracle Corporationandits afliates will notbe responsible orany loss, costs,or damages incurred dueto your accessto or useo third-party content, products,or services.

111130@25097



Contents

Pre ace .....................................................................................................................................................5

1 Installing GlassFish Server 3.1 ..........................................................................................................13Installation Requirements .................................................................................................................. 13

Javassist Library License Notice ................................................................................................. 13Installation Files or GlassFish Server 3.1 ......................................................................................... 21

GlassFish Server Download Locations ...................................................................................... 22GlassFish Server Installation Methods ...................................................................................... 22Choosing an Installation Method .............................................................................................. 22GlassFish Server ZIP Files ........................................................................................................... 25GlassFish Server Sel -Extracting Bundles ................................................................................. 26HTTP Load Balancer Plug-in or Oracle GlassFishServer ..................................................... 26

InstallingGlassFish Server From a ZIP File ...................................................................................... 27

▼ To Install GlassFish ServerUsing the ZIP File .......................................................................... 27InstallingGlassFish Server From a Sel -Extracting Bundle ............................................................ 28

▼ To Install GlassFish ServerUsing the Sel -Extracting File ...................................................... 28▼ To Per orm a CustomInstallation ............................................................................................. 31

Custom Con guration Parameters ............................................................................................ 35Per orming a Silent Mode Installation .............................................................................................. 38

Creating the InstallationAnswerFile ........................................................................................ 38Reviewing the InstallationAnswerFile ..................................................................................... 41Installing in Silent Mode ............................................................................................................. 44

Installation Command-Line Options ............................................................................................... 45

2 Uninstalling GlassFish Server 3.1 .....................................................................................................47

Removing a GlassFishServer Installation ........................................................................................ 47▼ To Uninstall GlassFish ServerSo tware A ter a ZIP File Installation .................................... 47

3



▼ To Uninstall GlassFish ServerSo tware A ter a GUI-Mode Installation .............................. 48

Index ......................................................................................................................................................51

Contents

Oracle GlassFish Server 3.1Installation Guide • July 20114



Preface

Thisdocumentcontains instructions or installing anduninstalling Oracle GlassFish Server 3.1

so tware.

Thispre ace contains in ormationabout andconventions or the entire Oracle GlassFish Server(GlassFish Server)documentation set.

GlassFish Server 3.1 is developed through the GlassFish projectopen-source community athttp://glassfish.java.net/ . The GlassFish project provides a structured process ordeveloping the GlassFish Server plat orm that makes thenew eatures o the Java EE plat orm

available aster,while maintaining the most important eatureo Java EE: compatibility. Itenables Java developers to access the GlassFish Server source code and to contribute to thedevelopment o the GlassFish Server. The GlassFish project is designed to encouragecommunication between Oracle engineers and the community.

The ollowing topics are addressed here:■ “GlassFish Server Documentation Set”on page 5■

“Related Documentation”on page 7■ “Typographic Conventions” on page 8■ “Symbol Conventions” on page 9■ “De ault Pathsand File Names” on page 9■ “Documentation, Support, and Training” on page 10■ “Searching Oracle Product Documentation” on page 10■ “Third-Party WebSite Re erences” on page 11

GlassFish Server Documentation SetThe GlassFish Server documentation set describes deployment planning andsysteminstallation. For an introduction to GlassFish Server, re er to the books in the order in whichthey are listed in the ollowing table.

5

http://glassfish.java.net/





TABLE P–1 Books in theGlassFishServerDocumentationSet

Book Title Description

ReleaseNotes Provides late-breaking in ormation about theso tware and thedocumentation and includes a comprehensive, table-based summary o thesupported hardware, operating system, Java Development Kit (JDK),anddatabase drivers.

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

Installation Guide Explains how to install the so tware and itscomponents.

Upgrade Guide Explains how to upgrade to the latest version o GlassFishServer.This guidealso describes di erences between adjacent product releases andcon guration options that canresult in incompatibilitywith theproductspeci cations.

Deployment Planning Guide Explains how to build a production deployment o GlassFish Server thatmeets the requirements o your systemand enterprise.

Administration Guide Explains how to con gure, monitor, and manage GlassFish Serversubsystems and components rom the command line by using the

asadmin (1M) utility. Instructions or per orming these tasks romtheAdministrationConsole are provided in the AdministrationConsole onlinehelp.

Security Guide Provides instructions or con guring and administering GlassFish Serversecurity.

Application Deployment Guide Explains how to assemble and deploy applications to theGlassFish Serverand provides in ormationaboutdeployment descriptors.

Application Development Guide Explains how to create and implement Java Plat orm, Enterprise Edition(Java EE plat orm) applications that are intended to run on the GlassFishServer. These applications ollow theopen Java standards model or Java EEcomponents and application programmer inter aces (APIs). This guideprovides in ormation about developer tools, security, and debugging.

Add-On Component Development Guide

Explains how to use published inter aces o GlassFish Server to developadd-on components or GlassFish Server. This document explains how toper ormonly those tasks that ensure that the add-on component is suitable

or GlassFish Server.Embedded ServerGuide Explains how to run applications in embedded GlassFish Server and to

develop applications in which GlassFish Server is embedded.

High Availability Administration Guide

Explains how to con gure GlassFish Server to provide higher availabilityandscalability through ailover and load balancing.

Per ormanceTuning Guide Explains how to optimize theper ormance o GlassFishServer.

Preface


http://www.oracle.com/pls/topic/lookup?ctx=E18930_01&id=SJSASEERN

http://www.oracle.com/pls/topic/lookup?ctx=E18930_01&id=SJSASEEQSG

http://www.oracle.com/pls/topic/lookup?ctx=E18930_01&id=SJSASEEIG

http://www.oracle.com/pls/topic/lookup?ctx=E18930_01&id=SJSASEEUMG

http://www.oracle.com/pls/topic/lookup?ctx=E18930_01&id=SJSASEEDPG

http://www.oracle.com/pls/topic/lookup?ctx=E18930_01&id=SJSASEEAG

http://www.oracle.com/pls/topic/lookup?ctx=E18930_01&id=SJSASEEREFMANasadmin-1m


http://www.oracle.com/pls/topic/lookup?ctx=E18930_01&id=GFSECURITY

http://www.oracle.com/pls/topic/lookup?ctx=E18930_01&id=SJSASEEADG

http://www.oracle.com/pls/topic/lookup?ctx=E18930_01&id=SJSASEEDG

http://www.oracle.com/pls/topic/lookup?ctx=E18930_01&id=SGFESADDONDEV


http://www.oracle.com/pls/topic/lookup?ctx=E18930_01&id=GFEMBEDDED

http://www.oracle.com/pls/topic/lookup?ctx=E18930_01&id=SJSASEEHAAG


http://www.oracle.com/pls/topic/lookup?ctx=E18930_01&id=SJSASEEPTG

http://www.oracle.com/pls/topic/lookup?ctx=E18930_01&id=SJSASEEPTG



http://www.oracle.com/pls/topic/lookup?ctx=E18930_01&id=GFEMBEDDED



http://www.oracle.com/pls/topic/lookup?ctx=E18930_01&id=SJSASEEDG

http://www.oracle.com/pls/topic/lookup?ctx=E18930_01&id=SJSASEEADG

http://www.oracle.com/pls/topic/lookup?ctx=E18930_01&id=GFSECURITY


http://www.oracle.com/pls/topic/lookup?ctx=E18930_01&id=SJSASEEAG

http://www.oracle.com/pls/topic/lookup?ctx=E18930_01&id=SJSASEEDPG


http://www.oracle.com/pls/topic/lookup?ctx=E18930_01&id=SJSASEEIG


http://www.oracle.com/pls/topic/lookup?ctx=E18930_01&id=SJSASEERN



TABLE P–1 Books in theGlassFishServerDocumentation Set (Continued)Book Title Description

Troubleshooting Guide Describes commonproblems that youmight encounter when usingGlassFish Server and explains howto solve them.

ErrorMessage Re erence Describes error messages that youmight encounter when using GlassFishServer.

Re erence Manual Provides re erence in ormation in man page ormat or GlassFishServeradministration commands, utility commands, and related concepts.

Message Queue Release Notes Describes new eatures, compatibility issues, and existing bugs or GlassFish

ServerMessage Queue. Message Queue Technical Overview

Provides an introduction to the technology,concepts, architecture,capabilities, and eatures o theMessage Queue messaging service.

Message Queue AdministrationGuide

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

Message Queue Developer’sGuide or JMX Clients

Describes theapplication programming inter ace in Message Queue orprogrammatically con guring and monitoring Message Queueresources in

con ormance with theJava ManagementExtensions (JMX). Message Queue Developer’sGuide or Java Clients

Provides in ormation about concepts and procedures or developingJavamessaging applications (Java clients) that work with GlassFish Server.

Message Queue Developer’sGuide or C Clients

Provides programming and re erence in ormation or developersworkingwith Message Queue who want to use the C language binding to the MessageQueue messaging service to send, receive, and processMessage Queuemessages.

Related DocumentationThe ollowing tutorials explainhow to developJava EE applications:■ Your First Cup: AnIntroduction to theJava EE Plat orm (http://download.oracle.com/

javaee/6/firstcup/doc/ ). Forbeginning Java EE programmers, this short tutorial

explains the entire process or developing a simple enterprise application. The sampleapplication is a webapplication that consists o a component that is based on theEnterpriseJavaBeansspeci cation, a JAX-RS web service, anda JavaServer Faces component or theweb ront end.

■ The Java EE 6 Tutorial (http://download.oracle.com/javaee/6/tutorial/doc/ ). Thiscomprehensive tutorial explains howto use Java EE 6 plat orm technologies and APIs todevelopJava EE applications.

Preface

7

http://www.oracle.com/pls/topic/lookup?ctx=E18930_01&id=SJSASEETSG

http://www.oracle.com/pls/topic/lookup?ctx=E18930_01&id=SJSASEEERR

http://www.oracle.com/pls/topic/lookup?ctx=E18930_01&id=SJSASEEREFMAN

http://www.oracle.com/pls/topic/lookup?ctx=E18930_01&id=MQRN

http://www.oracle.com/pls/topic/lookup?ctx=E18930_01&id=MQTO


http://www.oracle.com/pls/topic/lookup?ctx=E18930_01&id=MQAG


http://www.oracle.com/pls/topic/lookup?ctx=E18930_01&id=MQJMX


http://www.oracle.com/pls/topic/lookup?ctx=E18930_01&id=MQDGJ


http://www.oracle.com/pls/topic/lookup?ctx=E18930_01&id=MQDGC


http://download.oracle.com/javaee/6/firstcup/doc/






http://download.oracle.com/javaee/6/tutorial/doc/

















http://www.oracle.com/pls/topic/lookup?ctx=E18930_01&id=MQRN

http://www.oracle.com/pls/topic/lookup?ctx=E18930_01&id=SJSASEEREFMAN

http://www.oracle.com/pls/topic/lookup?ctx=E18930_01&id=SJSASEEERR

http://www.oracle.com/pls/topic/lookup?ctx=E18930_01&id=SJSASEETSG



Javadoc tool re erence documentation or packages that are provided with GlassFish Server isavailable as ollows.■

The API speci cation or version 6 o Java EE is located athttp://download.oracle.com/javaee/6/api/ .

■ The API speci cation or GlassFish Server 3.1, including Java EE 6 plat orm packages andnonplat ormpackages that are speci c to theGlassFish Server product, is located athttp://glassfish.java.net/nonav/docs/v3/api/ .

Additionally, the Java EE Speci cations (http://www.oracle.com/technetwork/java/javaee/tech/index.html ) might be use ul.

For in ormationabout creating enterprise applications in the NetBeans IntegratedDevelopment Environment (IDE), see the NetBeans Documentation, Training & Support page(http://www.netbeans.org/kb/ ).

For in ormation about the Java DB database or use with the GlassFish Server, see the Java DBproduct page ( http://www.oracle.com/technetwork/java/javadb/overview/index.html ).

The Java EE Samples project is a collection o sample applications that demonstrate a broad

range o Java EE technologies. TheJava EE Samplesare bundled with theJava EE So twareDevelopment Kit (SDK) and are also available rom the Java EE Samples project page(http://java.net/projects/glassfish-samples ).

Typographic ConventionsThe ollowing table describes the typographic changes that are used in this book.

TABLEP–2 TypographicConventions

Type ace Meaning Example

AaBbCc123 The names o commands, les, anddirectories, and onscreen computeroutput

Edityour .login le.

Use ls -a to list all les.

machine_name% you have mail.

AaBbCc123 What you type, contrasted with onscreencomputer output

machine_name% su

Password:

AaBbCc123 A placeholderto be replaced with a realname or value

The command to remove a le is rm flename .

AaBbCc123 Book titles, new terms, and terms to beemphasized (note that some emphasizeditems 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.

Preface


http://download.oracle.com/javaee/6/api/



http://glassfish.java.net/nonav/docs/v3/api/

http://www.oracle.com/technetwork/java/javaee/tech/index.html




http://www.netbeans.org/kb/





http://www.oracle.com/technetwork/java/javadb/overview/index.html




http://java.net/projects/glassfish-samples













http://glassfish.java.net/nonav/docs/v3/api/





Symbol Conventions

The ollowing table explains symbols that might be used in this book.TABLEP–3 SymbolConventions

Symbol Description Example Meaning

[ ] Contains optional argumentsand command options.

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

{ | } Contains a set o choices or a

required command option.

-d {y|n} The -d option requires that youuse

either the y argument or the nargument.

${ } Indicates a variablere erence.

${com.sun.javaRoot} Re erences thevalue o thecom.sun.javaRoot variable.

- Joins simultaneous multiplekeystrokes.

Control-A Press t he C ontrol k ey while y ou pressthe A key.

+ Joins consecutive multiplekeystrokes.

Ctrl+A+N Press t he C ontrol k ey, r elease i t, a ndthen press thesubsequent keys.

→ Indicatesmenu itemselection in a graphical userinter ace.

File → New → Templates FromtheFile menu, chooseNew.From theNew submenu, chooseTemplates.

De ault Paths and File NamesThe ollowing table describes thede ault pathsand le names that are used in this book.

TABLE P–4 De aultPathsand File Names

Placeholder Description De ault Value

as-install Represents thebase installation directory orGlassFishServer.

In con guration les, as-install is representedas ollows:

${com.sun.aas.installRoot}

Installations on theOracle Solaris operating system, Linuxoperating system, and MacOS operating system:

user’s-home-directory/glassfish3/glassfish

Windows, all installations:

SystemDrive:\glassfish3\glassfish

Preface

9



TABLE P–4 De aultPathsandFile Names (Continued)Placeholder Description De ault Value

as-install-parent Represents theparent o thebase installationdirectory or GlassFish Server. Installations on theOracle Solaris operating system, Linuxoperating system, and Macoperating system:

user’s-home-directory/glassfish3

Windows, all installations:

SystemDrive:\glassfish3

domain-root-dir Represents thedirectory in which a domain iscreated by de ault.

as-install /domains/

domain-dir Represents thedirectory in which a domain'scon guration is stored.

In con guration les, domain-dir isrepresented as ollows:

${com.sun.aas.instanceRoot}

domain-root-dir / domain-name

Documentation, Support, andTrainingThe Oracle web site provides in ormationabout the ollowing additional resources:■ Documentation ( http://www.oracle.com/technetwork/indexes/documentation/

index.html )■ Support ( http://www.oracle.com/us/support/index.html )■ Training ( http://education.oracle.com/ )

Searching Oracle Product DocumentationBesides searching Oracle product documentation rom the Oracle Documentation(http://www.oracle.com/technetwork/indexes/documentation/index.html ) web site, youcan use a search engine by typing the ollowing syntax in the search eld:

search-term site:oracle.com

Forexample, to search or “broker,” type the ollowing:

broker site:oracle.com

Preface


http://www.oracle.com/technetwork/indexes/documentation/index.html




http://www.oracle.com/us/support/index.html



http://education.oracle.com/















Third-PartyWeb Site Re erencesThird-party URLs are re erenced in thisdocument andprovide additional, related in ormation.

Note – Oracle is not responsible or theavailabilityo third-party web sitesmentioned in thisdocument. Oracle does not endorse and is not responsibleor liable or any content, advertising,products, or other materials that are available on or through such sitesor resources. Oraclewillnot be responsible or liable or any actual or alleged damage or losscaused or alleged to becaused by or in connection with use o or reliance on any such content, goods, or services thatare availableon or through such sitesor resources.

Preface

11



12



Installing GlassFish Server 3.1

Thischapter provides instructions or installing Oracle GlassFish Server 3.1 so tware on Solaris,Linux, Mac OS X, and Windowssystems.

The ollowing topics are addressed here:■

“InstallationRequirements” on page 13■ “Installation Files orGlassFish Server 3.1” on page 21■ “Installing GlassFish Server From a ZIPFile”on page 27■ “Installing GlassFish Server From a Sel -Extracting Bundle” on page 28■ “Per orming a Silent Mode Installation” on page 38■ “InstallationCommand-Line Options” on page 45

Installation RequirementsBe ore installing Oracle GlassFish Server 3.1, ensure that your system meets the requirementslisted in “Hardware and So tware Requirements” in Oracle GlassFishServer 3.1-3.1.1 ReleaseNotes. I necessary,download and install the required JDK so tware. Problemsare likely to arisei you attempt to install on a plat orm that is not supported or on a system that in some otherway does not meet release requirements. Also see “Known Issues” in Oracle GlassFishServer 3.1-3.1.1Release Notes or known issues related to installation.■

On Solaris, Linux, and Windows systems, JDK so tware is available rom the Java SEdownloads page .■ For Mac OS X systems, GlassFish Server uses the JDK that is part o the Macintosh operating

system. I necessary, obtain the required JDK version rom the Mac OS X Updates site.

Javassist Library License NoticeYou are receiving a copy o the Javassist (Java Programming Assistant) Library in source orm athttp://repo1.maven.org/

1C H A P T E R 1

13

http://www.oracle.com/pls/topic/lookup?ctx=E18930_01&id=SJSASEERNabpaj




http://www.oracle.com/pls/topic/lookup?ctx=E18930_01&id=SJSASEERNggrvi



http://www.oracle.com/technetwork/java/javase/downloads/index.html



http://support.apple.com/downloads/

http://repo1.maven.org/maven2/org/javassist/javassist/3.14.0-GA/javassist-3.14.0-GA-sources.jar


http://support.apple.com/downloads/









maven2/org/javassist/javassist/3.14.0-GA/javassist-3.14.0-GA-sources.jar and inobject code orm in the jar le glassfish/modules/weld-osgi-bundle.jar included with thedistribution. The terms o the Oracle license do NOT apply to theJavassist (Java ProgrammingAssistant) program; it is licensed under the ollowing license, separately rom the Oracleprograms youreceive. I you do not wish to install this program, youmay choose to not proceedwith the installation o Oracle GlassFish Server.

GNULESSERGENERAL PUBLICLICENSE Version 2.1, February 1999

Copyright (C) 1991, 1999 Free So tware Foundation, Inc. 51 Franklin Street, Fi th Floor,Boston, MA 02110-1301 USA Everyone is permitted to copy and distribute verbatim

copies o this license document, but changing it is not allowed. [This is the rst released version o the Lesser GPL. It also counts as the successor o the GNU Library PublicLicense, version2, hence the versionnumber 2.1.] Preamble The licenses ormostso tware are designed to take away your reedomto share and change it.By contrast, theGNU General Public Licenses are intended to guaranteeyour reedom to share andchange ree so tware--to make sure the so tware is ree orall its users.

This license, the Lesser General Public License, applies to some specially designatedso tware packages--typically libraries--o the Free So tware Foundationandotherauthors who decide to use it. You can use it too, but we suggest you rst think care ully about whether this license or the ordinary General Public License is thebetter strategy touse in any particular case, based on theexplanations below.When we speak o reeso tware,we are re erring to reedomo use, not price. OurGeneral Public Licenses aredesigned to make sure that youhave the reedomto distribute copieso ree so tware (andcharge or this service i you wish); that you receive source code or can get it i you want it;that you can change the so tware and use pieces o it in new ree programs; and that you

are in ormed that you can do these things.To protect your rights, we need to make restrictions that orbid distributors to deny youthese rights or to ask you to surrender these rights. These restrictions translate to certainresponsibilities or you i you distribute copieso the library or i you modi y it.

For example, i you distribute copieso the library, whether gratis or or a ee, you mustgive the recipients all the rights that we gave you. You must make sure that they, too,receive or can get the source code. I you link other code with the library, you must

providecompleteobject les to the recipients, so that they can relink them with thelibrary a termaking changes to the library and recompiling it.And you must show themthese terms so they know their rights. We protect your rights with a two-stepmethod: (1)we copyright the library, and (2) we o er you this license, which gives you legalpermission to copy, distribute and/or modi y the library.

To protect each distributor, we want to make it very clear that there is no warranty or theree library. Also, i the library is modi ed by someone else and passed on, the recipients

should know that what they have is not the original version, so that theoriginal author'sreputation will notbe a ected by problems that mightbe introducedby others.

InstallationRequirements






Finally, so tware patents pose a constant threat to theexistence o any ree program. Wewish to make sure that a company cannot e ectively restrict theusers o a ree program by obtaining a restrictive license rom a patent holder. There ore,we insist that any patentlicense obtained or a versiono the library must be consistent with the ull reedom o usespeci ed in this license. Most GNU so tware, including some libraries, is covered by theordinary GNU General Public License. This license, the GNU Lesser General PublicLicense, applies to certain designated libraries, and is quite di erent rom the ordinary General Public License. We use this license or certain libraries in order to permit linkingthose libraries into non- ree programs.

When a program is linked with a library, whether statically or using a shared library, thecombination o the two is legally speaking a combined work, a derivative o theoriginallibrary. The ordinary General Public License there ore permitssuch linking only i theentire combination ts its criteria o reedom. TheLesser General Public License permitsmore lax criteria or linking other code with the library.

We call this license the " Lesser" General Public License because it does Less to protect theuser's reedom than theordinary General Public License. It also provides other reeso tware developers Less o an advantage overcompeting non- ree programs. Thesedisadvantages are the reason we use the ordinary General Public License or many

libraries. However, the Lesser license provides advantages in certain specialcircumstances.

For example, on rare occasions, there may be a special need to encourage the widestpossible use o a certain library, so that it becomes a de- acto standard. To achieve this,non- ree programs must be allowed to use the library. A more requent case is that a reelibrary does thesame jobas widely used non- ree libraries. In this case, there is little togain by limiting the ree library to ree so tware only, so we use theLesser General PublicLicense.

Inother cases, permission to use a particular library in non- ree programs enablesagreaternumber o people to use a large body o ree so tware. For example,permission touse theGNU C Library in non- ree programs enablesmany more people to use thewholeGNU operating system,as well as itsvariant, theGNU/Linux operating system.

Although the Lesser General Public License is Less protective o theusers' reedom, itdoes ensure that the user o a program that is linked with the Library has the reedom andthe wherewithal to run that program using a modi ed versiono the Library.

The precise terms and conditions or copying, distribution andmodi cation ollow.Pay close attention to thedi erence between a " work based on the library " and a " work thatuses the library " . The ormer contains code derived rom the library, whereas the lattermust be combined with the library in order to run.

TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION ANDMODIFICATION

0. This License Agreement applies to any so tware library or other program whichcontains a notice placed by thecopyright holderor other authorized party saying it may


Chapter 1 • Installing GlassFish Server 3.1 15



be distributed under the terms o this Lesser General Public License (also called " thisLicense" ). Each licensee is addressed as " you " . A " library " means a collection o so tware

unctions and/or data prepared so as to be conveniently linked withapplicationprograms(which use some o those unctions and data) to orm executables. The

"

Library "

, below,re ers to any such so tware library or work which has been distributed under these terms.A " work based on the Library " means either the Library or any derivative work undercopyright law: that is to say, a work containing the Library or a portion o it, either verbatim or with modi cations and/or translated straight orwardly into anotherlanguage. (Hereina ter, translation is included without limitation in the term" modi cation " .) " Source code " or a work means the pre erred orm o the work ormaking modi cations to it.For a library, complete source code means all the source code

orall modules it contains, plus any associated inter ace de nition les, plus the scriptsused to control compilationand installation o the library. Activitiesother than copying,distributionand modi cation are not covered by this License; they are outside its scope.The act o running a program using theLibrary is not restricted, and output rom such aprogram is coveredonly i its contents constitute a work based on theLibrary (independent o the use o the Library in a tool or writing it). Whether that is truedepends on what the Library does and what the program that uses the Library does.

1. You may copy and distribute verbatim copieso theLibrary's complete source code asyou receive it, in any medium, provided that youconspicuously and appropriately publish on each copy an appropriate copyright notice and disclaimer o warranty;keepintact all the notices that re er to this License and to theabsence o any warranty; anddistribute a copy o this License along with the Library. You may charge a ee or thephysical act o trans erring a copy, and you may at your option o er warranty protectionin exchange or a ee.

2. You may modi y your copy or copies o the Library or any portion o it, thus orming a

work based on theLibrary, and copy and distribute such modi cations or work under theterms o Section 1 above, provided that youalso meet all o these conditions:

a) The modi ed work must itsel be a so tware library. b) You must cause the lesmodi ed to carry prominent notices stating that youchanged the les and the date o any change. c) You must cause the whole o the work to be licensed at no charge to all thirdparties under the terms o this License. d) I a acility in the modi ed Library re ers to a

unction or a tableo data to be supplied by an applicationprogram that uses the acility,other than as an argument passed when the acility is invoked, then youmust make agood aithe ort to ensure that, in theevent an application does not supply such unctionor table, the acility still operates, and per orms whatever part o itspurpose remainsmeaning ul. (For example, a unction in a library to compute square roots has a purposethat is entirely well-de ned independent o the application. There ore, Subsection 2drequires that any application-supplied unction or table used by this unction must beoptional: i the applicationdoes not supply it, the square root unction must still computesquare roots.) These requirements apply to themodi ed work as a whole. I identi ablesectionso that work are not derived rom the Library, and can be reasonably consideredindependent and separate works in themselves, then this License, and its terms, do not





apply to those sections when youdistribute them as separate works. But when youdistribute the same sectionsaspart o a whole which is a work based on the Library, thedistributiono thewhole must be on the terms o this License, whose permissions orother licensees extend to the entire whole, and thus to each and everypart regardless o who wrote it. Thus, it is not the intent o this section to claim rights or contest your rightsto work writtenentirely by you; rather, the intent is to exercise the right to control thedistributiono derivative or collective worksbased on the Library. In addition, mereaggregationo another work not based on the Library with theLibrary (orwith a work based on the Library) on a volume o a storage or distribution medium does not bring theotherwork under the scope o this License.

3. You may opt to apply the terms o the ordinary GNU General Public License instead o this License to a given copy o the Library. To do this, you must alter all the notices thatre er to this License, so that they re er to the ordinary GNU General Public License, version 2, instead o to this License. (I a newer version than version 2 o the ordinary GNU General Public License has appeared, then you can speci y that version instead i you wish.) Do not make any other change in these notices.Once this change is made in agiven copy, it is irreversible or that copy, so theordinary GNU General Public Licenseapplies to all subsequent copiesand derivative works made rom that copy. This option isuse ul when you wish to copy part o the code o the Library into a program that is not alibrary.

4. You may copy and distribute theLibrary (or a portion or derivative o it, under Section2) in object code or executable orm under the terms o Sections1 and 2 above providedthat you accompany it with the complete corresponding machine- readable source code,which must be distributed under the terms o Sections1 and 2 above on a mediumcustomarily used or so tware interchange. I distribution o object code is made by o ering access to copy rom a designated place, then o ering equivalent access to copy

the source code rom thesame place satis es the requirement to distribute the sourcecode, even though third partiesare not compelled to copy thesource along with theobjectcode.

5. A program that contains no derivative o any portion o the Library,but is designed towork with the Library by being compiled or linked with it, is called a " work that uses theLibrary " . Such a work, in isolation, is not a derivative work o theLibrary, and there ore

alls outside the scope o this License. However, linking a" work that uses the Library "

with theLibrary createsan executable that is a derivative o theLibrary (because itcontains portions o the Library), rather than a " work that uses the library " .Theexecutable is there ore covered by this License. Section 6 states terms or distributiono such executables. Whena " work that uses theLibrary " uses material rom a header lethat is part o the Library, the object code or the work may be a derivative work o theLibrary even though thesource code is not. Whether this is true is especially signi cant i the work can be linked without the Library, or i the work is itsel a library. The threshold

or this to be true is not precisely de ned by law. I such anobject le uses only numericalparameters, data structure layoutsand accessors, andsmall macros andsmall inline

unctions (ten lines or less in length), then theuse o theobject le is unrestricted,





regardlesso whether it is legally a derivative work. (Executables containing thisobjectcode plus portions o theLibrary will still all under Section 6.) Otherwise, i thework is aderivative o the Library,youmay distribute the object code or thework under the termso Section 6. Any executables containing that work also all underSection 6, whether ornot they are linked directly with the Library itsel .

6. As anexception to the Sectionsabove, you may also combine or link a " work that usesthe Library " with the Library to produce a work containing portions o the Library, anddistribute that work under terms o your choice, provided that the terms permitmodi cation o the work or thecustomer's own use and reverse engineering ordebugging such modi cations. Youmust give prominent notice with each copy o the

work that the Library is used in it and that the Library and its use are covered by thisLicense. You must supply a copy o this License. I the work during executiondisplayscopyrightnotices, you must include the copyright notice or theLibrary among them, aswell as a re erence directing the user to the copy o this License. Also, you must do one o these things:

a) Accompany the workwith the completecorresponding machine-readable source codeor theLibrary including whatever changes were used in the work (which must be

distributed underSections 1 and 2 above); and, i thework is an executable linkedwiththe Library, with the complete machine-readable " work that uses theLibrary " , asobjectcode and/or source code, so that the user can modi y the Library and then relink toproduce a modi ed executablecontaining the modi ed Library. (It is understood that theuser who changes the contents o de nitions les in theLibrary will not necessarily beable to recompile the application to use the modi ed de nitions.) b) Use a suitable sharedlibrary mechanism or linking with theLibrary. A suitablemechanism is one that (1) usesat run time a copy o the library already present on the user's computer system, ratherthan copying library unctions into the executable, and (2) will operate properly with amodi ed versiono the library, i the user installs one, as long as themodi ed version isinter ace-compatible with the version that thework was made with. c) Accompany thework with a written o er, valid or at least three years, to give the same user the materialsspeci ed in Subsection 6a, above, or a charge no more than thecost o per orming thisdistribution. d) I distributiono thework is made by o ering access to copy rom adesignated place, o er equivalent access to copy theabove speci ed materials rom thesame place. e) Veri y that the user has already received a copy o these materials or thatyou have already sent this user a copy. For an executable, the required orm o the " work that uses the Library " must include any data and utility programs needed or reproducingthe executable rom it.However, as a special exception, thematerials to be distributedneed not include anything that is normally distributed (in either source or binary orm)with themajorcomponents (compiler, kernel, and so on) o the operating system onwhich the executable runs, unless that component itsel accompanies the executable. Itmay happen that this requirement contradicts the license restrictions o other proprietary libraries thatdo not normally accompany the operating system. Sucha contradictionmeans youcannot use both them and the Library together in an executable that youdistribute.





7. You may place library acilities that are a work based on the Library side-by- side in asingle library together with other library acilitiesnot coveredby this License, anddistribute such a combined library, provided that the separate distribution o thework based on theLibrary and o theother library acilities is otherwise permitted, andprovided that youdo these two things:

a) Accompany thecombined library with a copy o the same work based on theLibrary,uncombined with any other library acilities. This must be distributedunder the terms o the Sections above. b) Give prominent notice with thecombined library o the act thatpart o it is a work based on the Library, and explaining where to nd the accompanyinguncombined orm o thesame work. 8. Youmay not copy, modi y, sublicense, link with,

or distribute the Library except as expressly provided under this License. Any attemptotherwise to copy, modi y, sublicense, link with, or distribute the Library is void, and willautomatically terminate your rights under thisLicense. However, partieswho havereceived copies, or rights, rom youunder this License will not have their licensesterminatedso long as such parties remain in ull compliance.

9. You are not required to accept this License, since youhave not signed it.However,nothing else grants you permission to modi y or distribute theLibrary or its derivativeworks. These actions are prohibited by law i youdo not accept this License. There ore,by modi ying or distributing theLibrary (or any work based on the Library), you indicateyour acceptance o this License to do so, and all its terms and conditions or copying,distributing or modi ying theLibrary or works based on it.

10. Each time youredistribute theLibrary (or any work based on the Library), therecipient automatically receives a license rom the original licensor to copy, distribute,link with or modi y the Library subject to these termsand conditions. You may notimpose any urther restrictions on the recipients' exercise o the rights grantedherein.

You are not responsible oren orcing compliance by third parties with this License.11. I , as a consequence o a court judgment or allegation o patent in ringement or orany other reason (not limited to patent issues), conditions are imposed on you (whetherby court order, agreement or otherwise) that contradict theconditions o this License,they do not excuse you rom the conditions o this License. I youcannot distribute so asto satis y simultaneously yourobligations under thisLicense andany other pertinentobligations, then as a consequence youmay not distribute the Library at all. For example,i a patent license would notpermit royalty- ree redistribution o the Library by all thosewho receive copies directlyor indirectly through you, then the only way you could satis y both it and this License wouldbe to re rain entirely rom distribution o theLibrary. I any portion o this section is held invalid or unen orceableunder any particularcircumstance, thebalance o the section is intended to apply, and thesection as a whole isintended to apply in other circumstances. It is not thepurpose o this section to induceyou to in ringe any patents or otherproperty right claims or to contest validity o any such claims; this section has the sole purpose o protecting the integrity o the reeso tware distribution system which is implemented by public license practices. Many people have made generous contributions to thewide range o so tware distributed





through that system in reliance on consistent application o that system; it is up to theauthor/donor to decide i he or she is willing to distribute so tware through any othersystem and a licensee cannot impose that choice. This section is intended to makethoroughly clear what is believed to be a consequence o the rest o this License.12. I the distribution and/or use o the Library is restricted in certain countries eitherby patentsor by copyrighted inter aces, the original copyright holder who places the Library under thisLicense may add an explicit geographical distribution limitation excludingthosecountries, so that distribution is permitted only in or among countries not thusexcluded. In such case, this License incorporates the limitation as i written in thebody o this License.

13. TheFree So tware Foundation may publish revised and/or new versions o the LesserGeneral Public License rom time to time. Such new versions will be similar in spirit tothe present version, butmay di er in detail to address new problemsor concerns. Each version is given a distinguishing version number. I the Library speci es a versionnumber o this License which applies to it and " any later version " , you have the option o

ollowing the terms and conditions eithero that versionor o any laterversionpublishedby the Free So tware Foundation. I theLibrary does not speci y a license versionnumber,you may choose any versionever publishedby theFree So tware Foundation.

14. I you wish to incorporate parts o the Library into other ree programs whosedistributionconditions are incompatible with these, write to the author to ask orpermission. For so tware which is copyrightedby the Free So tware Foundation, write tothe Free So tware Foundation; we sometimes make exceptions or this. Our decisionwillbe guided by the two goals o preserving the ree status o all derivatives o our reeso tware and o promoting thesharing and reuse o so tware generally.

NO WARRANTY

15. BECAUSETHELIBRARY IS LICENSED FREE OF CHARGE, THERE IS NOWARRANTY FOR THE LIBRARY, TO THE EXTENT PERMITTED BY APPLICABLELAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHTHOLDERS AND/OROTHER PARTIES PROVIDE THE LIBRARY " AS IS" WITHOUTWARRANTY OF ANYKIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUTNOTLIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITYANDFITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY

AND PERFORMANCE OF THELIBRARY IS WITH YOU. SHOULD THE LIBRARYPROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,REPAIR OR CORRECTION.

16. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREEDTO INWRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHERPARTY WHO MAYMODIFY AND/ORREDISTRIBUTE THE LIBRARY AS PERMITTED ABOVE, BELIABLE TO YOU FORDAMAGES, INCLUDING ANY GENERAL, SPECIAL,INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THEUSEORINABILITYTO USETHE LIBRARY (INCLUDING BUT NOT LIMITED TO LOSS OF



I ll i Fil f Gl Fi h S 3 1



DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BYYOU OR THIRD PARTIES OR A FAILURE OF THE LIBRARY TO OPERATE WITHANY OTHER SOFTWARE), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEENADVISEDOF THE POSSIBILITYOF SUCH DAMAGES. END OF TERMS ANDCONDITIONS How to Apply These Terms to Your New Libraries I you developa newlibrary, and you want it to be o the greatest possible use to the public, we recommendmaking it ree so tware that everyone can redistribute and change. You can do so by permitting redistributionunder these terms (or, alternatively,under the terms o theordinary General Public License). To apply these terms, attach the ollowing notices tothe library. It is sa est to attach them to the start o each source le to most e ectively convey the exclusion o warranty; and each le should have at least the " copyright " lineand a pointer to where the ull notice is ound. one line to give the library's name and anidea o what it does. Copyright (C) year name o author This library is ree so tware; youcan redistribute it and/or modi y it under the terms o the GNU Lesser General PublicLicense as publishedby theFree So tware Foundation; either version2.1 o the License, or(at your option)any laterversion. This library is distributed in the hope that it will beuse ul, but WITHOUT ANY WARRANTY; without even the impliedwarranty o MERCHANTABILITYor FITNESS FOR A PARTICULAR PURPOSE. See the GNU

Lesser General Public License or more details. You should have received a copy o theGNU Lesser General Public License alongwith this library; i not, write to theFreeSo tware Foundation, Inc., 51 Franklin Street, Fi th Floor, Boston, MA 02110-1301 USAAlso add in ormationon howto contact you by electronic and paper mail.You shouldalso get your employer (i you work asa programmer) or your school, i any, to sign a" copyright disclaimer " or the library, i necessary. Here is a sample; alter thenames:Yoyodyne, Inc., herebydisclaims all copyright interest in the library ‘Frob' (a library ortweaking knobs) writtenby JamesRandom Hacker. signature o Ty Coon, 1 April 1990 Ty Coon, President o Vice That's all there is to it!

Installation Files or GlassFish Server 3.1The ollowing topics are addressed here:

■ “GlassFish Server Download Locations” on page 22■ “GlassFish Server InstallationMethods” on page 22■ “Choosing an Installation Method” on page 22■ “GlassFish Server ZIP Files” on page 25■ “GlassFish Server Sel -Extracting Bundles” on page 26■ “HTTPLoad Balancer Plug-in or Oracle GlassFish Server” on page 26

Installation Files for GlassFish Server 3.1


Installation Files for GlassFish Server3 1



GlassFishServer Download LocationsInstallation les or Oracle GlassFish Server 3.1 are available rom theGlassFish ServerDownloads ( http://www.oracle.com/technetwork/middleware/glassfish/downloads/index.html ) page.

GlassFishServer Installation MethodsTable 1–1 lists the variousOracle GlassFish Server installation methods.The table also provideslinks to installation instructions or each method.

Note – Be ore per orming anyGlassFish Server installation, ensure that yourenvironmentadheres to the JDK guidelines in “Paths and Environment Settings or the JDK So tware” inOracle GlassFishServer 3.1-3.1.1 Release Notes.

TABLE 1–1 GlassFishServer 3.1 Installation Methods

Installation Method Installation Instructions

Multi-plat orm ZIP le “Installing GlassFish Server From a ZIP File” on page27 .

Solaris, Linux, MacOS,UNIX, orWindows sel -extracting bundle ingraphical mode

“Installing GlassFish Server From a Sel -Extracting Bundle” onpage 28.

Solaris, Linux, MacOS,UNIX, orWindows sel -extracting bundle in silentmode

“Per orming a SilentMode Installation” on page 38

Each o the installation methods listed in Table 1–1 also letyou choose between installing theFull Plat ormor the Web Profle . These two distributions are explained in the next section.

Choosing an Installation MethodThereare two general sets o questions you should consider when deciding which GlassFishServer 3.1 installation method to use.■ “ZIP Package or Sel -Extracting Bundle?” on page 23■ “Full Plat orm or Web Pro le Distribution?” on page 23

Installation Files for GlassFish Server3.1


Installation Files for GlassFish Server 3 1

http://www.oracle.com/technetwork/middleware/glassfish/downloads/index.html





http://www.oracle.com/pls/topic/lookup?ctx=E18930_01&id=SJSASEERNgfgps









ZIP Package or Sel -Extracting Bundle?The relative eatures and strengths o the GlassFish Server ZIP packages andsel -extractingbundles are listed below.■ ZIP Package

■ Is simpler to install, but provides no con guration optionsduring the installation■ Anyadditional con gurations must be per ormed manually, a ter installation■ Includes Update Tooland pkg utility installer stubs, which can be used to install those

utilities a ter GlassFish Server installation■ I uninstallation is desired, product must be uninstalled manually ■ Product downloads are roughly25%-30% larger thanthe analogous sel -extracting

bundles■ Sel -Extracting Bundle

■ Provides a GUI-based installation wizard with many con guration options■ The installation wizard can be used again a ter the initial installation to per orm

additional con guration tasks■

Canbe used to per ormSilent Mode installation, which is use ul or per ormingconsistent script-based installationson multiple server machines■ Provides the option to install the ull Update Tool and pkg utility at installation time■ I uninstallation is required, a GUI-based uninstaller is provided

Full Plat orm orWeb Profle Distribution?Each o the installation methods listed in Table 1–1 also let you choose to install either theGlassFish Server Full Plat ormor Web Profle distribution. Table 1–2 lists the eatures availablein each o these twodistributions. Note that some o these eatures are value-adds, and are notrequired by the Java 6 EE speci cation.

TABLE 1–2 GlassFishServerFull Pro leandWebPro leFeatures

Feature Full Plat orm Web Profle

Java Plat orm, Enterprise Edition 6 X X

EJB 3.1 Lite (Support or Local Container only) X X

JTS/JTA 1.1 ** X X

OSGi-based microkernel X X

Java Web Technologies (Servlet 3.0, JSP 2.2, JSF 2.0, JSTL 1.2, EL2.2)

X X

Grizzly/Comet X X






TABLE 1–2 GlassFishServerFull Pro leandWebPro leFeatures (Continued)Feature Full Plat orm Web Profle

JPA 2.0, (EclipseLink), JDBC Connection Pooling X X

JDBC 4.0 X X

JavaDB 10.5.3 X X

Web Administration Console and CLI X X

Rapid Redeployment (Maintain session state on applicationredeploy)

X X

OMG CORBA APIs 3.0 X XDebugging Support or Other Languages 1.0 X X

Common Annotations or Java 1.1 X X

Dependency Injection or Java 1.0 X X

Managed Beans 1.0 X X

Interceptors 1.1 X X

Contexts and DependencyInjection or Java 1.0 (CDI, ex-WebBeans)

X X

Bean Validation 1.0 X X

JAX-RS 1.1 (Jersey) X X

EJB 3.1 Full API (Support or Remote Container) X -

Java EE Connector Architecture 1.6 X -

JAX-WS 2.2 X -

JAXB 2.2 X -

Implementing Java Web Services 1.3 X -

Web Services Metadata or the Java Plat orm 2.1 X -

JMS 1.1 X -

JavaMail 1.4 X -

JACC 1.4 X -

Java Authentication Service Provider Inter ace or Containers1.1

X -

Java EE Application Deployment 1.2 X -

J2EE Management 1.1 X -





TABLE 1–2 GlassFishServerFull Pro leandWebPro leFeatures (Continued)Feature Full Plat orm Web Profle

JAX-RPC 1.1 X -

JAXR 1.0 X -

CORBA 3.0.0 X *

Metro X -

* The Full Java EE Plat orm contains thecompleteCORBApackage. The OMG CORBA v3.0

APIsare available in theJava EE Web Pro le.** Transaction propagation not supported.

Note – Regardless o whether youchoose theFull Plat orm or Web Pro le distribution, you canadd or removed packagesa ter installation by using the Update Tool or pkg utility.See Chapter11, “Extending andUpdating GlassFish Server,” in Oracle GlassFishServer 3.1 AdministrationGuide or more in ormation.

GlassFish Server ZIP FilesThe Oracle GlassFish Server 3.1 multi-plat orm ZIP les are compatible with Solaris, Linux,Mac OS,UNIX, and Windows operating systems. See “GlassFish Server Download Locations”on page 22 or a list o download locations.

Table 1–3 lists the available ZIP le downloads.

Note – Inall cases, the *-ml.zip bundles in the table are multilingual versions o theproduct.

TABLE 1–3 GlassFishServer DownloadableZIP Files

ZIP File Description

ogs-3.1.zipogs-3.1–ml.zip

Full Plat orm distribution o Oracle GlassFish Server

ogs-3.1-web.zipogs-3.1–web-ml.zip

Web Pro le distribution o Oracle GlassFish Server



http://www.oracle.com/pls/topic/lookup?ctx=E18930_01&id=SJSASEEAGghapp









GlassFishServer Sel -Extracting BundlesThe Oracle GlassFish Server 3.1 sel -extracting bundlesare plat orm-speci c, andare available

or Solaris, Linux, Mac OS,UNIX, and Windowsoperating systems. See “GlassFish ServerDownload Locations” on page 22 or a list o download locations.

Table 1–4 lists the available sel -extracting bundles.

Note – Inall cases, the *-ml.* bundles in the table are multilingual versions o the product.

TABLE 1–4 GlassFishServer Sel -extractingBundlesSel —Extracting Bundle Description

ogs-3.1-unix.shogs-3.1-windows.exeogs-3.1-unix-ml.shogs-3.1-windows-ml.exe

Full Plat orm distribution o Oracle GlassFish Server or Solaris, Linux,and Mac OSX systems ( *-unix.sh ) and Windows ( *-windows.exe )

ogs-3.1-web-unix.sh

ogs-3.1-web-windows.exeogs-3.1-web-unix-ml.shogs-3.1-web-windows-ml.exe

Web Pro le distributiono Oracle GlassFish Server or Solaris, Linux,

and Mac OSX systems ( *-unix.sh ) and Windows ( *-windows.exe )

HTTP Load Balancer Plug-in or Oracle GlassFishServerThe HTTPLoad BalancerPlug-in or Oracle GlassFish Server 3.1 provides high availability loadbalancing eatures or GlassFish Server.

The Plug-in is shipped as a ZIPbundle that you install a ter installing and con guring GlassFishServer and your desired Webserver. The Plug-in is installedby means o a graphical LoadBalancer Con gurator that helps youcon gure your Web server and GlassFish Server to work together.

Note – TheLoad Balancer Plug-in is only available to customers whoare using Oracle GlassFishServer 3.1. The Plug-in is not available orGlassFish Server Open SourceEdition.

SeeChapter 7, “Con guring Web Servers or HTTP LoadBalancing,” in Oracle GlassFishServer 3.1-3.1.1 High Availability Administration Guide or instructions on installing the HTTPLoad Balancer Plug-in and per orming the con gurationsteps required to make the Plug-inwork with your Web server.


InstallingGlassFish ServerFrom a ZIP File

http://www.oracle.com/pls/topic/lookup?ctx=E18930_01&id=SJSASEEHAAGgchvt







Installing GlassFish Server From a ZIP FileThis section describeshowto install Oracle GlassFish Server 3.1 using themulti-plat orm ZIP

le. GlassFish Server is installed by unzipping the le in the installation directory o your choice.

Note – It is not possible to speci y any GlassFish Server con gurationoptions during a ZIP leinstallation.Anycon guration changes, such as creating domains, clusters, and serverinstances, must be made manually a ter installation. I youpre er to make such changes duringthe GlassFish Server installation process, or i you pre er to use the GUI-based installationwizard, ollow the instructions in “Installing GlassFish Server From a Sel -Extracting Bundle”

on page 28.

▼ To Install GlassFish Server Using the ZIP FileEnsure that your system meets the requirements listed in “Hardware and So twareRequirements” in Oracle GlassFishServer 3.1-3.1.1 Release Notes.

Also see “Known Issues” in Oracle GlassFishServer 3.1-3.1.1 Release Notes or known issuesrelated to installation.

Download thedesired GlassFish Server 3.1ZIPfle.

See“GlassFish Server Download Locations” on page 22 or a list o download locations. SeeTable 1–3 or a list o available ZIP les.

Change to thedirectory whereyoudownloadedtheZIP fle.

Unzip thefle.

■ Solaris, Linux, and Mac OSX systems:

unzip zip-fle-name

zip-fle-name is the name o the le that you downloaded.

Forexample:

unzip ogs-3.1.zip■ Windowssystems:

Unzip using your avorite le compressionutility.

GlassFish Server 3.1 is extracted into a new glassfish3 directory under yourcurrent directory.This glassfish3 directory is re erred to throughout the GlassFish Server documentation set asas-install-parent .

Be oreYouBegin

1

2

3


InstallingGlassFish Server From a Self-ExtractingBundle












(Optional)Start GlassFish Server using the instructions in the Oracle GlassFishServer3.1QuickStartGuide .

The guide explains howto per orm basic tasks such as starting the server, accessing theAdministration Console, and deploying a sample application.

Installing GlassFish Server From a Sel -Extracting BundleThis section describeshowto install Oracle GlassFish Server 3.1 so tware using one o thesel -extracting installation bundles. Running any o the sel -extracting bundlesautomatically launches the GUI-based GlassFish Server installation wizard.

The ollowing topics are addressed here:■ “ToInstall GlassFish Server Using the Sel -Extracting File” on page 28■ “ToPer orm a Custom Installation” on page 31■ “Custom Con guration Parameters” on page 35

Note – Console installation is not supported in Oracle GlassFish Server 3.1. Silent modeinstallation is available, however. Formore in ormation, see “Per orming a Silent ModeInstallation” on page 38 .

▼ To Install GlassFishServer Using theSel -ExtractingFile■ When launching the sel -extracting installer romthe command-line, it possible to speci y

several command-line options that may be use ul to you. See “Installation Command-LineOptions” on page 45 or more in ormation.

■ Ensure that your system meets the requirements listed in “Hardware and So twareRequirements” in Oracle GlassFish Server 3.1-3.1.1 Release Notes.

■ See“Known Issues” in Oracle GlassFish Server 3.1-3.1.1 Release Notes or known issuesrelated to installation.

Download thedesired GlassFish Server 3.1bundle.

See“GlassFish Server Download Locations” on page 22 or a list o download locations. SeeTable 1–4 or a list o available sel -extracting bundles.

Change to thedirectory whereyoudownloaded thesel -extractingfle.

4

Be oreYouBegin

1

2


InstallingGlassFish Server From a Self-Extracting Bundle

















Start the installer.

■ Solaris, Linux, andMac OSX systems:

a. I necessary, grant execute permissions to thesel –extracting fle:chmod +x ./ sel -extracting-fle-name

sel -extracting-fle-nameis thename o thesel -extracting le that youdownloaded.

b. Atthe commandprompt, type:sh ./ sel -extracting-fle-name

For example, start the installer by typing the ollowing:

sh ./ogs-3.1-unix.sh

See“InstallationCommand-Line Options” on page 45 or a list o command-lineoptions you can speci y here, i desired.

■ Windows systems:

a. Double-click theexecutable .exe installationfle.

For example, double-click:ogs-3.1–windows.exe

On Windows you can also start the installer by typing the le name at the commandprompt.

Note–

■ Additional setup options are available. See “Installation Command-Line Options” onpage 45.

■ I youare installing on a 64–bit Windows system, run the installerwith the -j optionpointing to a 64–bit JDK.

■ Depending on your user privileges and the versiono Windowsyouare running, it may be

necessary to run the installer as Administrator. In particular, i youwill be con guring thedomain asa Service aspart o a Custom Installation (see next step) or a ter the installation,thenyou should run the installer as Administrator.

A ter starting the installer, the Introduction page is displayed. Use theNext button to movethrough the installation process.

3





Choose the InstallationType

■ Typical Installation

Choose thisoption or application development purposes or non-production use only. Thisoption installs the GlassFish Server binaries andcreates a DAS.

■ Custom Installation

Choose the option i youare deploying GlassFish Server in a productionenvironment. Thisoption provides several installation choices, which are described in detail later in this guide,in “ToPer orm a Custom Installation” on page 31 .

The remainder o this procedure describes the steps in the Typical Installation path. I youareper orming a Custom Installation, skip the remainder o this procedure and jump instead to“To Per orm a Custom Installation” on page 31 .

Speci y where to install GlassFishServer.

The de ault installation directories are as ollows:

■

Solaris, Linux, andMac OSX systemsuser-home-directory/glassfish3

■ Windows systems

SystemDrive\glassfish3

Make sure the directory you speci y is empty be ore installing the product.

The de ault installation directory is re erred to as as-install-parent throughout the GlassFish

Server documentation.

Speci y whether to installandenableUpdateTool.

Update Tool is an administrative tool that enablesyou to install updatesand add-oncomponents to an existingGlassFish Server 3.1 installation.Update Tool canbe installedduring GlassFish Server installation or at a later time. For more in ormationaboutUpdate Tool,see “Update Tool” in Oracle GlassFish Server 3.1 Administration Guide.

■ I youare not installing Update Tool, deselect the Install Update Tool checkbox.■ I youare installing Update Tool and your system accesses the Internet through a proxy,

speci y the proxy host and proxyport.■ I youare installing Update Tool and do not require theautomatic noti cations o available

updates a ter installation, deselect the Enable Update Toolcheck box.

4

5

6



http://www.oracle.com/pls/topic/lookup?ctx=E18930_01&id=SJSASEEAGghgai






Note – Update Tool di ers rom Upgrade Tool, which is used to migrate thecon gurationanddeployedapplications rom an earlierversiono GlassFish Server to the current version. For

more in ormationabout Upgrade Tool, see the Oracle GlassFishServer3.1Upgrade Guide.

Review theReady To Install selectionsandclick Install to proceed with the installation.

A progress bar is displayedas the core GlassFish Server components are installedand thede ault domain is automatically created and started.

The installer createsa de ault domain named domain1 . The results o this process will be brie y visible in the Con gResults screen.

Tip– The con guration resultspanel presents the recently executedcommand in the centersection and this is a selectable text. The text can be copied on to a script or uture automatedruns o such commands.

Note – I youchoose to cancel the installation at this point, no GlassFish Server les will beinstalled, but thedirectory you speci ed or as-install-parent will remain. This directory can bedeleted manually.

Review thesummarypage andclick Exitto exit theinstaller.

Installation in ormation is captured in log les. The nameso the les aretimestamp-install.log and timestamp-install-summary.html . On Solaris, Linux, and MacOS X systems, these les are generatedby de ault in the /tmp directory. On Windows systems,

these les are generated in the %TEMP%directory.

(Optional)Register yourGlassFish Serverproduct.

Follow the instructions on the registration screen to complete the registration process.

Familiarize yoursel with the instructions in the OracleGlassFishServer3.1 Quick Start Guide.The guideexplains howto per orm basic tasks such as starting the server, accessing the

Administration Console, and deploying a sample application.

▼ To Per orma Custom InstallationThisprocedure builds upon the instructions provided or the Typical Installation path in “ToInstall GlassFish Server Using the Sel -Extracting File” on page 28.

Complete thesteps in “To InstallGlassFishServer Using theSel -Extracting File”on page28 .

7

8

9

SeeAlso

1











Choose thekindo CustomInstallationyouwant to per orm.

■ Installand Confgure

Install theGlassFish Server binaries, and then con gure a DAS and one or more standaloneserver instances, clusters, or clustered instances.

■ Install Only

Install only the GlassFish Server binaries, without con guring a DAS or anyserver instancesor clusters. Youcan rerun theGlassFish Server installation wizard at a later time and choosethe Con gure an Existing Installation option to con gure the items.

■ Confgure an Existing Installation

Con gure a DAS, standalone server instances, clusters, or clustered instances or an existingGlassFish Server 3.1 installation. Note that this option is not or upgrading rom an older version o GlassFish Server. For instructions on upgrading rom a version o GlassFishServer prior to 3.1, see the OracleGlassFish Server 3.1Upgrade Guide.

The remainder o this procedure explains the Install and Con gure option. Most o these steps

also apply to theother options.



■ Solaris, Linux, andMac OSX systems

user-home-directory/glassfish3

■ Windows systemsSystemDrive\glassfish3


The de ault installation directory is re erred to as as-install-parent throughout the GlassFishServer documentation.

Speci y the path to the JDK tobeusedwith the installation.

Use a JDK installation detectedby the installeror speci y thepath ora di erent JDK.

JDK 6 is required. See “InstallationRequirements” on page 13 or more in ormation.

Note – This JDK page is not presented or Mac OS X installations. The installation uses thevaluein the JAVA_HOMEenvironment variable.

2

3

4








Speci y whether to installUpdateTool.

Update Tool is an administrative tool that enablesyou to install updatesand add-oncomponents to an existingGlassFish Server 3.1 installation.Update Tool canbe installedduring GlassFish Server installation or at a later time. For more in ormation aboutUpdate Tool,see “Update Tool” in Oracle GlassFish Server 3.1 Administration Guide.■ I youare not installing Update Tool, deselect the Install Update Tool checkbox.■ I youare installing Update Tool and your system accesses the Internet through a proxy,

speci y the proxy host and proxyport.■ I youare installing Update Tool and do not require theautomatic noti cations o available

updates a ter installation, deselect the Enable Update Toolcheck box.

Note – Update Tool di ers rom Upgrade Tool, which is used to migrate thecon gurationanddeployedapplications rom an earlierversiono GlassFish Server to the current version. Formore in ormationabout Upgrade Tool, see the Oracle GlassFishServer3.1Upgrade Guide.


A progress bar is displayedas the core GlassFish Server components are installedand thede ault domain is automatically created and started.

Note – I youchoose to cancel the installation at this point, no GlassFish Server les will beinstalled, but thedirectory you speci ed or as-install-parent will remain. This directory can bedeleted manually.

When the core installation has completed, the installer displays the Con gurationpage.Confgure GlassFish Servercomponents.

The general procedure or con guring server components involves the ollowing substeps:

a. Choosea componentconfgurationoption:

Createa serverdomainCreate a Domain Administration Server (DAS). At least one DAS must be createdandrunning be ore youcan con gureany other components. The parameters in theCon gurationscreen or this option are described in “Parameters or theCreate a serverdomain Option” on page 35 .

Createa standalone server instanceCreate a standalone GlassFish Server instance. The parameters in the Con gurationscreen or this optionare described in “Parameters or the Create a standalone serverinstance Option” on page 36 .

5

6

7












Createa clusteredserver instanceCreate a new cluster or a clustered server instance in a new or existing a cluster. Theparameters in theCon gurationscreen or this option are described in “Parameters or

theCreate a clustered server instance Option” on page 37 .Skip confguration

Skipany additional component con guration andproceed immediately to the nal stepso the installation andcon guration wizard.

Whencon guring a new or previously uncon gured GlassFish Server installation you mustchoose the rst option, Create a server domain, be ore proceeding with any o the otheroptions. Once at least one server domain has been created, you can chooseany o theotheroptions in anyorder you wish, including creating additional domains.

b. Confgure theselected component.

Each con guration option displays its own con guration screen.The speci c options ineach con guration screen are described a ter thisprocedure, in “Custom Con gurationParameters” on page 35 .

c. Choose how you want toproceed.A tercon guring any one o theavailable options, a Con gurationResults screen isdisplayed. In addition to displaying the con guration results, three buttons are displayed:Cancel

Cancel the con guration and exit the installation wizard. Note that the core GlassFishServer components will already be installed at this point, as well as any con gurationsthat may have been con gured during this step or during another installation. To remove

the core GlassFish Server components andany con gurations, ollow the instructions inChapter 2, “Uninstalling GlassFish Server 3.1”

Confgure againReturn to the Con gurationpage so youcan con gure another item.

NextComplete the con gurationoption and continue to the nal steps o the installation andcon guration wizard. Note that this label becomes " Exit" i this is a Custom Installation

and the “Con gure Existing Installation” option is selected.

Tip – The con guration results panel presents the recently executedcommand in thecenter section. This is selectable text, and it can be copied to a script or uture automatedruns o such commands.

When youhave con gured all thecomponents youwant and then clicked the Next button, the

nal con gurationoption is per ormedand a Summary screen is displayed.





Click Exit to exit theinstallation andconfgurationwizard.

A webbrowser is displayedso youcan registeryour GlassFish Server product.

(Optional)Register yourGlassFish Serverproduct.Follow the instructions on the registration screen to complete the registration process.

I you are done with the installation at this point, it is recommended that you amiliarizeyoursel with the instructions in the Oracle GlassFish Server 3.1Quick Start Guide. The guideexplains howto per orm basic tasks such as starting theserver, accessing theAdministrationConsole, anddeploying a sample application.

Custom Confguration ParametersThis section lists thecon gurationparameters in the screens displayed or the options in theCon gure GlassFishServer components. step in “To Per orm a Custom Installation” onpage 31.■ “Parameters or theCreate a server domain Option” on page 35■ “Parameters or theCreate a standalone server instance Option” on page 36■ “Parameters or theCreate a clustered server instance Option” on page 37

Parameters ortheCreate a server domainOptionThe ollowing are theparametersdisplayed in the Con gurationscreen when youchoose theCreate a server domain option in Con gureGlassFish Server components. step in “To Per orma Custom Installation” on page 31 . This option enablesyou to create a Domain Administration

Server (DAS)Domain Name

The unique domain name to use or the DAS. The de ault name is domain1 .

Admin PortThe port on which the GlassFish Server Admin Console will listen. Thede ault port is 4848 .

HTTPPortThe port on which the non-secure HTTP server will listen. The de aultport is 8080 . Notethat the port used or the secure HTTP listener is 8181 .

UsernameThe user name or administrative access to the GlassFish Server Admin Console.

PasswordThe password or administrative access to the GlassFish Server Admin Console. You canleave this parameter empty to enable unauthenticated logins to theAdmin Console, butmake sure that the Username eld has "

admin" as the input value. Speci ying a password is

highly recommended i you are installing GlassFish Server in a productionenvironment.

8

9

SeeAlso







ReenterPasswordReenter the password to veri y your typing.

CreateOperatingSystemService or thedomainSpeci y whether an operating system service will be created or theDAS. Theservice will bestartedwhen the operating system is booted.

I a service is not created here, the DAS can be started manually using the asadminstart-domain subcommand.

Note – The Create Operating System Service option is not available on Mac OS X systems.Also note that on Unix or Linux systems, you must run the installer as superuser or root i youwant to create a system service or thedomain.

Service NameSpeci y the name or the DAS operating system service. Thede ault name isdomain1Service . This parameter is only required i the Create Operating Systemserviceparameter is enabled.

Start domain a ter creationStart the domain as soon as it is created. This option is enabled by de ault. Note that isnecessary or the DAS to be running be ore you can con gure any server instances orclusters. I you choose to not start the domain at this time, you can start it manually laterusing the asadmin start-domain subcommand.

Note – Ensure that this option is enabled i youplan on per orming more con gurationsduring this installation procedure. The DAS must be running in order to create any serverinstances or clusters.

Parameters ortheCreate a standalone server instanceOptionThe ollowing are theparametersdisplayed in the Con gurationscreen when youchoose theCreate a standalone server instance option in Con gure GlassFish Server components. step in“To Per orm a Custom Installation” on page 31 . This optionenablesyou to create a standaloneGlassFishServer instance.

Note – TheDAS or thedomain in which thestandalone server instance will be createdmust berunning with the speci ed name and at the speci ed port be ore con guring a standalone serverinstance. See the “Parameters or the Create a server domain Option” on page 35 orinstructions.





InstanceNameThe unique name to use or the standalone GlassFish Server instance. I the name is already in use, an errorwill be generatedwhen thecon guration is per ormed. The de aultname is

instance1 .HostName

The name o the physical host on which the DAS is running. The de ault name is localhost .

Administration PortThe administration port on which theDAS is running. The de aultport is 4848 .

Parameters ortheCreate a clustered server instance OptionThe ollowing are theparametersdisplayed in the Con gurationscreen when youchoose theCreate a clustered server instance option in Con gure GlassFish Server components. step in“To Per orm a Custom Installation” on page 31 . This option enables you to create a new clusteror a clustered server instance in a new or existing a cluster.

Note – TheDAS or thedomain in which thestandalone server instance will be createdmust berunning with the speci ed name and at the speci ed port be ore con guring a cluster or

clustered server instance. See the “Parameters or the Create a server domain Option” onpage 35 or instructions.

InstanceNameThe unique name to use or theclustered GlassFish Server instance. I the name is already inuse, an errorwill be generatedwhen thecon guration is per ormed. Thede ault name isinstance1 .

HostNameThe name o the physical host on which the DAS is running. The de ault name is localhost .

Administration PortThe administration port on which theDAS is running. The de aultport is 4848 .

Create ClusterSpeci y whether a new cluster will be created at this time. The de ault is to leave this optiondisabled. I le t disabled, thecluster speci ed in the ClusterName eld, below,must already

exist.■ Ensure that this option is enabled i the cluster in which you want to create the clustered

server instance does not yet exist.■ Ensure that this option is disabled i the cluster in which you want to create the clustered

server existence already exists.

Cluster NameThe unique name to use or the cluster. I the name is already in use, anerror will begeneratedwhen thecon guration is per ormed. Thede ault name is c1 .


Performinga Silent ModeInstallation



Domain NameThe name o the DAS in which the cluster will run. The de ault name is domain1 .

Per orming a Silent Mode InstallationThis section describeshowto install Oracle GlassFish Server 3.1 using silent mode installation.Silent mode is a non-interactive installation based on user-de ned parameters captured in ananswer le. Theanswer le can be used later to install GlassFish Server on one or more systems.

Note – It is only possible to per orm a silent installation using the Typical Installation pathdescribed in “ToInstall GlassFish Server Using the Sel -Extracting File” on page 28.Itisnotpossible to per orm a silent installation using the more complex Custom Installation pathdescribed in “ToPer orma Custom Installation” on page 31 .

The ollowing topics are addressed here:■ “Creating the Installation Answer File” on page 38■ “Reviewing the Installation Answer File” on page 41■ “Installing in Silent Mode” on page 44

Creating the Installation Answer FileThe answer le orms the template or silent installation. The le is createdwhen youuse thedry-run (-n ) option to start an interactive installation. In dry-run mode, actual installation doesnot take place.

During the interactive installation youcan accept thede ault values presentedor you canchange them. Your input is collected and stored in the answer fle , which is then used to installGlassFish Server. You can use the answer le as it is or you can modi y the le be ore using it.

▼ To Create the Installation Answer FileThe installation wizard is used to create theanswer le. Actual installation does not take place.■ Remember that it is only possible to per orm a silent installation using the Typical

Installation path described in “To Install GlassFish Server Using the Sel -Extracting File” onpage 28. It is not possible to per orm a silent installation using themore complex CustomInstallation path described in “To Per orm a Custom Installation” on page 31 .

■ When launching the sel -extracting installer romthe command-line, it possible to speci y several command line options that may be use ul to you. See “Installation Command-LineOptions” on page 45 or more in ormation.

■ Ensure that your system meets the requirements listed in “Hardware and So tware

Requirements” in Oracle GlassFish Server 3.1-3.1.1 Release Notes.

Be oreYouBegin














■ See“Known Issues” in Oracle GlassFish Server 3.1-3.1.1 Release Notes or known issuesrelated to installation.

Download thedesired GlassFish Server 3.1bundle.See“GlassFish Server Download Locations” on page 22 or a list o download locations. SeeTable 1–4 or a list o available sel -extracting bundles.

Change to thedirectory whereyoudownloaded thesel -extractingfle.

Start theinstaller in dry-runmode.


a. I necessary, grant execute permissions to thesel –extracting fle:chmod +x ./ sel -extracting-fle-name

sel -extracting-fle-nameis thename o thesel -extracting le that youdownloaded.

b. Atthe commandprompt, type:

sel -extracting-fle-name -n answer-fle

answer-fle is the name o the answer le you want to generate. I you do not include apath to the answer le, the le is createdunder the directory rom which the installationprogram is run.

For example, start the installer in dry-run mode by typing the ollowing:

ogs-3.1-unix.sh -n 31-answer


■ Windows systems:

a. Open a Windows CommandPrompt shell with Administrative privileges.

b. Atthe commandprompt, type:sel -extracting-fle-name -n answer-fle

answer-fle is the name o the answer le you want to generate. I you do not include apath to the answer le, the le is createdunder the directory rom which the installationprogram is run.

For example, start the installer in dry-run mode by typing the ollowing:

ogs-3.1-windows.exe -n 31-answer

1

2

3


S “I t ll ti C d Li O ti ” 45 li t d li








Note–

■ Additional setup options are available. See “Installation Command-Line Options” onpage 45.

■ I youare installing on a 64–bit Windows system, run the installerwith the -j optionpointing to a 64–bit JDK.

■ Depending on your user privileges and the versiono Windowsyouare running, it may benecessary to run the installer as Administrator. In particular, i youwill be con guring thedomain asa Service aspart o a Custom Installation (see next step) or a ter the installation,thenyou should run the installer as Administrator.

A ter starting the installer, the Introduction page is displayed. Use theNext button to movethrough the installation process.

ChooseTypical Installation in theInstallationTypescreen.

It is not possible to use theCustom Installation path when generating an answer le orsilent-mode installation.



■ Solaris, Linux, andMac OSX systemsuser-home-directory/glassfish3

■ Windows systemsSystemDrive\glassfish3


The de ault installation directory is re erred to as as-install-parent throughout the GlassFishServer documentation.

Speci y whether to installandenableUpdateTool.Update Tool is an administrative tool that enablesyou to install updatesand add-oncomponents to an existingGlassFish Server 3.1 installation.Update Tool canbe installedduring GlassFish Server installation or at a later time. For more in ormationaboutUpdate Tool,see “Update Tool” in Oracle GlassFish Server 3.1 Administration Guide.■ I youare not installing Update Tool, deselect the Install Update Tool checkbox.■ I youare installing Update Tool and your system accesses the Internet through a proxy,

speci y the proxy host and proxyport.

4

5

6


■ I youare installing Update Tool and do not require theautomatic noti cations o available








■ I youare installing Update Tool and do not require theautomatic noti cations o availableupdates a ter installation, deselect the Enable Update Toolcheck box.

Note – Update Tool di ers rom Upgrade Tool, which is used to migrate thecon gurationanddeployedapplications rom an earlierversiono GlassFish Server to the current version. Formore in ormationabout Upgrade Tool, see the Oracle GlassFishServer3.1Upgrade Guide.


A progressbar is displayed as the answer le is created and anempty as-install-parent directory is created.

Tip– The con guration resultspanel presents the recently executedcommand in the centersection and this is a selectable text. The text can be copied on to a script or uture automatedruns o such commands.

Review thesummarypage andclick Exitto exit theinstaller.

Installation in ormation is captured in log les. The nameso the les aretimestamp-install.log and timestamp-install-summary.html . On Solaris, Linux, and MacOS X systems, these les are generatedby de ault in the /tmp directory. On Windows systems,these les are generated in the %TEMP%directory.

Proceed to theinstructions in “Reviewing theInstallationAnswer File”on page41 .

Reviewing the Installation Answer FileThe answer le generatedusing the procedure described in “Creating the Installation AnswerFile” on page 38 provides a number o system-speci c parameters as well as parameters that youselected during dry-run mode installation.Values or some parameterscan be edited asdescribed in “To Edit the Answer File” on page 43 .

The ollowing example shows the contents o an answer le that was createdduring a dry-runmode installation.All de ault values were accepted during the installation.

Note – The ollowing example contains a completeanswer le, where most o theparametersarenot used in GlassFish Server 3.1. For an answer le template that contains only the elementsrequired to per orma typical installation, see the Example 1–2.

EXAMPLE 1–1 Example AnswerFile

#openInstaller Dry Run Answer File. This File can be used as input to theopenInstaller engine using the -a option.

#Sun Jan 16 16:56:14 EST 2011

7

8

9


EXAMPLE 1–1 Example Answer File (Continued)







EXAMPLE 1 1 Example Answer File (Continued)

InstallType.Option.INSTALL_AND_CONFIG=INSTALL_AND_CONFIGUpdateTool.Configuration.PROXY_PORT=SOAccountCreation.accountinfo.FIRSTNAME=ClusteredInstance.Configuration.CLUSTER_NAME=c1Domain.Configuration.ADMIN_PASSWORD_REENTER=StandaloneInstance.Configuration.SERVER_HOST_NAME=localhostRegistrationOptions.regoptions.USE_EXISTINGACCT=USE_EXISTINGACCTDomain.Configuration.ADMIN_PASSWORD=UpdateTool.Configuration.BOOTSTRAP_UPDATETOOL=trueRegistrationOptions.regoptions.USERNAME=StandaloneInstance.Configuration.INSTANCE_NAME=instance1ClusteredInstance.Configuration.INSTANCE_NAME=instance1SOAccountCreation.accountinfo.EMAIL=ClusteredInstance.Configuration.SERVER_ADMIN_PORT=4848Domain.Configuration.CREATE_SERVICE=falseClusteredInstance.Configuration.CREATE_CLUSTER=falseInstallUserType.Option.ADVANCED_USER=ADVANCED_USERUpdateTool.Configuration.ALLOW_UPDATE_CHECK=trueSOAccountCreation.accountinfo.LASTNAME=RegistrationOptions.regoptions.CREATE_NEWACCT=CREATE_NEWACCTJDKSelection.directory.HIDDEN_JDK=SOAccountCreation.accountinfo.PASSWORD=ConfigType.Option.CREATE_CLUSTEREDINSTANCE=CREATE_CLUSTEREDINSTANCEJDKSelection.directory.JDK_LIST=ClusteredInstance.Configuration.SERVER_HOST_NAME=localhostSOAccountCreation.accountinfo.REENTERPASSWORD=JDKSelection.directory.JDK_TYPED_IN_CHOICE=falseUpdateTool.Configuration.PROXY_HOST=InstallType.Option.INSTALL_ONLY=INSTALL_ONLYConfigType.Option.CREATE_STANDALONEINSTANCE=CREATE_STANDALONEINSTANCEDomain.Configuration.HTTP_PORT=8080RegistrationOptions.regoptions.SKIP_REGISTRATION=SKIP_REGISTRATIONDomain.Configuration.SERVICE_NAME=domain1ServiceConfigType.Option.NO_CONFIGURATION=NO_CONFIGURATIONDomain.Configuration.ADMIN_USER=adminJDKSelection.directory.JDK_FROM_LIST_CHOICE=falseRegistrationOptions.regoptions.USERPASSWORD=SOAccountCreation.accountinfo.COUNTRY=InstallHome.directory.INSTALL_HOME=C\:\\glassfish3Domain.Configuration.ADMIN_PORT=4848SOAccountCreation.accountinfo.COMPANYNAME=InstallUserType.Option.BASIC_USER=BASIC_USERConfigType.Option.CREATE_DOMAIN=CREATE_DOMAINInstallType.Option.CONFIG_ONLY=CONFIG_ONLYDomain.Configuration.START_SERVER=falseDomain.Configuration.DOMAIN_NAME=domain1ClusteredInstance.Configuration.DOMAIN_NAME=domain1JDKSelection.directory.JDK_TYPE_IN=StandaloneInstance.Configuration.SERVER_ADMIN_PORT=4848SOAccountCreation.accountinfo.COUNTRY_DROP_DOWN=RegistrationOptions.regoptions.DUMMY_PROP=

EXAMPLE 1–2 AnswerFile Template orGlassFishServer3.1

#openInstaller Dry Run Answer File. This File can be used as input to theopenInstaller engine using the -a option.

Domain.Configuration.ADMIN_PASSWORD=


EXAMPLE 1–2 AnswerFile Template orGlassFishServer3.1 (Continued)




p ( )

Domain.Configuration.ADMIN_PASSWORD_REENTER=Domain.Configuration.ADMIN_PORT=4848Domain.Configuration.ADMIN_USER=adminDomain.Configuration.DOMAIN_NAME=domain1Domain.Configuration.HTTP_PORT=8080InstallHome.directory.INSTALL_HOME=C\:\\glassfish3UpdateTool.Configuration.ALLOW_UPDATE_CHECK=trueUpdateTool.Configuration.BOOTSTRAP_UPDATETOOL=trueUpdateTool.Configuration.PROXY_HOST=UpdateTool.Configuration.PROXY_PORT=8888

▼To Edit the AnswerFileSome values in theanswer le can be changed i desired. Such editing is strictly optional.

Create theanswer le as described in “To Create the Installation Answer File” on page 38 .

Review theanswer fle.

Reviewthe values that will be used or silent installation.

Edit theanswer fle.

Only the ollowing de ault values can be changed:InstallHome.directory.INSTALL_HOME= as-install-parent

Provide anotherdirectory name or GlassFish Server 3.1 installation les.

Domain.Configuration.ADMIN_PASSWORD=Providea password or access to the AdministrationConsole. This password is case

sensitive.Domain.Configuration.ADMIN_PASSWORD_REENTER=

Provide the password con rmation or Administration Console. Make sure that thismatches the value or Domain.Configuration.ADMIN_PASSWORD .

Domain.Configuration.ADMIN_PORT=4848Assign another port number to the Administration Console.

Domain.Configuration.ADMIN_USER=adminProvideanother user name or theadministrator. This name is case sensitive.

Domain.Configuration.HTTP_Port=8080Assign another port number to HTTPconnections.

UpdateTool.Configuration.ALLOW_UPDATE_CHECK=trueChange value to false i youdo not want Update Tool noti cations.

UpdateTool.Configuration.BOOTSTRAP_UPDATE=true

Change value to false i youdo not want to install the standalone Update Tool.

Be oreYouBegin

1

2


UpdateTool.Configuration.PROXY_HOST=




p gAssign a name to the proxy host.

UpdateTool.Configuration.PROXY_PORT=

Assign a port number to the proxyhost.

Note – Parameters not listed are system speci c. Do not change system-speci c parameters.Doing so will cause problemswith the installation program.

Installing in Silent ModeThe non-interactive installation program reads the speci ed answer le, checks or adequatedisk space, and installs GlassFish Server based on the data in the answer le.

▼ To Install UsingSilentMode■ Create the answer le as described in “ToCreate the Installation Answer File”on page 38 .

Veri y that the parameters in the answer le are set to the values that you want to use orsilent installation, as described in “Reviewing the Installation Answer File” on page 41 .

■ Answer lesgenerated using the GlassFish Server 3.1 installer are not backward-compatiblewith earlier versions o GlassFish Server including version3.1.

Navigate to thedirectory that contains thesel -extracting installer fleand theinstallationanswer fle.

From thecommand line, type:sel -extracting-fle-name -a answer-fle -s

sel -extracting-fle-nameis the name o the le that you downloaded during “Creating theInstallation Answer File” on page 38 .

-a answer-fleThe name o theanswer le that was generatedaccording to the instructions in Creating the

InstallationAnswer File . Ensure that youprovide thecomplete path to theanswer le.-s

Runs the installer in silent mode.

Forexample:

ogs-3.1-unix.sh -a 31-answer -s

When theprompt is returned, the silent installation is completeand the installation

components are installed on your system.

Be oreYouBegin

1

2


Familiarize yoursel with the instructions in the OracleGlassFishServer3.1 Quick Start Guide.NextSteps

InstallationCommand-LineOptions






The guideexplains howto per orm basic tasks such as starting the server, accessing theAdministration Console, and deploying a sample application.

Installation Command-Line OptionsThe ollowing options can be used when yourunthe installation program rom the commandline using the sel -extracting installation le ( .sh or .exe ). Speci y the desired optionsa tertyping the installation le name at thecommand prompt.

For example:ogs-3.1-unix.sh -a 3.1-answer -l log-directory -s

The options are as ollows:

-a answer-fleRun the installation program in silent mode using the answer le speci ed.Use this optionwith the -s option.

-l log-directoryWrite log in ormation to thisdirectory.

-qSet logging level to WARNING.

-vRuns the installation program in verbose mode, which can be use ul or troubleshooting.Also sets the logging level to FINEST.

-sRun the installation program in silent mode.

-j javahomeUse thisdirectory or the JDK so tware installation.

-n answer-fleRun the installation program in trial mode to generate the answer le or silent mode

installation.-h or -help

Display the helpmessage listing these options.




46

2C H A P T E R 2



Uninstalling GlassFish Server 3.1

Thischapter describes how to uninstall Oracle GlassFish Server 3.1 so tware.

Removing a GlassFish Server Installation

Thissection describes how to remove Oracle GlassFish Server 3.1 so tware.The ollowing topics are addressed here:■ “ToUninstall GlassFish Server So tware A tera ZIPFile Installation”on page 47■ “To Uninstall GlassFish Server So tware A ter a GUI-Mode Installation” on page 48

▼ To Uninstall GlassFish Server So tware A ter a ZIP FileInstallationThisprocedure describes how to uninstall GlassFish Server so tware that was installed using aZIP le, as described in “Installing GlassFish Server From a ZIP File”on page 27 .

Stopall domains andother relatedprocesses, including commandprompts using theinstallation directory or its subdirectories, the Update Tool noti erprocess i present, andany applications using Java SE les.

To stop domains, use the asadmin stop-domain command. For more in ormation aboutstopping a domain, see “To Stop a Domain” in Oracle GlassFish Server 3.1 AdministrationGuide.

To stop the Update Tool noti er process, use the updatetool --notifier --shutdowncommand, executed rom as-install-parent /bin .

I orphaned processes remain, identi yand terminate the processes as ollows:

2

Be oreYouBegin

47

■ Solaris, Linux, and Mac OSX systems:

Removinga GlassFishServer Installation

http://www.oracle.com/pls/topic/lookup?ctx=E18930_01&id=SJSASEEAGggoch








Use the ps -ef command and terminate the processes using the kill command.■ Windows systems:

Use theTask Manager and terminate theprocesses.

Also see “Known Issues” in Oracle GlassFishServer 3.1-3.1.1 Release Notes or known issuesrelated to uninstallation.

Save any fles in the installation directory that you may want tokeep.

Manuallydeleteinstallationdirectory andall itscontents.

▼ To Uninstall GlassFish Server So tware A ter aGUI-Mode InstallationThisprocedure describes how to uninstall GlassFish Server so tware that was installed using asel -extracting le, as described in“Installing GlassFish Server From a Sel -Extracting Bundle”on page 28.

During installation, a script or uninstalling GlassFish Server is placed in the installationdirectory. This sectionprovides instructions or removing the so tware using this script. I youattempt to remove the so tware using another method, problems are likely to arise when you try to reinstall the same version o GlassFish Server or when you install a new version.

Stop all GlassFish Server domainsandother related processes, including the ollowing:

■ All domains, clusters, and instances■ Command shells that may be active in the product installation directory or subdirectories■ The GlassFish Server Update ToolNoti er process, i present■ Any applications that are using Java SE les

a. To stop domains, use the asadmin stop-domain command.

For more in ormation about stopping a domain, see “To Stop a Domain” in Oracle GlassFish

Server 3.1 Administration Guide .b. To stop the Update Tool Notifer process, use the updatetool --notifier --shutdown

command, executed rom as-install-parent /bin .

c. I orphaned processes remain,identi y and terminate theprocessesas ollows:

■ Solaris, Linux, andMac OS X systems

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

1

2

1


■ Windows systems

U h T k M d i h

Removinga GlassFish ServerInstallation











Use the Task Managerand terminate theprocesses.

Navigate to thedirectory in which GlassFish Server 3.1is installed.Alternatively, i you are running on Windowsand want to run the uninstaller rom theWindows Start menu, you can skip this step and jump ahead to the next step.

The de ault installation directories are as ollows:■ Solaris, Linux, and Mac OS X systems: user's-home-directory/glassfish3■ Windows systems: SystemDrive:\glassfish3

The de ault installation directory is re erred to as as-install-parent throughout GlassFish Serverdocumentation.

Start theuninstallation program andremove theso tware.


a. I necessary, grant execute permissions to theuninstall fle.chmod +x ./uninstall.sh

b. Atthe commandprompt, type:sh ./uninstall.sh

■ Windows systems, rom theStart menu (recommended) :

a. Choose Start → Programs → OracleGlassFish Server → Uninstall.

■ Windows systems, rom thecommandline:

a. Double-click the uninstall.exe fle.

On Windows youcan also start the uninstallerby typing the le name at thecommandprompt.

2

3

Chapter 2 • Uninstalling GlassFish Server 3.1 49

Tip There is a knownissue on Windows7 systems (Issue 12093) whereby uninstallation o

Removinga GlassFishServer Installation



Tip – There is a knownissue on Windows7 systems (Issue 12093), whereby uninstallation o GlassFish Server may ail because Windows cannot nd the required JDK installation.The

problem may occurwhen theJava binariesare not installed through a standard Java SDKinstaller. This problem does not occur when running the uninstaller rom the WindowsStart menu.

The workaround or this issue is to explicitly speci y the locationo theJava binarieswhenrunning the GlassFish Server uninstall utility rom the command line. For example:

uninstall.exe -j "%JAVA_HOME%"

Note – To uninstall in silent (non-interactive) mode, use the -s option a ter the le name.Forexample: ./uninstall.sh -s or uninstall.exe -s

Review thesummarypage that displays ollowinguninstallation andclick Exitto exit theuninstaller.

Uninstallation in ormation is captured in log les. Thenameso the les are timestamp-remove.log and timestamp-remove-summary.html . On Solaris,Linux, and Mac OS Xsystems, these les are generatedby de ault in the /tmp directory. On Windowssystems, these

les are generated in the %TEMP%directory.

Examine thecontents o theremaining installationdirectories andremove anyfles ordirectories that youdo notwant.

Note – Not allGlassFish Server directories areautomatically removedby the uninstallationprogram. Remove the remaining contents as desired, including hidden directoriespre xed witha dot. It is sa e to remove uninstallation and installation log les a teryouhave examined them.

4

5




Index

Aadding components, 30, 33, 40answer le

Seealsosilent mode installationcreating, 38editing, 43example, 41reviewing, 41using to install, 44–45

Ccomponents

adding andupdating, 30, 33, 40removing, 47–50

Con gurator, Load Balancer, 26

Dde ault installationdirectories, 30, 32, 40directories, removing, 50download locations, 22

Eenvironment variables, JAVA_HOME, 22execute permissions, 29, 39

Fles

answer, 38installation, 22sel -extracting (GUI), 22silent mode, 22size o , 22ZIP, 22, 27

Ggettingstartedwith Enterprise Server, 31, 35, 45GlassFishServer Community downloads, 22graphical installation, 28

Hhardware requirements, 13

Iinstallation

de ault directories, 30, 32, 40log les, 31, 41requirements, 13types, 22

installingusing silent mode, 38using the sel -extracting (GUI) le, 28using the ZIP le, 27

51

JJAVA_HOME, 22

plat orm options (Continued)MacOSX, 27

Index



,Java requirements, 22JDK issues, 13JDK requirements, 13

Kknown issues, 13

LLinux installation

graphical inter ace and, 28multi-plat orm le and, 27silent modeand, 38uninstalling, 47–50

Load Balancer Plug-in, 26load balancing, LoadBalancer Plug-in, 26log les, 31, 41, 50

MMac OS X installation

graphical inter ace and, 28

JDK and, 13, 32multi-plat orm le and, 27silent modeand, 38uninstalling, 47–50

multi-plat orm installation, 27

OOracle GlassFish Server product page, 22

Pplat orm-independent installation, 27plat orm options

Linux, 27

multi-plat orm, 27Solaris, 27Windows, 27

plat orms, supported, 13Plug-in, LoadBalancer, 26processes, stopping, 47, 48–50

QQuick Start Guide, 31, 35, 45

Rremoving an installation, 47requirements, 13

Ssel -extracting le installation, 28setup options, 45silent mode installation

answer le, 38overview, 38running, 44

so tware requirements, 13Solaris installation


starting Enterprise Server, 31, 35, 45stopping processes, 47, 48–50supported plat orms, 13systemrequirements, 13

T

trial mode, 38


Uuninstallation log les, 50

Index



uninstalling, 47–50GUI-mode installation, 48–50ZIP le installation, 47–48

uninstalling the so tware, 47Update Tool, 30, 33, 40Update Tool noti erprocess, 47, 48–50updating components, 30, 33, 40Upgrade Tool, 30, 33, 40

WWindows installation


wizard installation, 28

ZZIP le installation, 27

53



54

Documents

OracleGlassFish Server 3.1 Installation Guide