Preface

The Sun Java System Web Server Getting Started guide is recommended for first time users of the Sun Java^TM System Web Server 6.1 product. This guide introduces you to the basic features of the server, through hands-on exercises.

This chapter assumes that you have already installed the server and are ready to explore its features.

This preface contains information about the following topics:

• Using the Documentation

• How This Guide Is Organized

• Documentation Conventions

• Product Support

Using the Documentation

The Sun Java System Web Server 6.1 SP10 manuals are available as online files in PDF and HTML formats at: http://docs.sun.com/app/docs/coll/1308.7

The following table lists the tasks and concepts described in the Sun Java System Web Server manuals.

Table P–1 Sun Java System Web Server Documentation Roadmap

For Information About	See the Following
Late-breaking information about the software and documentation	Release Notes
Getting started with Sun Java System Web Server, including hands-on exercises that introduce server basics and features (recommended for first-time users)	Getting Started Guide
Performing installation and migration tasks:  Installing Sun Java System Web Server and its various components, supported platforms, and environments Migrating from Sun Java System Web Server 4.1 or 6.0 to Sun Java System Web Server 6.1	Installation and Migration Guide Note: If you have the Sun Java Enterprise System 1 installed on your system and you want to upgrade the Sun Java System Web Server 6.1 that is part of Sun Java Enterprise System 1 to Sun Java System Web Server 6.1 SP10, you must use the Java Enterprise System (JES) installer to perform the upgrade. Do not use the separate component installer included with Sun Java System Web Server 6.1 SP10.
Performing the following administration tasks: Using the Administration and command-line interfaces Configuring server preferences Using server instances Monitoring and logging server activity Using certificates and public key cryptography to secure the server Configuring access control to secure the server Using Java 2 Platform, Standard Edition (J2SE) security features Deploying applications Managing virtual servers Defining server workload and sizing the system to meet performance needs Searching the contents and attributes of server documents, and creating a text search interface Configuring the server for content compression Configuring the server for web publishing and content authoring using WebDAV	Administrator’s Guide
Using programming technologies and APIs to do the following:  Extend and modify Sun Java System Web Server Dynamically generate content in response to client requests Modify the content of the server	Programmer’s Guide
Creating custom Netscape Server Application Programmer’s Interface (NSAPI) plugins	NSAPI Programmer’s Guide
Implementing servlets and JavaServer PagesTM (JSPTM) technology in Sun Java System Web Server	Programmer’s Guide to Web Applications
Editing configuration files	Administrator’s Configuration File Reference Guide
Tuning Sun Java System Web Server to optimize performance	Performance Tuning, Sizing, and Scaling Guide

How This Guide Is Organized

This guide has the following sections:

• Chapter 1, Basic Tasks

  Introduces you to a few basic tasks associated with Sun Java System Web Server, including starting and accessing the server.

• Chapter 2, Creating and Using Virtual Servers

  Demonstrates the creation and use of listen sockets, virtual server classes, and virtual servers.

• Chapter 3, Enabling Access Control

  Shows how you can configure access control to protect resources on a virtual server.

• Chapter 4, Publishing Content

  Demonstrates how to set up a virtual server to support web publishing through Web-based Distributed Authoring and Versioning (WebDAV) and also, how to access resources using a WebDAV-enabled client.

• Chapter 5, Making Content Searchable

  Demonstrates how you can use the search functionality to make content searchable on a virtual server.

• Chapter 6, Running Java Web Applications On Your Server

  Uses a sample application to show how you can deploy a Java web application on a virtual server.

• Chapter 7, Setting Up Database Connectivity

  Shows how you can set up database connectivity on a virtual server and create J2SE resources to store and retrieve data from a database.

• Chapter 8, Using CGI

  Demonstrates how to enable a virtual server to handle dynamic content using Common Gateway Interface (CGI) programs.

• Chapter 9, Using Sun Java System Active Server Pages

  Demonstrates how to enable a virtual server to handle dynamic content using Sun^TM Java System Active Server Pages.

Documentation Conventions

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

• File and directory paths are given in UNIX® format (with forward slashes separating directory names). For 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, pathnames, 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 are indicated by install_dir in this document.

By default, the location of install_dir on UNIX-based platforms is:

/opt/SUNWwbsvr/

On Windows, it is:

C:\Sun\WebServer6.1

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/training/

• 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