Sun GlassFish Enterprise Server
v3 PreludeTroubleshooting
Guide
Sun Microsystems, Inc.
4150 Network Circle
Santa Clara, CA 95054
U.S.A.
Part No: 820–6823–10
November 2008
Copyright 2008 SunMicrosystems, Inc.4150 NetworkCircle, Santa Clara, CA 95054 U.S.A. All rights reserved.
Sun Microsystems, Inc. has intellectual property rights relating to technology embodied in the product that is described in this document. In particular, and without
limitation, these intellectual property rights may include one or more U.S. patents or pending patent applications in the U.S. and in other countries.
U.S. Government Rights – Commercial software. Government users are subject to the Sun Microsystems, Inc. standard license agreement and applicable provisions
of the FAR and its supplements.
This distribution may include materials developed by third parties.
Parts of the product may be derived from Berkeley BSD systems, licensed from the University of California. UNIX is a registered trademark in the U.S. and other
countries, exclusively licensed through X/Open Company, Ltd.
Sun, Sun Microsystems, the Sun logo, the Solaris logo, the Java Coee Cup logo, docs.sun.com, Enterprise JavaBeans, EJB, GlassFish, J2EE, J2SE, Java Naming and
Directory Interface, JavaBeans, Javadoc, JDBC, JDK, JavaScript, JavaServer, JavaServer Pages, JMX, JSP,JVM, MySQL, NetBeans, OpenSolaris, SunSolve, Sun
GlassFish, Java, and Solaris are trademarks or registered trademarks of Sun Microsystems, Inc. or its subsidiaries in the U.S. and other countries. All SPARC
trademarks are used under license and are trademarks or registered trademarks of SPARCInternational, Inc. in the U.S. and other countries. Products bearing
SPARCtrademarks are based upon an architecture developed by Sun Microsystems, Inc.
The OPEN LOOK and Sun
of Xerox in researching and developing the concept of visual or graphical user interfaces for the computer industry. Sun holds a non-exclusive license from Xerox to
the Xerox Graphical User Interface, which license also covers Sun's licensees who implement OPEN LOOK GUIs and otherwise comply with Sun's written license
agreements.
Products covered by and information contained in this publication are controlled by U.S. Export Control laws and may be subject to the export or import laws in
other countries. Nuclear, missile, chemical or biological weapons or nuclear maritime end uses or end users, whether direct or indirect, are strictly prohibited. Export
or reexport to countries subject to U.S. embargo or to entities identied on U.S. export exclusion lists, including, but not limited to, the denied persons and specially
designated nationals lists is strictly prohibited.
DOCUMENTATION IS PROVIDED “AS IS” AND ALL EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES, INCLUDINGANY
IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT, ARE DISCLAIMED, EXCEPT TO
THE EXTENT THATSUCH DISCLAIMERS ARE HELD TO BE LEGALLY INVALID.
TM
Graphical User Interface was developed by Sun Microsystems, Inc. for its users and licensees. Sun acknowledges the pioneering eorts
Copyright 2008 Sun Microsystems, Inc.4150 Network Circle, Santa Clara, CA 95054 U.S.A. Tous droits réservés.
Sun Microsystems, Inc. détient les droits de propriété intellectuelle relatifs à la technologie incorporée dans le produit qui est décrit dans ce document. En particulier,
et ce sans limitation, ces droits de propriété intellectuelle peuvent inclure un ou plusieurs brevets américains ou des applications de brevet en attente aux Etats-Unis
et dans d'autres pays.
Cette distribution peut comprendre des composants développés par des tierces personnes.
Certaines composants de ce produit peuvent être dérivées du logiciel Berkeley BSD,licenciés par l'Université de Californie. UNIX est une marque déposée aux
Etats-Unis et dans d'autres pays; elle est licenciée exclusivement par X/Open Company, Ltd.
Sun, Sun Microsystems, le logo Sun, le logo Solaris, le logo Java Coee Cup, docs.sun.com, Enterprise JavaBeans, EJB, GlassFish, J2EE, J2SE, Java Naming and
Directory Interface, JavaBeans, Javadoc, JDBC, JDK, JavaScript, JavaServer, JavaServer Pages, JMX, JSP,JVM, MySQL, NetBeans, OpenSolaris, SunSolve, Sun
GlassFish, Java et Solaris sont des marques de fabrique ou des marques déposées de Sun Microsystems, Inc., ou ses liales, aux Etats-Unis et dans d'autres pays.
Toutes les marques SPARC sont utilisées sous licence et sont des marques de fabrique ou des marques déposées de SPARC International, Inc. aux Etats-Unis et dans
d'autres pays. Les produits portant les marques SPARC sont basés sur une architecture développée par Sun Microsystems, Inc.
L'interface d'utilisation graphique OPEN LOOK et Sun a été développée par Sun Microsystems, Inc. pour ses utilisateurs et licenciés. Sun reconnaît les eorts de
pionniers de Xerox pour la recherche et le développement du concept des interfaces d'utilisation visuelle ou graphique pour l'industrie de l'informatique. Sun détient
une licence non exclusive de Xerox sur l'interface d'utilisation graphique Xerox, cette licence couvrant également les licenciés de Sun qui mettent en place l'interface
d'utilisation graphique OPEN LOOK et qui, en outre, se conforment aux licences écrites de Sun.
Les produits qui font l'objet de cette publication et les informations qu'il contient sont régis par la legislation américaine en matière de contrôle des exportations et
peuvent être soumis au droit d'autres pays dans le domaine des exportations et importations. Les utilisations nales, ou utilisateurs naux, pour des armes nucléaires,
des missiles, des armes chimiques ou biologiques ou pour le nucléaire maritime, directement ou indirectement, sont strictement interdites. Les exportations ou
réexportations vers des pays sous embargo des Etats-Unis, ou vers des entités gurant sur les listes d'exclusion d'exportation américaines, y compris, mais de manière
non exclusive, la liste de personnes qui font objet d'un ordre de ne pas participer, d'une façon directe ou indirecte, aux exportations des produits ou des services qui
sont régis par la legislation américaine en matière de contrôle des exportations et la liste de ressortissants spéciquement designés, sont rigoureusement interdites.
LA DOCUMENTATIONEST FOURNIE "EN L'ETAT"ET TOUTES AUTRESCONDITIONS, DECLARATIONS ET GARANTIES EXPRESSES OU TACITES
SONT FORMELLEMENT EXCLUES, DANS LA MESURE AUTORISEE PAR LA LOI APPLICABLE, Y COMPRIS NOTAMMENT TOUTE GARANTIE
IMPLICITE RELATIVE A LA QUALITE MARCHANDE, A L'APTITUDE A UNE UTILISATIONPARTICULIERE OU A L'ABSENCE DE CONTREFACON.
Is JDBC Support Provided? ......................................................................................................... 42
Jersey FAQs ........................................................................................................................................... 42
How Do I Use Jersey? ................................................................................................................... 42
How Do I Use Update Tool to Extend My Enterprise Server Installation? ........................... 45
Index ......................................................................................................................................................47
Sun GlassFish Enterprise Server v3 PreludeTroubleshootingGuide • November 20086
Preface
This guide describes common problems that you might encounter when using Sun GlassFish
Enterprise Server v3 Prelude and how to solve them.
This preface contains information about and conventions for the entire Sun GlassFish
Enterprise Server documentation set.
The following topics are addressed here:
■
“Enterprise Server Documentation Set” on page 7
■
“Related Documentation” on page 9
■
“Typographic Conventions” on page 9
■
“Symbol Conventions” on page 10
■
“Default Paths and File Names” on page 10
■
“Documentation, Support, and Training” on page 11
■
“Searching Sun Product Documentation” on page 11
■
“Third-Party Web Site References” on page 11
■
“Sun Welcomes Your Comments” on page 12
Enterprise Server Documentation Set
The Enterprise Server documentation set describes deployment planning and system
installation. The Uniform Resource Locator (URL) for Enterprise Server documentation is
http://docs.sun.com/coll/1343.7. For an introduction to Enterprise Server, refer to the
books in the order in which they are listed in the following table.
TM
TABLE P–1 Books in the Enterprise Server Documentation Set
Book TitleDescription
Release NotesProvides late-breaking information about the software and the
documentation. Includes a comprehensive, table-based summary of the
supported hardware, operating system, Java
and database drivers.
Quick Start GuideExplains how to get started with the Enterprise Server product.
TM
Development Kit (JDKTM),
7
Preface
TABLE P–1 Books in the Enterprise Server Documentation Set(Continued)
Book TitleDescription
Installation GuideExplains how to install the software and its components.
Application Deployment GuideExplains how to assemble and deploy applications to the Enterprise Server
and provides information about deployment descriptors.
Developer’s GuideExplains how to create and implement Java Platform, Enterprise Edition
(Java EE platform) applications that are intended to run on the Enterprise
Server. These applications follow the open Java standards model for Java EE
components and APIs. This guide provides information about developer
tools, security, and debugging.
Add-On Component
Development Guide
Explains how to use published interfaces of Enterprise Server to develop
add-on components for Enterprise Server. This document explains how to
perform only those tasks that ensure that the add-on component is suitable
for Enterprise Server.
RESTful Web Services
Developer’s Guide
Getting Started With JRuby on
Rails for Sun GlassFish
Explains how to develop Representational State Transfer (RESTful) web
services for Enterprise Server.
Explains how to develop Ruby on Rails applications for deployment to
Enterprise Server.
Enterprise Server
Getting Started With Project
jMaki for Sun GlassFish
Enterprise Server
Roadmap to the Java EE 5
Tutorial
Explains how to use the jMaki framework to develop Ajax-enabled web
applications that are centered on JavaScript
TM
technology for deployment to
Enterprise Server.
Explains which information in the Java EE 5 Tutorial is relevant to users of
the v3 Prelude release of the Enterprise Server.
Java EE 5 TutorialExplains how to use Java EE 5 platform technologies and APIs to develop
Java EE applications.
Java WSIT TutorialExplains how to develop web applications by using the Web Service
Interoperability Technologies (WSIT). The tutorial focuses on developing
web service endpoints and clients that can interoperate with Windows
Communication Foundation (WCF) endpoints and clients.
Administration GuideExplains how to congure, monitor, and manage Enterprise Server
subsystems and components from the command line by using the
asadmin(1M) utility. Instructions for performing these tasks from the
Administration Console are provided in the Administration Console online
help.
Administration ReferenceDescribes the format of the Enterprise Server conguration le, domain.xml.
Troubleshooting GuideDescribes common problems that you might encounter when using
Enterprise Server and how to solve them.
Sun GlassFish Enterprise Server v3 PreludeTroubleshootingGuide • November 20088
TABLE P–1 Books in the Enterprise Server Documentation Set(Continued)
Book TitleDescription
Reference ManualProvides reference information in man page format for Enterprise Server
Related Documentation
A JavadocTMtool reference for packages that are provided with the Enterprise Server is located at
https://glassfish.dev.java.net/nonav/api/v3-prelude/index.html. Additionally, the
following resources might be useful:
■
The Java EE 5 Specications (http://java.sun.com/javaee/5/javatech.html)
■
The Java EE Blueprints (http://java.sun.com/reference/blueprints/index.html)
For information about creating enterprise applications in the NetBeansTMIntegrated
Development Environment (IDE), see http://www.netbeans.org/kb/60/index.html.
For information about the Java DB for use with the Enterprise Server, see
http://developers.sun.com/javadb/.
Preface
administration commands, utility commands, and related concepts.
Typographic Conventions
The following table describes the typographic changes that are used in this book.
TABLE P–2 TypographicConventions
TypefaceMeaningExample
AaBbCc123The names of commands, les, and
directories, and onscreen computer
output
AaBbCc123What you type, contrasted with onscreen
computer output
AaBbCc123A placeholder to be replaced with a real
name or value
AaBbCc123Book titles, new terms, and terms to be
emphasized (note that some emphasized
items appear bold online)
Edit your .login le.
Use ls -a to list all les.
machine_name% you have mail.
machine_name% su
Password:
The command to remove a le is rm lename.
Read Chapter 6 in the User's Guide.
A cache is a copy that is stored locally.
Do not save the le.
9
Preface
Symbol Conventions
The following table explains symbols that might be used in this book.
TABLE P–3 SymbolConventions
SymbolDescriptionExampleMeaning
[]Contains optional arguments
and command options.
{|}Contains a set of choices for a
required command option.
${ }Indicates a variable
reference.
-Joins simultaneous multiple
keystrokes.
+Joins consecutive multiple
keystrokes.
→Indicates menu item
selection in a graphical user
interface.
ls [-l]The -l option is not required.
-d {y|n}The -d option requires that you use
${com.sun.javaRoot}References the value of the
Control-APress the Control key while you press
Ctrl+A+NPress the Control key, release it, and
File → New → TemplatesFrom the File menu, choose New.
Default Paths and File Names
The following table describes the default paths and le names that are used in this book.
TABLE P–4 Default Pathsand File Names
PlaceholderDescriptionDefault Value
as-installRepresents the base installation directory for
Enterprise Server.
In conguration les, as-install is represented
as follows:
${com.sun.aas.installRoot}
Installations on the Solaris
system, and Mac operating system:
domain-root-dir Represents the directory in which a domain is
created by default.
Sun GlassFish Enterprise Server v3 PreludeTroubleshootingGuide • November 200810
as-install/domains/
TABLE P–4 Default Paths and File Names(Continued)
PlaceholderDescriptionDefault Value
Preface
domain-dirRepresents the directory in which a domain's
conguration is stored.
In conguration les, domain-dir is
represented as follows:
${com.sun.aas.instanceRoot}
domain-root-dir/domain-name
Documentation, Support, andTraining
The Sun web site provides information about the following additional resources:
■
Documentation (http://www.sun.com/documentation/)
■
Support (http://www.sun.com/support/)
■
Training (http://www.sun.com/training/)
Searching Sun Product Documentation
Besides searching Sun product documentation from the docs.sun.comSMweb site, you can use a
search engine by typing the following syntax in the search eld:
search-term site:docs.sun.com
For example, to search for “broker,” type the following:
broker site:docs.sun.com
To include other Sun web sites in your search (for example, java.sun.com, www.sun.com, and
developers.sun.com), use sun.com in place of docs.sun.com in the search eld.
Third-PartyWeb Site References
Third-party URLs are referenced in this document and provide additional, related information.
11
Preface
Note – Sun is not responsible for the availability of third-party web sites mentioned in this
document. Sun does not endorse and is not responsible or liable for any content, advertising,
products, or other materials that are available on or through such sites or resources. Sun will not
be responsible or liable for any actual or alleged damage or loss caused or alleged to be caused by
or in connection with use of or reliance on any such content, goods, or services that are available
on or through such sites or resources.
Sun WelcomesYour Comments
Sun is interested in improving its documentation and welcomes your comments and
suggestions. To share your comments, go to http://docs.sun.com and click Send Comments.
In the online form, provide the full document title and part number. The part number is a
7-digit or 9-digit number that can be found on the book's title page or in the document's URL.
For example, the part number of this book is 820-6823.
Sun GlassFish Enterprise Server v3 PreludeTroubleshootingGuide • November 200812
CHAPTER 1
1
Overview of Enterprise Server Troubleshooting
This chapter describes the tools, methods, and information sources available for
troubleshooting Sun GlassFish Enterprise Server v3 Prelude. Guidelines for evaluating and
investigating a problem are included.
This chapter contains the following sections:
■
“Identifying the Problem” on page 13
■
“Troubleshooting Tools” on page 17
■
“Where to Go for More Information” on page 19
Identifying the Problem
Application servers are typically deployed in complex and sophisticated operating
environments and involve many technologies, products, and tools. Understanding and
diagnosing problems in a large piece of software with so many components performing so
many tasks can be challenging. This section gets you started, and includes the following topics:
■
“First Steps” on page 13
■
“Gathering Information” on page 15
■
“Examining Log Files” on page 16
■
“Monitoring the System” on page 17
First Steps
Sometimes the most obvious solutions are overlooked. As you begin your investigation, try the
following steps rst.
13
Identifying the Problem
VerifySystemRequirements and Conguration
Problems are often caused by conguration issues (system, JVMTM, server, or application-level)
and by resource issues (such as when a system runs out of memory). Refer to the
Sun GlassFish
Enterprise Server v3 Prelude Release Notes for the latest information regarding system
requirements dependencies.
Review Known Issues
Your problem might be related to a known issue for the release. Refer to the Sun GlassFish
Enterprise Server v3 Prelude Release Notes for the latest information regarding known issues and
possible workarounds. Also search the GlassFish issue tracker at
GlassFish user forum: http://forums.java.net/jive/forum.jspa?forumID=56
■
Other GlassFish forums: http://forums.java.net/jive/category.jspa?categoryID=58
Learn More About Enterprise Server v3 Prelude
As the name suggests, the release is a prelude to Sun GlassFish Enterprise Server v3. It is not a
full Java EE 5 application server, and not everything that was implemented in Sun Java System
Application Server 9.1 (GlassFish v2) is implemented and functional in Enterprise Server v3
Prelude. You might be trying to do something that is not possible with the existing feature set.
For more information about Enterprise Server v3 Prelude and the features it contains, consult
the following resources:
Sun GlassFish Enterprise Server v3 PreludeTroubleshootingGuide • November 200814
Identifying the Problem
Note – Some resources refer to GlassFish v3 Prelude. GlassFish v3 Prelude is the community
version of the commercially supported oering, Sun GlassFish Enterprise Server v3 Prelude.
The software is the same; the dierence is in support.
Search the SunSolve Knowledgebase
SunSolveSMis Sun's informational and patch database service with a browseable directory of all
publicly available Sun Microsystems support documents. SunSolve is available at
http://sunsolve.sun.com. Additional resources are also available for customers with support
contracts.
Gathering Information
Troubleshooting and analysis require information. The more information that you have, the
easier it is to classify a problem and search for its solution. Detailed information will also be
necessary should you need to contact others for support, either through a community mailing
list or through more formal Sun support channels.
For general information about gathering data, also refer to
Java System Application Server
. The document pertains to previous versions but much of the
Sun Gathering Debug Data for Sun
information is generic enough that it might be helpful for Enterprise Server v3 Prelude.
As you continue your investigation, consider the following questions.
When Does the Problem Occur?
■
What do the logs show? What kind of error message are you getting? For more information
about logs, see
■
What are you trying to do when the problem occurs, and how are you doing it? What is the
“Examining Log Files” on page 16.
sequence of events?
■
Does the problem occur every time you perform the same type of operation, or does it seem
random? Can you reproduce the issue?
■
Have other events or problems occurred that could possibly be related, such as web sessions
closing early, exceptions being thrown in your own application logic, components not being
correctly deployed or undeployed?
What Is Your Environment?
■
What version of Enterprise Server are you using? What operating system and version? What
JDK version?
■
What resources does your system have, such as memory, disk, and swap space? If system
memory is an issue, look for ways to optimize your conguration and consider taking other
actions such as adding memory or decreasing system load.
Chapter 1 • Overview of Enterprise Server Troubleshooting15
Loading...
+ 33 hidden pages
You need points to download manuals.
1 point = 1 manual.
You can buy points or you can get point for every manual you upload.