Great presentation from Sean Klotsman (@RedComponent) to upgrade from Joomla 1.5 to 2.5 using jUpgrade.
Presented at the March 2012 Joomla User Group Milwaukee.
1. jUpgrade
Migrating from Joomla! 1.5 to
Joomla! 2.5 using jUpgrade
2. jUpgrade
What is jUpgrade?
A migration tool written for Joomla! 1.5, designed to assist
administrators in moving the contents of their site into
a new Joomla! 2.5 installation
A simple Joomla! 1.5 component that automatically:
• downloads a version of Joomla! 2.5
• decompresses and install it into a new folder
• migrates all of the core content from 1.5 to the new 2.5 installation
• migrates content of supported third party components
• migrates 1.5 templates (requires manual updates to 2.5)
3. jUpgrade
What does jUpgrade migrate?
Core Content:
Joomla Users
Standard Joomla Modules
Joomla Categories
Joomla Content
Joomla Menus
Joomla Banners
Joomla Contacts
Joomla Newsfeeds
Joomla Weblinks
Joomla Images and media
Standard Joomla 1.5 Templates
5. jUpgrade
Before migrating…
Some considerations:
• Is your Joomla! 1.5 site up to date?
• Any core files modified?
• Any core database tables modified?
• Language pack available for Joomla! 2.5?
• Extensions compatible with Joomla! 2.5?
• Are incompatible extensions critical to
site functionality?
• Joomla! 2.5 version of template available?
• Do you really need to migrate to Joomla! 2.5 NOW?
6. jUpgrade
Migration is a GO!
When you have decided to migrate:
1. Plan Ahead
2. Keep your users informed
3. Backup, Backup, Backup
4. Create a local test site
7. jUpgrade
Backing up before proceeding
Before you even start your migration, make sure you backup your Joomla! 1.5 site!
Recommended tool for the job: Akeeba Backup
Download a copy from either of these links:
http://extensions.joomla.org/extensions/access-a-security/site-security/backup/1606
http://www.akeebabackup.com/download/akeeba-backup/
8. jUpgrade
Backing up before proceeding
More detailed guide available on jUpgrade wiki:
http://wiki.redcomponent.com/index.php?title=jUpgrade:Preparing_to_migrate_from_1.5
9. jUpgrade
Setting up a test environment
You may want to test the migration on a localhost testing environment before
running it on the live site.
XAMPP download and installation instructions
http://www.apachefriends.org/en/xampp-windows.html
WampServer download and installation instructions
http://www.wampserver.com/en/
MAMP download (http://www.mamp.info/en/downloads/index.html)
and installation instructions (http://documentation.mamp.info/en)
12. jUpgrade
jUpgrade Requirements
Minimum requirements:
• PHP 5.2.x series or above
• Curl module of PHP enabled
• Joomla! 1.5 (preferably latest)
• Enabled "System - Mootools Upgrade" plugin
(included in Joomla 1.5.19 and greater.)
• A browser with Javascript/Mootools support
13. jUpgrade
jUpgrade Requirements
MooTools Upgrade
Visit the Plugin Manager, and
make sure the plugin is enabled
and first in order
In case of issues, download and re-install:
http://extensions.joomla.org/extensions/core-enhancements/scripts/14643
14. jUpgrade
jUpgrade Requirements
Writable Directories
Visit System Info, and review the
directory permissions of the root
and /tmp folders especially
Recommended tool to easily modify
file and folder permissions:
eXtplorer
http://extensions.joomla.org/extensions/core-enhancements/file-management/2630
http://extplorer.net/files
15. jUpgrade
jUpgrade Requirements
cURL Module
Visit System Info, and review the
PHP Information listed for the presence of
the cURL module
If it is disabled or unavailable:
http://curl.haxx.se/libcurl/php/
http://php.net/manual/en/book.curl.php
http://stackoverflow.com/questions/1347146/how-to-enable-curl-in-php
16. jUpgrade
Configuring jUpgrade
Prior to running jUpgrade, visit the
Parameters section to configure and
review jUpgrade settings;
Make sure to click on “Back” button
to save changes and update settings
for next migration.
http://wiki.redcomponent.com/index.php?title=jUpgrade:Installing_jUpgrade
17. jUpgrade
“Press START”
When you have ensured that
• Backup has been made
• MooTools Upgrade plugin is installed and enabled
• cURL module is enabled
• /tmp and “target directory” folders are writable
• Parameters have been reviewed and saved
Push the big “Start jUpgrade” button to
begin the migration!
18. jUpgrade
The migration process
1) Checking and cleaning
jUpgrade looking for cURL, set_time_limit
and writable /tmp and root folders
Also runs cleanup script if
"Delete previous migration" is enabled
1) Downloading Joomla 2.5
jUpgrade downloading Joomla distribution
selected in Parameters screen;
Stores package in /tmp folder and renames
to “joomla25.zip”
19. jUpgrade
The migration process
3) Decompressing Package
jUpgrade extracts contents of distro package
in /tmp folder (joomla25.zip)
into folder labeled after "Target directory“
4) Installing Joomla 2.5
jUpgrade updates the "configuration.php" file in
the folder of the newly extracted
Joomla! 2.5 installation; then creates the
necessary tables for the 2.5 install in the
database
20. jUpgrade
The migration process
5) Upgrading progress
jUpgrade looking for and transferring core
Joomla! content:
Users, Categories, Content, Menus, Modules,
Banners, Contacts, Newsfeeds and Weblinks
6) Copying templates
jUpgrade copies over any templates that have
been installed in the Joomla! 1.5 site to
the new Joomla! 2.5 site, unless
“Skip Templates” has been set to Yes
(Post-migration manual update required)
21. jUpgrade
The migration process
7) Copying images/media files
jUpgrade renames Joomla 2.5 images
folder to "images.old" and copies over
Joomla 1.5 "images" folder.
8) Upgrading 3rd party extensions
jUpgrade looks for any third-party extensions
that it supports and migrates the data for
each one
22. jUpgrade
The migration process
9) Upgrade Finished!
Confirms when the upgrade has been
successfully completed, and displays shortcut
links for the administrator to access the new
Joomla! 2.5 installation.
You can visit the front-end of the new install using the "Site" link,
while the "Administrator" link will direct you to the back-end.
With a successful migration, you should be able to log into the new site
using the same username and password as the old one.
23. jUpgrade
Post-migration checklist
In the back-end
• verify all user accounts were transferred, group level permissions settings maintained
• check that all Joomla! categories and articles were transferred correctly,
including any Joomla! 1.5 sections that were converted
• check that all menus were transferred, menu items and parameters maintained
• check that all core modules and stored parameters were transferred
• check to ensure that any banners, contacts, newsfeeds and weblinks
(and their respective category structures) have been transferred and rebuilt successfully
24. jUpgrade
Post-migration checklist
In the back-end
• verify all the images and media used in the Joomla 1.5 site have been transferred
(a quick way to check is using the "Media Manager" in the new installation)
• if any supported third-party components are being used on the new 2.5 site,
verify that all the relevant data has been transferred successfully
(this can only be done after the 2.5 version of the component has been installed)
• check Joomla!'s Global Configuration to verify all relevant settings are correct
25. jUpgrade
Post-migration checklist
In the front-end
• check that the template(s) used for the site are being displayed correctly
• check that all menu item links work and point to the items they are meant to
• check that any Joomla! categories being used have the correct articles assigned to them
• check that the modules are displaying in the correct positions
26. jUpgrade
Post-migration manual adjustments
To complete the gaps in the site and resolve minor display issues:
• locating and installing any required language packs (as these are not migrated)
• updating the "template_details.xml" file of any transferred 1.5 templates
before 2.5 can work with them
• updating the template positions of modules not yet assigned or those that
lost their assignments to match those of the new template
• if using a club template, locating and installing the 2.5 version of the template
in the new site
27. jUpgrade
Post-migration manual adjustments
To complete the gaps in the site and resolve minor display issues:
• locating and installing the native 2.5 versions of the components
whose data was migrated
• locating and installing the native 2.5 versions of any modules that were
being used on the old site
• locating and installing the native 2.5 versions of any plugins that were being
used on the old site
• in the event that 2.5 versions are not available, locating, installing and configuring any
extensions that would provide similar or equal functionality to the ones used on the
old site, or leaving the functionality out for the meantime altogether
28. jUpgrade
Before going live…
1) Backup the new Joomla! 2.5 installation
Backup the newly migrated site at least once,
you don’t want to lose all your hard work…
2) Move the new site over to the old space
General Procedure:
1. Create a subfolder (e.g. myoldsite) for the Joomla 1.5 installation in your html root,
e.g. public_html/myoldsite
2. Select all the folders (***except the jupgrade folder***) and files in the html root and
move them into the Joomla 1.5 subfolder (e.g. myoldsite)
3. Select all the folders and files in the jupgrade folder and move them to the html root
4. Double check the frontend and backend
30. jUpgrade
Further Reference: Templates
Migrated 1.5 templates will need to be updated to the 2.5 syntax format:
• Template Parameters
(XML file, “params” + “param” => “config” + “fields”)
• Template Manifest File
(XML file, doctype + <install> => <extension>)
• Objects and methods
(within template code, “sitename” and “error codes”)
http://wiki.redcomponent.com/index.php?title=jUpgrade:Migrating_templates
http://docs.joomla.org/Tutorial:Upgrade_Joomla_1.5_Template_to_Joomla_1.6
http://www.slideshare.net/chrisdavenport/template-changes-for-joomla-16
http://community.joomla.org/blogs/community/1257-16-templates.html
31. jUpgrade
Further Reference: 3rd Party Extensions
Guides available with additional instructions on migrating specific components:
http://wiki.redcomponent.com/index.php?title=jUpgrade:Migrating_third-party_extensions
More information on adapting Joomla! 1.5 extensions to Joomla! 2.5:
http://docs.joomla.org/Adapting_a_Joomla_1.5_extension_to_Joomla_1.6
Guides available on developing content migration profiles for jUpgrade:
http://wiki.redcomponent.com/index.php?title=
jUpgrade:Developing_migration_profiles_for_third-party_extensions
http://redcomponent.com/images/stories/Developers-Documentation-for-jUpgrade.pdf
32. jUpgrade
Further Reference: Troubleshooting
Detailed solutions for common issues during migration can be found here:
http://wiki.redcomponent.com/index.php?title=jUpgrade:Troubleshooting
Includes notes on:
- Understanding and using Debug Mode
- Manually removing a failed migration
- Tackling specific issues, including:
• Frozen “jUpgrade” button • 408: {$tmp} is unwritable
• MooTools 1.2 not loaded • Issues with “set_time_limit”
• 405: jupgrade_steps is not valid • Migrating undefined
• 406: cURL not loaded • Collation error