Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 159340 - Upgrade guide misses information about Merge Tables
Summary: Upgrade guide misses information about Merge Tables
Status: RESOLVED FIXED
Alias: None
Product: [OLD] Docs on www.gentoo.org
Classification: Unclassified
Component: Other documents (show other bugs)
Hardware: All Other
: High normal (vote)
Assignee: nm (RETIRED)
URL: http://www.gentoo.org/doc/en/mysql-up...
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2006-12-28 20:59 UTC by Wolf Giesen (RETIRED)
Modified: 2006-12-28 21:52 UTC (History)
1 user (show)

See Also:
Package list:
Runtime testing required: ---


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Wolf Giesen (RETIRED) gentoo-dev 2006-12-28 20:59:48 UTC
I forgot to file this one a hundred times, here it finally is:

When upgrading from MySQL 4.1 to 5.0, there is one caveat: The seamless upgrade does NOT work for Merge Tables [which is basically a concatenation of seperate tables into one virtual table].

I noticed that when upgrading my phpsyslog-ng installation (ref: bug #151021).

Once you re-create the Merge Table you will start to get strange error messages saying that your MyISAM tables are not identical. As far as I found out, the MyISAM tables MySQL 5 uses do have a higher version number than the old ones. The problem really only occurs with Merge Tables.

There is a bug about that somewhere at MySQL, but I lost the reference in the process of constatnly forgetting to file this bug :P

After a long speach, my recommendation is to put something in the guide that tells users of Merge Tables to dump and restore those during the process (or just use the 4.0 -> 4.1 process, after all).

Regards,

Wolf
Comment 1 nm (RETIRED) gentoo-dev 2006-12-28 21:03:12 UTC
(In reply to comment #0)
> I forgot to file this one a hundred times, here it finally is:
> 
> When upgrading from MySQL 4.1 to 5.0, there is one caveat: The seamless upgrade
> does NOT work for Merge Tables [which is basically a concatenation of seperate
> tables into one virtual table].
> 
> I noticed that when upgrading my phpsyslog-ng installation (ref: bug #151021).
> 
> Once you re-create the Merge Table you will start to get strange error messages
> saying that your MyISAM tables are not identical. As far as I found out, the
> MyISAM tables MySQL 5 uses do have a higher version number than the old ones.
> The problem really only occurs with Merge Tables.
> 
> There is a bug about that somewhere at MySQL, but I lost the reference in the
> process of constatnly forgetting to file this bug :P
> 
> After a long speach, my recommendation is to put something in the guide that
> tells users of Merge Tables to dump and restore those during the process (or
> just use the 4.0 -> 4.1 process, after all).

Can you please give us some specific code samples and accompanying text, as well as where exactly it should be? Doesn't have to be a guidexml patch or anything; we just need something to go on. :)
Comment 2 Wolf Giesen (RETIRED) gentoo-dev 2006-12-28 21:33:45 UTC
At least I found another reference for the problem, look at "Posted by Johannes Ullrich on October 31 2006 1:55pm" on this page: http://dev.mysql.com/doc/refman/5.0/en/merge-table-problems.html

So, I think you should extend the introduction under 1. to something like this:

The myisam storage engine in version 4.1 was already mature enough to allow a direct upgrade to the next major version of MySQL.

Nothe that this is not true for MERGE Tables. You will likely run into trouble if you attempt a direct upgrade for this (rarely used) type of table. Be advised that you should dump and recreate those tables and restore their contents in the process of upgrading. If unsure, follow method 2. "Uppgrading from old versions of MySQL".

I think that'd be sufficient, since I doubt a lot of people are using that feature (except for the MASSES of phpsyslog-ng users, of course ^_^)


Feel free to ask if you need anything else.

[Ref: http://www.gentoo.org/doc/en/mysql-upgrading.xml]
Comment 3 nm (RETIRED) gentoo-dev 2006-12-28 21:36:54 UTC
(In reply to comment #2)
> [. . .]

Okay, so no actual code samples are necessary? Just the warning about if unsure, proceed to 2? Works for me. Will do.
Comment 4 Wolf Giesen (RETIRED) gentoo-dev 2006-12-28 21:44:15 UTC
Should work (note I can't swear it does, since I ran into the problem and fixed it _afterwards_), but for testing purposes I just ran mysqldump on the MERGE table a few seconds ago and it produces everything necessary to recreate it, so I can't see anything at all contradicting my expectation that using the "standard procedure" (under "2.") will work.
Comment 5 nm (RETIRED) gentoo-dev 2006-12-28 21:52:15 UTC
Added your suggestion as-is to the guide. Thank you very much for reporting. Fixed in CVS.