• Share
  • Email
  • Embed
  • Like
  • Save
  • Private Content
J upgrade presentation

J upgrade presentation



Great presentation from Sean Klotsman (@RedComponent) to upgrade from Joomla 1.5 to 2.5 using jUpgrade.

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.



Total Views
Views on SlideShare
Embed Views



2 Embeds 6

http://elearning.tadelformacion.com 5
https://twitter.com 1



Upload Details

Uploaded via as Microsoft PowerPoint

Usage Rights

© All Rights Reserved

Report content

Flagged as inappropriate Flag as inappropriate
Flag as inappropriate

Select your reason for flagging this presentation as inappropriate.

  • Full Name Full Name Comment goes here.
    Are you sure you want to
    Your message goes here
Post Comment
Edit your comment

    J upgrade presentation J upgrade presentation Presentation Transcript

    • jUpgrade Migrating from Joomla! 1.5 to Joomla! 2.5 using jUpgrade
    • jUpgradeWhat is jUpgrade?A migration tool written for Joomla! 1.5, designed to assistadministrators in moving the contents of their site intoa new Joomla! 2.5 installationA 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)
    • jUpgradeWhat does jUpgrade migrate?Core Content:Joomla UsersStandard Joomla ModulesJoomla CategoriesJoomla ContentJoomla MenusJoomla BannersJoomla ContactsJoomla NewsfeedsJoomla WeblinksJoomla Images and mediaStandard Joomla 1.5 Templates
    • jUpgradeWhat does jUpgrade migrate?Third-party Component Content including:
    • jUpgradeBefore 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?
    • jUpgradeMigration is a GO!When you have decided to migrate:1. Plan Ahead2. Keep your users informed3. Backup, Backup, Backup4. Create a local test site
    • jUpgrade Backing up before proceedingBefore you even start your migration, make sure you backup your Joomla! 1.5 site!Recommended tool for the job: Akeeba BackupDownload a copy from either of these links:http://extensions.joomla.org/extensions/access-a-security/site-security/backup/1606http://www.akeebabackup.com/download/akeeba-backup/
    • jUpgrade Backing up before proceedingMore detailed guide available on jUpgrade wiki:http://wiki.redcomponent.com/index.php?title=jUpgrade:Preparing_to_migrate_from_1.5
    • jUpgradeSetting up a test environmentYou may want to test the migration on a localhost testing environment beforerunning 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)
    • jUpgradeDownloading jUpgradeDownload from redCOMPONENT “Free Downloads” sectionhttp://redcomponent.com/free-downloads(requires registration)
    • jUpgradeInstalling jUpgradejUpgrade is a Joomla! 1.5 component, and as such is installed using theExtension Manager (Extensions > Install/Uninstall).
    • jUpgradejUpgrade RequirementsMinimum 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 jUpgrade RequirementsMooTools UpgradeVisit the Plugin Manager, andmake sure the plugin is enabledand first in orderIn case of issues, download and re-install:http://extensions.joomla.org/extensions/core-enhancements/scripts/14643
    • jUpgrade jUpgrade RequirementsWritable DirectoriesVisit System Info, and review thedirectory permissions of the rootand /tmp folders especiallyRecommended tool to easily modifyfile and folder permissions:eXtplorerhttp://extensions.joomla.org/extensions/core-enhancements/file-management/2630http://extplorer.net/files
    • jUpgrade jUpgrade RequirementscURL ModuleVisit System Info, and review thePHP Information listed for the presence ofthe cURL moduleIf it is disabled or unavailable:http://curl.haxx.se/libcurl/php/http://php.net/manual/en/book.curl.phphttp://stackoverflow.com/questions/1347146/how-to-enable-curl-in-php
    • jUpgradeConfiguring jUpgradePrior 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
    • 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 savedPush the big “Start jUpgrade” button tobegin the migration!
    • jUpgradeThe 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 enabled1) Downloading Joomla 2.5jUpgrade downloading Joomla distributionselected in Parameters screen;Stores package in /tmp folder and renamesto “joomla25.zip”
    • jUpgradeThe 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.5jUpgrade updates the "configuration.php" file inthe folder of the newly extractedJoomla! 2.5 installation; then creates thenecessary tables for the 2.5 install in thedatabase
    • jUpgradeThe migration process 5) Upgrading progress jUpgrade looking for and transferring core Joomla! content: Users, Categories, Content, Menus, Modules, Banners, Contacts, Newsfeeds and Weblinks6) Copying templatesjUpgrade copies over any templates that havebeen installed in the Joomla! 1.5 site tothe new Joomla! 2.5 site, unless“Skip Templates” has been set to Yes(Post-migration manual update required)
    • jUpgradeThe 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 extensionsjUpgrade looks for any third-party extensionsthat it supports and migrates the data foreach one
    • jUpgradeThe migration process9) Upgrade Finished!Confirms when the upgrade has beensuccessfully completed, and displays shortcutlinks for the administrator to access the newJoomla! 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 siteusing the same username and password as the old one.
    • jUpgrade Post-migration checklistIn 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
    • jUpgrade Post-migration checklistIn 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
    • jUpgrade Post-migration checklistIn 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
    • jUpgrade Post-migration manual adjustmentsTo 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
    • jUpgrade Post-migration manual adjustmentsTo 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
    • jUpgrade Before going live…1) Backup the new Joomla! 2.5 installationBackup 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 spaceGeneral Procedure:1. Create a subfolder (e.g. myoldsite) for the Joomla 1.5 installation in your html root, e.g. public_html/myoldsite2. 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 root4. Double check the frontend and backend
    • jUpgradeMigration… complete.
    • jUpgradeFurther Reference: TemplatesMigrated 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_templateshttp://docs.joomla.org/Tutorial:Upgrade_Joomla_1.5_Template_to_Joomla_1.6http://www.slideshare.net/chrisdavenport/template-changes-for-joomla-16http://community.joomla.org/blogs/community/1257-16-templates.html
    • jUpgrade Further Reference: 3rd Party ExtensionsGuides available with additional instructions on migrating specific components:http://wiki.redcomponent.com/index.php?title=jUpgrade:Migrating_third-party_extensionsMore information on adapting Joomla! 1.5 extensions to Joomla! 2.5:http://docs.joomla.org/Adapting_a_Joomla_1.5_extension_to_Joomla_1.6Guides available on developing content migration profiles for jUpgrade:http://wiki.redcomponent.com/index.php?title=jUpgrade:Developing_migration_profiles_for_third-party_extensionshttp://redcomponent.com/images/stories/Developers-Documentation-for-jUpgrade.pdf
    • jUpgradeFurther Reference: TroubleshootingDetailed solutions for common issues during migration can be found here:http://wiki.redcomponent.com/index.php?title=jUpgrade:TroubleshootingIncludes 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
    • jUpgradeThanks for watching the presentationand enjoy your new Joomla! 2.5 site with jUpgrade!