Main Menu

Components Documentation

User Guide - SP Upgrade

    This is a comprehensive guide of how to use SP Upgrade component to migrate Joomla 1.5 to 2.5

    Note: Anything below is mentioned for version 2.5 goes the same for 1.7 or 1.6. The component is able to migrate to 2.5 or 1.7 or 1.6.

    Requirements

    1. SP Upgrade Component. You can download from here
    2. Joomla 1.5
    3. Joomla 2.5

    Attention: J16 should be a fresh new installation on a new database, not depended in any way with your old J15. Do not install, or overwrite your live site J15 path or database.

    It is also recommended not to install sample data.

    The Process

    The migration process is fully automated. See below the steps how to do it.

    Install SP Upgrade component

    Install the component on your new 2.5 site just like any other component.
    Install Component

    Fill in your J15 information

    Fill the info for your 1.5 database and path (this is necessary only for images and templates) and press button Upgrade.
    J15 information

    If you are doing a remote migration across different hosts, then:

    1. Login to the Cpanel of the 1.5 host. Give access to your "dev host's" IP (the one where you have your new Joomla 2.5 installation). This "remote host" needs to have access to manage the 1.5 mySQL database.
    2. Now, in the field host name, instead of "localhost", fill in the host name, or IP for the server of the 1.5 database. (Ask that hosting provider what it should be if you don't know.)

    Choose what to transfer

    As per below image you may choose what to migrate.

    Choose what to upgrade

    You have the ability to choose whether to bring all menu items, or only the core menu items. That could be useful in order to keep the whole structure of your menus, even though the ones that are linked to external extensions will not be functional until you install their extensions.

    You also have the option to choose whether to bring all modules, or only the core menu items. The non core modules will not be functioning unless you install the corresponding module compatible release.

    Wait...

    Migration duration depends on your site size. A pop-up log window is refreshed every 15 seconds for monitoring the status of the migration. When migration is completed you may download the log to your PC if you want. If the migration have for time out just go back and repeat process. It will begin from where it started.

    Monitor Log

    Fix modules positions

    After migration is finished all you have to do is to to fix the positions of your modules to your template.

    That's it you are done and ready to test!!!

    Note

    Test is the most important part before you move your site live. Test everything that are functional and correct if necessary.

    MySQL or MySQLi?

    While installing your new Joomla you are asked to choose between MySQL or MySQLi. Many people are confused with that. This is not the database type. It represents the connection type between PHP and a MySQL database. If you have MySQL 4.1.13+ and PHP 5.0.7+, then choose MySQLi, else MySQL.

    Our component support both, but we have available for download only the MySQLi compatible release to urge people to use the new database type for their own benefit. In case you have to use MySQL, just contact us to send you the compatible release.