Migrating from Joomla! 1.5 to Joomla! 2.5 using jUpgrade

jUpgrade

What is jUpgrade?

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)

What does jUpgrade migrate?

jUpgrade

Core Content:

Joomla Users Standard Joomla Modules Joomla Categories Joomla ContentJoomla MenusJoomla BannersJoomla ContactsJoomla NewsfeedsJoomla WeblinksJoomla Images and media Standard Joomla 1.5 Templates

What does jUpgrade migrate?

jUpgrade

Third-party Component Content including:

Before migrating…

jUpgrade

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?

Migration is a GO!

jUpgrade

When you have decided to migrate:

1. Plan Ahead

2. Keep your users informed

3. Backup, Backup, Backup

4. Create a local test site

Backing up before proceeding

jUpgrade

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/

Backing up before proceeding

jUpgrade

More detailed guide available on jUpgrade wiki:http://wiki.redcomponent.com/index.php?title=jUpgrade:Preparing_to_migrate_from_1.5

Setting up a test environment

jUpgrade

You may want to test the migration on a localhost testing environment before running it on the live site.

XAMPP download and installation instructionshttp://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)

Downloading jUpgrade

jUpgrade

Download from redCOMPONENT “Free Downloads” sectionhttp://redcomponent.com/free-downloads(requires registration)

Installing jUpgrade

jUpgrade

jUpgrade is a Joomla! 1.5 component, and as such is installed using theExtension Manager (Extensions > Install/Uninstall).

jUpgrade Requirements

jUpgrade

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

jUpgrade Requirements

jUpgrade

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

jUpgrade Requirements

jUpgrade

Writable Directories

Visit System Info, and review thedirectory 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/2630http://extplorer.net/files

jUpgrade Requirements

jUpgrade

cURL Module

Visit System Info, and review thePHP Information listed for the presence ofthe 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

Configuring jUpgrade

jUpgrade

Prior to running jUpgrade, visit theParameters section to configure andreview jUpgrade settings;

Make sure to click on “Back” buttonto save changes and update settingsfor next migration.

http://wiki.redcomponent.com/index.php?title=jUpgrade:Installing_jUpgrade

“Press START”

jUpgrade

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!

The migration process

jUpgrade

1) Checking and cleaningjUpgrade 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.5jUpgrade downloading Joomla distribution selected in Parameters screen; Stores package in /tmp folder and renamesto “joomla25.zip”

The migration process

jUpgrade

3) Decompressing PackagejUpgrade extracts contents of distro package in /tmp folder (joomla25.zip)into folder labeled after "Target directory“

4) Installing Joomla 2.5jUpgrade updates the "configuration.php" file inthe folder of the newly extracted Joomla! 2.5 installation; then creates the necessary tables for the 2.5 install in the database

The migration process

jUpgrade

5) Upgrading progressjUpgrade looking for and transferring coreJoomla! content:Users, Categories, Content, Menus, Modules,Banners, Contacts, Newsfeeds and Weblinks

6) Copying templatesjUpgrade 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)

The migration process

jUpgrade

7) Copying images/media filesjUpgrade renames Joomla 2.5 images folder to "images.old" and copies over Joomla 1.5 "images" folder.

8) Upgrading 3rd party extensionsjUpgrade looks for any third-party extensions that it supports and migrates the data for each one

The migration process

jUpgrade

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.

Post-migration checklist

jUpgrade

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

Post-migration checklist

jUpgrade

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

Post-migration checklist

jUpgrade

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

Post-migration manual adjustments

jUpgrade

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

Post-migration manual adjustments

jUpgrade

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

Before going live…

jUpgrade

1) Backup the new Joomla! 2.5 installation

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

Backup the newly migrated site at least once,you don’t want to lose all your hard work…

Migration… complete.

jUpgrade

Further Reference: Templates

jUpgrade

http://wiki.redcomponent.com/index.php?title=jUpgrade:Migrating_templateshttp://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

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”)

Further Reference: 3rd Party Extensions

jUpgrade

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

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

Further Reference: Troubleshooting

jUpgrade

Includes notes on:- Understanding and using Debug Mode

- Manually removing a failed migration

- Tackling specific issues, including:

Detailed solutions for common issues during migration can be found here:http://wiki.redcomponent.com/index.php?title=jUpgrade:Troubleshooting

• Frozen “jUpgrade” button• MooTools 1.2 not loaded• 405: jupgrade_steps is not valid• 406: cURL not loaded

• 408: {$tmp} is unwritable• Issues with “set_time_limit”• Migrating undefined• Collation error

Thanks for watching the presentation

jUpgrade

and enjoy your new Joomla! 2.5 sitewith jUpgrade!