![]() | |
Sun Java System Communications Services User Management Utility 6 2004Q2 Administration Guide |
About This Guide
This guide explains how to configure and administer Sun Java System Communications Services User Management Utility. This guide also describes the User Management Utility commands, providing syntax and examples.
User Management Utility is 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 Identity Server.
Topics covered in this chapter include:
Who Should Read This BookYou should read this book if you are responsible for administering, configuring, and deploying User Management Utility at your site.
What You Need to KnowThis book assumes that you are responsible for administering the software and that you have a general understanding of the following:
How This Book is OrganizedThis book contains the following chapters and appendixes:
- About This Guide (this chapter)
- Planning for Installation and Configuration—describes the steps necessary to install and configure Sun Java System Communcations Services User Management Utility.
- Configuring User Management Utility—describes and steps through the configuration program for User Management Utility.
- Command Line Utilities—describes the commadmin utility, providing syntax and examples.
- Appendix—lists attribute values and time zone values for specific command-line options.
Document Conventions
- Monospaced font is used for any text that appears on the computer screen or text that you should type. It is also used for filenames, distinguished names, functions, and examples.
- Bold monospaced font is used to represent text within a code example that you should type. For example, you might see something like this:
For example, throughout this document you will see path references of the form:
is_cli_base/...
The User Management Utility Base (is_cli_base) represents the directory path in which you install User Management Utility. The default value of the is_cli_base is /opt/SUNWcomm.
Italicized font is also used for variables within the synopsis of a command line utility. For example, the synopsis for the commadmin admin remove command is:
commadmin admin remove -D login -l userid -n domain -w password [-d domain]
[-h] [-i inputfile] [-p port] [-X host] [-s] [-v]In the above example, the italicized words are arguments for their associated option. For example, in the -w password option, you would substitute the Administrator’s password for password when you enter the commadmin admin remove command.
./installer [options] [arguments]
It is possible to run the installer command by itself as follows to start the Messaging Server installation:
./installer
However, the presence of [options] and [arguments] indicate that there are additional optional parameters that may be added to the installer command. For example, you could use installer command with the -b option to specify the is_cli_base prior to running the installation program:
./installer -b /opt/SUNWcomm
- 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.
Where to Find Related InformationIn addition to this manual, Messaging Server and Calendar Server come with supplementary information for administrators as well as documentation for end users and developers. Use the following URL to see all the Messaging Server documentation:
http://docs.sun.com/coll/MessagingServer_04q2
Use the following URL to see all the Calendar Server documentation:
http://docs.sun.com/coll/CalendarServer_04q2
The Sun Java System product suite contains other products such as Console, Directory Server, and Administration Server. Documentation for these and other products can be found at the following URL:
http://docs.sun.com/db/prod/java.sys
Where to Find This Book OnlineYou can find the Sun Java System Communcations Services User Management Utility Administration Guide online in PDF and HTML formats. This book can be found at the following URL:
http://docs.sun.com/doc/817-5703
Related Third-Party Web Site ReferencesThird-party URLs may be referenced in this document and provide additional, related information.