test

Sun Java System Messaging Server 6 2005Q4 Administration Guide

Running the Upgrade Utility

This section describes the do_the_upgrade.sh utility (located in /var/tmp/UpgradeMsg5toMsg6.ScratchDir), a shell script that is made up of four sub-scripts. The following topics are covered in this section:

Overview of the Upgrade Utility

The do_the_upgrade.sh utility is made up of four shell scripts that, with your *.MERGED files, update the configuration and file directory locations of your MTAconfiguration, your configutil parameters, backup parameters, and your mboxlist database in your current version of Messaging Server system.

You can either run the do_the_upgrade.sh utility, or you can individually run one or more of the scripts that make up the do_the_upgrade.sh utility (make_mta_config_changes.sh, make_configutil_changes.sh, make_backup_config_changes.sh, and make_mboxlistdb_changes.sh).

If you want to upgrade an MTA relay machine from Messaging Server 5.2 to current version of Messaging Server, you only need to run the make_mta_config_changes.sh and the make_backup_config_changes.sh (described in Backup Configuration).

When executing either the do_the_upgrade.sh utility or any of the sub-scripts, be sure that neither Messaging Server 5.2 nor 6 2005Q4 is up and running.

ProcedureTo Run the do_the_upgrade.sh Utility

Steps

  1. Shut down both the 5.2 and the current version of Messaging Servers.

  2. Run the utility:


    # sh /var/tmp/UpgradeMsg5toMsg6.ScratchDir/do_the_upgrade.sh

    After running the do_the_upgrade.sh script, you can either continue to reference your 5.2 partition paths (though you will not be able to remove your Messaging Server 5.2 server-root directory) or you can manually move the 5.2 store partitions to the appropriate current version of Messaging Server directory location. You should perform this step prior to restarting Messaging Server.

MTA Configuration

The MTA upgrade configuration sub-script that makes up of part of the do_the_upgrade.sh utility is called make_mta_config_changes.sh (located in /var/tmp/UpgradeMsg5toMsg6.ScratchDir).

The make_mta_config_changes.sh script backs up, renames, and moves the *.MERGED server configuration files to their original names and locations within the current version of Messaging Server file directory structure.

Once the script has finished renaming and moving the files, it automatically runs the imsimta cnbuild command to recompile the MTA configuration.

Note –

If you want to upgrade an MTA relay machine from Messaging Server 5.2 to the current version of Messaging Server, you only need to run the make_mta_config_changes.sh and the make_backup_config_changes.sh (described in Backup Configuration).

configutil Parameters

The configutil upgrade configuration sub-script that makes up part of the do_the_upgrade.sh utility is called make_configutil_changes.sh script (located in /var/tmp/UpgradeMsg5toMsg6.ScratchDir).

The make_configutil_changes.sh script incorporates new or updated parameters in the msg.conf and local.conf files. If default values are not specified in configutil parameters in the current version of Messaging Server, any Messaging Server 5.2 values are carried forward to the current version of Messaging Server version.

Backup Configuration

The backup upgrade configuration sub-script that makes up part of the do_the_upgrade.sh utility is called make_backup_config_changes.sh script (located in /var/tmp/UpgradeMsg5toMsg6.ScratchDir).

The make_backup_config_changes.sh script upgrades the configuration of your backup services such as those in your backup-groups.conf file.

mboxlist Database

The mboxlist database upgrade configuration sub-script that makes up part of the do_the_upgrade.sh utility is called make_mboxlistdb_changes.sh script (located in /var/tmp/UpgradeMsg5toMsg6.ScratchDir).

The make_mboxlistdb_changes.sh script transfers and upgrades your 5.2 mboxlist database and upgrades it to the current version of Messaging Server directory structure. The script copies the four *.db files (folder.db, quota.db, peruser.db, and subscr.db) from server-root/msg-instance/store/mboxlist on your Messaging Server 5.2 system to msg_svr_base/data/store/mboxlist on your current version of Messaging Server system.