821-2427

8/6/2019 821-2427

http://slidepdf.com/reader/full/821-2427 1/54

Oracle® GlassFish Server 3.1 InstallationGuide

Part No: 821–2427–11April 2011

8/6/2019 821-2427


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

LicenseRestrictionsWarranty/ConsequentialDamagesDisclaimer

This sotware and related documentation are provided undera license agreement containingrestrictions on use and disclosure and are protected by intellectualproperty laws. Exceptas expresslypermitted in your license agreementor allowed by law, youmay notuse, copy, reproduce, translate, broadcast, modiy, license,transmit,distribute,exhibit,perorm,publish or display anypart,in anyorm,or by anymeans. Reverse engineering,disassembly,or decompilation o this sotware,unless required by law or interoperability, is prohibited.

WarrantyDisclaimer

Theinormationcontained hereinis subject to changewithout noticeand is notwarranted to be error-ree. I yound anyerrors,please reportthem to us in writing.

RestrictedRights Notice

Ithis is sotware or related documentation that is deliveredto theU.S. Government or anyonelicensing it on behalo theU.S. Government, theollowing noticeisapplicable:

U.S. GOVERNMENT RIGHTS

Programs, sotware, databases, and related documentation and technicaldata deliveredto U.S. Governmentcustomers are "commercialcomputersotware" or"commercial technicaldata" pursuant to the applicableFederalAcquisition Regulationand agency-specic supplemental regulations. As such, the use, duplication,

disclosure, modication,and adaptation shall be subject to therestrictions andlicense terms setorthin theapplicable Government contract,and, to theextentapplicable by thetermso theGovernment contract,the additional rightsset orth in FAR 52.227-19, Commercial Computer Sotware License (December 2007).OracleAmerica,Inc.,500 OracleParkway, Redwood City, CA 94065.

HazardousApplicationsNotice

This sotware or hardware is developedor general usein a variety o inormation management applications. Itis notdeveloped or intended oruse in anyinherently dangerousapplications, includingapplications that maycreate a risk o personal injury. I youuse this sotware or hardware in dangerousapplications, then youshallbe responsible to take allappropriate ail-sae, backup, redundancy, andothermeasuresto ensure itssae use. OracleCorporationand itsafliatesdisclaimany liabilityor anydamagescausedby useo this sotware or hardware in dangerousapplications.

TrademarkNotice

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 Advanced MicroDevices. UNIX is a registered trademarko TheOpen Group in theUnited Statesand other countries.

ThirdPartyContent,Products,and ServicesDisclaimer

This sotware or hardware anddocumentation mayprovide accessto or inormation 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.

110427@25097

8/6/2019 821-2427


Contents

Preace .....................................................................................................................................................5

1 Installing GlassFish Server 3.1 ..........................................................................................................13

Installation Requirements .................................................................................................................. 13

Javassist Library License Notice ................................................................................................. 13

Installation Files or GlassFish Server 3.1 ......................................................................................... 21

GlassFish Server Download Locations ...................................................................................... 22

GlassFish Server Installation Methods ...................................................................................... 22

Choosing an Installation Method .............................................................................................. 22

GlassFish Server ZIP Files ........................................................................................................... 25

GlassFish Server Sel-Extracting Bundles ................................................................................. 26

HTTP Load Balancer Plug-in or Oracle GlassFish Server ..................................................... 26

Installing GlassFish Server From a ZIP File ...................................................................................... 27

▼ To Install GlassFish Server Using the ZIP File .......................................................................... 27

Installing GlassFish Server From a Sel-Extracting Bundle ............................................................ 28

▼ To Install GlassFish Server Using the Sel-Extracting File ...................................................... 28

▼ To Perorm a Custom Installation ............................................................................................. 31

Custom Conguration Parameters ............................................................................................ 35

Perorming a Silent Mode Installation .............................................................................................. 38

Creating the Installation Answer File ........................................................................................ 38Reviewing the Installation Answer File ..................................................................................... 41

Installing in Silent Mode ............................................................................................................. 44

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

2 UninstallingGlassFishServer 3.1 .....................................................................................................47

Removing a GlassFish Server Installation ........................................................................................ 47▼ To Uninstall GlassFish Server Sotware Ater a ZIP File Installation .................................... 47

3

8/6/2019 821-2427


▼ To Uninstall GlassFish Server Sotware Ater a GUI-Mode Installation .............................. 48

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

Contents

Oracle GlassFish Server3.1 Installation Guide • April 20114

8/6/2019 821-2427


Preface

This document contains instructions or installing and uninstalling Oracle GlassFish Server 3.1

sotware.

This preace contains inormation about and conventions or the entire Oracle GlassFish Server

(GlassFish Server) documentation set.

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

http://glassfish.java.net/. The GlassFish project provides a structured process or

developing the GlassFish Server platorm that makes the new eatures o the Java EE platorm

available aster, while maintaining the most important eature o Java EE: compatibility. Itenables Java developers to access the GlassFish Server source code and to contribute to the

development o the GlassFish Server. The GlassFish project is designed to encourage

communication 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■ “Deault Paths and File Names” on page 9■ “Documentation, Support, and Training” on page 10■ “Searching Oracle Product Documentation” on page 10■ “Third-Party Web Site Reerences” on page 11

GlassFish Server Documentation Set

The GlassFish Server documentation set describes deployment planning and system

installation. For an introduction to GlassFish Server, reer to the books in the order in which

they are listed in the ollowing table.

5

http://glassfish.java.net/



8/6/2019 821-2427


TABLE P–1 Books in the GlassFishServer Documentation Set

Book Title Description

ReleaseNotes Provides late-breaking inormation about the sotware and the

documentation and includes a comprehensive, table-based summary o the

supported hardware, operating system, Java Development Kit (JDK), and

database drivers.

Quick StartGuide Explains how to get started with the GlassFish Server product.

InstallationGuide Explains how to install the sotware and its components.

Upgrade Guide Explains how to upgrade to the latest version o GlassFish Server. This guidealso describes dierences between adjacent product releases and

conguration options that can result in incompatibility with the product

specications.

Deployment PlanningGuide Explains how to build a production deployment o GlassFish Server that

meets the requirements o your system and enterprise.

AdministrationGuide Explains how to congure, monitor, and manage GlassFish Server

subsystems and components rom the command line by using the

asadmin(1M) utility. Instructions or perorming these tasks rom theAdministration Console are provided in the Administration Console online

help.

SecurityGuide Provides instructions or conguring and administering GlassFish Server

security.

ApplicationDeploymentGuide Explains how to assemble and deploy applications to the GlassFish Server

and provides inormation about deployment descriptors.

ApplicationDevelopmentGuide Explains how to create and implement Java Platorm, Enterprise Edition(Java EE platorm) applications that are intended to run on the GlassFish

Server. These applications ollow the open Java standards model or Java EE

components and application programmer interaces (APIs). This guide

provides inormation about developer tools, security, and debugging.

Add-OnComponent DevelopmentGuide

Explains how to use published interaces o GlassFish Server to develop

add-on components or GlassFish Server. This document explains how to

perorm only those tasks that ensure that the add-on component is suitable

or GlassFish Server.

EmbeddedServer Guide Explains how to run applications in embedded GlassFish Server and to

develop applications in which GlassFish Server is embedded.

HighAvailability AdministrationGuide

Explains how to congure GlassFish Server to provide higher availability and

scalability through ailover and load balancing.

PerormanceTuning Guide Explains how to optimize the perormance o GlassFish Server.

Preface


http://www.oracle.com/pls/topic/lookup?ctx=821-2434&id=sjsaseern

http://www.oracle.com/pls/topic/lookup?ctx=821-2432&id=sjsaseeqsg

http://www.oracle.com/pls/topic/lookup?ctx=821-2427&id=sjsaseeig

http://www.oracle.com/pls/topic/lookup?ctx=821-2437&id=sjsaseeumg

http://www.oracle.com/pls/topic/lookup?ctx=821-2419&id=sjsaseedpg

http://www.oracle.com/pls/topic/lookup?ctx=821-2416&id=sjsaseeag

http://www.oracle.com/pls/topic/lookup?ctx=821-2433&id=asadmin-1m


http://www.oracle.com/pls/topic/lookup?ctx=821-2435&id=gfsecurity

http://www.oracle.com/pls/topic/lookup?ctx=821-2417&id=sjsaseeadg

http://www.oracle.com/pls/topic/lookup?ctx=821-2418&id=sjsaseedg

http://www.oracle.com/pls/topic/lookup?ctx=821-2415&id=sgfesaddondev


http://www.oracle.com/pls/topic/lookup?ctx=821-2424&id=gfembedded

http://www.oracle.com/pls/topic/lookup?ctx=821-2426&id=sjsaseehaag


http://www.oracle.com/pls/topic/lookup?ctx=821-2431&id=sjsaseeptg

http://www.oracle.com/pls/topic/lookup?ctx=821-2431&id=sjsaseeptg



http://www.oracle.com/pls/topic/lookup?ctx=821-2424&id=gfembedded



http://www.oracle.com/pls/topic/lookup?ctx=821-2418&id=sjsaseedg

http://www.oracle.com/pls/topic/lookup?ctx=821-2417&id=sjsaseeadg

http://www.oracle.com/pls/topic/lookup?ctx=821-2435&id=gfsecurity


http://www.oracle.com/pls/topic/lookup?ctx=821-2416&id=sjsaseeag

http://www.oracle.com/pls/topic/lookup?ctx=821-2419&id=sjsaseedpg


http://www.oracle.com/pls/topic/lookup?ctx=821-2427&id=sjsaseeig


http://www.oracle.com/pls/topic/lookup?ctx=821-2434&id=sjsaseern

8/6/2019 821-2427


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

Book Title Description

Troubleshooting Guide Describes common problems that you might encounter when usingGlassFish Server and explains how to solve them.

ErrorMessageReerence Describes error messages that you might encounter when using GlassFish

Server.

ReerenceManual Provides reerence inormation in man page ormat or GlassFish Server

administration commands, utility commands, and related concepts.

MessageQueue ReleaseNotes Describes new eatures, compatibility issues, and existing bugs or GlassFish

Server Message Queue.

MessageQueue Technical Overview

Provides an introduction to the technology, concepts, architecture,

capabilities, and eatures o the Message Queue messaging service.

MessageQueueAdministration

Guide

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

MessageQueueDeveloper’sGuide or JMXClients

Describes the application programming interace in Message Queue or

programmatically conguring and monitoring Message Queue resources in

conormance with the Java Management Extensions (JMX).

MessageQueueDeveloper’s

Guide or JavaClientsProvides inormation about concepts and procedures or developing Java

messaging applications (Java clients) that work with GlassFish Server.

MessageQueueDeveloper’sGuide orC Clients

Provides programming and reerence inormation or developers working

with Message Queue whowant to use the C language binding to the Message

Queue messaging service to send, receive, and processMessage Queue

messages.

Related Documentation

The ollowing tutorials explain how to develop Java EE applications:

■ Your First Cup: AnIntroduction to the JavaEEPlatorm (http://download.oracle.com/

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

explains the entire process or developing a simple enterprise application. The sampleapplication is a web application that consists o a component that is based on the Enterprise

JavaBeans specication, a JAX-RS web service, and a JavaServer Faces component or the

web ront end.

■ The Java EE6 Tutorial (http://download.oracle.com/javaee/6/tutorial/doc/). This

comprehensive tutorial explains how to use Java EE 6 platorm technologies and APIs to

develop Java EE applications.

Preface

7

http://www.oracle.com/pls/topic/lookup?ctx=821-2436&id=sjsaseetsg

http://www.oracle.com/pls/topic/lookup?ctx=821-2425&id=sjsaseeerr

http://www.oracle.com/pls/topic/lookup?ctx=821-2433&id=sjsaseerefman

http://www.oracle.com/pls/topic/lookup?ctx=821-2442&id=mqrn

http://www.oracle.com/pls/topic/lookup?ctx=821-2443&id=mqto


http://www.oracle.com/pls/topic/lookup?ctx=821-2438&id=mqag


http://www.oracle.com/pls/topic/lookup?ctx=821-2441&id=mqjmx


http://www.oracle.com/pls/topic/lookup?ctx=821-2440&id=mqdgj


http://www.oracle.com/pls/topic/lookup?ctx=821-2439&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=821-2442&id=mqrn

http://www.oracle.com/pls/topic/lookup?ctx=821-2433&id=sjsaseerefman

http://www.oracle.com/pls/topic/lookup?ctx=821-2425&id=sjsaseeerr

http://www.oracle.com/pls/topic/lookup?ctx=821-2436&id=sjsaseetsg

8/6/2019 821-2427


Javadoc tool reerence documentation or packages that are provided with GlassFish Server isavailable as ollows.

■

The API specication or version 6 o Java EE is located at http://download.oracle.com/javaee/6/api/.

■ The API specication or GlassFish Server 3.1, including Java EE 6 platorm packages andnonplatorm packages that are specic to the GlassFish Server product, is located athttp://glassfish.java.net/nonav/docs/v3/api/ .

Additionally, the Java EE Specications (http://www.oracle.com/technetwork/java/

javaee/tech/index.html) might be useul.

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

For inormation 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. The Java EE Samples are bundled with the Java EE SotwareDevelopment 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

Typeace Meaning Example

AaBbCc123 The names o commands, les, and

directories, and onscreen computer

output

Edit your .login le.

Use ls -a to list all les.

machine_name% you have mail.

AaBbCc123 What you type, contrasted with onscreencomputer output

machine_name% su

Password:

AaBbCc123 A placeholderto be replaced with a real

name or value

The command to remove a le is rm flename.

AaBbCc123 Book titles, new terms, and terms to be

emphasized (note that some emphasized

items appear bold online)

Read Chapter 6 in theUser’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/



8/6/2019 821-2427


Symbol Conventions

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

TABLEP–3 SymbolConventions

Symbol Description Example Meaning

[ ] Contains optional arguments

and 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 you use

either the y argument or the nargument.

${ } Indicates a variable

reerence.

${com.sun.javaRoot} Reerences the value o the

com.sun.javaRoot variable.

- Joins simultaneous multiple

keystrokes.

Control-A Press t he C ontrol k ey w hile y ou press

the A key.

+ Joins consecutive multiple

keystrokes.

Ctrl+A+N Press t he C ontrol k ey, r elease i t, a nd

then press the subsequent keys.

→ Indicates menu item

selection in a graphical user

interace.

File→New→Templates FromtheFile menu, chooseNew.

From the New submenu, choose

Templates.

Deault Paths and File NamesThe ollowing table describes the deault paths and le names that are used in this book.

TABLE P–4 Deault Pathsand File Names

Placeholder Description Deault Value

as-install Represents the base installation directory or

GlassFish Server.

In conguration les,as-install is represented

as ollows:

${com.sun.aas.installRoot}

Installations on the Oracle Solaris operating system, Linux

operating system, and Mac OS operating system:

user’s-home-directory/glassfish3/glassfish

Windows, all installations:

SystemDrive:\glassfish3\glassfish

Preface

9

8/6/2019 821-2427


TABLE P–4 Deault Pathsand File Names (Continued)

Placeholder Description Deault Value

as-install-parent Represents the parent o the base installationdirectory or GlassFish Server. Installations on the Oracle Solaris operating system, Linuxoperating system, and Mac operating system:

user’s-home-directory/glassfish3

Windows, all installations:

SystemDrive:\glassfish3

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

created by deault.

as-install /domains/

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

conguration is stored.

In conguration les,domain-dir is

represented as ollows:

${com.sun.aas.instanceRoot}

domain-root-dir /domain-name

Documentation, Support, and TrainingThe Oracle web site provides inormation about 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

For example, 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/













8/6/2019 821-2427


Third-Party Web Site ReerencesThird-party URLs are reerenced in this document and provide additional, related inormation.

Note – Oracle is not responsible or the availability o third-party web sites mentioned in thisdocument. Oracle does not endorse and is not responsible or liable or any content, advertising,products, or other materials that are available on or through such sites or resources. Oracle willnot be responsible or liable or any actual or alleged damage or loss caused or alleged to becaused by or in connection with use o or reliance on any such content, goods, or services thatare available on or through such sites or resources.

Preface

11

8/6/2019 821-2427


12

8/6/2019 821-2427


Installing GlassFish Server 3.1

This chapter provides instructions or installing Oracle GlassFish Server 3.1 sotware on Solaris,Linux, Mac OS X, and Windows systems.


■

“Installation Requirements” on page 13■ “Installation Files or GlassFish Server 3.1” on page 21■ “Installing GlassFish Server From a ZIP File” on page 27■ “Installing GlassFish Server From a Sel-Extracting Bundle” on page 28■ “Perorming a Silent Mode Installation” on page 38■ “Installation Command-Line Options” on page 45

Installation RequirementsBeore installing Oracle GlassFish Server 3.1, ensure that your system meets the requirementslisted in “Hardware and Sotware Requirements” inOracleGlassFishServer 3.1Release Notes. I necessary, download and install the required JDK sotware. Problems are likely to arise i youattempt to install on a platorm that is not supported or on a system that in some other way doesnot meet release requirements. Also see “Known Issues” inOracleGlassFishServer3.1ReleaseNotes or known issues related to installation.

■

On Solaris, Linux, and Windows systems, JDK sotware is available rom the Java SEdownloads page.

■ For Mac OS X systems, GlassFish Server uses the JDK that is part o the Macintosh operatingsystem. I necessary, obtain the required JDK version rom the Mac OS X Updates site.

Javassist Library License Notice

You 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=821-2434&id=abpaj


http://www.oracle.com/pls/topic/lookup?ctx=821-2434&id=ggrvi



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/






8/6/2019 821-2427


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 the Javassist (Java Programming

Assistant) program; it is licensed under the ollowing license, separately rom the Oracleprograms you receive. I you do not wish to install this program, you may choose to not proceedwith the installation o Oracle GlassFish Server.

GNU LESSER GENERAL PUBLIC LICENSE Version 2.1, February 1999

Copyright (C) 1991, 1999 Free Sotware Foundation, Inc. 51 Franklin Street, Fith 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, version 2, hence the version number 2.1.] Preamble The licenses or mostsotware are designed to take away your reedom to share and change it. By contrast, theGNU General Public Licenses are intended to guarantee your reedom to share andchange ree sotware--to make sure the sotware is ree or all its users.

This license, the Lesser General Public License, applies to some specially designatedsotware packages--typically libraries--o the Free Sotware Foundation and other

authors who decide to use it. You can use it too, but we suggest you rst think careully about whether this license or the ordinary General Public License is the better strategy touse in any particular case, based on the explanations below. When we speak o reesotware, we are reerring to reedom o use, not price. Our General Public Licenses aredesigned to make sure that you have the reedom to distribute copies o ree sotware (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 sotware and use pieces o it in new ree programs; and that you

are inormed 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 copies o the library or i you modiy it.

For example, i you distribute copies o 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

provide complete object les to the recipients, so that they can relink them with thelibrary ater making changes to the library and recompiling it. And you must show them

these terms so they know their rights. We protect your rights with a two-step method: (1)we copyright the library, and (2) we oer you this license, which gives you legalpermission to copy, distribute and/or modiy 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 modied by someone else and passed on, the recipientsshould know that what they have is not the original version, so that the original author'sreputation will not be aected by problems that might be introduced by others.

Installation Requirements




8/6/2019 821-2427


Finally, sotware patents pose a constant threat to the existence o any ree program. Wewish to make sure that a company cannot eectively restrict the users o a ree program by obtaining a restrictive license rom a patent holder. Thereore, we insist that any patent

license obtained or a version o the library must be consistent with the ull reedom o usespecied in this license. Most GNU sotware, 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 dierent 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 the originallibrary. The ordinary General Public License thereore permits such linking only i theentire combination ts its criteria o reedom. The Lesser 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 the ordinary General Public License. It also provides other reesotware developers Less o an advantage over competing 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 the same job as widely used non-ree libraries. In this case, there is little togain by limiting the ree library to ree sotware only, so we use the Lesser General PublicLicense.

In other cases, permission to use a particular library in non-ree programs enables agreater number o people to use a large body o ree sotware. For example, permission touse the GNU C Library in non-ree programs enables many more people to use the wholeGNU operating system, as well as its variant, the GNU/Linux operating system.

Although the Lesser General Public License is Less protective o the users' 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 modied version o the Library.

The precise terms and conditions or copying, distribution and modication ollow. Pay close attention to the dierence 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 sotware library or other program whichcontains a notice placed by the copyright holder or other authorized party saying it may


Chapter 1 • Installing GlassFish Server 3.1 15

8/6/2019 821-2427


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 sotwareunctions and/or data prepared so as to be conveniently linked with application programs

(which use some o those unctions and data) to orm executables. The "Library ", below,reers to any such sotware 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 modications and/or translated straightorwardly into anotherlanguage. (Hereinater, translation is included without limitation in the term"modication".) "Source code" or a work means the preerred orm o the work ormaking modications to it. For a library, complete source code means all the source code

or all modules it contains, plus any associated interace denition les, plus the scriptsused to control compilation and installation o the library. Activities other than copying,distribution and modication are not covered by this License; they are outside its scope.The act o running a program using the Library is not restricted, and output rom such aprogram is covered only i its contents constitute a work based on the Library (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 copies o the Library's complete source code asyou receive it, in any medium, provided that you conspicuously and appropriately publish on each copy an appropriate copyright notice and disclaimer o warranty; keepintact all the notices that reer to this License and to the absence o any warranty; anddistribute a copy o this License along with the Library. You may charge a ee or thephysical act o transerring a copy, and you may at your option oer warranty protectionin exchange or a ee.

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

work based on the Library, and copy and distribute such modications or work under theterms o Section 1 above, provided that you also meet all o these conditions:

a) The modied work must itsel be a sotware library. b) You must cause the lesmodied to carry prominent notices stating that you changed 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 modied Library reers to aunction or a table o data to be supplied by an application program that uses the acility,other than as an argument passed when the acility is invoked, then you must make agood aith eort to ensure that, in the event an application does not supply such unctionor table, the acility still operates, and perorms whatever part o its purpose remainsmeaningul. (For example, a unction in a library to compute square roots has a purposethat is entirely well-dened independent o the application. Thereore, Subsection 2drequires that any application-supplied unction or table used by this unction must beoptional: i the application does not supply it, the square root unction must still computesquare roots.) These requirements apply to the modied work as a whole. I identiablesections o 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



8/6/2019 821-2427


apply to those sections when you distribute them as separate works. But when youdistribute the same sections as part o a whole which is a work based on the Library, thedistribution o the whole must be on the terms o this License, whose permissions or

other licensees extend to the entire whole, and thus to each and every part regardless o who wrote it. Thus, it is not the intent o this section to claim rights or contest your rightsto work written entirely by you; rather, the intent is to exercise the right to control thedistribution o derivative or collective works based on the Library. In addition, mereaggregation o another work not based on the Library with the Library (or with a work based on the Library) on a volume o a storage or distribution medium does not bring theother work 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 thatreer to this License, so that they reer 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 speciy 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 the ordinary GNU General Public Licenseapplies to all subsequent copies and derivative works made rom that copy. This option isuseul 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 the Library (or a portion or derivative o it, under Section2) in object code or executable orm under the terms o Sections 1 and 2 above providedthat you accompany it with the complete corresponding machine- readable source code,which must be distributed under the terms o Sections 1 and 2 above on a mediumcustomarily used or sotware interchange. I distribution o object code is made by oering access to copy rom a designated place, then oering equivalent access to copy

the source code rom the same place satises the requirement to distribute the sourcecode, even though third parties are not compelled to copy the source along with the objectcode.

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 the Library, and thereorealls outside the scope o this License. However, linking a "work that uses the Library "with the Library creates an executable that is a derivative o the Library (because itcontains portions o the Library), rather than a "work that uses the library ".Theexecutable is thereore covered by this License. Section 6 states terms or distribution o such executables. When a "work that uses the Library " 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 the source code is not. Whether this is true is especially signicant i the work can be linked without the Library, or i the work is itsel a library. The thresholdor this to be true is not precisely dened by law. I such an object le uses only numericalparameters, data structure layouts and accessors, and small macros and small inlineunctions (ten lines or less in length), then the use o the object le is unrestricted,



8/6/2019 821-2427


regardless o whether it is legally a derivative work. (Executables containing this objectcode plus portions o the Library will still all under Section 6.) Otherwise, i the work is aderivative o the Library, you may distribute the object code or the work under the terms

o Section 6. Any executables containing that work also all under Section 6, whether ornot they are linked directly with the Library itsel.

6. As an exception to the Sections above, 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 permitmodication o the work or the customer's own use and reverse engineering ordebugging such modications. You must 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 execution displayscopyright notices, you must include the copyright notice or the Library among them, aswell as a reerence directing the user to the copy o this License. Also, you must do one o these things:

a) Accompany the work with the complete corresponding machine-readable source codeor the Library including whatever changes were used in the work (which must bedistributed under Sections 1 and 2 above); and, i the work is an executable linked with

the Library, with the complete machine-readable "work that uses the Library ", as objectcode and/or source code, so that the user can modiy the Library and then relink toproduce a modied executable containing the modied Library. (It is understood that theuser who changes the contents o denitions les in the Library will not necessarily beable to recompile the application to use the modied denitions.) b) Use a suitable sharedlibrary mechanism or linking with the Library. A suitable mechanism 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 a

modied version o the library, i the user installs one, as long as the modied version isinterace-compatible with the version that the work was made with. c) Accompany thework with a written oer, valid or at least three years, to give the same user the materialsspecied in Subsection 6a, above, or a charge no more than the cost o perorming thisdistribution. d) I distribution o the work is made by oering access to copy rom adesignated place, oer equivalent access to copy the above specied materials rom thesame place. e) Veriy 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, the materials to be distributedneed not include anything that is normally distributed (in either source or binary orm)with the major components (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 that do not normally accompany the operating system. Such a contradictionmeans you cannot use both them and the Library together in an executable that youdistribute.



8/6/2019 821-2427


7. You may place library acilities that are a work based on the Library side-by- side in asingle library together with other library acilities not covered by this License, anddistribute such a combined library, provided that the separate distribution o the work

based on the Library and o the other library acilities is otherwise permitted, andprovided that you do these two things:

a) Accompany the combined library with a copy o the same work based on the Library,uncombined with any other library acilities. This must be distributed under the terms o the Sections above. b) Give prominent notice with the combined library o the act thatpart o it is a work based on the Library, and explaining where to nd the accompanyinguncombined orm o the same work. 8. You may not copy, modiy, sublicense, link with,

or distribute the Library except as expressly provided under this License. Any attemptotherwise to copy, modiy, sublicense, link with, or distribute the Library is void, and willautomatically terminate your rights under this License. However, parties who havereceived copies, or rights, rom you under this License will not have their licensesterminated so long as such parties remain in ull compliance.

9. You are not required to accept this License, since you have not signed it. However,nothing else grants you permission to modiy or distribute the Library or its derivativeworks. These actions are prohibited by law i you do not accept this License. Thereore, by

modiying or distributing the Library (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 modiying the Library or works based on it.

10. Each time you redistribute the Library (or any work based on the Library), therecipient automatically receives a license rom the original licensor to copy, distribute,link with or modiy the Library subject to these terms and conditions. You may notimpose any urther restrictions on the recipients' exercise o the rights granted herein.

You are not responsible or enorcing compliance by third parties with this License.11. I, as a consequence o a court judgment or allegation o patent inringement or orany other reason (not limited to patent issues), conditions are imposed on you (whetherby court order, agreement or otherwise) that contradict the conditions o this License,they do not excuse you rom the conditions o this License. I you cannot distribute so asto satisy simultaneously your obligations under this License and any other pertinentobligations, then as a consequence you may not distribute the Library at all. For example,i a patent license would not permit royalty-ree redistribution o the Library by all thosewho receive copies directly or indirectly through you, then the only way you could satisy both it and this License would be to rerain entirely rom distribution o the Library. I any portion o this section is held invalid or unenorceable under any particularcircumstance, the balance o the section is intended to apply, and the section as a whole isintended to apply in other circumstances. It is not the purpose o this section to induceyou to inringe any patents or other property right claims or to contest validity o any such claims; this section has the sole purpose o protecting the integrity o the reesotware distribution system which is implemented by public license practices. Many people have made generous contributions to the wide range o sotware distributed



8/6/2019 821-2427


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 sotware through any othersystem and a licensee cannot impose that choice. This section is intended to make

thoroughly 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 either by patents or by copyrighted interaces, the original copyright holder who places the Library under this License may add an explicit geographical distribution limitation excludingthose countries, so that distribution is permitted only in or among countries not thusexcluded. In such case, this License incorporates the limitation as i written in the body o this License.

13. The Free Sotware 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, but may dier in detail to address new problems or concerns. Each version is given a distinguishing version number. I the Library species a versionnumber o this License which applies to it and "any later version", you have the option o ollowing the terms and conditions either o that version or o any later version publishedby the Free Sotware Foundation. I the Library does not speciy a license version number,you may choose any version ever published by the Free Sotware Foundation.

14. I you wish to incorporate parts o the Library into other ree programs whosedistribution conditions are incompatible with these, write to the author to ask orpermission. For sotware which is copyrighted by the Free Sotware Foundation, write tothe Free Sotware Foundation; we sometimes make exceptions or this. Our decision willbe guided by the two goals o preserving the ree status o all derivatives o our reesotware and o promoting the sharing and reuse o sotware generally.

NO WARRANTY

15. BECAUSE THE LIBRARY 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/OR OTHER PARTIES PROVIDE THE LIBRARY "AS IS" WITHOUTWARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUTNOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY ANDFITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY

AND PERFORMANCE OF THE LIBRARY 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 AGREED TO INWRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAYMODIFY AND/OR REDISTRIBUTE THE LIBRARY AS PERMITTED ABOVE, BELIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL,INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE ORINABILITY TO USE THE LIBRARY (INCLUDING BUT NOT LIMITED TO LOSS OF



I t ll ti Fil f Gl Fi h S 3 1

8/6/2019 821-2427


DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY

YOU OR THIRD PARTIES OR A FAILURE OF THE LIBRARY TO OPERATE WITH

ANY OTHER SOFTWARE), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN

ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. END OF TERMS ANDCONDITIONS How to Apply These Terms to Your New Libraries I you develop a new

library, and you want it to be o the greatest possible use to the public, we recommend

making it ree sotware that everyone can redistribute and change. You can do so by

permitting redistribution under these terms (or, alternatively, under the terms o the

ordinary General Public License). To apply these terms, attach the ollowing notices to

the library. It is saest to attach them to the start o each source le to most eectively

convey the exclusion o warranty; and each le should have at least the "copyright" line

and a pointer to where the ull notice is ound. one line to give the library's name and an

idea o what it does. Copyright (C) year name o author This library is ree sotware; you

can redistribute it and/or modiy it under the terms o the GNU Lesser General Public

License as published by the Free Sotware Foundation; either version 2.1 o the License, or

(at your option) any later version. This library is distributed in the hope that it will be

useul, but WITHOUT ANY WARRANTY; without even the implied warranty o

MERCHANTABILITY or 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 along with this library; i not, write to the Free

Sotware Foundation, Inc., 51 Franklin Street, Fith Floor, Boston, MA 02110-1301 USA

Also add inormation on how to contact you by electronic and paper mail. You should

also get your employer (i you work as a programmer) or your school, i any, to sign a

"copyright disclaimer" or the library, i necessary. Here is a sample; alter the names:

Yoyodyne, Inc., hereby disclaims all copyright interest in the library ‘Frob' (a library or

tweaking knobs) written by James Random 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.1


■ “GlassFish Server Download Locations” on page 22■ “GlassFish Server Installation Methods” 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■ “HTTP Load Balancer Plug-in or Oracle GlassFish Server” on page 26

Installation Files for GlassFish Server3.1


Installation Files for GlassFish Server3 1

8/6/2019 821-2427


GlassFish Server Download Locations

Installation les or Oracle GlassFish Server 3.1 are available rom the GlassFish Server

Downloads (http://www.oracle.com/technetwork/middleware/glassfish/downloads/

index.html) page.

GlassFish Server Installation Methods

Table 1–1 lists the various Oracle GlassFish Server installation methods. The table also provides

links to installation instructions or each method.

Note – Beore perorming any GlassFish Server installation, set the JAVA_HOME environment

variable to point to the correct Java version. Also be sure to add the JAVA_HOME/bin directory to

the PATH variable or your environment.

TABLE 1–1 GlassFishServer 3.1 Installation Methods

Installation Method Installation Instructions

Multi-platorm ZIP le “Installing GlassFish Server From a ZIP File” on page 27.

Solaris, Linux, Mac OS, UNIX, or

Windows sel-extracting bundle in

graphical mode

“Installing GlassFish Server From a Sel-Extracting Bundle” on

page 28.

Solaris, Linux, Mac OS, UNIX, or

Windows sel-extracting bundle in silentmode

“Perorming a Silent Mode Installation” on page 38

Each o the installation methods listed in Table 1–1 also let you choose between installing the

Full Platormor theWebProfle. These two distributions are explained in the next section.

Choosing an Installation Method

There are two general sets o questions you should consider when deciding which GlassFish

Server 3.1 installation method to use.

■ “ZIP Package or Sel-Extracting Bundle?” on page 23■ “Full Platorm or Web Prole Distribution?” on page 23



Installation Files for GlassFish Server3 1

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








8/6/2019 821-2427


ZIP Package or Sel-Extracting Bundle?

The relative eatures and strengths o the GlassFish Server ZIP packages and sel-extractingbundles are listed below.

■ ZIPPackage

■ Is simpler to install, but provides no conguration options during the installation

■ Any additional congurations must be perormed manually, ater installation

■ Includes Update Tool and pkg utility installer stubs, which can be used to install thoseutilities ater GlassFish Server installation

■ I uninstallation is desired, product must be uninstalled manually

■ Product downloads are roughly 25%-30% larger than the analogous sel-extractingbundles

■ Sel-ExtractingBundle

■ Provides a GUI-based installation wizard with many conguration options

■ The installation wizard can be used again ater the initial installation to perormadditional conguration tasks

■

Can be used to perorm Silent Mode installation, which is useul or perormingconsistent script-based installations on 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 Platorm or Web Profle Distribution?

Each o the installation methods listed in Table 1–1 also let you choose to install either theGlassFish Server Full PlatormorWebProfle distribution. Table 1–2 lists the eatures availablein each o these two distributions. Note that some o these eatures are value-adds, and are notrequired by the Java 6 EE specication.

TABLE 1–2 GlassFishServer Full Prole and WebProle Features

Feature Full Platorm Web Profle

Java Platorm, 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, JSP2.2, JSF 2.0, JSTL 1.2, EL

2.2)

X X

Grizzly/Comet X X




8/6/2019 821-2427


TABLE 1–2 GlassFishServer Full Prole and WebProle Features (Continued)


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 application

redeploy)

X X

OMG CORBA APIs 3.0 X X

Debugging 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 Dependency Injection or Java 1.0 (CDI, ex-Web

Beans)

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 Platorm 2.1 X -

JMS 1.1 X -

JavaMail 1.4 X -

JACC 1.4 X -

Java Authentication Service Provider Interace or Containers

1.1

X -

Java EE Application Deployment 1.2 X -

J2EE Management 1.1 X -



8/6/2019 821-2427


TABLE 1–2 GlassFishServer Full Prole and WebProle Features (Continued)


JAX-RPC 1.1 X -

JAXR 1.0 X -

CORBA 3.0.0 X *

Metro X -

* The Full Java EE Platorm contains the complete CORBA package. The OMG CORBA v3.0

APIs are available in the Java EE Web Prole.

** Transaction propagation not supported.

Note – Regardless o whether you choose the Full Platorm or Web Prole distribution, you can

add or removed packages ater installation by using the Update Tool or pkg utility. See Chapter

11, “Extending and Updating GlassFish Server,” inOracle GlassFishServer 3.1Administration

Guide or more inormation.

GlassFish Server ZIP Files

The Oracle GlassFish Server 3.1 multi-platorm 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 – In all cases, the *-ml.zip bundles in the table are multilingual versions o the product.

TABLE 1–3 GlassFishServer Downloadable ZIP Files

ZIP File Description

ogs-3.1.zip

ogs-3.1–ml.zip

Full Platorm distribution o Oracle GlassFish Server

ogs-3.1-web.zip

ogs-3.1–web-ml.zip

Web Prole distribution o Oracle GlassFish Server



http://www.oracle.com/pls/topic/lookup?ctx=821-2416&id=ghapp







8/6/2019 821-2427


GlassFish Server Sel-Extracting Bundles

The Oracle GlassFish Server 3.1 sel-extracting bundles are platorm-specic, and are available

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

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

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

TABLE 1–4 GlassFishServer Sel-extractingBundles

Sel—Extracting Bundle Description

ogs-3.1-unix.sh

ogs-3.1-windows.exe

ogs-3.1-unix-ml.sh

ogs-3.1-windows-ml.exe

Full Platorm 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.sh

ogs-3.1-web-windows-ml.exe

Web Prole distribution o Oracle GlassFish Server or Solaris, Linux,

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

HTTP Load Balancer Plug-in or Oracle GlassFishServer

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

The Plug-in is shipped as a ZIP bundle that you install ater installing and conguring GlassFishServer and your desired Web server. The Plug-in is installed by means o a graphical LoadBalancer Congurator that helps you congure your Web server and GlassFish Server to work together.

Note – The Load Balancer Plug-in is only available to customers who are using Oracle GlassFishServer 3.1. The Plug-in is not available or GlassFish Server Open Source Edition.

See Chapter 7, “Conguring Web Servers or HTTP Load Balancing,” inOracle GlassFishServer 3.1HighAvailability AdministrationGuide or instructions on installing the HTTP LoadBalancer Plug-in and perorming the conguration steps required to make the Plug-in work

with your Web server.


InstallingGlassFish Server Froma ZIPFile

http://www.oracle.com/pls/topic/lookup?ctx=821-2426&id=gchvt





8/6/2019 821-2427


Installing GlassFish Server From a ZIP File

This section describes how to install Oracle GlassFish Server 3.1 using the multi-platorm ZIP

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

Note – It is not possible to speciy any GlassFish Server conguration options during a ZIP leinstallation. Any conguration changes, such as creating domains, clusters, and serverinstances, must be made manually ater installation. I you preer to make such changes duringthe GlassFish Server installation process, or i you preer 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 File

Ensure that your system meets the requirements listed in “Hardware and SotwareRequirements” inOracleGlassFish Server 3.1Release Notes.

Also see “Known Issues” inOracleGlassFishServer 3.1Release Notes or known issues related toinstallation.

Download the desired GlassFish Server 3.1 ZIP fle.

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 the directory where you downloaded the ZIP fle.

Unzip the fle.

■ Solaris, Linux, andMacOSX systems:

unzip zip-fle-name

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

For example:

unzip ogs-3.1.zip

■ Windowssystems:

Unzip using your avorite le compression utility.

GlassFish Server 3.1 is extracted into a new glassfish3 directory under your current directory.This glassfish3 directory is reerred to throughout the GlassFish Server documentation set as

as-install-parent .

BeoreYouBegin

1

2

3


Installing GlassFish ServerFrom a Self-Extracting Bundle










8/6/2019 821-2427


(Optional) Start GlassFish Server using the instructions in theOracleGlassFishServer3.1Quick

StartGuide.

The guide explains how to perorm basic tasks such as starting the server, accessing the

Administration Console, and deploying a sample application.

Installing GlassFish Server From a Sel-Extracting Bundle

This section describes how to install Oracle GlassFish Server 3.1 sotware using one o the

sel-extracting installation bundles. Running any o the sel-extracting bundles automatically

launches the GUI-based GlassFish Server installation wizard.


■ “To Install GlassFish Server Using the Sel-Extracting File” on page 28■ “To Perorm a Custom Installation” on page 31■ “Custom Conguration Parameters” on page 35

Note – Console installation is not supported in Oracle GlassFish Server 3.1. Silent mode

installation is available, however. For more inormation, see “Perorming a Silent Mode

Installation” on page 38.

▼ To Install GlassFish Server Using the Sel-ExtractingFile■ When launching the sel-extracting installer rom the command-line, it possible to speciy

several command-line options that may be useul to you. See “Installation Command-Line

Options” on page 45 or more inormation.

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

Requirements” inOracleGlassFishServer3.1Release Notes.

■ See “Known Issues” inOracleGlassFishServer3.1Release Notes or known issues related toinstallation.

Download the desired GlassFish Server 3.1 bundle.

See “GlassFish Server Download Locations” on page 22 or a list o download locations. See

Table 1–4 or a list o available sel-extracting bundles.

Change to the directory where you downloaded the sel-extracting fle.

4

BeoreYouBegin

1

2

















8/6/2019 821-2427


Start the installer.

■ Solaris, Linux, and Mac OS X systems:

a. I necessary, grant execute permissions to the sel–extracting fle:

chmod +x ./sel-extracting-fle-name

sel-extracting-fle-nameis the name o the sel-extracting le that you downloaded.

b. Atthe command prompt, type:

sh ./sel-extracting-fle-name

For example, start the installer by typing the ollowing:

sh ./ogs-3.1-unix.sh

See “Installation Command-Line Options” on page 45 or a list o command-line

options you can speciy here, i desired.

■ Windows systems:

a. Double-click the executable .exe installation fle.

For example, double-click:

ogs-3.1–windows.exe

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

prompt.

Note–

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

page 45.

■ I you are installing on a 64–bit Windows system, run the installer with the -j option

pointing to a 64–bit JDK.

■ Depending on your user privileges and the version o Windows you are running, it may be

necessary to run the installer as Administrator. In particular, i you will be conguring thedomain as a Service as part o aCustom Installation (see next step) or ater the installation,

then you should run the installer as Administrator.

Ater starting the installer, the Introduction page is displayed. Use the Next button to move

through the installation process.

3



8/6/2019 821-2427


Choose the Installation Type

■ Typical Installation

Choose this option or application development purposes or non-production use only. Thisoption installs the GlassFish Server binaries and creates a DAS.

■ Custom Installation

Choose the option i you are deploying GlassFish Server in a production environment. This

option provides several installation choices, which are described in detail later in this guide,

in “To Perorm a Custom Installation” on page 31.

The remainder o this procedure describes the steps in the Typical Installation path. I you areperorming a Custom Installation, skip the remainder o this procedure and jump instead to

“To Perorm a Custom Installation” on page 31.

Speciy where to install GlassFish Server.

The deault installation directories are as ollows:

■

Solaris, Linux, and Mac OS X systemsuser-home-directory/glassfish3

■ Windows systems

SystemDrive\glassfish3

Make sure the directory you speciy is empty beore installing the product.

The deault installation directory is reerred to asas-install-parent throughout the GlassFish

Server documentation.

Speciy whether to install and enable Update Tool.

Update Tool is an administrative tool that enables you to install updates and add-on

components to an existing GlassFish Server 3.1 installation. Update Tool can be installed

during GlassFish Server installation or at a later time. For more inormation about Update Tool,

see “Update Tool” inOracle GlassFishServer 3.1AdministrationGuide.

■ I you are not installing Update Tool, deselect the Install Update Tool check box.

■ I you are installing Update Tool and your system accesses the Internet through a proxy,

speciy the proxy host and proxy port.

■ I you are installing Update Tool and do not require the automatic notications o available

updates ater installation, deselect the Enable Update Tool check box.

4

5

6



http://www.oracle.com/pls/topic/lookup?ctx=821-2416&id=ghgai




8/6/2019 821-2427


Note – Update Tool diers rom Upgrade Tool, which is used to migrate the conguration anddeployed applications rom an earlier version o GlassFish Server to the current version. For

more inormation about Upgrade Tool, see theOracleGlassFishServer3.1Upgrade Guide.

Review the ReadyTo Install selections and click Install to proceed with the installation.

A progress bar is displayed as the core GlassFish Server components are installed and thedeault domain is automatically created and started.

The installer creates a deault domain named domain1. The results o this process will be briey visible in the CongResults screen.

Tip– The conguration results panel presents the recently executed command 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 you choose to cancel the installation at this point, no GlassFish Server les will beinstalled, but the directory you specied oras-install-parent will remain. This directory can bedeleted manually.

Review the summarypage and click Exitto exit the installer.

Installation inormation is captured in log les. The names o the les aretimestamp-install.log and timestamp-install-summary.html. On Solaris, Linux, and MacOS X systems, these les are generated by deault in the /tmp directory. On Windows systems,

these les are generated in the%TEMP% directory.

(Optional) Register your GlassFish Server product.

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

Familiarize yoursel with the instructions in theOracleGlassFishServer3.1QuickStartGuide.The guide explains how to perorm basic tasks such as starting the server, accessing the

Administration Console, and deploying a sample application.

▼ To Perorm a Custom InstallationThis procedure builds upon the instructions provided or the Typical Installation path in “ToInstall GlassFish Server Using the Sel-Extracting File” on page 28.

Complete the steps in “To Install GlassFish Server Using the Sel-Extracting File”on page 28.

7

8

9

See Also

1









8/6/2019 821-2427


Choose the kind o Custom Installation you want to perorm.

■ Install and Confgure

Install the GlassFish Server binaries, and then congure a DAS and one or more standaloneserver instances, clusters, or clustered instances.

■ Install Only

Install only the GlassFish Server binaries, without conguring a DAS or any server instances

or clusters. You can rerun the GlassFish Server installation wizard at a later time and choose

the Congure an Existing Installation option to congure the items.

■ Confgure an Existing Installation

Congure a DAS, standalone server instances, clusters, or clustered instances or an existing

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

Server prior to 3.1, see theOracleGlassFishServer 3.1Upgrade Guide.

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

also apply to the other options.



■ Solaris, Linux, and Mac OS X systems

user-home-directory/glassfish3

■ Windows systems



The deault installation directory is reerred to asas-install-parent throughout the GlassFish

Server documentation.

Speciy the path to the JDK to be used with the installation.

Use a JDK installation detected by the installer or speciy the path or a dierent JDK.

JDK 6 is required. See “Installation Requirements” on page 13 or more inormation.

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

in the JAVA_HOME environment variable.

2

3

4






8/6/2019 821-2427


Speciy whether to install Update Tool.

Update Tool is an administrative tool that enables you to install updates and add-on

components to an existing GlassFish Server 3.1 installation. Update Tool can be installed

during GlassFish Server installation or at a later time. For more inormation about Update Tool,see “Update Tool” inOracle GlassFishServer 3.1AdministrationGuide.





updates ater installation, deselect the Enable Update Tool check box.

Note – Update Tool diers rom Upgrade Tool, which is used to migrate the conguration and

deployed applications rom an earlier version o GlassFish Server to the current version. For

more inormation about Upgrade Tool, see theOracleGlassFishServer3.1Upgrade Guide.


A progress bar is displayed as the core GlassFish Server components are installed and thedeault domain is automatically created and started.

Note – I you choose to cancel the installation at this point, no GlassFish Server les will be

installed, but the directory you specied oras-install-parent will remain. This directory can be

deleted manually.

When the core installation has completed, the installer displays the Conguration page.

Confgure GlassFish Server components.

The general procedure or conguring server components involves the ollowing substeps:

a. Choose a component confguration option:

Createa serverdomain

Create a Domain Administration Server (DAS). At least one DAS must be created and

running beore you can congure any other components. The parameters in the

Conguration screen or this option are described in “Parameters or the Create a server

domain Option” on page 35.

Createa standalone serverinstance

Create a standalone GlassFish Server instance. The parameters in the Conguration

screen or this option are described in “Parameters or the Create a standalone server

instance Option” on page 36.

5

6

7










8/6/2019 821-2427


Createa clusteredserverinstance

Create a new cluster or a clustered server instance in a new or existing a cluster. The

parameters in the Conguration screen or this option are described in “Parameters or

the Create a clustered server instance Option” on page 37.

Skip confguration

Skip any additional component conguration and proceed immediately to the nal steps

o the installation and conguration wizard.

When conguring a new or previously uncongured GlassFish Server installation you must

choose the rst option, Create a server domain, beore proceeding with any o the other

options. Once at least one server domain has been created, you can choose any o the other

options in any order you wish, including creating additional domains.

b. Confgure the selected component.

Each conguration option displays its own conguration screen. The specic options in

each conguration screen are described ater this procedure, in “Custom Conguration

Parameters” on page 35.

c. Choose how you want to proceed.Ater conguring any one o the available options, a Conguration Results screen is

displayed. In addition to displaying the conguration results, three buttons are displayed:

Cancel

Cancel the conguration and exit the installation wizard. Note that the core GlassFish

Server components will already be installed at this point, as well as any congurations

that may have been congured during this step or during another installation. To remove

the core GlassFish Server components and any congurations, ollow the instructions inChapter 2, “Uninstalling GlassFish Server 3.1”

Confgureagain

Return to the Conguration page so you can congure another item.

Next

Complete the conguration option and continue to the nal steps o the installation and

conguration wizard. Note that this label becomes "Exit" i this is a Custom Installation

and the “Congure Existing Installation” option is selected.

Tip – The conguration results panel presents the recently executed command in the

center section. This is selectable text, and it can be copied to a script or uture automated

runs o such commands.

When you have congured all the components you want and then clicked the Next button, the

nal conguration option is perormed and a Summary screen is displayed.



8/6/2019 821-2427


Click Exit to exit the installation and confguration wizard.

A web browser is displayed so you can register your GlassFish Server product.

(Optional) Register your GlassFish Server product.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 theOracleGlassFishServer 3.1Quick StartGuide. The guideexplains how to perorm basic tasks such as starting the server, accessing the AdministrationConsole, and deploying a sample application.

Custom Confguration Parameters

This section lists the conguration parameters in the screens displayed or the options in theCongure GlassFish Server components. step in “To Perorm a Custom Installation” onpage 31.

■ “Parameters or the Create a server domain Option” on page 35

■ “Parameters or the Create a standalone server instance Option” on page 36■ “Parameters or the Create a clustered server instance Option” on page 37

Parameters or the Create a server domain Option

The ollowing are the parameters displayed in the Conguration screen when you choose theCreate a server domain option in Congure GlassFish Server components. step in “To Perorma Custom Installation” on page 31. This option enables you to create a Domain Administration

Server (DAS)DomainName

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

AdminPortThe port on which the GlassFish Server Admin Console will listen. The deault port is 4848.

HTTPPortThe port on which the non-secure HTTP server will listen. The deault port is 8080. Note

that 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 the Admin Console, butmake sure that the Username eld has "admin" as the input value. Speciying a password is

highly recommended i you are installing GlassFish Server in a production environment.

8

9

See Also





8/6/2019 821-2427


ReenterPassword

Reenter the password to veriy your typing.

CreateOperatingSystemService orthedomain

Speciy whether an operating system service will be created or the DAS. The service will bestarted when the operating system is booted.

I a service is not created here, the DAS can be started manually using the asadmin

start-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 you want to create a system service or the domain.

ServiceName

Speciy the name or the DAS operating system service. The deault name is

domain1Service. This parameter is only required i the Create Operating System service

parameter is enabled.

Start domain ater creation

Start the domain as soon as it is created. This option is enabled by deault. Note that is

necessary or the DAS to be running beore you can congure any server instances or

clusters. I you choose to not start the domain at this time, you can start it manually later

using the asadmin start-domain subcommand.

Note – Ensure that this option is enabled i you plan on perorming more congurationsduring this installation procedure. The DAS must be running in order to create any server

instances or clusters.

Parameters or the Create a standalone server instance Option

The ollowing are the parameters displayed in the Conguration screen when you choose the

Create a standalone server instance option in Congure GlassFish Server components. step in

“To Perorm a Custom Installation” on page 31. This option enables you to create a standalone

GlassFish Server instance.

Note – The DAS or the domain in which the standalone server instance will be created must be

running with the specied name and at the specied port beore conguring a standalone server

instance. See the “Parameters or the Create a server domain Option” on page 35 or

instructions.



8/6/2019 821-2427


InstanceNameThe unique name to use or the standalone GlassFish Server instance. I the name is already in use, an error will be generated when the conguration is perormed. The deault name is

instance1.HostName

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

AdministrationPortThe administration port on which the DAS is running. The deault port is 4848.

Parameters or the Create a clustered server instance Option

The ollowing are the parameters displayed in the Conguration screen when you choose theCreate a clustered server instance option in Congure GlassFish Server components. step in“To Perorm 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 – The DAS or the domain in which the standalone server instance will be created must berunning with the specied name and at the specied port beore conguring 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 the clustered GlassFish Server instance. I the name is already inuse, an error will be generated when the conguration is perormed. The deault name isinstance1.

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

AdministrationPortThe administration port on which the DAS is running. The deault port is 4848.

Create ClusterSpeciy whether a new cluster will be created at this time. The deault is to leave this optiondisabled. I let disabled, the cluster specied in the Cluster Name 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 isdisabled i the cluster in which you want to create the clusteredserver existence already exists.

ClusterNameThe unique name to use or the cluster. Ithe name is already in use, an error will be

generated when the conguration is perormed. The deault name is c1.


Performinga Silent ModeInstallation

8/6/2019 821-2427


DomainNameThe name o the DAS in which the cluster will run. The deault name is domain1.

Perorming a Silent Mode InstallationThis section describes how to install Oracle GlassFish Server 3.1 using silent mode installation.Silent mode is a non-interactive installation based on user-dened parameters captured in ananswer le. The answer le can be used later to install GlassFish Server on one or more systems.

Note – It is only possible to perorm a silent installation using theTypical Installationpath

described in “To Install GlassFish Server Using the Sel-Extracting File” on page 28.Itisnotpossible to perorm a silent installation using the more complexCustomInstallationpathdescribed in “To Perorm a Custom Installation” on page 31.


■ “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 created when you use thedry-run (-n) option to start an interactive installation. In dry-run mode, actual installation doesnot take place.

During the interactive installation you can accept the deault values presented or you canchange them. Your input is collected and stored in the answerfle, which is then used to installGlassFish Server. You can use the answer le as it is or you can modiy the le beore using it.

▼ To Create the Installation Answer FileThe installation wizard is used to create the answer le. Actual installation does not take place.

■ Remember that it is only possible to perorm a silent installation using theTypicalInstallationpath described in “To Install GlassFish Server Using the Sel-Extracting File” onpage 28. It is not possible to perorm a silent installation using the more complexCustomInstallationpath described in “To Perorm a Custom Installation” on page 31.

■ When launching the sel-extracting installer rom the command-line, it possible to speciy several command line options that may be useul to you. See “Installation Command-LineOptions” on page 45 or more inormation.

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

Requirements” inOracleGlassFishServer3.1Release Notes.

BeoreYouBegin


S “K I ” i O l Gl Fi hS 3 1R l N k i l d











8/6/2019 821-2427


■ See “Known Issues” inOracleGlassFishServer3.1Release Notes or known issues related to

installation.

Download the desired GlassFish Server 3.1 bundle.See “GlassFish Server Download Locations” on page 22 or a list o download locations. See

Table 1–4 or a list o available sel-extracting bundles.

Change to the directory where you downloaded the sel-extracting fle.

Start the installer in dry-runmode.


a. I necessary, grant execute permissions to the sel–extracting fle:

chmod +x ./sel-extracting-fle-name

sel-extracting-fle-nameis the name o the sel-extracting le that you downloaded.


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 a

path to the answer le, the le is created under the directory rom which the installation

program is run.

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

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

See “Installation Command-Line Options” on page 45 or a list o command-line

options you can speciy here, i desired.

■ Windows systems:

a. Open a Windows Command Prompt shell with Administrative privileges.

b. Atthe command prompt, 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 a

path to the answer le, the le is created under the directory rom which the installation

program 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 Opti ” p 45 li t d li





8/6/2019 821-2427


See Installation Command-Line Options on page 45 or a list o command-lineoptions you can speciy here, i desired.

Note–

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

■ I you are installing on a 64–bit Windows system, run the installer with the -j optionpointing to a 64–bit JDK.

■ Depending on your user privileges and the version o Windows you are running, it may benecessary to run the installer as Administrator. In particular, i you will be conguring thedomain as a Service as part o aCustom Installation (see next step) or ater the installation,then you should run the installer as Administrator.

Ater starting the installer, the Introduction page is displayed. Use the Next button to movethrough the installation process.

ChooseTypical Installation in the Installation Type screen.

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




user-home-directory/glassfish3

■ Windows systems



The deault installation directory is reerred to asas-install-parent throughout the GlassFishServer documentation.

Speciy whether to install and enable Update Tool.Update Tool is an administrative tool that enables you to install updates and add-oncomponents to an existing GlassFish Server 3.1 installation. Update Tool can be installedduring GlassFish Server installation or at a later time. For more inormation about Update Tool,see “Update Tool” inOracle GlassFishServer 3.1AdministrationGuide.




4

5

6








8/6/2019 821-2427


■ I you are installing Update Tool and do not require the automatic notications o availableupdates ater installation, deselect the Enable Update Tool check box.

Note – Update Tool diers rom Upgrade Tool, which is used to migrate the conguration anddeployed applications rom an earlier version o GlassFish Server to the current version. Formore inormation about Upgrade Tool, see theOracleGlassFishServer3.1Upgrade Guide.


A progress bar is displayed as the answer le is created and an empty as-install-parent directory is created.

Tip– The conguration results panel presents the recently executed command 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 the summarypage and click Exitto exit the installer.

Installation inormation is captured in log les. The names o the les aretimestamp-install.log and timestamp-install-summary.html. On Solaris, Linux, and MacOS X systems, these les are generated by deault in the /tmp directory. On Windows systems,these les are generated in the%TEMP% directory.

Proceed to the instructions in “Reviewing the Installation Answer File”on page 41.

Reviewing the Installation Answer File

The answer le generated using the procedure described in “Creating the Installation AnswerFile” on page 38 provides a number o system-specic parameters as well as parameters that youselected during dry-run mode installation. Values or some parameters can be edited asdescribed in “To Edit the Answer File” on page 43.

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

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

EXAMPLE 1–1 Example Answer File

#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)





8/6/2019 821-2427


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 Answer File Template or GlassFishServer 3.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 Answer File Template or GlassFishServer 3.1 (Continued)


8/6/2019 821-2427


p ( )

Domain.Configuration.ADMIN_PASSWORD_REENTER=Domain.Configuration.ADMIN_PORT=4848

Domain.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 Answer FileSome values in the answer le can be changed i desired. Such editing is strictly optional.

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

Review the answer fle.

Review the values that will be used or silent installation.

Edit the answer fle.

Only the ollowing deault values can be changed:

InstallHome.directory.INSTALL_HOME=as-install-parent Provide another directory name or GlassFish Server 3.1 installation les.

Domain.Configuration.ADMIN_PASSWORD=

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

sensitive.

Domain.Configuration.ADMIN_PASSWORD_REENTER=

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

Domain.Configuration.ADMIN_PORT=4848

Assign another port number to the Administration Console.

Domain.Configuration.ADMIN_USER=admin

Provide another user name or the administrator. This name is case sensitive.

Domain.Configuration.HTTP_Port=8080

Assign another port number to HTTP connections.

UpdateTool.Configuration.ALLOW_UPDATE_CHECK=true

Change value to false i you do not want Update Tool notications.

UpdateTool.Configuration.BOOTSTRAP_UPDATE=true

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

BeoreYouBegin

1

2


UpdateTool.Configuration.PROXY_HOST=


8/6/2019 821-2427


Assign a name to the proxy host.

UpdateTool.Configuration.PROXY_PORT=

Assign a port number to the proxy host.

Note – Parameters not listed are system specic. Do not change system-specic parameters.Doing so will cause problems with the installation program.

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

▼ To Install Using Silent Mode

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

Veriy 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 les generated using the GlassFish Server 3.1 installer are not backward-compatiblewith earlier versions o GlassFish Server including version 3.1.

Navigate to the directory that contains the sel-extracting installer fle and the installation

answer fle.

From the command 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 the answer le that was generated according to the instructions in Creating the

Installation Answer File. Ensure that you provide the complete path to the answer le.-s

Runs the installer in silent mode.

For example:

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

When the prompt is returned, the silent installation is complete and the installation

components are installed on your system.

BeoreYouBegin

1

2


Familiarize yoursel with the instructions in theOracleGlassFishServer3.1QuickStartGuide.NextSteps

Installation Command-LineOptions




8/6/2019 821-2427


The guide explains how to perorm 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 you run the installation program rom the commandline using the sel-extracting installation le (.sh or .exe). Speciy the desired options atertyping the installation le name at the command 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 specied. Use this optionwith the -s option.

-l log-directoryWrite log inormation to this directory.

-q

Set logging level to WARNING.

-v

Runs the installation program in verbose mode, which can be useul or troubleshooting.Also sets the logging level to FINEST.

-s

Run the installation program in silent mode.

-j javahomeUse this directory or the JDK sotware installation.

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

installation.

-h or -help

Display the help message listing these options.


8/6/2019 821-2427


46

2C H A P T E R 2

8/6/2019 821-2427


Uninstalling GlassFish Server 3.1

This chapter describes how to uninstall Oracle GlassFish Server 3.1 sotware.

Removing a GlassFish Server Installation

This section describes how to remove Oracle GlassFish Server 3.1 sotware.The ollowing topics are addressed here:

■ “To Uninstall GlassFish Server Sotware Ater a ZIP File Installation” on page 47■ “To Uninstall GlassFish Server Sotware Ater a GUI-Mode Installation” on page 48

▼ To Uninstall GlassFish Server Sotware Ater a ZIP FileInstallation

This procedure describes how to uninstall GlassFish Server sotware that was installed using aZIP le, as described in “Installing GlassFish Server From a ZIP File” on page 27.

Stop all domains and other related processes, including command prompts using theinstallation directory or its subdirectories, the Update Tool notier process i present, and any

applications using Java SE les.

To stop domains, use the asadmin stop-domain command. For more inormation aboutstopping a domain, see “To Stop a Domain” inOracle GlassFishServer 3.1AdministrationGuide.

To stop the Update Tool notier process, use the updatetool --notifier --shutdown

command, executed romas-install-parent /bin.

I orphaned processes remain, identiy and terminate the processes as ollows:

2

BeoreYouBegin

47

■ Solaris, Linux, andMacOSX systems:

Removinga GlassFish ServerInstallation

http://www.oracle.com/pls/topic/lookup?ctx=821-2416&id=ggoch






8/6/2019 821-2427


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

■ Windowssystems:

Use the Task Manager and terminate the processes.

Also see “Known Issues” inOracleGlassFishServer 3.1Release Notes or known issues related touninstallation.

Save anyfles in the installation directory that you may want to keep.

Manually deleteinstallation directory and all its contents.

▼ To Uninstall GlassFish Server Sotware Ater aGUI-Mode InstallationThis procedure describes how to uninstall GlassFish Server sotware 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 section provides instructions or removing the sotware using this script. I youattempt to remove the sotware 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 domains and other 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 Tool Notier process, i present

■ Any applications that are using Java SE les

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

For more inormation about stopping a domain, see “To Stop a Domain” inOracle GlassFish

Server 3.1AdministrationGuide.

b. To stop the Update Tool Notifer process, use the updatetool --notifier --shutdown

command, executed romas-install-parent /bin.

c. I orphaned processes remain, identiy and terminate the processes as ollows:


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

1

2

1


■ Windows systems

U th T k M d t i t th










8/6/2019 821-2427


Use the Task Manager and terminate the processes.

Navigate to the directory in which GlassFish Server 3.1 is installed.Alternatively, i you are running on Windows and want to run the uninstaller rom the

Windows Start menu, you can skip this step and jump ahead to the next step.


■ Solaris, Linux, andMacOSX systems:user's-home-directory/glassfish3

■ Windowssystems:SystemDrive:\glassfish3

The deault installation directory is reerred to asas-install-parent throughout GlassFish Serverdocumentation.

Start the uninstallation program and remove the sotware.


a. I necessary, grant execute permissions to the uninstall fle.

chmod +x ./uninstall.sh


sh ./uninstall.sh

■ Windows systems, rom the Start menu (recommended):

a. Choose Start→Programs→Oracle GlassFish Server→Uninstall.

■ Windows systems, rom the command line:

a. Double-click the uninstall.exe fle.

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

prompt.

2

3

Chapter 2 • Uninstalling GlassFish Server 3.1 49

Tip – There is a known issue on Windows 7 systems (Issue 12093) whereby uninstallation o


8/6/2019 821-2427


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

problem may occur when the Java binaries are 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 speciy the location o the Java binaries whenrunning 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 ater the le name. Forexample: ./uninstall.sh -s or uninstall.exe -s

Review the summarypage that displays ollowing uninstallation and click Exitto exit the

uninstaller.

Uninstallation inormation is captured in log les. The names o the les are timestamp-remove.log and timestamp-remove-summary.html. On Solaris, Linux, and Mac OS Xsystems, these les are generated by deault in the /tmp directory. On Windows systems, theseles are generated in the%TEMP% directory.

Examine the contents o the remaining installation directories and remove anyfles or

directories that you do not want.

Note – Not all GlassFish Server directories are automatically removed by the uninstallationprogram. Remove the remaining contents as desired, including hidden directories prexed witha dot. It is sae to remove uninstallation and installation log les ater you have examined them.

4

5


8/6/2019 821-2427


Index

A

adding components, 30, 33, 40

answer leSeealso silent mode installation

creating, 38

editing, 43

example, 41

reviewing, 41

using to install, 44–45

C

components

adding and updating, 30, 33, 40

removing, 47–50

Congurator, Load Balancer, 26

D

deault installation directories, 30, 32, 40

directories, removing, 50

download locations, 22

E

environment variables, JAVA_HOME, 22

execute permissions, 29, 39

Fles

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

Ggetting started with Enterprise Server, 31, 35, 45GlassFish Server Community downloads, 22graphical installation, 28

Hhardware requirements, 13

Iinstallation

deault 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

platorm options (Continued)

multi-platorm, 27

Index

8/6/2019 821-2427


JDK issues, 13JDK requirements, 13

Kknown issues, 13

LLinux installation

graphical interace and, 28multi-platorm le and, 27silent mode and, 38uninstalling, 47–50

Load Balancer Plug-in, 26load balancing, Load Balancer Plug-in, 26

log les, 31, 41, 50

MMac OS X installation

graphical interace and, 28JDK and, 13, 32

multi-platorm le and, 27silent mode and, 38uninstalling, 47–50

multi-platorm installation, 27

O

Oracle GlassFish Server product page, 22

Pplatorm-independent installation, 27platorm options

Linux, 27

MacOSX, 27

Solaris, 27

Windows, 27

platorms, supported, 13

Plug-in, Load Balancer, 26

processes, stopping, 47, 48–50

Q

Quick Start Guide, 31, 35, 45

R

removing an installation, 47

requirements, 13

S

sel-extracting le installation, 28

setup options, 45

silent mode installation

answer le, 38

overview, 38

running, 44sotware requirements, 13

Solaris installation

graphical interace and, 28

multi-platorm le and, 27

silent mode and, 38

uninstalling, 47–50

starting Enterprise Server, 31, 35, 45

stopping processes, 47, 48–50supported platorms, 13

system requirements, 13

T

trial mode, 38


Uuninstallation log les, 50

Index

8/6/2019 821-2427


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

uninstalling the sotware, 47Update Tool, 30, 33, 40Update Tool notier process, 47, 48–50updating components, 30, 33, 40Upgrade Tool, 30, 33, 40

WWindows installation

graphical interace and, 28multi-platorm le and, 27silent mode and, 38uninstalling, 47–50

wizard installation, 28

ZZIP le installation, 27

53

8/6/2019 821-2427


821-2427

Documents