Difference between revisions of "How to migrate JReviews data from Joomla 1.5"

From JReviews Documentation
Jump to: navigation, search
Line 1: Line 1:
<div class="jrError">At this time the migrator add-on does not work with JReviews 2.4 nor Joomla 3.0. We will try to remedy this as soon as possible. What this means for you is that if you are still on JReviews 2.2 or older you must first upgrade to JReviews 2.3 which is available for download in the client area. Once you make sure everything continues to work as expected. You can then proceed with the migration to Joomla 2.5. Again verify everything works correctly and follow the
 
 
[[How_to_upgrade_JReviews#Upgrading_to_JReviews_2.4_from_earlier_versions|upgrade instructions for JReviews 2.4]] before you upgrade to Joomla 3.0.</div>
 
 
 
There are two Joomla extensions available for migrating the data from Joomla 1.5 to Joomla 1.7 or 2.5, '''jUpgrade''' and '''SP Upgrade'''. This article will show instructions for both and you can choose which solution is better for you.
 
There are two Joomla extensions available for migrating the data from Joomla 1.5 to Joomla 1.7 or 2.5, '''jUpgrade''' and '''SP Upgrade'''. This article will show instructions for both and you can choose which solution is better for you.
  

Revision as of 04:03, 21 March 2013

There are two Joomla extensions available for migrating the data from Joomla 1.5 to Joomla 1.7 or 2.5, jUpgrade and SP Upgrade. This article will show instructions for both and you can choose which solution is better for you.

Some of the differences between jUpgrade and SP Upgrade:

  • jUpgrade is free, SP Upgrade is commercial (€19.95).
  • jUpgrade changes the IDs of Joomla categories which makes the upgrade process more difficult, while SP Upgrade retains the same IDs.
  • jUpgrade must be installed on your Joomla 1.5 site and it will create Joomla 1.7 site for you with Joomla 1.5 data. SP Upgrade must be installed on exiting Joomla 1.7 site and you can use it to migrate the data from Joomla 1.5 site.


jUpgrade extension is available here (Note: free registration is required to download the extension):


SP Upgrade extension is available here:


Notes:

  • These instructions will show you how to migrate Joomla core data and JReviews data to Joomla 1.7. For data migration of other Joomla extensions that you have on your Joomla 1.5 site, refer to their documentation for instructions.
  • It is a good idea to backup the database before proceeding with the migration.


Migrating data using jUpgrade extension

Video Tutorial

Watch in HD on YouTube

Steps

  • First make sure your main site uses the latest Joomla 1.5.25 and the latest version of JReviews. It is important that you install the same version of JReviews on the J1.7 site that you have on J1.5 site, the best way to ensure that is to install the latest version of JReviews on the J1.5 site.
  • Install jUpgrade extension (com_jupgrade-1.2.0.zip) on your Joomla 1.5 site using Joomla installer.
  • Go to Components -> jUpgrade to start the migration process (the extension will ask you to enable MooTools Upgrade plugin if it's disabled)
  • Click on "Start upgrade" button. jUpgrade will then download the latest Joomla 1.7 release, install it and migrate all Joomla core data. The new site will be located inside the /jupgrade subfolder of your main site and it will use the same database, but with a different table prefix (j17_ instead of jos_).
  • Next step is to transfer JReviews database tables for the new site (that needs to be done before installing JReviews on Joomla 1.7). Since the new site is installed in the same database, you could just rename all jos_jreviews_ tables to j17_jreviews_, but it is safer to create copies of the tables. To do that, go to phpMyAdmin, select the database you are using and click on the Export tab. Select all jos_jreviews_ tables and export them into .sql file.

ExportJReviewsTables.png

  • Edit the sql file using a text editor (i.e. Notepad++) and do a "Search and replace" to replace jos_ to j17_ everywhere in the file. Save the file, go back to phpMyAdmin and import the file. Click on the database name to refresh the tables and you should see JReviews tables together with core Joomla 1.7 tables:

JReviewsDatabaseTables.png

  • Now you can install JReviews on the Joomla 1.7 site. Read Installing JReviews.
  • Next go to Installer/Updater menu in JReviews administration and install MigrationHelper add-on:

MigrationHelper.jpg

  • Reload the page and click on the Migrationhelper link in the menu to access the add-on, you should see this screen:

MigrationHelper2.jpg

  • Click on the Reset Category Manager button. Then go to JReviews Categories Manager and setup categories again. Make sure you read Using JReviews with unlimited levels of categories in Joomla 1.6.
  • Click on Reset Access Settings button. After that, you can adjust Access Settings how you want.
  • Click on Move Images button.
  • Old JReviews menu items will no longer work, we need to edit them and configure again.
  • Run this url to make sure database tables are updated:
    • /administrator/index.php?option=com_jreviews&url=install&sql=1

Your Joomla 1.7 site should now have all your JReviews data from the old Joomla 1.5 site.


Migrating data using SP Upgrade extension

  • First make sure your main site uses the latest Joomla 1.5.25 and the latest version of JReviews. It is important that you install the same version of JReviews on the J1.7 site that you have on J1.5 site, the best way to ensure that is to install the latest version of JReviews on the J1.5 site.
  • Download the latest version of Joomla 1.7 and install it in a new database. During the installation, Joomla will suggest a randomly generated database table prefix (i.e. hx31_), but you should change that to jos_ to make the migration process easier. Important: don't install the sample data.
  • After the installation is completed, login to the Joomla 1.7 administration, go to Extensions Manager and install SP Upgrade extension.
  • After SP Upgrade is installed, it will ask you to enter Joomla 1.5 database information and to select the data you want to migrate. Select everything you want and click the Migrate button.
  • Next step is to transfer JReviews database tables from the old site's database to the new database (that needs to be done before installing JReviews on Joomla 1.7). Go to phpMyAdmin, select your Joomla 1.5 database and click on the Export tab. Select all jos_jreviews_ tables and export them into .sql file.

ExportJReviewsTables.png

  • Next go to the Joomla 1.7 database and import the file. Click on the database name to refresh the tables and you should see JReviews tables together with core Joomla 1.7 tables:

JReviewsDatabaseTables2.png

  • Now you can install JReviews on the Joomla 1.7 site. Read Installing JReviews.
  • Next go to Installer/Updater menu in JReviews administration and install MigrationHelper add-on:

MigrationHelper.jpg

  • Reload the page and click on the Migrationhelper link in the menu to access the add-on, you should see this screen:

MigrationHelper2.jpg

  • With SP Upgrade it is not necessary to click on Reset Category Manager button, just go to the JReviews Categories Manager and setup your ex Sections which are now categories. For those categories select "This category will not have listings" instead of a listing type. Read Using JReviews with unlimited levels of categories in Joomla 1.6 for more details.
  • Click on Reset Access Settings button. After that, you can adjust Access Settings how you want.
  • Click on Move Images button.
  • Old JReviews menu items will no longer work, we need to edit them and configure again.
  • Run this url to make sure database tables are updated:
    • /administrator/index.php?option=com_jreviews&url=install&sql=1

Your Joomla 1.7 site should now have all your JReviews data from the old Joomla 1.5 site.