About This Guide


This manual explains how to install iPlanet Messaging Server 5.0 and its accompanying software components. iPlanet Messaging Server 5.0 provides a powerful and flexible cross-platform solution to 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 5.0 at your site.

---

Note	The installation program does not give you the option to migrate any existing mailboxes and message queues to the newly installed server. If you choose to migrate your existing data, you must contact Technical Support.

---

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 appendix:

• About This Guide (this chapter)

• Chapter 1 "Installation Overview

  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 various components/products being installed.

• Chapter 2 "Installation Questions

  This chapter lists and describes all the questions that make up the Messaging Server installation and the responses that are expected from you. Depending on the type of installation you are performing, you may or may not see all of the questions listed in this chapter.

• Chapter 3 "Installation Instructions

  This chapter describes four basic installation scenarios that you can choose from, and a checklist/worksheet of the questions that you will be expected to answer for each scenario. Information about how to transfer the install files to the server machine and how to run and use the setup program is also included in this chapter.

• Appendix A "High Availability

  This appendix describes the high availability models and outlines the advantages/disadvantages of each model. It also provides pre- and post-installation instructions and some configuration information.

• Appendix B "Installing the Messaging Multiplexor

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

• Appendix C "Un-Installing the Software

  This appendix explains why you might want to un-install the Messaging Server and provides instructions for doing so.

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 from 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 5.0 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 5.0 Administrator's Guide

• iPlanet Messaging Server 5.0 Reference Manual

• iPlanet Messaging Server 5.0 Schema Reference

• iPlanet Messaging Server 5.0 Provisioning Guide

• iPlanet Delegated Administrator for Messaging Installation Guide

The iPlanet Messaging Server product suite contains numerous 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.0 Installation Guide online in PDF and HTML formats. To find this book, use this URL:

http://docs.iplanet.com/docs/manuals/messaging/ims50/install/contents.htm