Sun Java System Messaging Server 6 2005Q4 Administration Guide

ProcedureTo Run the UpgradeMsg5toMsg6.pl Perl Script

To run the UpgradeMsg5toMsg6.pl to create sets of files by which you’ll be able to update your configuration, follow these steps:

Before You Begin

Both your 5.2 and current version of Messaging Server can be running at this point.

If your Messaging Server 5.2 and 6 versions are on the same machine, start with Step 2.

Steps
  1. If your Messaging Server 5.2 and 6 versions are not on the same machine, transfer, extract and copy the Messaging Server 5.2 server-root directory to the current version of Messaging Server.

    If your server versions are installed on the same machine, you can skip this step.

    If your Message Store is too large to transfer from one system to another, you can transfer just the essential portions of the server instance to the new system. There are comments inside of the UpgradeMsg5toMsg6.pl which cover this in detail.

    You don't have to copy the Messaging Server 5.2 store data to the Messaging Server 6 2005Q4 system, however, you must ensure that the Messaging Server 5.2 mboxlist directory is accessible during the upgrade process.

  2. Run the UpgradeMsg5toMsg6.pl upgrade script.

    By default, this script is located in msg_svr_base/sbin.

    Run the script against the msg-instance of 5.2 version and the msg_svr_base of the current version of Messaging Server. For example:


    perl UpgradeMsg5toMsg6.pl /usr/sunone/server5/msg-budgie \
      /opt/SUNWmsgsr
    

    where /usr/sunone/server5/msg-budgie is the msg-instance of the 5.2 Messaging Server and /opt/SUNWmsgsr is the msg_svr_base of the current version of Messaging Server.

    The process creates *.MERGED and *.CHANGES files (as described in About Upgrade Files).

  3. Carefully review the *.MERGED files to determine if you need to adjust the settings.

    If you don’t want to use the suggested recommendations, you must manually adjust the settings.

    This utility does not update the Messenger Express customization files. Therefore, you need to manually change these files in order to keep the relevant information from Messaging Server 5.2 and add any new information from the current version of Messaging Server installation.