Sun ONE Messaging Server 6.0 Reference Manual |
About This Guide
This manual provides reference information about the Beta version of Sun Open Net Environment (Sun ONE) Messaging Server product. Messaging Server provides a powerful and flexible cross-platform solution to the email needs of enterprises and messaging hosts of all sizes using open Internet standards.
Use this manual as a companion to the Messaging Server Administrator’s Guide. The administrator’s guide describes how to configure, maintain, monitor, and troubleshoot Messaging Server. The reference manual provides information about command-line utilities and configuration files. This information enables you to configure, maintain, monitor, and troubleshoot Messaging Server.
Topics covered in this chapter include:
Who Should Read This BookThis manual is intended for highly or moderately technical network administrators with experience in UNIX® or Windows NT. These administrators will be configuring, administering, and maintaining Messaging Server. Architects and developers may also use the Messaging Server Reference Manual. This manual is not intended for end users.
What You Need to KnowThis book assumes that you are responsible for configuring, administering, and maintaining the Messaging Server software and that you have a general understanding of the following:
How This Book is OrganizedThis book contains the following chapters:
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.
Italicized Font
Italicized font is used to represent text that you enter using information that is unique to your messaging server. It is used for server paths and names and account IDs.
For example, throughout this document you will see path references of the form:
msg_svr_base/...
In these situations, msg_svr_base represents the directory path in which you install the server. For example, if you install your server in the directory /opt/SUNWmsgsr, then msg_svr_base refers to /opt/SUNWmsgsr.
Italicized font is also used for variables within the synopsis of a command line utility. For example, the synopsis for the imadmin admin remove command is:
imadmin admin remove -D login -l userid -n domain -w password [-d domain]
[-h] [-i inputfile] [-p idaport] [-X idahost] [-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 Top-Level Administrator’s password for password when you enter the imadmin admin remove command.
Square or Straight Brackets
Square (or straight) brackets [] are used to enclose optional parameters. For example, in this manual you will see the usage for the readership command described as follows:
readership [-d days] [-p months]
It is possible to run the readership command by itself as follows to start the Messaging Server installation:
readership
However, the presence of [-d days] and [-p months] indicate that there are additional optional parameters that may be added to the readership command. For example, you could use readership command with the -d option to count the number of people who have read messages in a shared folder within the indicated number of days:
readership -d 10
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 environment 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.
All paths specified in this manual are in UNIX format. If you are using a Windows 2000-based Messaging Server, you should assume the Windows 2000 equivalent file paths whenever UNIX file paths are shown in this book.
Related Third-Party Web Site ReferencesNote - 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 by or in connection with the use of or reliance on any such content, goods, or services that are available on or through such sites or resources.
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:
http://docs.sun.com/db/prod/s1msgsrv
Listed below are the additional documents that are available:
- Sun ONE Messaging Server Installation Guide for Solaris
- Sun ONE Messaging Server Release Notes
- Sun ONE Messaging Server Administrator’s Guide
- Messaging Server Reference Manual
- Sun ONE Messaging and Collaboration Schema Reference Manual
- Sun ONE Messaging and Collaboration Event Notification Service Manual
- Sun ONE Messaging Server Messenger Express Customization Guide
- Sun ONE Messaging Server MTA SDK Programmer’s Reference Manual
The Sun ONE 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:
http://docs.sun.com/db/prod/sunone
In addition to the software documentation, see the Sun ONE 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 Messaging Server Reference Manual online in PDF and HTML formats. To find this book, use this URL:
http://docs.sun.com/db/prod/s1msgsrv