Sun Java System Communications Services 6 2005Q4 Delegated Administrator Guide

Preface

This guide explains how to configure and administer Sun TMSun Java System Communications Services 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.

Topics covered in this chapter include:

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:

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 Communications Services 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. 

Related Books

The http://docs.sun.comSM 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:

The Messaging Server product suite contains other products such as Sun JavaTM System Directory Server and Administration Server. Documentation for these and other products can be found at the following URL:

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

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:

Communications Services Documents

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

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

or

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

The following documents are available:

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.


Documentation, Support, and Training

Sun Function 

URL 

Description 

Documentation 

http://www.sun.com/documentation/

Download PDF and HTML documents, and order printed documents 

Support and Training 

http://www.sun.com/supportraining/

Obtain technical support, download patches, and learn about Sun courses 

Accessing Sun Resources Online

For product downloads, professional services, patches and support, and additional developer information, go to the following:

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.

Typographic Conventions

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

Table P–2 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–3 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 

#

Symbols

The following table describes the symbol conventions used in this book.

Table P–4 Symbol Conventions

Symbol  

Description  

Example  

Meaning  

[ ]

Contains optional 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.

-

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. 

Default Paths and File Names

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

Table P–5 Default Paths and File Names

Term  

Description  

msg_svr_base

Represents the base installation directory for Messaging Server. The default value of the msg_svr_base installation is as follows:

Solaris TM systems: /opt/SUNWmsgsr

Linux systems: /opt/sun/messaging

da_base

Represents the base installation directory for Delegated Administrator. The default value of the da_base installation is as follows:

Solaris TM systems: /opt/SUNWcomm

Linux systems: /opt/sun/comms/commcli

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 book or at the top of the document. For example, the title of this book is Sun Java System Communications Services 2005Q4 Delegated Administrator Guide, and the part number is 819-2658.