MySQL schema upgrade recipe for 3.6.1->3.8.1

Spurred on by Jesse’s excellent class last week, I’m upgrading to 3.8.1,
and wanted to report the issues I found with the schema upgrade script.
I managed to solve most of the stumbling blocks, and I document them
here for others.

Here was my procedure (working on a test sandbox…obviously):

Using RHEL4 MySQL4.1.22 (on a non-local server)

install RT code -> make upgrade

(no problems here except for GnuPG::Interface as noted here )

rt-setup-database --action upgrade

(no problems here…though I did go all the way to 3.8.1, while the docs
might have meant for me to stop at 3.8.0 or were they just older?)

Now I have to upgrade my copy of DBD::mysql, since RHEL4 is woefully out
of date. Would be nice to note this in the UPGRADING.mysql doc, since it
isn’t covered by testdeps/fixdeps (and it shouldn’t be in testdeps,
since it isn’t a dependency of RT, just of the schema upgrade script)

perl -MCPAN -eshell
cpan> install CAPTTOFU/DBD-mysql-4.005.tar.gz

(as noted elsewhere on the list one has to do something akin to:

sudo service mysqld start
mysql -uroot -p
mysql> grant all privileges on test.* to ‘root’@‘localhost’ identified by ‘’

in order to allow CPAN to run tests on DBD::mysql
Note also that 4.010 still wouldn’t pass tests (as noted elsewhere)
hanging on test 76 or so. So I just backed down to 4.005 which worked
fine. Probably I could have upgraded the DBI version instead but this
downgrade seemed to work fine. Then you might like to remove the very
permissive privs you granted on your test db.) DB USER PASS > sql.queries

but this failed because my db is remote so I trivially modified the
script with attached patch (probably not the best way, but it works, not
needed if your db is local, or if you just run the script on your DB
server.) DB USER PASS HOST > sql.queries
Use of uninitialized value in numeric gt (>) at etc/upgrade/ line 310.
Use of uninitialized value in numeric gt (>) at etc/upgrade/ line 310.
Use of uninitialized value in numeric gt (>) at etc/upgrade/ line 310.
Use of uninitialized value in numeric gt (>) at etc/upgrade/ line 310

now my sql.queries contains many lines, including, for example:


As noted elsewhere on the list, this appears to convert the content
column of my Templates table to 1 CHAR and then make it a BLOB that has
utf8 encoding. (Also there are 4 such pairs…matching the 4 errors
above perhaps?) So, I am not a MySQL expert, and it’s a sandbox, so
let’s see what MySQL says:

ERROR 1064 (42000) at line 131: You have an error in your SQL syntax; check the manual that corresponds to your MySQL server version for the right syntax to use near ‘CHARACTER SET utf8 NULL DEFAULT NULL’ at line 1

This is

Which suggests to change BLOB to TEXT and CHAR in above to BLOB (or just
delete the line(s), since in my orig. schema it is already a BLOB)
and this fix is what I will try once restored from backup (and report
success or failure here)

Hope this helps some others.


Travis C. Brooks
Manager of Information Systems & SPIRES
Stanford Linear Accelerator Center Library

schema.remote_db_patch (821 Bytes)