Sun Java System Web Proxy Server 4.0.2 2005Q4 Configuration File Reference

Preface

This guide describes how to configure and administer the Sun Java^TM System Web Proxy Server 4, formerly known as Sun ONE^TM Web Proxy Server and iPlanet^TM Web Proxy Server (and hereafter referred to as Sun Java System Web Proxy Server or just Proxy Server).

Who Should Use This Book

This guide is intended for information technology administrators in production environments. The guide assumes familiarity with the following:

Basic system administration tasks
Installing software
Using Web browsers
Issuing commands in a terminal window

How This Book Is Organized

The guide is divided into parts, each of which addresses specific areas and tasks. The following table lists the parts of the guide and their contents.

Table P–1 Guide Organization


Chapter	Description
Chapter 1, Basics of Server Operation	This chapter introduces the major configuration files that control the Sun Java System Web Proxy Server and describes how to activate and edit them.
Chapter 2, Server Configuration Elements in server.xml	This chapter discusses the server.xml file, which controls most aspects of server operation.
Chapter 3, Syntax and Use of magnus.conf	This chapter discusses the directives you can set in the magnus.conf file to configure the Sun Java System Web Proxy Server during initialization.
Chapter 4, Syntax and Use of obj.conf	This chapter discusses the SAFs you can set in the configuration file obj.conf to configure the Sun Java System Web Proxy Server during initialization.
Chapter 5, Predefined SAFs in obj.conf	This chapter describes the predefined SAFs used in the obj.conf file.
Chapter 6, MIME Types	This chapter discusses the MIME types file, which maps file extensions to file types.
Chapter 7, Other Server Configuration Files	This chapter lists other important configuration files and provides a quick reference of their contents.
Chapter 8, Configuration Changes Between iPlanet Web Proxy Server 3.6 and Sun Java System Web Proxy Server 4	This appendix describes the changes in configuration files between the iPlanet Web Proxy Server 3.6 and Sun Java System Web Proxy Server 4.
Chapter 9, Time Formats	This appendix describes the format strings used for dates and times in the server log.
Chapter 10, Server Configuration Elements	This chapter provide an alphabetical list for easy lookup of elements in server.xml and directives in magnus.conf.
Chapter 11, List of Predefined SAFs	This chapter provide an alphabetical list for easy lookup of directives in obj.conf.

Related Books

The Sun documents that are related to this manual are:

Sun Java System Web Proxy Server 4.0.2 Release Notes
Sun Java System Web Proxy Server 4.0.2 Installation and Migration Guide
Sun Java System Web Proxy Server 4.0.2 Administration Guide
Sun Java System Web Proxy Server 4.0.2 NSAPI Developer's Guide

The following table lists the tasks and concepts described in guide.

Table P–2 Proxy Server Documentation


For Information About	See
Late-breaking information about the software and documentation	Release Notes
Performing installation and migration tasks: Supported platforms and environments Installing Sun Java System Web Proxy Server Migrating from version 3.6 to version 4	Installation and Migration Guide
Performing administration and management tasks: Using the Administration and command-line interfaces Configuring server preferences Managing users and groups Monitoring and logging server activity Using certificates and public key cryptography to secure the server Controlling server access Proxying and routing URLs Caching Filtering content Using a reverse proxy Using SOCKS Tuning the Proxy Server to optimize performance	Administration Guide (and the online Help included with the product)
Creating custom Netscape Server Application Developer’s Interface (NSAPI) plugins	NSAPI Programmer’s Guide

Related Third-Party Web Site References

Third-party URLs are referenced in this document and provide additional, related information.

Note –

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

Feedback

Sun is interested in improving its documentation and welcomes your comments and suggestions. To share your comments, go to http://docs.sun.com/app/docs and click “Send comments.” Be sure to provide the document title and part number in the online form.

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–3 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 the C shell, Bourne shell, and Korn shell.

Table P–4 Shell Prompts


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