Preface

SIMS System Administration Guide begins where SIMS Installation Guide ends. Use this guide in conjunction with SIMS Reference Manual to fine-tune the default configuration, and to maintain, monitor, and troubleshoot your mail server after installing the software and loading the user and distribution lists from your existing email system.

SIMS User Registration

Register as a user of the Sun Internet Mail Server 4.0 (SIMS) to receive information about new releases, upgrade offers, and promotions. To register, press the Registration button at the Administration Console login page. Fill in the form requesting your name, address, email address, and other information, and press Send. When Sun receives the completed registration form, you will receive an email acknowledgment. You must provide an email address in order to receive a confirmation notice.

Error Conditions

Registration errors are rare, but Table P-1 describes the possible error messages and the required action.

TABLE P-1 Registration Error Conditions and Required Action
Error Message
Required Action

"The server could not set a locale to encode the mail. There was no locale supplied and the server could not set the default properly."

Make sure that you start registration from the Admin Console screen.

"The server could not obtain the <LOCALE> locale that you registered from to properly format the mail. It is necessary to have the same locale installed on the server that you registered from."

Either make sure the locale installed on server is the same as the locale you are registering from on your client, or type in registration in us-ascii.

"The mail program on the server could not be opened."

There was an error involving the sendmail program. Make sure that /usr/lib/sendmail is on your system and properly configured.

"There was not enough memory to process the mail."

You've run out of swap space. Shut down applications or increase swap and try again.

**TABLE P-1** Registration Error Conditions and Required Action
Error Message	Required Action
"The server could not set a locale to encode the mail. There was no locale supplied and the server could not set the default properly."	Make sure that you start registration from the Admin Console screen.
"The server could not obtain the <LOCALE> locale that you registered from to properly format the mail. It is necessary to have the same locale installed on the server that you registered from."	Either make sure the locale installed on server is the same as the locale you are registering from on your client, or type in registration in us-ascii.
"The mail program on the server could not be opened."	There was an error involving the sendmail program. Make sure that /usr/lib/sendmail is on your system and properly configured.
"There was not enough memory to process the mail."	You've run out of swap space. Shut down applications or increase swap and try again.

Who Should Use This Book

This book is intended for two audiences:

Highly technical network administrators who are experienced in working with Solaris^TM systems and who manage a network comprised of Sun^TM workstations, personal computers (PCs), Macintoshes, or IBM mainframes that share resources. This network administrator has previous experience planning, installing, configuring, maintaining, and troubleshooting an enterprise email system.

Moderately technical network administrators with some Solaris experience who manage a network that includes Sun workstations, PCs, and Macintoshes that share resources. This network administrator may not have previous experience planning, installing, configuring, maintaining, and troubleshooting an email system.

Before You Read This Book

Before performing the tasks described in this book, you should have installed the mail server software and loaded the users and distribution lists from your existing email system if applicable per information provided in the Sun Internet Mail Server 4.0 Installation Guide.

How This Book Is Organized

Chapter 1, "SIMS Administration Road Map," provides an approach to thinking about SIMS administration.

Chapter 2, "The SIMS Administration Console Overview," provides overview information on the Administration Console as well as a road map for Admin Console documentation.

Chapter 3, "User/Group Management" describes how to add, delete, or modify user, group, or organizational units in the Directory Service.

Chapter 4, "Hosted Domains" describes how to create, delete, and modify hosted domains, how to create and remove hosted domain delegated administrators, and how to customize the Delegated Admin Console.

Chapter 5, "Internet Message Transport Agent (IMTA) Administration" provides step-by-step instructions for changing the message transport characteristics of SIMS.

Chapter 6, "IMTA Security and Unsolicited Bulk Email (UBE) Handling

Chapter 7, "Message Store Administration" describes step-by-step instructions for changing the Sun Message Store characteristics of SIMS.

Chapter 8, "Sun Directory Services Administration" provides limited information on directory services. References Sun and Netscape Directory Services documentation.

Chapter 9, "Populating SIMS with Users and Groups" describes how to populate users and groups from your current directory database to the SIMS directory.

Chapter 10, "Secure Sockets Layer (SSL) Support in SIMS," describes how to use the SSL security features supported by SIMS.

Chapter 11, "SIMS Periodic Maintenance Procedures," provides procedures and background concepts that enable you to perform scheduled or as-needed maintenance.

Chapter 12, "SIMS Monitoring and Logging" describes SIMS monitoring and logging.

Chapter 13, "SIMS Troubleshooting," describes tools that enable you to troubleshoot your mail server, and provides some troubleshooting procedures.

Appendix A, "Configuring SIMS as a Proxy Message Access Server,"describes SIMS message access proxy.

Appendix B, "Replication Configuring--Examples," provides examples of how to configure replication.

Appendix B, "Migrating Mailboxes from /var/mail to SIMS" describes how to migrate mailboxes from /var/mai/ to SIMS.

Appendix C, "Populating the Directory Examples," describes three examples of populating the directory.

Appendix D, "Error Messages" lists error messages and the appropriate actions.

"Glossary" lists words and phrases found in this book and their definitions.

Related Information

The following books are related to Sun Internet Mail Server 4.0. Included in this documentation set are:

Sun Internet Mail Server 4.0 Concepts Guide - Provides a conceptual understanding of the SIMS product. By understanding how SIMS works on a conceptual level, readers will more easily understand the administrative tasks described in the SIMS System Administration Guide and SIMS Reference Manual.

Sun Internet Mail Server 4.0 Provisioning Guide - Describes how to provision the SIMS LDAP directory with users, distribution lists, administrators, and domains by creating and importing LDIF records.

Sun Internet Mail Server 4.0 Advanced Installation Guide - Describes the planning and installation procedures for the Sun Internet Mail Server (SIMS) 3.5 software on Solaris SPARC and Intel-based x86 systems. In particular, it describes the installation of the software using the Graphical User Interface (GUI).

Sun Internet Mail Server 4.0 Administrator's Guide - Describes how to fine-tune the default configuration, and maintain, monitor, and troubleshoot your mail server using the Administration Console, a GUI.

Sun Internet Mail Server 4.0 Reference Manual - Provides in-depth information about Sun Internet Mail Server. Many administrative functions can also be accomplished through command line utilities. Other advanced functions can be accomplished only through these utilities and by editing configuration files.

Sun Internet Mail Server 4.0 Delegated Management Guide - Describes the SIMS Delegated Management Console and the tasks associated with the console. In particular, it describes how a delegated administrator for a hosted domain performs tasks on users and distribution lists.

Reference manual pages (man pages) - Describes command-line utilities and detailed information about the arguments and attributes relevant to each command.

Sun Directory Services 3.1 Administration Guide (http://docs.sun.com:80/ab2/coll.297.1/@Ab2CollToc?subject=sysadmin) - Describes the Sun Directory Services.

Netscape Directory Services documentation (http://home.netscape.com/eng/server/directory/) - Describes the Netscape Directory Services.

Web Access Administrator's Guide - Describes the core system administration tasks for the Sun Web Access software.

Sun Internet Mail Server 4.0 Release Notes - Covers open issues and late-breaking installation, administration, and reference information that is not published in the product books.

Sun Internet Mail Server 4.0 Web site (located at http://www.sun.com/sims) offers up-to-date information on a variety of topics, including:

On-line product documentation and late-breaking updates

Data sheets and evaluation guide

Technical white papers

Product demos

Press coverage and customer success stories

Client solutions

What Typographic Changes Mean

The following table describes the typographic changes used in this book.TABLE P-2 Typographic Conventions Typeface or Symbol Meaning Example AaBbCc123 The names of commands, files, and directories; on-screen computer output. Edit your.login file. Use ls -a to list all files. machine_name% You have mail. AaBbCc123 What you type, contrasted with on-screen computer output. machine_name% su Password: AaBbCc123 Command-line place holder: replace with a real name or value. To delete a file, type rm filename. AaBbCc123 Book titles, new words or terms, or words to be emphasized. Read Chapter 6 in User's Guide. These are called class options. You must be root to do this.

**TABLE P-2** Typographic Conventions
Typeface or Symbol	Meaning	Example
`AaBbCc123`	The names of commands, files, and directories; on-screen computer output.	Edit your`.login` file. Use `ls -a` to list all files. `machine_name% You have mail.`
`AaBbCc123`	What you type, contrasted with on-screen computer output.	`machine_name%` `su` `Password:`
AaBbCc123	Command-line place holder: replace with a real name or value.	To delete a file, type `rm` filename.
AaBbCc123	Book titles, new words or terms, or words to be emphasized.	Read Chapter 6 in User's Guide. These are called class options. You must be root to do this.

Path Convention for Screen Navigation

The following is an example of a navigation path. Navigation paths are shown at the beginning of each task. The navigation path is used in the Admin Console graphical user interface to move from the main Admin Console screen to the screen where the task is performed.

AdminConsole>Sun Message Store>Purge Options

Using the navigation path above, begin at the main Admin Console screen, shown immediately after login. Then, click on Sun Message Store to view the next screen. Written directions accompanying the path direct you to click on the Purge Option listing of the Sections List. Follow the written instructions for configuring the purge options.

AdminConsole>Sun Message Store>Purge Options

Shell Prompts in Command Examples

The following table shows the default system prompt and superuser prompt for the C shell, Bourne shell, and Korn shell.TABLE P-3 Shell Prompts Shell Prompt C shell prompt machine_name% C shell superuser prompt machine_name# Bourne shell and Korn shell prompt $ Bourne shell and Korn shell superuser prompt #

**TABLE P-3** Shell Prompts
Shell	Prompt
C shell prompt	`machine_name%`
C shell superuser prompt	`machine_name#`
Bourne shell and Korn shell prompt	`$`
Bourne shell and Korn shell superuser prompt	`#`

Note - Although the majority of commands can be run without special superuser permissions, some commands can be performed only as root. These commands include: imta dirsync, imta start, imta stop, and imta restart. Other commands that require root privileges are noted within the document.

Graphical User Interface Conventions

This section describes terminology and other conventions used when discussing the Administration Console, a graphical user interface.

Terminology

The following table defines terms used in procedures associated with the Administration Console.

TABLE P-4 Graphical User Interface Terminology
Term
Explanation
Example

Check box

A yes/no or on/off control. A square box that appears highlighted and pushed in when on or pushed out when off. Usually, all check boxes in a group can be selected.

To enable the logging of each message, click the check box.

Radio button

A yes/no or on/off control. A diamond or circle that appears highlighted and pushed in when on or pushed out when off. Usually, only one radio button in a group can be selected.

You can enable the channel to ignore nonstandard encoding headers by clicking the appropriate radio button.

Click

Press and release a mouse button without moving the pointer.

Click the radio button.

Double-click

Click a mouse button twice quickly without moving the pointer.

Double-click the SMTP channel name from the list of channels to display the SMTP property book.

**TABLE P-4** Graphical User Interface Terminology
Term	Explanation	Example
Check box	A yes/no or on/off control. A square box that appears highlighted and pushed in when on or pushed out when off. Usually, all check boxes in a group can be selected.	To enable the logging of each message, click the check box.
Radio button	A yes/no or on/off control. A diamond or circle that appears highlighted and pushed in when on or pushed out when off. Usually, only one radio button in a group can be selected.	You can enable the channel to ignore nonstandard encoding headers by clicking the appropriate radio button.
Click	Press and release a mouse button without moving the pointer.	Click the radio button.
Double-click	Click a mouse button twice quickly without moving the pointer.	Double-click the SMTP channel name from the list of channels to display the SMTP property book.

Notice

To better illustrate the process being discussed, SIMS manuals contain examples of data that might be used in daily business operations. The examples might include names of individuals, companies, brands, and products. SIMS manuals use only fictitious names, and any similarity to the names of individuals, companies, brands, and products used by any business enterprise is purely coincidental.