Migration from JG 1.5.7 to JG 2

Article Index

The migration from JoomGallery 1.5.7 to JoomGallery 2 is possible with the help of the migration script you can download here.

Please note that the migration can only be done from JoomGallery 1.5.7. In case that you are still using previous versions you have to update them first.

This article will guide you through all the steps that have to be done for migrating the gallery successfully:



Step 1: Backup

Surely this is the most important step for the whole migration. Even though we have tested the migration extensively we cannot guarantee that it will work successfully for everyone.
There can be undiscovered bugs or the migration fails because of missing write permissions on the server, for example.

Therefore, a complete backup of the filesystem and the database tables is indispensable.

In case that the migration fails this is the only possibility to reverse the operation. Please create the backup carefully and test it.

The migration deletes all image files in the source folders.

Step 2: Preconditions

Since a simple update from Joomla! 1.5 to Joomla! 1.7/2.5 isn't possible you have usually two parallel Joomla! installations: Old Joomla! 1.5 and the new Joomla! 1.7/2.5 (created with component jUpgrade, for example).
Please do a check im migration manager in the old installation for removing problems if there are any.
For migration of JoomGallery additionally the following preconditions must be fulfilled:


  • The three image folders of the images to migrate must be in the same webspace than the new Joomla! 1.7/2.5.
  • The database tables of JoomGallery 1.5.7 must be in the same database than the tables of the new Joomla! 1.7/2.5.


These conditions are already fulfilled if you used jUpgrade component for creating the new Joomla! 1.7/2.5. In this case please simply jump to step 3.

Otherwise please check whether the conditions are fulfilled:


  • If the images are on another server you have to move them to the new one via FTP first.
  • If the database tables are in another database, please transport them to the new one via export/import of PhpMyAdmin or MySQL-Dumper.
    Important: Along with that, please ensure that there prefix (the part afore string 'joomgallery') is not the same than the one of the other tables there (but a uniform one). Otherwise the migration is not possible.


Step 3: Installation of JoomGallery

In accordance with the preconditions the images are now on the same server than the Joomla! to which you want to migrate and the old database tables of JoomGallery are in the same database than that Joomla!, but with their own prefix.

Please download JoomGallery 2 now from here and install it via the installer of Joomla! 1.7/2.5.

If everything is correct there shouldn't be any problems during installation and you should get a message for the successful installation, not a message for an update or even an error.

If you don't want to store the images in the default image folders of JoomGallery (in 'images/joomgallery/') please edit the image paths in first tab of the ocnfiguration manager and create the folders now.

Step 4: Installation of migration script

Please download the migration script now (if not already done) from here and install it also via the installer of Joomla! 1.7/2.5.

After the installation please enable the offline mode of Joomla! 1.7/2.5. You can do that in the first section of global configuration of Joomla!.

Then, please go to migration manager of JoomGallery 2 (you can find it near CSS manager and maintenance manager in the menu of JoomGallery).
There, you should see a possibility for migrating JoomGallery 1.5.7 to JoomGallery 2 with a small form and a check button. This form has to be filled completely first:

Database prefix of Joomla! 1.5
Please insert here the database prefix of the old Joomla! 1.5 (e.g. jos_).

Path to Joomla! 1.5
If the old Joomla! 1.5 installation is on another server or doesn't exist anymore, please insert here a hyphen: '-'.
Otherwise, you have to enter the complete absolute path to the old Joomla! 1.5. The suggested value is the path to the current Joomla! 1.7/2.5 and has to be changed usually only marginally. For determining the correct path you should have a look on your server via FTP.

Path to original images, Path to detail images, Path to thumbnails
Here you have to specify the paths to the original, detail and thumbnail folders of the old Joomla! installation. If you entered a hyphen at Path to Joomla! 1.5 you will have to specify the complete absolute paths. Otherwise, please copy in the corresponding values from the configuration manager of the old JoomGallery 1.5.7.

Check owners
If this option is enabled there will be checked for all owners of the images and categories whether these users exist in Joomla! 1.7/2.5. If the latter isn't the case the value will be set to 0. This would be possibly later on in maintenance manager, too.
If you also migrated the users to Joomla! 1.7/2.5 should remain disabled.

Then, please click on 'Check'. With that it will be checked whether a migration is possible. If there are any problems you may have to go back to the form and correct the values.

Step 5: Migration

If all entries are marked green you may start the migration with the button 'Start'.

Depending on the size this may take some time (an hour or more is not uncommon). Please don't interrupt the process by no means, but wait until you get an error or a message of success.
For dealing with possible errors and a check please have a look at step 6.

Step 6: Check

If the migration ends with a message of success all categories, images, comments, name tags, votes, favourites and many parts of the configuration were transfered successfully.

After creating a menu item for the gallery in menu manager of Joomla! should see the gallery in frontend like before.

Finally, please start a check in migration manager to ensure that actually everything is alright.

Possibly you have to adjust some settings in configuration manager because there couldn't be migrated all settings for technical reasons (especially the part of the upload permissions and things like that because this is handled via the ACL of Joomla! now).

In the case there there were errors during the migration please download the log file 'migration.mvc2acl.php' from the log directory of Joomla!. Usually, this is the folder 'logs' in the root directory of Joomla!.
If you migrated your Joomla! with the help of component jUpgrade possibly the log directory of the old Joomla! installation is still used for the new one. You may check that in the global configuration.

Please have a precise look at the log file. If only single images weren't transfered you probably are able to do that manually now. If there were serious errors (e.g. a category could not be created) please import your backup and check whether there is alright in the old Joomla! installation afore trying again.

If you have any questions please feel free to ask the in the board 'Migration' of our forum.

Step 7: Clearance

If the migration was successful you should uninstall the migration script again. For that, please click on 'Manage' in extension manager of Joomla! and filter by type 'File'.

The datebase tables of the old gallery are now waste because the image files were moved away and should be deleted. The image folders of the old gallery should also be deleted via FTP because during migration only the image files were moved away, so the folders are still there.


Joom::Gallery is not affiliated with or endorsed by the Joomla! Project or Open Source Matters. The Joomla! name and logo is used under a limited license granted by Open Source Matters the trademark holder in the United States and other countries.