Preface
The Sun JavaTM System Access Manager Policy Agent 2.2 Guide for Sun Java System Application Server 8.2/9.0/9.1 is a Java 2 Platform Enterprise Edition (J2EE) agent guide that provides general information about J2EE agents in the Policy Agent 2.2 software set. This guide also provides specific information about Sun Java System Access Manager Policy Agent for Application Server 8.2/9.0/9.1.
For support and compatibility information specific to this J2EE agent, see Supported Platforms and Compatibility of Agent for Application Server 8.2/9.0/9.1.
Included in this guide is information about installing, configuring, uninstalling, and troubleshooting J2EE agents, again with the focus being on Agent for Application Server 8.2/9.0/9.1.
Topics in this preface include:
Who Should Use This Book
This Sun Java System Access Manager Policy Agent 2.2 Guide for Sun Java System Application Server 8.2/9.0/9.1 is intended for use by IT professionals who manage access to their network using Sun Java System servers and software. Administrators should understand the following technologies:
-
Directory technologies
-
JavaServer PagesTM (JSP) technology
-
HyperText Transfer Protocol (HTTP)
-
HyperText Markup Language (HTML)
-
eXtensible Markup Language (XML)
-
J2EE technologies
-
Enterprise Java Beans (EJB)
Before You Read This Book
Sun Java System Policy Agent software works with Sun Java System Access Manager. Both products work with Sun Java Enterprise System, a software infrastructure that supports enterprise applications distributed across a network or Internet environment. Furthermore, Sun Java System Directory Server is a necessary component in a new Access Manager deployment since it is used as the data store. To understand how these products interact and to understand this book, you should be familiar with the following documentation:
-
Sun Java Enterprise System documentation set, which can be accessed online at http://docs.sun.com. All Sun technical documentation is available online through this web site, including the other documentation sets referred to in this list.
You can browse the documentation archive or search for a specific book title, part number, or subject.
-
Sun Java System Directory Server documentation set.
-
Sun Java System Access Manager documentation set, which is explained in more detail subsequently in this chapter.
-
Sun Java System Access Manager Policy Agent 2.2 documentation set, which is explained in more detail subsequently in this chapter.
Related Books
Sun Microsystems server documentation sets, some of which are mentioned in this preface, are available at http://docs.sun.com. These documentation sets provide information that can be helpful for a deployment that includes Policy Agent.
Access Manager Documentation Set
The following table describes the Access Manager documentation set, which is available on the following Web site:
http://docs.sun.com/coll/1292.2
Table P–1 Access Manager 7.1 Documentation Set|
Title |
Description |
|---|---|
|
Contains links to commonly referenced information in the Access Manager documentation collection. |
|
|
Describes new features, problems fixed, installation notes, and known issues and limitations. The Release Notes are updated periodically after the initial release to describe any new features or problems. |
|
|
Provides an overview of how Access Manager components work together to consolidate access control functions, and to protect enterprise assets and web-based applications. It also explains basic Access Manager concepts and terminology. |
|
|
Sun Java System Access Manager 7.1 Deployment Planning Guide |
Provides planning and deployment solutions for Access Manager based on the solution life cycle. |
|
Provides information about configuring Access Manager after installation. Usually, you perform postinstallation tasks only a few times. For example, you might want to deploy an additional instance of Access Manager or configure Access Manager for session failover. |
|
|
Describes how to use the Access Manager console as well as manage user and service data via the command line interface. |
|
|
Provides reference information for the Access Manager command-line interface (CLI), configuration attributes, AMConfig.properties attributes, serverconfig.xml file attributes, log files, and error codes. |
|
|
Sun Java System Access Manager 7.1 Federation and SAML Administration Guide |
Provides information about the Federation module based on the Liberty Alliance Project specifications. It includes information on the integrated services based on these specifications, instructions for enabling a Liberty-based environment, and summaries of the application programming interface (API) for extending the framework. |
|
Provides information about customizing Access Manager and integrating its functionality into an organization’s current technical infrastructure. It also contains details about the programmatic aspects of the product and its API. |
|
|
Provides summaries of data types, structures, and functions that make up the public Access Manager C APIs. |
|
|
Provides information about the implementation of Java packages in Access Manager. |
|
|
Provides information about how to tune Access Manager and its related components for optimal performance. |
|
|
Sun Java System Access Manager Policy Agent 2.2 User’s Guide |
Provides an overview of Policy Agent software, including the web agents and J2EE agents that are currently available. To view the Access Manager Policy Agent 2.2 documentation collection, see: |
Policy Agent 2.2 Documentation Set
Other Policy Agent guides, besides this guide, are available as described in the following sections:
Sun Java System Access Manager Policy Agent 2.2 User's Guide
The Sun Java System Access Manager Policy Agent 2.2 User's Guide is available in two documentation sets: the Access Manager documentation set as described in Table P–2 and in the Policy Agent 2.2 documentation set as described in this section.
Other Individual Agent Guides
The individual agents in the Policy Agent 2.2 software set, of which this book is an example, are available on a different schedule than Access Manager itself. Therefore, documentation for Access Manager and Policy Agent are available in separate sets, except for the Sun Java System Access Manager Policy Agent 2.2 User's Guide, which is available in both documentation sets.
The documentation for the individual agents is divided into two subsets: a web agent subset and a J2EE agent subset.
Each web agent guide in the Policy Agent 2.2 software set provides general information about web agents and installation, configuration, and uninstallation information for a specific web agent.
Each J2EE agent guide in the Policy Agent 2.2 software set provides general information about J2EE agents and installation, configuration, and uninstallation information for a specific J2EE agent.
The individual agent guides are listed along with supported server information in the following chapters of the Sun Java System Access Manager Policy Agent 2.2 User's Guide:
- Web Agents
- J2EE Agents
Release Notes
The Sun Java System Access Manager Policy Agent 2.2 Release Notes are available online after an agent or set of agents is released. The release notes include a description of what is new in the current release, known problems and limitations, installation notes, and how to report issues with the software or the documentation.
Sun Java Enterprise System Product Documentation
The following table provides links to documentation collections for related Java ES products.
Table P–2 Related Sun Java Enterprise System 5 Documentation|
Product |
Link |
|---|---|
|
Sun Java Enterprise System 5 | |
|
Sun Java System Directory Server Enterprise Edition 6 | |
|
Sun Java System Web Server 7 | |
|
Sun Java System Application Server 9.1 | |
|
Sun Java System Application Server 9.0 | |
|
Sun Java System Message Queue 3.7 UR1 | |
|
Sun Java System Web Proxy Server 4.0.4 | |
|
Sun Java System Identity Manager 7 |
Accessing Sun Resources Online
For product downloads, professional services, patches and support, and additional developer information, go to the following:
- Download Center
- Sun Java System Services Suite
- Sun Enterprise Services, Solaris Patches, and Support
- Developer Information
Contacting Sun Technical Support
If you have technical questions about this product that are not answered in the product documentation, go to:
http://www.sun.com/service/contacting
Related Third-Party Web Site References
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.
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 Send Comments. In the online form, provide the document title and part number. The part number is a seven-digit or nine-digit number that can be found on the title page of the guide or at the top of the document.
For example, the title of this guide is Sun Java System Access Manager Policy Agent 2.2 Guide for Sun Java System Application Server 8.2/9.0/9.1, and the part number is 820-2539-11.
Documentation, Support, and Training
|
Sun Function |
URL |
Description |
|---|---|---|
|
Documentation |
Download PDF and HTML documents, and order printed documents |
|
|
Support and Training |
Obtain technical support, download patches, and learn about Sun courses |
Typographic Conventions
The following table describes the typographic changes that are used in this book.
Table P–3 Typographic Conventions|
Typeface or Symbol |
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. Perform a patch analysis. Do not save the file. [Note that some emphasized items appear bold online.] |
Shell Prompts in Command Examples
The following table shows the default system prompt and superuser prompt for the C shell, Bourne shell, and Korn shell.
Table P–4 Shell Prompts|
Shell |
Prompt |
|---|---|
|
C shell prompt |
machine_name% |
|
C shell superuser prompt |
machine_name# |
|
Bourne shell and Korn shell prompt |
$ |
|
Bourne shell and Korn shell superuser prompt |
# |
- © 2010, Oracle Corporation and/or its affiliates