J upgrade presentation
- 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
- 4. jUpgrade What does jUpgrade migrate? Third-party Component Content including:
- 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)
- 10. jUpgrade Downloading jUpgrade Download from redCOMPONENT “Free Downloads” section http://redcomponent.com/free-downloads (requires registration)
- 11. jUpgrade Installing jUpgrade jUpgrade is a Joomla! 1.5 component, and as such is installed using the Extension Manager (Extensions > Install/Uninstall).
- 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
- 33. jUpgrade Thanks for watching the presentation and enjoy your new Joomla! 2.5 site with jUpgrade!