Preface

This guide explains how to configure and administer Sun^TM Java System Delegated Administrator. This guide also describes the Delegated Administrator commands, providing syntax and examples.

Delegated Administrator consists of a console (graphical user interface) and a set of command-line tools for provisioning users, groups, domains, and resources for Sun Java System Messaging Server and Sun Java System Calendar Server using Sun Java System Access Manager.

Who Should Use This Book

You should read this book if you are responsible for administering, configuring, and deploying Delegated Administrator at your site.

Before You Read This Book

This book assumes that you are responsible for administering the software and that you have a general understanding of the following:

• The Internet and the World Wide Web

• Messaging Server protocols

• Sun Java System Administration Server

• Sun Java System Directory Server and LDAP

• Sun Java System Console

• System administration and networking on the following platforms:

  • Solaris 10 for SPARC and x86

  • Solaris 9 for SPARC and x86

  • Red Hat Enterprise Linux 4.0 or any RHEL 4 Update

  • Red Hat Enterprise Linux 3.0 or any RHEL 3 Update

  General deployment architectures

How This Book Is Organized

The following table summarizes the content of this book.

Table P–1 How This Book Is Organized

Chapter	Description
Chapter 1, Delegated Administrator Overview	Describes the directory organizations, administrator roles, and service packages provided by Delegated Administrator
Chapter 2, Planning for Installation and Configuration	Describes the steps necessary to install and configure Sun Java System Delegated Administrator.
Chapter 3, Configuring Delegated Administrator	Describes and steps through the configuration program for Delegated Administrator.
Chapter 4, Customizing Delegated Administrator	Describes how to customize Delegated Administrator—for example, to change the look and feel of the console.
Chapter 5, Command Line Utilities	Describes the commadmin utility, providing syntax and examples.
Appendix A, Service Provider Administrator and Service Provider Organizations	Describes the Service Provider Administrator role and provider and business organizations managed by the Service Provider Administrator.
Appendix B, Attribute Values and Calendar Time Zones	Lists attribute values and time zone values for specific command-line options.
Appendix C, Debugging Delegated Administrator	Lists log files that can be examined to debug Delegated Administrator.
Appendix D, Delegated Administrator Performance Tuning	Offers tuning tips for Delegated Administrator, the Web containers, and Directory Server that improve Delegated Administrator performance.
Appendix E, Consolidating ACIs for Directory Server Performance	Describes how to consolidate ACIs and remove unused ACIs from the directory.

Communications Suite Documentation Set

The http://docs.sun.com^SM web site enables you to access Sun technical documentation online. You can browse the archive or search for a specific book title or subject.

Messaging Server Documents

Use the following URL to see all the Messaging Server documentation:

http://docs.sun.com/coll/1312.1

The following documents are available:

• Sun Java System Messaging Server Administration Guide

• Sun Java System Messaging Server Administration Reference

• Sun Java System Messaging Server MTA Developer’s Reference

The Messaging Server product suite contains other products such as Sun Java^TM System Directory Server. Documentation for these and other products can be found on the docs.sun.com web site.

In addition to the software documentation, see the Messaging Server Software Forum for technical help on specific Messaging Server product questions. The forum can be found at the following URL:

http://swforum.sun.com/jive/forum.jsp?forum=15

Calendar Server Documents

Use the following URL to see all the Calendar Server documentation:

http://docs.sun.com/coll/1313.1

The following documents are available:

• Sun Java System Calendar Server Administration Guide

• Sun Java System Calendar Server Developer’s Guide

Communications Suite Documents

Use either one of the following URLs to see the documentation that applies to all Communications Suite products:

http://docs.sun.com/coll/1312.1

or

http://docs.sun.com/coll/1313.1

The following documents are available:

• Sun Java Communications Suite Installation Guide

• Sun Java Communications Suite Upgrade Guide

• Sun Java Communications Suite Release Notes

• Sun Java System Delegated Administrator Administration Guide

• Sun Java Communications Suite Deployment Planning Guide

• Sun Java Communications Suite Schema Migration Guide

• Sun Java Communications Suite Schema Reference

• Sun Java Communications Suite Event Notification Service Guide

• Sun Java System Communications Express Administration Guide

• Sun Java System Communications Express Customization Guide

Default Paths and File Names

The following table describes the default paths and file names used in this book.

Table P–2 Default Paths and File Names

Placeholder	Description	Default Value
msg-svr-base	Represents the base installation directory for Messaging Server.	Solaris systems: /opt/SUNWmsgsr Linux systems: /opt/sun/messaging
da-base	Represents the base installation directory for Delegated Administrator.	Solaris systems: /opt/SUNWcomm Linux systems: /opt/sun/comms/commcli

Typographic Conventions

The following table describes the typographic changes 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	A placeholder to be replaced 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 (note that some emphasized items appear bold online)	Read Chapter 6 in the User's Guide. A cache is a copy that is stored locally. Do not save the file.

Shell Prompts in Command Examples

The following table shows default system prompts and superuser prompts.

Table P–4 Shell Prompts

Shell	Prompt
C shell on UNIX and Linux systems	machine_name%
C shell superuser on UNIX and Linux systems	machine_name#
Bourne shell and Korn shell on UNIX and Linux systems	$
Bourne shell and Korn shell superuser on UNIX and Linux systems	#
Microsoft Windows command line	C:\

Symbol Conventions

The following table explains symbols that might be used in this book.

Table P–5 Symbol Conventions

Symbol	Description	Example	Meaning
[ ]	Contains optional arguments and command options.	ls [-l]	The -l option is not required.
{ | }	Contains a set of choices for a required command option.	-d {y|n}	The -d option requires that you use either the y argument or the n argument.
${ }	Indicates a variable reference.	${com.sun.javaRoot}	References the value of the com.sun.javaRoot variable.
-	Joins simultaneous multiple keystrokes.	Control-A	Press the Control key while you press the A key.
+	Joins consecutive multiple keystrokes.	Ctrl+A+N	Press the Control key, release it, and then press the subsequent keys.
->	Indicates menu item selection in a graphical user interface.	File -> New -> Templates	From the File menu, choose New. From the New submenu, choose Templates.

Documentation, Support, and Training

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

• Documentation (http://www.sun.com/documentation/)

• Support (http://www.sun.com/support/)

• Training (http://www.sun.com/training/)

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.

---

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 full document title and part number. The part number is a 7-digit or 9-digit number that can be found on the book's title page or in the document's URL. For example, the part number of this book is 819-4438.