Preface

This guide describes common problems encountered when using the Sun Java™ System Application Server Server 8.1 Standard and Enterprise Editions, and how to solve them.

Who Should Use This Book

The Troubleshooting Guide is intended for developers and administrators who use the Sun Java™ System Application Server to assemble and deploy distributed and Web-based applications.

Java APIs as defined in the Java™ Servlet, JavaServer Pages™ (JSP™), Enterprise JavaBeans™ (EJB™), and Java™ Database Connectivity (JDBC™) specifications

The SQL structured database query languages

Relational database concepts

How This Book Is Organized

This book describes workarounds for some problems you may encounter when configuring, using, or deploying applications with the Sun Java™ System Application Server 8.1 EE or PE. The following table summarizes the content of this book.

Table 1 How This Book Is Organized
Chapter	Description
Chapter 1, "Overview"	Provides a general overview of the troubleshooting process.
Chapter 2, "Common Problems"	Covers problems that users frequently encounter when using the product.
Chapter 4, "Security Problems"	Covers problems that users encounter as a result of security settings.
Chapter 5, "Frequently Asked Questions"	Covers questions that users commonly ask about the product.

Conventions Used in This Book

The tables in this section describe the conventions used in this book.

Typographic Conventions

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

Table 2 Typographic Conventions
Typeface	Meaning	Examples
AaBbCc123 (Monospace)	API and language elements, HTML tags, web site URLs, command names, file names, directory path names, onscreen computer output, sample code.	Edit your.login file. Use ls -a to list all files. % You have mail.
AaBbCc123 (Monospace bold)	What you type, when contrasted with onscreen computer output.	% su Password:
AaBbCc123 (Italic)	Book titles, new terms, words to be emphasized. A placeholder in a command or path name to be replaced with a real name or value.	Read Chapter 6 in the User’s Guide. These are called class options. Do not save the file. The file is located in the install-dir/bin directory.

Symbols

The following table describes the symbol conventions used in this book.

Table 3 Symbol Conventions
Symbol	Description	Example	Meaning
[ ]	Contains optional command options.	ls [-l]	The -l option is not required.
{ \| }	Contains a set of choices for a required command option.	-d {y\|n}	The -d option requires that you use either the y argument or the n argument.
-	Joins simultaneous multiple keystrokes.	Control-A	Press the Control key while you press the A key.
+	Joins consecutive multiple keystrokes.	Ctrl+A+N	Press the Control key, release it, and then press the subsequent keys.
>	Indicates menu item selection in a graphical user interface.	File > New > Templates	From the File menu, choose New. From the New submenu, choose Templates.

Default Paths and File Names

The following table describes the default paths and file names used in this book.

Table 4 Default Paths and File Names
Term	Description
IdentityServer-base	Represents the base installation directory for Identity Server. The Identity Server 2004Q2 default base installation and product directory depends on your specific platform: Solaris™ systems: /opt/SUNWam Linux systems: /opt/sun/identity
DirectoryServer-base	Represents the base installation directory for Sun Java System Directory Server. Refer to the product documentation for the specific path name.
ApplicationServer-base	Represents the base installation directory for Sun Java System Application Server. Refer to the product documentation for the specific path name.
WebServer-base	Represents the base installation directory for Sun Java System Web Server. Refer to the product documentation for the specific path name.

Shell Prompts

The following table describes the shell prompts used in this book.

Table 5 Shell Prompts
Shell	Prompt
C shell on UNIX or Linux	machine-name%
C shell superuser on UNIX or Linux	machine-name#
Bourne shell and Korn shell on UNIX or Linux	$
Bourne shell and Korn shell superuser on UNIX or Linux	#
Windows command line	C:\

Related Documentation

The http://docs.sun.comSM website enables you to access Sun technical documentation online. You can browse the archive or search for a specific book title or subject.

Books in This Documentation Set

The Sun Java System Application Server Standard and Enterprise Edition manuals are available as online files in Portable Document Format (PDF) and Hypertext Markup Language (HTML).

The following table lists tasks and concepts described in the Sun Java System Application Server manuals. The manuals marked (updated for 8 2004Q5) have been updated for the Sun Java System Application Server Standard and Enterprise Edition 8 2004Q5 release. The manuals not marked in this way have not been updated since the version 8 Enterprise Edition release.

Table 6 Books in This Documentation Set
Book Title	Description
Release Notes	(Updated for 8 2004Q5) Late-breaking information about the software and the documentation. Includes a comprehensive, table-based summary of supported hardware, operating system, JDK, and JDBC/RDBMS.
Product Overview	Sun Java System Application Server 8 overview, including the features available with each product edition.
Server Architecture	Diagrams and descriptions of server architecture and the benefits of the Sun Java System Application Server architectural approach.
Getting Started Guide	(Updated for 8 2004Q5) How to get started with the Sun Java System Application Server product. Includes a sample application tutorial. There are two guides, one for Standard Edition and one for Enterprise Edition.
Installation Guide	(Updated for 8 2004Q5) Installing the Sun Java System Application Server Standard Edition and Enterprise Edition software and its components, such as sample applications and the Administration interface. For the Enterprise Edition software, instructions are provided for implementing the high-availability configuration.
System Deployment Guide	(Updated for 8 2004Q5) Evaluating your system needs and enterprise to ensure that you deploy Sun Java System Application Server in a manner that best suits your site. General issues and concerns that you must be aware of when deploying an application server are also discussed.
Developer’s Guide	Creating and implementing Java™ 2 Platform, Enterprise Edition (J2EE™ platform) applications intended to run on the Sun Java System Application Server that follow the open Java standards model for J2EE components such as servlets, Enterprise JavaBeans™ (EJBs™), and JavaServer Pages™ (JSPs™). Includes general information about application design, developer tools, security, assembly, deployment, debugging, and creating lifecycle modules. A comprehensive Sun Java System Application Server glossary is included.
Developer’s Guide to Web Applications	(Updated for 8 2004Q5) Creating and implementing J2EE web applications that follow the Java™ Servlet and JavaServer Pages (JSP) specifications on the Sun Java System Application Server. Discusses web application programming concepts and tasks, and provides sample code, implementation tips, and reference material. Topics include results caching, JSP precompilation, session management, security, deployment, SHTML, and CGI.
Developer’s Guide to Enterprise JavaBeans Technology	(Updated for 8 2004Q5) Creating and implementing J2EE applications that follow the open Java standards model for enterprise beans on the Sun Java System Application Server. Discusses Enterprise JavaBeans (EJB) programming concepts and tasks, and provides sample code, implementation tips, and reference material. Topics include container-managed persistence, read-only beans, and the XML and DTD files associated with enterprise beans.
Developer’s Guide to Clients	(Updated for 8 2004Q5) Creating Application Client Container (ACC) clients that access J2EE applications on the Sun Java System Application Server.
Developer’s Guide to Web Services	Creating web services in the Sun Java System Application Server environment.
Developer’s Guide to J2EE Services and APIs	(Updated for 8 2004Q5) Java™ Database Connectivity (JDBC™), transaction, Java Naming and Directory Interface™ (JNDI), Java™ Message Service (JMS), and JavaMail™ APIs.
Developer’s Guide to NSAPI	Creating custom NSAPI plug-ins.
Administration Guide	(Updated for 8 2004Q5) Information and instructions on the configuration, management, and deployment of the Sun Java System Application Server subsystems and components, from both the Administration interface and the command-line interface. Topics include cluster management, the high-availability database, load balancing, and session persistence. A comprehensive Sun Java System Application Server glossary is included.
Administrator’s Configuration File Reference	(Updated for 8 2004Q5) Editing Sun Java System Application Server configuration files, such as the server.xml file.
Administrator’s Guide to Security	Configuring and administering security for the Sun Java System Application Server operational environment. Includes information on general security, certificates, and SSL/TLS encryption. HTTP server-based security is also addressed.
J2EE CA Service Provider Implementation Administrator’s Guide	Configuring and administering service provider implementation for J2EE™ Connector Architecture (CA) connectors for the Sun Java System Application Server. Topics include the Administration Tool, Pooling Monitor, deploying a JCA connector, and sample connectors and sample applications.
Migrating and Redeploying Server Applications Guide	(Updated for 8 2004Q5) Migrating your applications to the new Sun Java System Application Server programming model, specifically from iPlanet Application Server 6.x and Sun ONE Application Server 8.0. Includes a sample migration.
Performance Tuning Guide	(Updated for 8 2004Q5) How and why to tune your Sun Java System Application Server to improve performance.
Troubleshooting Guide	(Updated for 8 2004Q5) Information on solving Sun Java System Application Server problems.
Error Message Reference	(Updated for 8 2004Q5) Information on solving Sun Java System Application Server error messages.
Utility Reference Manual	(Updated for 8 2004Q5) Utility commands available with the Sun Java System Application Server; written in manpage style.
The Sun Java System Message Queue documentation at: http://docs.sun.com/db?p=prod/s1.s1msgqu	Using the Sun™ Java System Message Queue 3.5 software.

Accessing Sun Resources Online

For product downloads, professional services, patches and support, and additional developer information, go to the following:

Download Center
http://wwws.sun.com/software/download/

Professional Services
http://www.sun.com/service/sunps/sunone/index.html

Sun Enterprise Services, Solaris Patches, and Support
http://sunsolve.sun.com/

Developer Information
http://developers.sun.com/prodtech/index.html

Contacting Sun Technical Support

If you have technical questions about this product that are not answered in the product documentation, go to http://www.sun.com/service/contacting.

Related Third-Party Web Site References

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 Welcomes Your 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 document title and part number. The part number is a seven-digit or nine-digit number that can be found on the title page of the book or at the top of the document. For example, the title of this book is Sun Java™ System Application Server 2004Q4 Troubleshooting Guide, and the part number is 817-6085.

Previous Contents Index Next

Previous Contents Index Next
Sun Java System Application Server 8.1 2004Q4 Beta Troubleshooting Guide