- Post by Matias Aguirre
- Created: 26 April 2012
Downloading and installing jUpgrade
The first step is to download the latest version of jUpgrade from Matware "Downloads" section.
jUpgrade is a Joomla! 1.5 component, and as such is installed using the Extension Manager (Extensions > Install/Uninstall).
Preparing the environment
Before opening jUpgrade, you should visit the Plugin Manager (Extensions >> Plugin Manager), look for the "MooTools Upgrade" plugin and make sure it is enabled. The "MooTools Upgrade" plugin comes installed with all versions of Joomla 1.5 since v1.5.19, and it is recommended to update to the latest version prior to running jUpgrade. Ensure it is also ordered at the top of the "System" plugin list.
From the main Joomla! administrator page, click on Help >> System Info. Click on the "Directory Permissions" tab and make sure all the folders are "Writable". If your temp and log folders in joomla are not writable make sure the path specified for respective directories are correct (they are supposed to be in root directory), in configuration.php file in line number 18 and 19.
Then click on the "PHP Information" tab, scroll down until the "cURL" section appears and confirm that "cURL support" has been "enabled". If folders are not writable or cURL is not installed, more information on dealing with that is available in the Troubleshooting section.
At this point it would be wise to run through a short checklist to confirm the environment has been ideally created for a successful migration:
- Ensure "MooTools Upgrade" plugin is present and enabled
- Ensure the PHP cURL library is installed and present on the server
- Ensure the /tmp folder is writable and the administrator has permission to write to the root folder
Configuring the Parameters screen
The Parameters screen lets you configure various aspects of the migration process and define how jUpgrade will behave when reaching certain steps. This should be configured before the first migration, and can be reconfigured when jUpgrade runs into issues at certain steps.
Please note: while updates to the Parameters settings can be saved, they will only take effect either after jUpgrade has been refreshed or after the "Back" button has been clicked (which simulates a refresh). Without a refresh, starting jUpgrade will initiate a migration using the previous Parameters settings.
The options available are grouped and listed as follows:
Distribution - the version of Joomla! which is being migrated to: current options are Joomla! 1.7 and 2.5
Target Directory - the name of the folder where the new Joomla installation will be stored (this folder is created in the root of the Joomla! site folder)
Prefix for old database - the prefix label marking tables belonging to the original 1.5 database
Prefix for new database - the prefix label marking tables belonging to the database of the new Joomla! install
Disable set_time_limit() - sets whether jUpgrade should disable the check for the value of "set_time_limit" on the host server's PHP configuration. jUpgrade uses this value if it exists, however some server configurations disable this feature for security reasons, so if there are any issues during migration related to "set_time_limit" can be resolved by setting this option to "Yes" to disable the check.
Disable Error Reporting - sets whether error messages are hidden from view when issues are encountered.
Skip checks - If set to "Yes" will skip the initial checks that jUpgrade runs before starting the migration process. It is recommended not to skip them, but the ability is there in case there are issues on the first step.
Skip Download - If set to "Yes" will skip downloading the Joomla! distribution and assume that there is a copy of the distro package available in the /tmp folder ready for extraction. Use this option when there is no internet connectivity or there are issues establishing download connection.
Skip Decompress - If set to "Yes" will skip decompressing the distro package in the /tmp folder and assume that the contents have been extracted into the folder labelled after the "target directory". Use this option when there are issues extracting the contents of the distro package.
Skip templates copy - If set to "Yes" will skip the transferring of any installed Joomla! 1.5 templates to the new 2.5 site.
Skip 3rd party extensions - If set to "yes" will skip the step that checks for any components that are installed in the Joomla! 1.5 site and, if jUpgrade has migration profiles for them, transfers the component data to the new 2.5 site.
Keep original positions? - If set to "Yes" will maintain the currently defined template position names that modules are assigned to. The reason for the inclusion of this setting is that with the default Joomla! templates, such as "JA Purity" and "Beez", have different names between 1.5 and 2.5 for module positions. With this set to "No", the template position names will be modified according to their 2.5 template equivalent.
Enable migration debug - In cases where jUpgrade hangs and runs into an error which prevents the process from continuing, setting this to "Yes" will result in a progress log being displayed in a section below the migration steps. The error messages listed here will identify the issue jUpgrade has run into, and the "Troubleshooting" section outlines the solutions for most.
Enable Mootools version debug - If set to "Yes" will ensure a pop-up window appears with the version number of the MooTools library currently loaded every time jUpgrade is accessed. This can be useful in verifying that the required minimum version of 1.2 has been met, although it is not necessary to keep.
Delete previous migration - If set to "Yes" will run a clean-up script before every migration that will remove any database tables, files or folders which were created, inserted or left over from a previous migration or failed attempt.