Sun Java System Messaging Server 6 2004Q2 Administration Guide |
About This Guide
This guide explains how to administer Sun Java System Messaging Server 6 and its accompanying software components. Messaging Server provides a powerful and flexible cross-platform solution to meet the email needs of enterprises and messaging hosts of all sizes using open Internet standards.
Topics covered in this chapter include:
Who Should Read This BookYou should read this book if you are responsible for administering and deploying Messaging Server at your site. You should also have read the Sun Java Messaging Server Deployment Planning Guide (http:/docs.sun.com/doc/817-6440/).
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)
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:
msg_svr_base/...
The Messaging Server Base (msg_svr_base) represents the directory path in which you install the server. The default value of the msg_svr_base is /opt/SUNWmsgsr.
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:
./configutil [options] [arguments]
It is possible to run the configutil command by itself or to list some or all configutil parameters and values:
./configutil
However, the presence of [options] and [arguments] indicate that there are additional optional parameters that may be added to the configutil command with the -p option to list all parameters with the prefix service.imap:
./configutil -p service.imap
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 InformationIn addition to this guide, Messaging Server comes 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:
Listed below are some of the documents that are available:
- Sun Java System Messaging Server Release Notes
- Sun Java System Messaging Server Administration Guide
- Sun Java System Messaging Server Administration Reference
- Sun Java System Communications Services Schema Reference Manual
- Sun Java System Communications Services Event Notification Service Manual
- Sun Java System Communications Express Administration Guide
- Sun Java System Messaging Server Developer’s Reference
The Sun Java System Messaging Server 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:
In addition to the software documentation, see the Sun Java System 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
Where to Find This Book OnlineYou can find the Sun Java System Messaging Server Administration Guide online in PDF and HTML formats. This book can be found at the following URL:
http://docs.sun.com/doc/817-6266