About This Guide


This Policy Agent Pack Guide offers an introduction to Sun™ ONE Identity Server Policy Agent and describes how to install URL policy agents on Web and Proxy Servers.

This preface contains the following sections:

• What You Are Expected to Know

• Sun ONE Identity Server Documentation Set

• What's in This Guide

• Documentation Conventions Used in This Manual

• Related Information

What You Are Expected to Know

---

This book is considered to be an auxiliary manual in the documentation series provided with Sun ONE Identity Server 5.1 (formerly known as iPlanet Directory Server Access Management Edition or DSAME). It is essential that you understand directory technologies and have some experience with Java and XML programming languages. You will get the most out of this guide if you are familiar with directory servers and Lightweight Directory Access Protocol (LDAP). Particularly, you should be familiar with Sun ONE Directory Server and the documentation provided with that product.

This guide is intended for use by IT professionals who manage access to their network through Sun ONE servers and services. The functionality contained in Sun ONE Identity Server allows you to manage user data and enforce access policies throughout your enterprise.

As you try to understand the concepts described in this guide, you should reference the Sun ONE Identity Server Installation and Configuration Guide and the Sun ONE Identity Server Programmer's Guide.

Sun ONE Identity Server Documentation Set

---

This book is considered an auxiliary manual in the documentation series provided with Sun ONE Identity Server. The Sun ONE Identity Server documentation set contains the following titles:

• Installation and Configuration Guide describes Sun ONE Identity Server and provides details on how to plan and install Sun ONE Identity Server on Solaris and Windows 2000 platforms.

• Administration Guide documents how to manage user and service data in an Sun ONE Identity Server system once it has been installed.

• Programmer's Guide documents how to customize DSAME interfaces.

• Sun ONE Identity Server Policy Agent Pack Guide (this guide) documents how to install Sun ONE Identity Server Policy Agent on Web and Proxy Servers.

• The Release Notes file gathers an assortment of information, including a description of what is new in this release, last minute installation notes, known problems and limitations, and how to report problems.

  
  

  ---

  Note	Be sure to check the Sun ONE Identity Server documentation web site for updates to the release notes and for revisions to the guides. http://docs.sun.com/db/coll/S1_s1IdServ_51

  ---

  
  

What's in This Guide

---

The following table lists all the Agents documented in this Guide.

Table 1    Agents Documented in this Guide

Agents	Platforms
iPlanet Web Server 6.0 SPx	Solaris 8
iPlanet Web Server 4.1 SP8	Solaris 8
iPlanet Proxy Server 3.6	Solaris 8
Microsoft IIS 5.0	Windows 2000
iPlanet Web Server 6.0 SP2	Windows 2000
Microsoft IIS 4.0	Windows NT 4.0
Apache 1.3.22 from Red Hat	Linux 7.2
Apache 1.3.26	Solaris 8 and 9
Lotus Domino 5.0.10	Windows 2000
Sun ONE Web Server 6.0 SPx	Solaris 9
IBM HTTP Server 4.0.3 AE	Solaris 8

Documentation Conventions Used in This Manual

---

In this guide, there are certain typographic and terminology conventions used to simplify discussion and to help you better understand the material. These conventions are described below.

Typographic Conventions

This book uses the following typographic conventions:

• Italic type is used within text for book titles, new terminology, emphasis, and words used in the literal sense.

• Monospace font is used for sample code and code listings, API and language elements (such as function names and class names), filenames, pathnames, directory names, HTML tags, and any text that must be typed on the screen.

• Italic serif font is used within code and code fragments to indicate variable placeholders. For example, the following command uses filename as a variable placeholder for an argument to the gunzip command:

  gunzip -d filename.tar.gz

Terminology

Below is a list of the general terms that are used in the Sun ONE Identity Server documentation set:

• DSAME refers to Sun ONE Identity Server and any installed instances of the Sun ONE Identity Server software.

• Policy and Management Services refers to the collective set of Sun ONE Identity Server components and software you have installed and running a dedicated web server. The dedicated web server is installed for you automatically when you install the Policy and Management Services.

• Web server that runs Sun ONE Identity Server services refers to the dedicated web server where the Policy and Management Servers are installed.

• Directory Server refers to an installed instance of Sun ONE Directory Server.

• Agent_Install_Dir is a variable placeholder for the directory where you have installed the URL Policy Agent.

• Web_Server_root is a variable placeholder for the home directory where you have installed Web Server.

• DSAME_Install_Dir is a variable placeholder for the home directory where you have installed Sun ONE Identity Server.

Related Information

---

In addition to the documentation provided with DSAME, you should be familiar with several other sets of documentation that can be used with this book. Of particular interest are Sun ONE Web Server and Sun ONE Proxy Server documentation sets. You can access these on the Internet at the following URLs:

Sun ONE Web Server Documentation
You can find the Sun ONE Web Server documentation at the following web site:

http://docs.sun.com/db/prod/s1websrv

Sun ONE Proxy Server Documentation
You can find the Sun ONE Proxy Server documentation at the following web site:

http://docs.sun.com/prod/s1.webproxys

Other Sun ONE Product Documentation
Documentation for all Sun ONE servers and technologies can be found at the following web site:

http://docs.sun.com