Joomla Tutorial

We will show you how your Joomla 1.0.x can be upgraded to the stable Joomla 1.5 version.

!Note that we strongly recommend before proceeding with the migration process to backup your existing Joomla web site. Unlikely the normal Joomla upgrades, Joomla 1.0.x to 1.5 migration requires a little bit more tweaking.

Chapter 1: The Migrator component installation

The first step that we should follow is to install the Migrator component to our existing Joomla web site. You can download the Migrator component here. We are going to use the migrator1.1 archive for our tutorial.

Left-click on the migrator.zip link and save the archive on your PC.

The archive itself contains a Joomla component, which is actually taking care of the process of migration. Luckily, Joomla components installation is not a big deal. Go to your Joomla administrative control panel (http://www.your-domain.com/administrator) and log in:

When you are in, from the top navigation menu mouse over the tool Installers and select Components from the drop down menu:

You locate the migrator_rc6.tgz from your hard disk by clicking on [Upload Package File].

To confirm the installation, click on the button [Upload file & install]:

Press [Continue..] at the Upload Component - Success screen.

When the installation of the component is done, mouse over the tool Components available at the top Joomla menu and select Migrator:

Now, you are allowed by the component menu to migrate your current Joomla 1.0.x data to the Joomla 1.5 database format. With our tutorial you can only migrate a base Joomla web site and there are no third party extensions and components installed.

Thus, if you use such, make sure to imput their migration scripts by using the options 3rd Party Information and Add 3rd Party Migrators, which the Migrator component offers:

There should be migration scripts provided by their respective developers on the offical project sites for any additional modules / components / mambots.

Chapter 2: Migration SQL File creating

Select the last link that is available near the bottom of the Migrator component page - Create Migration SQL File to proceed with the database migration.

The following screen will be seen if the things go fluently and there are no errors reported during the SQL data export process: What you have to do next is to download the extracted SQL from your 1.0.x Joomla:

Now your SQL dump can be downloaded by clicking on the link Download available on the right section of the page and upload it into your Joomla. 1.5 installation.

Later, when you import this SQL file into your 1.5 installation, make sure to select Load Migration Script and use the prefix 'jos_' (by default).

Chapter 3: Performing a clean Joomla 1.5 installation

Next, a clean Joomla 1.5 installation will be performed. First, get the latest installation package from:

http://www.joomla.org/download.html

Now follow the steps for manual Joomla 1.5 installation and install a fresh copy of Joomla 1.5. Since this installation will be used for migration purposes, it is advised to perform the installation in a subfolder of public_html (like /new for example).

Therefore, you should upload the Joomla 1.5 installation files in /public_html/new

Go further with the installation till you reach

Step 4: Configuration:

Fill in your web site name, your admin e-mail and password details. !

Choose the option Load Migration Script because it is the key part here:

Fill the old table prefix _jos (or a different prefix that your previous Joomla has used) and do not change the encoding unless it is necessary and you are familiar with this option.

You have to select the previous Joomla 1.0.x migration dump from your Desktop by clicking on the button [Browse]. ! Make sure to tick the check box This script is a Joomla! 1.0 migration script. as well. Click on the button [Upload and execute] to confirm the progress.

The following screen should be seen when the data is imported:

Click on the button [Next] near the upper right corner. ! By using the File manager available in cPanel you completely remove the installation directory.

Now, you will see all the articles and data from the previous Joomla imported when you open the front end of your newly installed Joomla 1.5.