Which Joomla versions require a pre-upgrade?

Versions that require a pre-upgrade

Use the following table to determine which steps to take based on the version you currently use.

Joomla! version Pre-upgrade instructions
1.0 – 1.0.15
Reference – http://docs.joomla.org/J1.5:Migrating_from_1.0.x_to_1.5_Stable
  1. Be sure that FastCGI is turned OFF.
    • Go to (Panel > 'Domains' > 'Manage Domains') in the panel.
    • Click the Edit button under Web Hosting next to the domain.
    • Locate "PHP mode" under web options check to see which version of PHP you're running.
    • If your PHP version is set to "FastCGI" then switch from PHP FastCGI to PHP CGI. For best results, stay within the same PHP 5.x.x version number. View the Changing the PHP version of your site article for further details.
  2. Download the migrator component to your system and then install it into the 1.0 install.
    • You can download the latest version of the migrator component (zip file) here.
    • This is done like any normal component install.
    • There is a migrator entry in the component menu option where you can access the migrator.
  3. Install any third-party migrator plugins.
    • The migration system only handles the core system in its migration, which means that if you want to include any third-party extension data from other tables you must install migrator plugins to handle the migration of this data.
    • There are two types of plugins that are used: a "SQL" plugin which is a plain text SQL file, and an "ETL" plugin which is a bit of PHP that tells the migrator how to handle the data stored in tables (or in configuration files).
    • You do this by selecting "Add Third Party Migrators", and then locating the plugin you wish to install and uploading the file.
    • SQL files are automatically prepended to the output, and ETL plugins are automatically executed.
    • You can view a list of ETL plugins by clicking "List Plugins" in the main screen.
    • You can also upload ETL plugins to the "plugins" directory in the "/administrator/components/com_migrator" directory within your Joomla! site.
  4. Generate SQL.
    • Once you have installed any third-party migrator plugins, you can select the "Create Migration SQL file" to begin the creation process.
    • The system is designed to build a SQL file without causing a timeout on the server, so you may notice that the page automatically refreshes and displays status information.
    • Eventually, it displays a notification that the process has completed and the SQL file is available for download.
    • Part of the SQL file generation involves the alteration of various fields to make them compatible with changes made in Joomla! 1.5, including the rewriting of mosimage tags.
  5. Rename the Joomla! directory for your 1.0.x version by appending a "-1.0" to the end. For example, if it is named "EXAMPLE.COM" change the name to "EXAMPLE.COM-1.0"
    • After renaming EXAMPLE.COM to EXAMPLE.COM-1.0 it will no longer be accessible from the web.
    • This step is necessary because the DreamHost installer needs to have the app be in the original install location for the final upgrade to work.
  6. Install the new version of Joomla! 1.5.26 to EXAMPLE.COM, not EXAMPLE.COM-1.0.
  7. Import the SQL file into Joomla! 1.5.26.
  8. You have now upgraded to 1.5.26. To complete the upgrade to 2.5.6, see the upgrade from versions 1.5 through 1.5.26 to Joomla! 2.5.6 section.
1.5.0 – 1.5.24
  1. Be sure that FastCGI is turned OFF.
    • Go to (Panel > 'Domains' > 'Manage Domains') in the panel.
    • Click the Edit button under Web Hosting next to the domain.
    • Locate "PHP mode" under web options check to see which version of PHP you're running.
    • If your PHP version is set to "FastCGI" then switch from PHP FastCGI to PHP CGI. For best results, stay within the same PHP 5.x.x version number. View the Changing the PHP version of your site article for further details.
  2. Navigate to the (Panel > 'Goodies' > 'One-Click Installs') page.
  3. Click Manage Installed Applications.
  4. Click the green icons next to the Upgrades Needed message, and then click Upgrade. View the How to upgrade a One-Click Install article for further details.
  5. You have now upgraded to 1.5.26. To complete the upgrade to 2.5.6, see the upgrade from versions 1.5 through 1.5.26 to Joomla! 2.5.6 section.
1.5.25 and later

Proceed to upgrade from versions 1.5 through 1.5.26 to Joomla! 2.5.6.

See also

Did this article answer your questions?

Article last updated .