Sun Java System Web Server 6.1 SP9 Administrator's Guide


This guide describes how to configure and administer Sun JavaTM System Web Server 6.1. It is intended for information technology administrators in the corporate enterprise who want to extend client-server applications to a broader audience through the World Wide Web.

This preface includes the following sections:

What's In This Guide?

This guide explains how to configure and administer the Sun Java System Web Server. After configuring your server, use this guide to help maintain your server.

After you install the server, this guide is available in HTML format at /manual/https/ag in your server root directory. By default, the server root directory is C:\Sun\WebServer6.1\ or /opt/SunWwbsvr.

How This Guide Is Organized

This guide is divided into five parts, a glossary, and a comprehensive index. If you are new to Sun Java System Web Server 6.1, begin with Product Support for an overview of the product. If you are already familiar with this version of Sun Java System Web Server, skim through the material in Product Support before going on to Migrating a Server From a Previous Version.

Once you are familiar with the fundamentals of using the Administration Server, you can refer to Adding Variables, which includes examples of how to configure and monitor your Sun Java System Web Servers. Using the Command Line Utility provides information for using programs and configuration styles.

Finally, Security Considerations addresses specific reference topics that describe the various topics, including: Hypertext Transfer Protocol (HTTP), server configuration files, ACL files, internationalization issues, server extensions, and the Sun Java System Web Server user interface reference, which you may want to review. Note that the user interface appendix is available in the online version only.

Server Basics

This section provides an overview of the Sun Java System Web Server. The following chapters are included:

Using the Administration Server

This section provides conceptual and procedural details about using the Administration Server to administer your Sun Java System Web Servers. The following chapters are included:

Configuring and Monitoring

This section includes how to use the Server Manager to configure and monitor your Sun Java System Web Servers. The following chapters are included:

Managing Virtual Servers and Services

This section provides information for using the Server Manager to programs and configuration styles. The following chapters are included:


This section includes various appendixes with reference material that you may wish to review. This section includes the following appendixes:

In addition, a glossary is included to define frequently used terms that may be unfamiliar to Sun Java System Web Server administrators.

Using the Sun Java System Web Server Documentation

The Sun Java System Web Server manuals are available as online files in PDF and HTML formats at:

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 ONE Web Server 4.1 or 6.0 to Sun Java System Web Server 6.1

Installation and Migration Guide

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 platform) 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 Pages™ (JSP™) 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

Documentation Conventions

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

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


On Windows, it is:


Product Support

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

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:

Documentation, Support, and Training

The Sun web site provides information about the following additional resources:

Sun Welcomes Your Comments

Sun is interested in improving its documentation and welcomes your comments and suggestions. To share your comments, go to and click Feedback.

Typographic Conventions

The following table describes the typographic conventions that are used in this book.

Table P–2 Typographic Conventions





The names of commands, files, and directories, and onscreen computer output 

Edit your .login file.

Use ls -a to list all files.

machine_name% you have mail.


What you type, contrasted with onscreen computer output 

machine_name% su



Placeholder: replace with a real name or value 

The command to remove a file is rm filename.


Book titles, new terms, and terms to be emphasized 

Read Chapter 6 in the User's Guide.

A cache is a copy that is stored locally.

Do not save the file.

Note: Some emphasized items appear bold online.

Shell Prompts in Command Examples

The following table shows the default UNIX® system prompt and superuser prompt for the C shell, Bourne shell, and Korn shell.

Table P–3 Shell Prompts



C shell 


C shell for superuser 


Bourne shell and Korn shell 


Bourne shell and Korn shell for superuser