Sun Java logo     Previous      Contents      Index      Next     

Sun logo
Sun Java System Communications Services 6 2005Q1 Delegated Administrator Guide 


This guide explains how to configure and administer Sun™ 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 1  How This Book Is Organized 



Chapter 1, “Delegated Administrator Overview”

Describes the directory organizations, administrator roles, and Class of 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, "ACI Consolidation"

Describes how to consolidate ACIs and remove unused ACIs from the directory.

Conventions Used in This Book

The tables in this section describe the conventions used in this book.

Typographic Conventions

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

Table 2  Typographic Conventions 





Any text that appears on the computer screen or text that you should type. Can be API and language elements, HTML tags, web site URLs, command names, file names, directory path names, onscreen computer output, sample code.

Edit your.login file.

Use ls -a to list all files.

% You have mail.

(Monospace bold)

Text that you should type when it appears within a code example or other onscreen computer output.

% su


A placeholder in a command or path name that you should replace with a real name or value (for example, a variable).

Also can be a book title, new term, or word to be emphasized.

The file is located in the msg_svr_base/bin directory.

Read Chapter 6 in the User’s Guide.

These are called class options.

Do not save the file.


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

Table 3  Symbol Conventions 





[ ]

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.


Press the Control key while you press the A key.


Joins consecutive multiple keystrokes.


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 4  Default Paths and File Names




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

Solaris™ systems: /opt/SUNWmsgsr

Linux systems: /opt/sun/messaging


Represents the base installation directory for Delegated Administrator. The Delegated Administrator Base (da_base) represents the directory path in which you install Delegated Administrator. The default value of the da_base is /opt/SUNWcomm.

Command Line Prompts

Command line prompts (for example, % for a C-Shell, or $ for a Korn or Bourne shell) are not displayed in the examples. Depending on which operating system you are using, you will see a variety of different command line prompts. However, you should enter the command as it appears in the document unless specifically noted otherwise.

Related Documentation

The 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:

The following documents are available:

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

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:

Calendar Server Documents

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

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:


The following documents are available:

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

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 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 2005Q1 Delegated Administrator Guide, and the part number is 819-0114-10.

Previous      Contents      Index      Next     

Part No: 819-0114-10.   Copyright 2005 Sun Microsystems, Inc. All rights reserved.