This is regarding the "Upgrading from 5.0.2 or earlier" section on p.36 of the 5.0.11 release notes.
1. We should explain that the file can be obtained from /opt/zimbra/libexec/scripts on a test 5.0.3+ install or extracted from the 5.0.3+ bits. For example, to extract from 5.0.11, the following commands can
be used:
# cd packages directory where you've expanded the 5.0.11 tarball
# rpm2cpio zimbra-core-5.0.11_GA_2696.RHEL4-20081117013729.i386.rpm | cpio -vid ./opt/zimbra/libexec/scripts/migratePreWidenSizeColumns.pl
# mv opt/zimbra/libexec/scripts/migratePreWidenSizeColumns.pl /opt/zimbra/libexec/scripts
2. The step about stopping all ZCS processes except mysql is correct.
# su - zimbra
$ zmcontrol stop
$ mysql.server start
3. As the zimbra user, go to the /opt/zimbra/libexec/scripts directory. For example,
# su - zimbra
$ cd /opt/zimbra/libexec/scripts
Note: There's a typo in the path in this section as well as the previous section about migrateLargeMetadata.pl. "libexc" should be "libexec".
4. Run the script with perl, i.e.
$ perl ./migratePreWidenSizeColumns.pl -g [all | N groups]
5. Remove the following comment:
"If you run this without options, you will see how many mailbox groups need to be upgraded and you can set the number of accounts to be processed at
a time."
Note: the -g parameter is not optional. You'll get an error if you don't specify -g. If you specify N groups to migrate, the script will update the first N groups it finds. It won't update a group that has already been updated.