Sun Java System Web Server 6.1 SP12 Administrator's Guide

Preface

This guide describes how to configure and administer Sun Java^TM 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:

Chapter 2, Introduction to Sun Java System Web Server provides an overview of Sun Java System Web Server.
Chapter 3, Administering Sun Java System Web Servers describes how to manage your Sun Java System Web Servers with the Administration Server.

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:

Chapter 4, Managing Users and Groups describes how to use the Administration Server Users and Groups forms to configure your Sun Java System Web Servers.
Chapter 5, J2SE-based Security for Web Container and Web Applications describes how to configure your Sun Java System Web Server security. Two security models: ACL-based access control and Java™ 2 Platform, Standard Edition (J2SE)/Servlets-based authentication and authorization is discussed in this chapter.
Chapter 6, Setting Administration Preferences describes how to use the Administration Server Preferences and Global Settings forms to configure your Sun Java System Web Servers.
Chapter 7, Using Certificates and Keys describes how you can use certificates and public keys to enhance security. Note that before reading this chapter you should be familiar with the basic concepts of public-key cryptography and the Secure Sockets layer (SSL) protocol. These concepts include encryption and decryption, keys, digital certificates and signatures, and SSL encryption, ciphers, and the major steps of the SSL handshake.
Chapter 8, Managing Server Clusters describes the concept of clustering servers and explains how you can use them to share configurations among servers.

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:

Chapter 9, Configuring Server Preferences describes how to configure server preferences for your Sun Java System Web Server.
Chapter 10, Controlling Access to Your Server describes how to specify who can access parts of your server.
Chapter 11, Using Log Files describes how to monitor your Sun Java System Web Server using the Hypertext Transfer Protocol (HTTP), by recording and viewing log files, or by using the performance monitoring tools provided with your operating system.
Chapter 12, Monitoring Servers describes how to monitor your Sun Java System Web Server using SNMP (Simple Network Management Protocol).
Chapter 13, Configuring Naming and Resources describes how you can configure Java Naming and Description Interface (JNDI) resources and include database connectivity on your server.

Managing Virtual Servers and Services

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

Chapter 14, Using Virtual Servers describes how to set up and administer virtual servers using your Sun Java System Web Server.
Chapter 15, Creating and Configuring Virtual Servers describes how you can create and configure individual virtual servers.
Chapter 16, Extending Your Server With Programs describes how to install Java applets, CGI programs, JavaScript applications, and other plug-ins onto your server.
Chapter 17, Content Management describes how you can configure and manage your server’s content.
Chapter 18, Applying Configuration Styles describes how to use configuration styles with Sun Java System Web Server.
Chapter 19, Using Search describes how to search the contents and attributes of documents on the server. In addition, this chapter describes how to create a customized text search interface that’s tailored to your user community.
Chapter 20, Web Publishing with WebDAV describes how you can configure a virtual server to use the WebDAV protocol that enables web publishing and in-place collaborative web authoring.

Appendixes

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

Appendix A, Command Line Utilities provides instructions for using command line utilities in place of the user interface screens.
Appendix B, Hypertext Transfer Protocol provides a short introduction to a few HTTP basic concepts.
Appendix C, ACL File Syntax describes the access-control list (ACL) files and their syntax.
Appendix D, Support for Internationalization and Localization describes the internationalized version of the Sun Java System Web Server.

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 6.1 SP12 manuals are available as online files in PDF and HTML formats at: http://docs.sun.com/app/docs/coll/1308.9

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	Sun Java System Web Server 6.1 SP12 Release Notes
Information about Sun Java System Web Server 6.1 FastCGI plug-in, including information about server application functions (SAFs), installation, configuration, technical notes, and pointers to additional resources.	Sun Java System Web Server 6.1 SP12 FastCGI Plug-in Release Notes
Information about Sun Java System Web Server 6.1 Reverse Proxy plug-in, including information about server application functions (SAFs), installation, configuration, technical notes, and pointers to additional resources.	Sun Java System Web Server 6.1 SP12 Reverse Proxy Plug-in 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)	Sun Java System Web Server 6.1 SP12 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	Sun Java System Web Server 6.1 SP12 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 SP11, 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 SP11.
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	Sun Java System Web Server 6.1 SP12 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	Sun Java System Web Server 6.1 SP12 Programmer’s Guide
Creating custom Netscape Server Application Programmer’s Interface (NSAPI) plugins	Sun Java System Web Server 6.1 SP12 NSAPI Programmer’s Guide
Implementing servlets and JavaServer Pages^TM (JSP^TM) technology in Sun Java System Web Server	Sun Java System Web Server 6.1 SP12 Programmer’s Guide to Web Applications
Editing configuration files	Sun Java System Web Server 6.1 SP12 Administrator’s Configuration File Reference
Tuning Sun Java System Web Server to optimize performance	Sun Java System Web Server 6.1 SP12 Performance Tuning, Sizing, and Scaling Guide

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/service/sunone/software
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

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 http://docs.sun.com and click Feedback.

Typographic Conventions

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

Table P–2 Typographic Conventions


Typeface	Meaning	Example
`AaBbCc123`	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.`
`AaBbCc123`	What you type, contrasted with onscreen computer output	`machine_name%` `su` `Password:`
`aabbcc123`	Placeholder: replace with a real name or value	The command to remove a file is `rm` `filename`.
AaBbCc123	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 shells that are included in the Solaris OS. Note that the default system prompt that is displayed in command examples varies, depending on the Solaris release.

Table P–3 Shell Prompts


Shell	Prompt
Bash shell, Korn shell, and Bourne shell	`$`
Bash shell, Korn shell, and Bourne shell for superuser	`#`
C shell	`machine_name%`
C shell for superuser	`machine_name#`