As the chairman of G.B.D. Calamari, a Dutch student diving association, it falls to me to upgrade an aging Joomla configuration that is a relict of the last time that the board was chaired by somebody with web-development expertise (Joris van Alphen). This happened to be during a time when Joomla 1.5.20 was cutting-edge. It no longer is, so, although the website still looks nifty enough for this day and age (in my ageing eyes, at least), a software upgrade is long overdue.
[Note that the below is more of a disjointed collection of notes than it is an article of interest to anyone not directly involved with the maintenance of www.gbdcalamari.nl.]
The first step in any upgrade, of course, is backing up everything. Everything means all the files and the complete database. I did this using the “Export” option in phpmyadmin.
One peculiarity that I noticed during the database backup was that while there there were two MySQL databases — one called calamari_phpbb and one called calamari_site — the one called calamari_phpbb actually contained the tables for both the phpBB forum and the Joomla 1.5 site; calamari_site seemed to be a legacy of an older (custom-written) incarnation of the website.
The phpBB upgrade went surprisingly well. To update phpBB, I used phpbb.nl‘s automatic update packages to update from 3.0.8 to 3.0.12 in 4 steps:
- 3.0.8 to 3.0.9 (common.php merged)
- 3.0.9 to 3.0.10
- 3.0.10 to 3.0.11
- 3.0.11 to 3.0.12 (common.php merged again)
One by one, for each of these packages, I
- unpacked and uploaded the install dir,
- visited http://www.gbdcalamari.nl/phpbb/install/,
- updated the database,
- downloaded the ‘diff’, and
- copied it through WebDAV,
- checked if the update was successful and
- deleted the install dir.
It was quite fun (albeit a bit cumbersome) to update web software the noob way for a change.
Joomla 1.5.20 to 1.5.26
Joomla 2.5.19 is the current Joomla version (not counting the version 3 branch). The docs on upgrading from 1.5.x to 2.5 mention specifically that it’s a good idea to first upgrade to the latest 1.5.x version. Again, as with phpBB, I played the n00b game and performed the file updates by uploading the files in the the latest 1.5.x patch, overwriting the old Joomla stuff.
Joomla 1.5.26 to 2.5.19
The tricky part was yet to come: the upgrade from one major version to the next, from Joomla 1.5.26 to 2.5.19. The official guide on this process uses the jUpgrade extension. I followed the steps. jUpgrade installed the new version in a jupgrade/ subdirectory in the document root, after which I moved the old installation temporarily into a subdirectory called joomla1.5. (‘Temporarily’ may not be the most accurate qualification; now, five months later, it’s still sitting around as I’m finally polishing the last rough edges left after the upgrade.) With the old installation safed, I moved the Joomla 2.5 files from jupgrade/ to the document root. In this way, I still had access to the old, fully functional site while transitioning the templates and modules, etc.
Joomla components, modules and plug-ins
There are several Joomla components that I had to also upgrade, the most important of which is JFusion, which is necessary for the phpBB integration.
It took some tweaking to get JFusion behave as well as it did previously. The following error caused a bit of a headache (and might do so again, during future phpBB updates):
Fatal error: Cannot redeclare utf8_substr() (previously declared in /home/calamari/public_html/libraries/phputf8/mbstring/core.php:98) in /home/calamari/public_html/phpbb/includes/utf/utf_tools.php on line 225
The solution was to patch utf_tools.php with a version provided by the JFusion project.
Another process that can be challenging when upgrading between major versions of a CMS is updating the template. The template that has been used by the previous site administrator (JA Purity) seems to be quite popular, however, with a Joomla 2 and 3 version available. Too bad that he did modify it, so that I had to depend om my good old friend that is diff to figure out which changes he made. To be able to more seamlessly upgrade JA Purity in the future, I modified Joris van Alphen’s JA Purity fork to use a Calamari template theme for most of his customizations.
I re-enabled the old favicon file, by copying it to the ja_purity_ii/themes/calamari/ directory and copying a modified head.php to a new blocks/ subdirectory for that theme.
Migrating file attachment from Joomla 1.5 to 2.5 was non-trivial. Initially, I tried this while running 2.5.7, but the new version of the attachments plugin required 2.5.7 or higher. Besides my initial confusion about how I ended up with Joomla 2.5.7 instead of 2.5.19, following the cumbersome instructions in the project‘s upgrade manual worked out well.
Eventually, Joomla Event Manager is set to replace the EvenList component by Schlu that Joris had used for the Joomla 1.5 incarnation of the Calamari website. For now, though, Schlu’s EventList component will do. Data migration only required copying the MySQL table rows from the Joomla 1.5 prefixed tables (“jos_”) to the Joomla 2.5 prefixed tables (“j25_”):
INSERT INTO j25_* SELECT * FROM jos_*; INSERT INTO j25_eventlist_categories SELECT * FROM jos_eventlist_categories; INSERT INTO j25_eventlist_events SELECT * FROM jos_eventlist_events; INSERT INTO j25_eventlist_groupmembers SELECT * FROM jos_eventlist_groupmembers; INSERT INTO j25_eventlist_groups SELECT * FROM jos_eventlist_groups; INSERT INTO j25_eventlist_register SELECT * FROM jos_eventlist_register; INSERT INTO j25_eventlist_settings SELECT * FROM jos_eventlist_settings; INSERT INTO j25_eventlist_venues SELECT * FROM jos_eventlist_venues;
To upgrade the ALFcontact component
again only, the factory contacts had to be replaced with the old Calamari contacts, after downloading and installing the new version:
DELETE FROM j25_alfcontact; INSERT INTO j25_alfcontact SELECT * FROM jos_alfcontact;
The Joomla 1.5 website used mod_poll for some fun (but mostly useless polls), a module which was removed somewhere during the further development of the 1.5 branch. I found no ready replacement which could import the old mod_poll content, so I decided to not install a new module.
For the continued use use wgPicassa, the most important step is to upload years worth of photos to Picasa, which was supposedly inconvenient, because the Picasa account was said to be linked to Joris’ private Google Account. I thought I’d thus have to create a new Picasa account, linked to an @gbdcalamari.nl email address and ask him to re-upload all the photo’s in his account. Luckily, it turned out that the Picassa account was already associated with an @gbdcalamari.nl email address. So, after resetting the password using that email adress, we can now finally update the gallery.
Slideshow on public homepage
A slideshow with promotional pictures was originally displayed on the home page for non-logged in visitors (using the Unite Nivo Slider extension). It took me some trouble to find out how to display this module before the main content in JA Purity. In fact, that was the only place where I couldn’t position anything. All I could find were clumsy work-arounds, until I stumbled upon the existance of “mass positions” in the JA developer guide.
Joomla 2.5.19 to 2.5.24
I left the upgrade process were it was on Mach 31 of this year, finally continuing the process this August. In the meantime, the Joomla 2.5 branch has arrived at version 2.5.24. Luckily for me, it’s much easier to update an existing 2.5.x installation. After making a fresh backup of everything, I unpacked the archive remotely, after which I updated the database. That was it.
Left to do
- Cleanup excess JUpgrade table.
- Get rid of the cpanel thingy in the header
- Move font size control from cpanel thingy to header?
- Restore search in header
- Reinstall XMap extension
- Rename database to avoid future confusion