| 1 | |
| 2 | == Dolphin Upgrade Instructions == |
| 3 | |
| 4 | '''From:''' 5.6.0005 |
| 5 | |
| 6 | '''To:''' 6.0 (and higher) |
| 7 | |
| 8 | '''First - Backup all files and database of your Dolphin site.''' |
| 9 | If you use Zip Codes, please save them. |
| 10 | |
| 11 | |
| 12 | |
| 13 | '''1.''' Open and edit the file '''inc/header.inc.php''' of your existing Dolphin site. |
| 14 | |
| 15 | Find the following lines: |
| 16 | |
| 17 | {{{ |
| 18 | if ( file_exists( $dir['root'] . 'install' ) ) |
| 19 | { |
| 20 | echo "You will see this nice message every time until you remove <b>install</b> directory"; |
| 21 | exit(); |
| 22 | } |
| 23 | }}} |
| 24 | |
| 25 | and delete them. |
| 26 | Save the file and re-upload it. |
| 27 | |
| 28 | '''2.''' Download and unzip the Upgrade pack. You will find '''install''' directory in it. You need to upload to your Dolphin's root directory. |
| 29 | |
| 30 | '''3.''' Set permissions for the folder '''install/sql''' to ''777''. |
| 31 | |
| 32 | '''4.''' Run the following URL in your favourite browser and follow the onscreen instructions: |
| 33 | {{{http://<your_site>/<path_to_dolphin>/install/upgrade.php}}} |
| 34 | |
| 35 | This script will convert your database and save the results to the '''install/sql''' folder. |
| 36 | |
| 37 | '''Note:''' This script will create a few temporary tables for conversion purposes and then will delete them. |
| 38 | But this will not change anything in your current tables. |
| 39 | |
| 40 | '''Note:''' The script may take a few minutes. It depends on the size of your database (number of profiles, media, blogs, etc.). |
| 41 | Thus if you think the script is stuck, please don't cancel execution. Just wait. |
| 42 | |
| 43 | '''Note:''' The conversion procedure doesn't include ZIP codes export because of performance problems. |
| 44 | Therefore, if you have ZIP codes in your database, you will have to import them again after upgrade. |
| 45 | |
| 46 | '''Note:''' The conversion script deletes a few old non-mandatory fields from your profiles tables. |
| 47 | This won't affect the fields that you created manually after Dolphin installation. |
| 48 | If you wish to save some of them, before running the script edit the lines marked as follows in the '''install/db_upg/profiles.sql''' file: |
| 49 | {{{ |
| 50 | -- Non mandatory Fields |
| 51 | }}} |
| 52 | Comment out the lines with the fields which you want to save using the '{{{-- }}}' (minus, minus, space). |
| 53 | Also edit the file '''install/db_upg/profiles_desc.sql''' and comment out the lines with the same fields. |
| 54 | Do it carefully to avoid errors. |
| 55 | If you're unsure that you can make it on your own but you need to make these changes, you should contact us at support@boonex.com. |
| 56 | |
| 57 | '''5.''' Delete all files and folders from Dolphin's root directory. Remove the cron jobs. |
| 58 | |
| 59 | '''Attention! ''' Do not delete the '''install''' and '''media''' folders. |
| 60 | |
| 61 | '''6.''' Upload the latest Dolphin 6.0 package in your Dolphin's root directory. |
| 62 | |
| 63 | '''7.''' Commence the standard procedure for Dolphin installation. |
| 64 | At the Database installation step you should indicate the file '''./sql/v60_convert.sql''' instead of the default one. |
| 65 | Finish the installation. |
| 66 | |
| 67 | '''Upgrade is complete.''' |