Appendix D   Upgrading Your Messaging Server


This appendix contains instructions to help you upgrade previous versions of iPlanet Messaging Server to iPlanet Messaging Server 5.1.

To upgrade from an older version of iPlanet Messaging Server (such as iPlanet Messaging Server 5.0 and its subsequent patches), follow these steps:

1. Shut down all servers before performing the upgrade.

2. Save the job_controller.cnf and dispatcher.cnf files prior to the upgrade. At the completion of upgrade, you should restore the files.

3. Make sure that your upgrade takes place on the same machine and the same server-root where you originally installed iPlanet Messaging Server.

4. Login as root and run ./setup -k from Messaging installation binaries. This is the same setup program you would run if you were installing a new instance of Messaging Server.

5. During the installation process, Installer detects existing file, directory, and configuration values as the defaults and fills in missing values with standard default suggestions. You will get the following question when Installer detects the existing configuration values of your prior Messaging Server installation:

This machine has a Messaging Server instance installed already. Please choose below whether you want to upgrade the existing server instance or create a new server instance.

If you choose to create a new server instance, the configuration for the existing server instance will not be touched. If you choose to upgrade the existing server instance, any missing configuration will be detected and the configuration will be repaired if necessary.

   [1] Create New
   [2]  Upgrade

---

Note	Mailbox and message queues do not require migration from a 5.x to 5.1 system.

---

Choose option 2 to upgrade your Messaging Server. The upgrade process will complete once Installer updates the necessary configuration values.