Preface

This guide describes how to provision users in the Sun Internet Mail Server 4.0 directory.

Audience

This book is intended for people who want to develop their own customized SIMS provision tools. These include those who want to interface SIMS and its naming service (LDAP directory) to an existing source of user/group/domain information (for example, a company database or order entry system).

Readers are expected to be familiar with LDAP programming and email system concepts. Some basic information on these topics can be found in the SIMS Concepts Guide.

How This Book Is Organized

Chapter 1, "Preliminaries," is an overview of provisioning a user. For a more complete and detailed description, refer to the Sun Internet Mail Server 4.0 Concepts Guide.

Chapter 2, "Creating Domains," explains how to set up and provision a hosted domain.

Chapter 3, "Creating Mail Users," explains how to set up a user and provision that user for a hosted domain. Administrative tasks will also be discussed.

Chapter 4, "Creating Groups explains how to set up a group, or distribution list, and provision that group for a hosted domain. Administrative tasks for groups will also be discussed.

Chapter 5, "Creating SIMS Administrators," explains how to set up a service for a hosted domain.

Glossary is a list of 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-1 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-1** 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.

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-2 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-2** 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.

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.