About This Guide


This guide explains how to install iPlanet^TM Messaging Server 5.2 and its accompanying software components. iPlanet 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.

Topics covered in this chapter include:

• Who Should Read This Book

• What You Need to Know

• How This Book is Organized

• Document Conventions

• Where to Find Related Information

• Where to Find This Book Online

Who Should Read This Book

---

You should read this book if you are responsible for installing and deploying iPlanet Messaging Server at your site.

---

Note

The installation program does not give you the option to migrate any existing mailboxes and message queues from Netscape Messaging Server or Sun Internet Mail Server products to iPlanet Messaging Server. If you choose to migrate your existing data, you should refer to the iPlanet Messaging Server Migration Guide.

---

What You Need to Know

---

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

• iPlanet Administration Server

• iPlanet Directory Server and LDAP

• Netscape Console

How This Book is Organized

---

This book contains the following chapters and appendixes:

• About This Guide (this chapter)

• Chapter 1, "Preparing for Installation"

  This chapter provides much of the information you will need to know before beginning the installation. Some of the topics covered include system requirements, installation options, and descriptions of the components that you will install.

• Chapter 2, "Installation Instructions"

  In this chapter, you will learn how to run the setup program, the directory setup program (ims_dssetup.pl), and silent installation. In addition, you will be walked through common installation scenarios and post-installation configuration procedures.

• Chapter 3, "Installation Questions"

  This chapter explains the questions that make up the Messaging Server installation and will show you how to respond to these questions in order to get the appropriate installation.

The following two chapters describe optional features that you might consider when installing iPlanet Messaging Server 5.2.

• Chapter 4, "High Availability"

  This chapter describes the high availability models and outlines the advantages and disadvantages of each model. It also provides pre- and post-installation instructions and some configuration information. High Availability products discussed in this chapter include: Veritas Cluster Server 1.1 or higher, Sun Cluster 2.2, Sun Cluster 3.0 U1 (Update 1), and Sun Cluster 3.0 U2 (Update 2).

• Chapter 5, "Installing the Messaging Multiplexor"

  This chapter contains detailed instructions for installing and starting the Messaging Multiplexor. It also contains sample configuration files. Detailed information about the Messaging Multiplexor can also be found in the iPlanet Messaging Server Administrator's Guide and iPlanet Messaging Server Reference Manual.

• Appendix A, "Installing iPlanet Directory Server 5.1"

  This appendix describes how to install and configure iPlanet Directory Server 5.1 with iPlanet Messaging Server. While iPlanet Directory Server 5.1 is not bundled with the Messaging Server installation program, you can configure this version of Directory Server to work with Messaging Server by following these instructions.

• Appendix B, "Running the Uninstall Program"

  This appendix provides instructions on how to run the uninstall program to remove instances of Messaging Server.

• Appendix C, "Upgrading Your Messaging Server"

  This appendix contains instructions on how to upgrade from previous versions of iPlanet Messaging Server to iPlanet Messaging Server 5.2.

Document Conventions

---

Monospaced 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. For example, you might see something like this:

./setup
Sun-Netscape Alliance
iPlanet Server Products Installation/Uninstallation
-------------------------------------------------------------------

Welcome to the iPlanet Server Products installation program. This program will install iPlanet Server Products and the iPlanet Console on your computer.

It is recommended that you have "root" privilege to install the software.

Tips for using the installation program:

- Press "Enter" to choose the default and go to the next screen
- Type "Control-B" to go back to the previous screen
- Type "Control-C" to cancel the installation program
- You can enter multiple items using commas to separate them.
For example: 1, 2, 3

Would you like to continue with installation? [Yes]:

In this example, ./setup is what you would type at the command line and the rest is what would appear as a result.

Italicized Font

Italicized font is used to represent text that you enter using information that is unique to your installation (for example, variables). It is used for server paths and names and account IDs.

For example, throughout this document you will see path references of the form:

server-root/msg-serverID/...

In these situations, server-root represents the directory path in which you install the server, and msg-serverID represents the server instance you use when you install it. For example, if you install your server in the directory /usr/iplanet/server5 and use the server instance tango, the actual path is:

/usr/iplanet/server5/msg-tango/

Square or Straight Brackets

Square (or straight) brackets [] are used to enclose optional parameters. For example, in this document you will see the usage for the setup command described as follows:

./setup [options] [argument]

It is possible to run the setup command by itself as follows to start the Messaging Server installation:

./setup

However, the presence of [options] and [arguments] indicate that there are additional optional parameters that may be added to the setup command. For example, you could use setup command with the -k option to keep the installation cache:

./setup -k

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.

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 Installation Guide

The iPlanet Messaging Server product suite contains other products such as Netscape Console, Directory Server, and Administration Server. Documentation for these and other products can be found at the following URL:

http://docs.iplanet.com/docs/manuals/index.html

Where to Find This Book Online

---

You can find the iPlanet Messaging Server 5.2 Installation Guide online in PDF and HTML formats. This book can be found at the following URL:

http://docs.iplanet.com/docs/manuals/messaging.html