Migrating the log of our queue manager from linear to circular

Follow this sequence of steps to migrate your queue manager log from being linear to circular.


Before starting

Before we migrate, take a backup of our queue manager.

Decide whether we want to migrate your log in place, or migrate the log to a new location by specifying the -ld option on the migmqlog command. If we are moving your queue manager from an old disk to a new Advanced Format disk, it might be convenient to use the -ld option.

Make sure that we have enough space to migrate your log, as the log might grow during migration.

Note the following:

  • You do not need to migrate the log of our queue manager in order to use IBM MQ Version 9.1.0.
  • migmqlog might take some minutes to complete if your log is very large. However, the command outputs progress messages from time to time.
  • If, for any reason (for instance due to a power outage) migmqlog stops before it has completed the process, rerun the same migmqlog command on the partially migrated logs to complete the migration.
  • If you specified the -ld option, migmqlog updates the log path in the qm.ini file for you, so when you start your queue manager it will use the migrated log.
  • Do not pass a relative path when using the -ld option; only use an absolute path.
  • migmqlog does not update any queue or queue manager objects.


Procedure

  1. Login as a member of the mqm group.
  2. If we have not already done so, take a backup of our queue manager.
  3. Run the following command: 
    migmqlog -m QMgrName -lc
    See migmqlog for more information.

Parent topic: Migrating logs on UNIX, Linux, and Windows


Related tasks