News

How to upgrade from version 1.2 to version 2.0 without losing data METHOD 1

News - Documentation

Written by Hristo Genev Monday, 30 November 2009 14:46

If you want to make and upgrade from Apoll version 1.2 to 2.0 without loosing your created polls, you must do a little more work than usually. It's easy and it should not take you more than 3 minutes.

Both versions have significant changes in database schema, that's why they are not compatible, and uploading the new files over the old ones won't do the job.

Fortunately we have included a script which will import the polls from the 1.2 database tables and recreate them for use in the v. 2.0. The execution of the script will be triggered when you try to install v. 2.0, but only if it finds database tables left from Apoll 1.2. In other words you need to get rid of Apoll 1.2, without dropping its database tables. The normal component uninstall process will delete the Apoll 1.2 files, and will also drop the Apoll database tables, so we are not going to do a regular uninstall. We'll just delete all Apoll files and install version 2.0. Then the script will take care of everything else.

So here is the process in 3 steps. First we are going to make a backup!!! Then we are going to delete some old files, and last we are going to install the new component.

Requirements:

Apoll v. 1.2 installed on your joomla site.
Access to your files via ftp client, web file manager or etc.
Version 2.0 of Apoll downloaded

Step 1 - The backup:
1.1: BACKUP your database. (If you have a database backup, and you don't like the end result you can always go back)
1.2: BACKUP your site. (Its very important to backup all your files, since we are going to delete some. You don't wanna have that strange look if you accidentally delete something else.)

Step 2 - The deletion (Total: 2 folders and 11 files):

2.1: Make sure you delete the following 2 folders (with all files being inside):
your_site/administrator/components/com_apoll
your_site/components/com_apoll

and the following files:

2.2: 2 files from the administrator/languages/en-GB folder:
your_site/administrator/language/en-GB/en-GB.com_apoll.ini
your_site/administrator/language/en-GB/en-GB.com_apoll.menu.ini

2.3: 1 file from the your_site/language/en-GB folder:
your_site/language/en-GB/en-GB.com_apoll.ini

2.4: 4 files from the your_site/media/system/js folder:

2.5: your_site/media/system/js/jquery.colorpicker.js
2.6: your_site/media/system/js/jquery.js
2.7: your_site/media/system/js/jquery.tablednd.js
2.8: your_site/media/system/js/reorder.js

2.9: 3 files from your_site/media/system/images folder:

your_site/media/system/images/add.png
your_site/media/system/images/remove.png
your_site/media/system/images/apoll-arrow.gif

2.10: 1 file from media/system/swf folder:

your_site/media/system/swf/open-flash-chart.swf

Step 3: The installation

Download Apoll version 2.0 and install it the way you normally install components. If you have deleted all the files from the old component you should get no errors and see the congratulation message "Apoll component 2.0 successfully installed", together with messages for the successful import of the old datase.


FAQ
HELP! I get an error "JInstaller::install: There is already a folder called ..." - this undoubtedly means that you have not deleted all files mentioned in the list above, and some of them are not replaced by the new ones. No problem, uninstall Apoll 2.0 (you will not loose your created polls, because the database will not be dropped by default) and install it again.

Should you have any questions don't hasitate to use the forum.