Before You Begin

This installation guide for Suntrademark Java trademark Studio Enterprise 6 2004Q1 (Java Studio Enterprise) software provides instructions for installing, setting up, and starting the software. This book is designed to aid both system administrators and developers who install this software. You should be experienced with basic installation procedures for your operating environment.

Screen shots and commands entered at the command line vary slightly from one platform to another. For example, a Microsoft Windows command might look like this:

c:\>cd MyWorkDir\MyPackage

A UNIX command might look like this:

% cd MyWorkDir/MyPackage


Before You Read This Book

You should be familiar with installing and uninstalling software products on the platforms you choose to use with this software. You need familiarity with system administration commands and topics such as:

If you are unsure about the system administration commands for your operating system or you do not have a user account with administrator or superuser privileges, contact your system administrator for assistance with installing this software.

Before using the Java Studio Enterprise Integrated Development Environment (the IDE), you should also be familiar with several of the following subjects:

Using the Java Studio Enterprise IDE successfully requires a knowledge of J2EE concepts, as described in the following resources:

Familiarity with the Java API for XML-Based RPC (JAX-RPC) is helpful. For more information, see this web page:

http://java.sun.com/xml/jaxrpc



Note - Sun is not responsible for the availability of third-party web sites mentioned in this document and does not endorse and is not responsible or liable for any content, advertising, products, or other materials on or available from such sites or resources. Sun will not be responsible or liable for any 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 available on or through any such sites or resources.




Typographic Conventions

Typeface

Meaning

Examples

AaBbCc123

The names of commands, files, and directories; on-screen computer output

Edit your .cvspass file.

Use DIR to list all files.

Search is complete.

AaBbCc123

What you type, when contrasted with on-screen computer output

> login

:

AaBbCc123

Book titles, new words or terms, words to be emphasized

Read Chapter 6 in the User's Guide.

These are called class options.

You must save your changes.

AaBbCc123

Command-line variable; replace with a real name or value

To delete a file, type DEL filename.



Product Names

Products that have been released with the Sun ONE brand have been rebranded with new names described in TABLE P-1.

TABLE P-1 Java Studio Enterprise Product Names

Old Name

New Name

Sun ONE Application Server

Sun Java System Application Server

Sun ONE Directory Server

Sun Java System Directory Server

Sun ONE Identity Server

Sun Java System Identity Server

Sun ONE Message Queue

Sun Java System Message Queue

Sun ONE Portal Server

Sun Java System Portal Server

Sun ONE Web Server

Sun Java System Web Server

Sun ONE Identity Server Policy Agent

Sun Java System Identity Server Policy Agent

Sun ONE Studio 5 Update 1

Sun Java Studio Standard 5 Update 1

Sun ONE Portlet Builder

Sun Java System Portlet Builder

Sun ONE Application Framework

Sun Java Studio's Web Application Framework


Please see Chapter 2 for a list of the specific versions of these products that are included with this version of the Sun Java Studio Enterprise 6 software. This book uses the new names to refer to these component products in most places. When referring to screen elements in the products, the old names are still used. The documentation titles can be found under the old names. See Finding Additional Documentation.


Related Documentation

Java Studio Enterprise documentation includes books delivered in Acrobat Reader (PDF) format, release notes, online help, and readme files for example applications.

Documentation Available Online

The documents described in this section are available from the docs.sun.comSM web site and from the documentation page of the Sun Developer Resources portal at http://developers.sun.com/prodtech/javatools/jsenterprise/
reference/docs/index.html
.

The docs.sun.com web site (http://docs.sun.com) enables you to read, print, and buy Sun Microsystems manuals through the Internet.

Describes last-minute release changes and technical notes.

Describes how to install the Sun Java Studio Enterprise 6 integrated development environment (IDE) on each supported platform and includes other pertinent information, such as system requirements, upgrade instructions, server information, command-line switches, installed subdirectories, database integration, and information on how to upgrade from a trial license to a permanent license.

This series provides in-depth information on how to use various Sun Java Studio Enterprise 6 features to develop well-formed J2EE applications.

Describes how to build a web application as a J2EE web module using JSP pages, servlets, tag libraries, and supporting classes and files.

Describes how to assemble EJB modules and web modules into a J2EE application and how to deploy and run a J2EE application.

Describes how to build EJB components (session beans, message-driven beans, and entity beans with container-managed persistence or bean-managed persistence) using the Sun Java Studio Enterprise 6 EJB Builder wizard and other components of the IDE.

Describes how to use the Sun Java Studio Enterprise 6 IDE to build web services, to make web services available to others through a UDDI registry, and to generate web service clients from a local web service or a UDDI registry.

Describes how to use the JDBC productivity enhancement tools of the Sun Java Studio Enterprise 6 IDE, including how to use them to create a JDBC application.

Describes the various parts of the Sun Java Studio Enterprise 6 IDE and emphasizes the use of the visual tools for developing a Web Application Framework application.

Introduces the mechanics and techniques to build a web application using the Web Application Framework tools.

Provides the steps to create and use application components that can be assembled to develop an application using the Web Application Framework and explains how to deploy the application in most J2EE containers.

Introduces the Web Application Framework and what it is, how it works, and what sets it apart from other application frameworks.

Gives a brief introduction to the Web Application Framework tag library, as well as a comprehensive reference to the tags available within the library.

Describes the Web Application Framework component architecture and the process to design, create, and distribute new components.

Describes the components available in the Web Application Framework Library.

Tutorials, Mini-Tutorials, and Examples

Sun Java Studio Enterprise 6 tutorials, mini-tutorials, and examples help you understand the features of the IDE. Each example or tutorial provides code samples that you can use or modify in developing more substantial applications. All examples and tutorials illustrate deployment with Sun Java System Application Server.

Completed examples are available in the AboutExamples directory under your Java Studio Enterprise user directory.

Mini-tutorials are available from the Tutorials and Code Camps page of the Sun Java Studio Enterprise 6 developers portal, at http://developers.sun.com/prodtech/javatools/jsenterprise/learning/tutorials/index.html.

Provides step-by-step instructions for building a simple J2EE web application.

Provides step-by-step instructions for building an application using EJB components and Web Services technology.

These documents are available from docs.sun.com. The documents, as well as zip files of the completed applications, are also available from the Tutorials and Code Camps page of the Sun Java Studio Enterprise 6 developers portal, at http://developers.sun.com/prodtech/javatools/jsenterprise/learning/tutorials/index.html.

Online Help

Online help is available in the Sun Java Studio Enterprise 6 IDE. You can open help by pressing the help key (F1 in Microsoft Windows environments, Help key in the Solaris environment), or by choosing Help right arrow Contents. Either action displays a list of help topics and a search facility.

Documentation in Accessible Formats

The documentation is provided in accessible formats that are readable by assistive technologies for users with disabilities. You can find accessible versions of documentation as described in the following table.

Type of Documentation

Format and Location of Accessible Version

Books and tutorials

HTML at http://docs.sun.com

Mini-tutorials

HTML at http://developers.sun.com/prodtech/javatools/jsenterprise/learning/tutorials/index.html

Integrated example readmes

HTML in the example subdirectories of java-studio-install-dir/examples

Release notes

HTML at http://docs.sun.com



Sun Welcomes Your Comments

Sun is interested in improving its documentation and welcomes your comments and suggestions. Email your comments to Sun at this address:

docfeedback@sun.com

Please include the part number (817-4662-10) of this document in the subject line of your email.