| Sun ONE Messaging and Collaboration User Management Utility 1.0 Installation and Reference Guide |
About This Guide
This guide explains how to install and configure User Management Utility for Sun™ Open Net Environment (Sun ONE) Messaging and Collaboration. 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 ONE Messaging Server and Sun ONE Calendar Server using Sun ONE Identity Server 6.1.
Topics covered in this chapter include:
Who Should Read This BookYou should read this book if you are responsible for installing and deploying User Management Utility at your site.
What You Need to KnowThis book assumes that you are responsible for installing the Messaging Server 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 ONE Messaging and Collaboration 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 ConventionsMonospaced Font
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
Bold monospaced font is used to represent text within a code example that you should type. For example, you might see something like this:
./installer
In this example, ./installer is what you would type at the command line.
Italicized Font
Italicized font is used to represent text that you enter using information that is unique to your installation (for example, variables). It is used for server paths and names.
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.
Square or Straight Brackets
Square (or straight) brackets [] are used to enclose optional parameters. For example, in this document you will see the usage for the installer command described as follows:
./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
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.
Platform-specific Syntax
Note that the examples in this book use the UNIX C shell. If necessary, make appropriate adjustments to your preferred shell.
Where to Find Related InformationThe Sun ONE product suite contains other products such as Sun ONE 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/sunone
Where to Find This Book OnlineYou can find the Sun ONE Messaging and Collaboration User Management Utility Installation and Reference Guide online in PDF and HTML formats. This book can be found at the following URL:
http://docs.sun.com/db/prod/s1calsrv
