About This Guide


The iPlanet Messaging Server Migration Guide describes how to migrating from a Sun Internet Mail Server (SIMS) 4.0 or Netscape Messaging Server 4.x email system to an iPlanet Messaging Server email system.

This preface contains the following sections:

• Who Should Read This Book

• What You Need to Know

• How This Book is Organized

• Typographical Conventions

• Where to Find Related Information

• Listed below are the additional documents that are available:

Who Should Read This Book

---

You should read this book if you are responsible for migrating from SIMS 4.0 or Netscape Messaging Server 4.x to the iPlanet Messaging Server.

What You Need to Know

---

This book assumes that you have a general understanding of the following:

• The Internet and the World Wide Web

• iPlanet Administration Server

• iPlanet Directory Server and LDAP

• Netscape Console

• Either SIMS or Netscape Messaging Server

How This Book is Organized

---

This book contains the following chapters and appendix:

• About This Guide (this chapter)

• Chapter 1 "SIMS 4.0 and Netscape Messaging Server 4.x Changes, Regressions, and Transitions to the iPlanet Messaging Server

• Chapter 2 "Migration Overview

• Chapter 3 "Scenarios and Procedures for Migrating a Single-Server System to the iPlanet Messaging Server

• Chapter 4 "Scenarios and Procedures for Migrating a Multi-Server System to the iPlanet Messaging Server

• Chapter 5 "Troubleshooting iPlanet Messaging Server Migrations

• Appendix A "Command-Line Interface

• Appendix B "Common Migration Procedures

• "Glossary"

Typographical Conventions

---

Table 1    Typographical Conventions

Typeface or Symbol	Meaning	Example
AaBbCc123	The names of commands, files, code, directories, hostnames, distinguished names, on-screen computer output.	Edit your msg.conf file. Use ls -a to list all files. Error: illegal port #
AaBbCc123	User entered text.	% cd madonna
the_variable	Command-line place holder or variable. Replace with a real name or value.	# instance_root/start-msg
AaBbCc123	Book titles, new words or terms, or words to be emphasized.	iPlanet Messaging Server Provisioning Guide

Directory and File Conventions

---

After you install iPlanet Messaging Server, its directories and files are arranged in the organization depicted in Table 2. The table is not exhaustive; it shows only those directories and files of most interest for typical server migration tasks.

Table 2    Post-Installation Directories and Files

Directory	Default Location and Description
server root directory (server_root)	/usr/iplanet/server5/ (default location) The directory into which all servers of a given server group (that is, all servers managed by a given Administration Server) are installed. This may include other iPlanet servers in addition to Messaging Server. This directory also contains the binary executables for starting and stopping the administration server (start-admin, stop-admin) and for starting the Console (startconsole).
instance directory (instance_root)	server_root/msg-instance_name/ (required location) instance_name is the name of this instance of Messaging Server, as specified at installation. (Default = host name of server machine) This directory contains the configuration files that define a given instance of Messaging Server. Multiple instances of Messaging Server, all using the same binary files, may exist on a given host machine. This directory also contains some of the executables of the installed Messaging Server, such as configutil, start-msg, stop-msg, and so on.

Where to Find Related Information

---

In addition to this guide, iPlanet 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.iplanet.com/docs/manuals/messaging.html

Listed below are the additional documents that are available:

• iPlanet Messaging Server Administrator's Guide

• iPlanet Messaging Server Reference Manual

• iPlanet Messaging Server Schema Reference

• iPlanet Messaging Server Provisioning Guide

• iPlanet Delegated Administrator for Messaging and Collaboration Installation and Administration Guide