About This Guide

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

The following topics are addressed here:

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

---

Who Should Use This Guide

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

This guide assumes you are familiar with the following:

Installation of enterprise-level software products
UNIX^� operating system
Client/server programming model
Internet and World Wide Web
High-availability and clustering concepts

---

How This Guide is Organized

This guide contains the following documentation components:

Chapter 1, "Preparing to Install"—Provides information on the installation components, installation methods, and requirements for installing Sun ONE Application Server 7, Enterprise Edition software
Chapter 2, "Installing Enterprise Edition Software"—Provides instructions for installing the Sun ONE Application Server 7, Enterprise Edition software components. Includes instructions for performing a non-interactive silent installation.
Chapter 3, "Preparing for HADB Setup"—Provides instructions for configuring shared memory, and setting up host communications and the user environment for the high-availability configuration.
Chapter 4, "Post-installation Tasks"—Describes additional tasks you may need to perform during or after installing the Sun ONE Application Server software.
Chapter 5, "Uninstalling the Enterprise Edition Software"—Provides instructions for uninstalling the Sun ONE Application Server 7 software. Includes instructions for performing a non-interactive silent uninstallation.
Chapter 6, "Troubleshooting"—Provides information on logging as well as solutions to problems you may encounter during or after installation or uninstallation.
Appendix A, "Installation Cheatsheet"—Provides a checklist of the summarized tasks of installing the Sun ONE Application Server Version 7, Enterprise Edition software.

---

Using the Documentation

The Sun ONE Application Server 7, Enterprise Edition manuals are available in Portable Document Format (PDF) and Hypertext Markup Language (HTML) on the documentation CD that is distributed with the product.

The following table lists tasks and concepts described in the Sun ONE Application Server manuals. The left column lists the tasks and concepts, and the right column lists the corresponding manuals.

Application Server Documentation Roadmap 

For information about	See the following
Late-breaking information about the software and the documentation	Release Notes
Comprehensive, table-based summary of supported hardware, operating system, JDK, and JDBC/RDBMS.	Platform Summary
Sun ONE Application Server 7 overview, features available with each product edition	Product Overview
Diagrams and descriptions of server architecture, benefits of the Sun ONE Application Server architectural approach	Server Architecture
New enterprise, developer, and operational features of Sun ONE Application Server 7	What’s New
How to get started with the Sun ONE Application Server 7 product. Includes new features, architectural overview, and sample application tutorial.	Getting Started Guide
Installing the Sun ONE Application Server software and its components, such as sample applications, the Administration interface, and the high-availability components. Instructions for implementing a basic high-availability configuration are included.	Installation Guide
Evaluating your system needs and enterprise to ensure that you deploy Sun ONE 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.	System Deployment Guide
Best practices for HTTP session availability that application architects and developers can use	Application Design Guidelines for Storing Session State
Creating and implementing J2EE applications intended to run on the Application Server 7 that follow the open Java standards model for servlets, Enterprise JavaBeans™ (EJBs™), JavaServer Pages (JSPs), and other J2EE components. Includes general information about application design, developer tools, security, assembly, deployment, debugging, and creating lifecycle modules. A comprehensive Application Server glossary is included.	Developer’s Guide
Creating and implementing J2EE web applications that follow the Java™ Servlet and JavaServer Pages™ (JSP™) specifications on the Application Server 7. 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 Web Applications
Creating and implementing J2EE applications that follow the open Java standards model for enterprise beans on the Sun ONE Application Server 7. 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 Enterprise JavaBeans Technology
Creating Application Client Container (ACC) clients that access J2EE applications on the Application Server 7	Developer’s Guide to Clients
Creating web services in the Sun ONE Application Server environment	Developer’s Guide to Web Services
Java™ Database Connectivity (JDBC™), transaction, Java Naming and Directory Interface™ (JNDI), Java™ Message Service (JMS), and JavaMail™ APIs	Developer’s Guide to J2EE Services and APIs
Creating custom NSAPI plugins	Developer’s Guide to NSAPI
Information and instructions on the configuration, management, and deployment of the Sun ONE 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 Application Server glossary is included.	Administrator’s Guide
Editing Sun ONE Application Server configuration files, such as the server.xml file	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. HTTP server-based security is also addressed.	Administrator’s Guide to Security
Configuring and administering service provider implementation for J2EE™ Connector Architecture (CA) connectors for the Sun ONE Application Server 7. Topics include the Administration Tool, Pooling Monitor, deploying a JCA connector, and sample connectors and sample applications.	J2EE CA Service Provider Implementation Administrator’s Guide
Migrating your applications to the new Sun ONE Application Server 7 programming model, specifically from iPlanet Application Server 6.x and from Netscape Application Server 4.0. Includes a sample migration.	Migrating and Redeploying Server Applications Guide
How and why to tune your Sun ONE Application Server to improve performance	Performance Tuning Guide
Information on solving Sun ONE Application Server problems	Troubleshooting Guide
Messages that you may encounter while running Sun ONE Application Server 7. Includes a description of the likely cause and guidelines on how to address the condition that caused the message to be generated.	Error Message Reference
Utility commands available with the Sun ONE Application Server; written in manpage style	Utility Reference Manual
Using the Sun ONE Message Queue software.	The Sun ONE Message Queue documentation at: http://docs.sun.com/db?p=prod/s1.s1msgqu

---

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).
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.
Instance root directories are indicated by instance_dir in this document, which is an abbreviation for the following:

default_config_dir/domains/domain/instance

Conventions Referring to Directories

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

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

Use your early access support process for any product or documentation issues and for submitting defects.

If you have general feedback on the product or documentation, please send this to appserver-feedback@sun.com.

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 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_development.html

Sun ONE learning solutions

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

Sun ONE product data sheets

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

Sun Microsystems product documentation

http://docs.sun.com/

Previous      Contents      Index      Next

---

Copyright 2003 Sun Microsystems, Inc. All rights reserved.