Sun Java System Message Queue 3.7 UR1 Installation Guide

Migrating Files from an Earlier Installation

If Message Queue Version 3.0.x or 3.5 is already installed on your system and you want to preserve any of its instance data files (flat-file user repository, access control properties file, or password file), you will need to use the mqmigrate utility to migrate those files before uninstalling the earlier version of Message Queue. If you do not want to preserve your old data files, there is no need to run the mqmigrate utility.

Before you run the mqmigrate utility, you must be root.

su root

When prompted, enter your root password.

The mqmigrate utility assumes that the data files to be migrated are located in the standard directories shown in Table 3–2. In Message Queue 3.0.x installations, the base directory baseDir is assumed by default to be /opt, but the files may be installed in another, nonstandard base directory instead. The mqmigrate command provides an option, -basedir, for designating an alternate base directory from which to migrate the files:

./mqmigrate [-basedir baseDir]

For example, if the earlier installation's data files reside in a directory named, /export, you would migrate them with the command

./mqmigrate -basedir /export

Table 3–2 Message Queue Standard Data Directories

Message Queue Version 

Standard Data Directories 

3.0.x

baseDir/imq/var
baseDir/imq/etc

3.5 

/var/opt/imq
/etc/opt/imq

3.6 

/var/opt/sun/mq
/etc/opt/sun/mq

3.7 UR1 

/var/opt/sun/mq
/etc/opt/sun/mq