Preface

This guide explains how to administer the Sun Java^TM System Messaging Server 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.

Who Should Use This Book

You 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 Communications Suite 5 Deployment Planning Guide.

Before You Read This Book

This book assumes that you are responsible for installing the Messaging Server software and that you have a general understanding of the following:

• The Internet and the World Wide Web

• Messaging Server protocols

• Sun Java System Directory Server and LDAP

• System administration and networking

• General deployment architectures

How This Book Is Organized

This manual contains the following chapters and appendix:

Table P–1 How This Book Is Organized

Chapter	Description
Preface	General information about using this book.
Chapter 1, Messaging Server Command-line Utilities	Describes the Messaging Server command-line utilities.
Chapter 2, Message Transfer Agent Command-line Utilities	Describes the MTA command-line utilities.
Chapter 3, Messaging Server Configuration	Describes the configutil parameters.
Chapter 4, MTA Configuration	Describes MTA configuration files and options.
Chapter 5, Messaging Multiplexor Configuration	Describes the MMP configuration files and options.
Appendix A, Supported Standards	Lists the standards supported by the Messaging Server.

Messaging Server Documentation Set

The following table summarizes the books included in the Messaging Server core documentation set.

Table P–2 Messaging Server Documentation

Document Title	Contents
Chapter 3, Sun Java System Messaging Server 6.3 Release Notes, in Sun Java Communications Suite 5 Release Notes	Contains important information available at the time of release of Sun Java System Messaging Server 6.3
Sun Java System Messaging Server 6.3 Administration Guide	Explains how to administer Messaging Server and its accompanying software components.
Sun Java System Messaging Server 6 2005Q4 MTA Developer’s Reference	Describes the Messaging Server Message Transfer Agent (MTA) Software Development Kit (SDK) and Callable Send facility.
Sun Java System Messenger Express 6 2005Q4 Customization Guide	Explains how to customize the look and feel of Sun Java System Messenger Express. Although the product architecture permits an almost unlimited customization of the static portion of the pages served by the Messenger Express HTTP daemon, this guide focuses on how to perform the most commonly requested customizations.

In addition, use the following URL to see the documentation that applies to all Communications Services products:

http://docs.sun.com/coll/1312.1

Related Books

The http://docs.sun.com web site enables you to access Sun technical documentation online. You can browse the archive or search for a specific book title or subject.

For other server documentation related to deploying Messaging Server, go to the following:

• Access Manager documentation: http://docs.sun.com/app/docs/coll/1292.1

• Calendar Server documentation: http://docs.sun.com/app/docs/coll/1313.1

• Communications Express documentation: http://docs.sun.com/app/docs/coll/1312.1

• Directory Server documentation: http://docs.sun.com/app/docs/coll/1316.1

• Instant Messaging documentation: http://docs.sun.com/app/docs/coll/1309.1

• Messaging Server documentation: http://docs.sun.com/app/docs/coll/1312.1

Default Path and File Names

The following table describes the default path and file name that are used in this book.

Table P–3 Default Paths and File Names

Placeholder	Description	Default Value
msg-svr-base	Represents the base installation directory for Messaging Server. The Messaging Server 6 .3 default base installation and product directory depends on your specific platform.	Solaris systems: /opt/SUNWmsgsr Linux systems: /opt/sun/messaging

Typographic Conventions

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

Table P–4 Typographic Conventions

Typeface	Meaning	Example
AaBbCc123	The names of commands, files, and directories, and onscreen computer output	Edit your .login file. Use ls -a to list all files. machine_name% you have mail.
AaBbCc123	What you type, contrasted with onscreen computer output	machine_name% su Password:
AaBbCc123	A placeholder to be replaced with a real name or value	The command to remove a file is rm filename.
AaBbCc123	Book titles, new terms, and terms to be emphasized (note that some emphasized items appear bold online)	Read Chapter 6 in the User's Guide. A cache is a copy that is stored locally. Do not save the file.

Shell Prompts in Command Examples

The following table shows default system prompts and superuser prompts.

Table P–5 Shell Prompts

Shell	Prompt
C shell on UNIX and Linux systems	machine_name%
C shell superuser on UNIX and Linux systems	machine_name#
Bourne shell and Korn shell on UNIX and Linux systems	$
Bourne shell and Korn shell superuser on UNIX and Linux systems	#
Microsoft Windows command line	C:\

Symbol Conventions

The following table explains symbols that might be used in this book.

Table P–6 Symbol Conventions

Symbol	Description	Example	Meaning
[ ]	Contains optional arguments and 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.
${ }	Indicates a variable reference.	${com.sun.javaRoot}	References the value of the com.sun.javaRoot variable.
-	Joins simultaneous multiple keystrokes.	Control-A	Press the Control key while you press the A key.
+	Joins consecutive multiple keystrokes.	Ctrl+A+N	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.

Accessing Sun Resources Online

The docs.sun.com web site enables you to access Sun technical documentation online. You can browse the docs.sun.com archive or search for a specific book title or subject. Books are available as online files in PDF and HTML formats. Both formats are readable by assistive technologies for users with disabilities.

To access the following Sun resources, go to http://www.sun.com:

• Downloads of Sun products

• Services and solutions

• Support (including patches and updates)

• Training

• Research

• Communities (for example, Sun Developer Network)

Third-Party Web Site References

Third-party URLs are referenced in this document and provide additional, related information.

---

Note –

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 http://docs.sun.com and click Send Comments. In the online form, provide the full document title and part number. The part number is a 7-digit or 9-digit number that can be found on the book's title page or in the document's URL. For example, the part number of this book is 819-4429-10.