About This Guide

This Installation Guide provides instructions for installing the Sun™ Open Net Environment (Sun ONE) Application Server Upgrade product.

The following topics are addressed here:

Who Should Use This Guide
How This Guide is Organized
Using the Documentation
Documentation Conventions
Product Support

Note	Sun ONE Application Server Platform Edition is automatically installed with Solaris 9. Users of the Solaris 9 bundled product should read "Documentation Conventions". After completing basic installation, you should then proceed to "Completing a Solaris 9 Bundled Installation" before reading the Getting Started Guide and Administrator’s Guide for information about configuring and using the Sun ONE Application Server product.

---

Who Should Use This Guide

This manual is intended for system administrators, network administrators, evaluators, application server administrators, web developers, and software developers who want to install the Sun ONE Application Server software.

This guide assumes you are familiar with the following:

Installation of software products
UNIX or Microsoft Windows, depending on your operating system
Client/server programming model
Internet and World Wide Web

---

How This Guide is Organized

This guide contains the following documentation components:

Chapter 1, "Preparing to Install"—Provides an overview of the minimum requirements, and steps to be taken prior to installing Sun ONE Application Server software.
Chapter 2, "Installing for Evaluation"—Provides quick-start instructions for installing the evaluation version of the Sun ONE Application Server software.
Chapter 3, "Installing for Development"—Provides instructions for installing the development (non-evaluation) version of the Sun ONE Application Server software. Includes instructions for performing a non-interactive silent installation.
Chapter 4, "Completing a Solaris 9 Bundled Installation"—Provides additional instructions specifically for Solaris 9 installation. Instructions for creating a domain are included.
Chapter 5, "Upgrading the Sun ONE Application Server Software"—Provides instructions for upgrading an existing installation of the Sun™ Open Net Environment (Sun ONE) Application Server software.
Chapter 6, "Uninstalling the Sun ONE Application Server Software"—Provides instructions for uninstalling the Sun ONE Application Server software.
Chapter 7, "Troubleshooting"—Provides solutions to problems you might encounter during or after installation.
Appendix A, "Licensing Information"—Provides information about application server licensing, upgrading your license, and licensing commands.

---

Using the Documentation

The Sun ONE Application Server manuals are available as online files in Portable Document Format (PDF) and Hypertext Markup Language (HTML) formats, at:

http://docs.sun.com/

The following table lists tasks and concepts described in the Sun ONE Application Server manuals.

Table 1   Sun ONE Application Server Documentation Road Map 

For information about	See the following
Late-breaking information about the software and the documentation	Release Notes
Supported platforms and environments	Platform Summary
Introduction to the application server, including new features, evaluation installation information, and architectural overview.	Getting Started Guide
Installing Sun ONE Application Server and its various components (sample applications, Administration interface, Sun ONE Message Queue).	Installation Guide
Creating and implementing J2EE applications that follow the open Java standards model on the Sun ONE Application Server. Includes general information about application design, developer tools, security, assembly, deployment, debugging, and creating lifecycle modules.	Developer’s Guide
Creating and implementing J2EE applications that follow the open Java standards model for web applications on the Sun ONE Application Server. Discusses web application programming concepts and tasks, and provides sample code, implementation tips, and reference material.	Developer’s Guide to Web Applications
Creating and implementing J2EE applications that follow the open Java standards model for enterprise beans on the Sun ONE Application Server. Discusses EJB programming concepts and tasks, and provides sample code, implementation tips, and reference material.	Developer’s Guide to Enterprise JavaBeans
Creating Web Services, RMI-IIOP, or other clients that access J2EE applications on the Sun ONE Application Server.	Developer’s Guide to Clients
J2EE features such as JDBC, JNDI, JTS, JMS, JavaMail, resources, and connectors	Developer’s Guide to J2EE Features and Services
Creating custom NSAPI plugins	Developer’s Guide to NSAPI
Performing the following administration tasks: Using the Administration interface and the command line interface Configuring server preferences Using administrative domains Using server instances Monitoring and logging server activity Configuring the web server plugin Configuring the Java Messaging Service Using J2EE features Configuring support for CORBA-based clients Configuring database connectivity Configuring transaction management Configuring the web container Deploying applications Managing virtual servers	Administrator’s Guide
Editing server configuration files	Administrator’s Configuration File Reference
Configuring and administering security for the Sun ONE Application Server operational environment. Includes information on general security, certificates, and SSL/TLS encryption. Web-core-based security is also addressed.	Administrator’s Guide to Security
Configuring and administering service provider implementation for J2EE CA connectors for the Sun ONE Application Server. Includes information about the Administration Tool, DTDs and provides sample XML files.	J2EE CA Service Provider Implementation Administrator’s Guide
Migrating your applications to the new Sun ONE Application Server programming model from the Netscape Application Server, including a sample migration of an Online Bank application provided with Sun ONE Application Server	Migrating and Redeploying Server Applications
Using Sun ONE Message Queue.	The Sun ONE Message Queue documentation at: http://docs.sun.com/db/prod/s1msgqu#hic

---

Documentation Conventions

This section describes the types of conventions used throughout this guide:

General Conventions
Conventions Referring to Directories

General Conventions

The following general conventions are used in this guide:

File and directory paths are given in UNIX^� format (with forward slashes separating directory names). For Microsoft Windows versions, the directory paths are the same, except that backslashes are used to separate directories.
URLs are given in the format:

http://server.domain/path/file.html

In these URLs, server is the server name where applications are run; domain is your Internet domain name; path is the server’s directory structure; and file is an individual filename. Italic items in URLs are placeholders.

Font conventions include:
The monospace font is used for sample code and code listings, API and language elements (such as function names and class names), file names, path names, directory names, and HTML tags.
Italic type is used for code variables.
Italic type is also used for book titles, emphasis, variables and placeholders, and words used in the literal sense.
Bold type is used as either a paragraph lead-in or to indicate words used in the literal sense.
Installation root directories for most platforms are indicated by install_dir in this document. Exceptions are noted in "Conventions Referring to Directories".

By default, the location of install_dir on most platforms is:

Solaris 8 non-package-based evaluation installations:

user_home_directory/sun/appserver7

Solaris unbundled, package-based installations:

/opt/SUNWappserver7

Linux RPM-based and file-based installations:

/opt/SUNWappserver7

Microsoft Windows, all installations:

C:\Sun\AppServer7

For the platforms listed above, default_config_dir and install_config_dir are identical to install_dir. See "Conventions Referring to Directories" for exceptions and additional information.

Instance root directories are indicated by instance_dir in this document, which is an abbreviation for the following:

default_config_dir/domains/domain/instance

UNIX-specific descriptions throughout this manual apply to the Linux operating system as well, except where Linux is specifically mentioned.

Conventions Referring to Directories

By default, when using the Solaris 8 and 9 package-based installation and the Solaris 9 bundled installation, the application server files are spread across several root directories. These directories are described in this section.

For Solaris 9 bundled installations, this guide uses the following document conventions to correspond to the various default installation directories provided:
install_dir refers to /usr/appserver/, which contains the static portion of the installation image. All utilities, executable files, and libraries that make up the application server reside in this location.
default_config_dir refers to /var/appserver/domains, which is the default location for any domains that are created.
install_config_dir refers to /etc/appserver/, which contains installation-wide configuration information such as licenses and the master list of administrative domains configured for this installation.
For Solaris 8 and 9 package-based, unbundled installations, this guide uses the following document conventions to correspond to the various default installation directories provided:
install_dir refers to /opt/SUNWappserver7, which contains the static portion of the installation image. All utilities, executable files, and libraries that make up the application server reside in this location.
default_config_dir refers to /var/opt/SUNWappserver7/domainswhich is the default location for any domains that are created.
install_config_dir refers to /etc/opt/SUNWappserver7/, which contains installation-wide configuration information such as licenses and the master list of administrative domains configured for this installation.

---

Product Support

If you have problems with your system, contact customer support using one of the following mechanisms:

The online support web site at:

http://www.sun.com/supportraining/

The telephone dispatch number associated with your maintenance contract

Please have the following information available prior to contacting support. This helps to ensure that our support staff can best assist you in resolving problems:

Description of the problem, including the situation where the problem occurs and its impact on your operation
Machine type, operating system version, and product version, including any patches and other software that might be affecting the problem
Detailed steps on the methods you have used to reproduce the problem
Any error logs or core dumps

---

For More Information

Useful Sun ONE information can be found at the following Internet locations:

Sun ONE products and services information

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

Sun ONE developer information

http://wwws.sun.com/software/product_categories/application_deve lopment.html

Sun ONE learning solutions

http://training.sun.com/

Sun ONE product data sheets

http://wwws.sun.com/software/

Sun Microsystems product documentation

http://docs.sun.com/

Sun ONE Application Server product downloads:

http://wwws.sun.com/software/download/app_servers.html

Sun ONE Application Server product documentation

http://docs.sun.com/db/prod/s1.asse#hic

Previous      Contents      Index      Next

---

Copyright 2003 Sun Microsystems, Inc. All rights reserved.