== Dolphin Upgrade Instructions ==

'''From:''' 5.6.0005

'''To:''' 6.0 (and higher)

'''First -  Backup all files and database of your Dolphin site.'''
If you use Zip Codes, please save them. 



'''1.''' Open and edit the file '''inc/header.inc.php''' of your existing Dolphin site.

Find the following lines:

{{{
if ( file_exists( $dir['root'] . 'install' ) )
{
	echo "You will see this nice message every time until you remove <b>install</b> directory";
	exit();
}
}}}

and delete them.
Save the file and re-upload it.

'''2.''' Download and unzip the Upgrade pack. You will find '''install''' directory in it. You need to upload to your Dolphin's root directory.

'''3.''' Set permissions for the folder '''install/sql''' to ''777''.

'''4.''' Run the following URL in your favourite browser and follow the onscreen instructions:
{{{http://<your_site>/<path_to_dolphin>/install/upgrade.php}}}

This script will convert your database and save the results to the '''install/sql''' folder.

'''Note:''' This script will create a few temporary tables for conversion purposes and then will delete them.
But this will not change anything in your current tables.

'''Note:''' The script may take a few minutes. It depends on the size of your database (number of profiles, media, blogs, etc.).
Thus if you think the script is stuck, please don't cancel execution. Just wait.

'''Note:''' The conversion procedure doesn't include ZIP codes export because of performance problems.
Therefore, if you have ZIP codes in your database, you will have to import them again after upgrade.

'''Note:''' The conversion script deletes a few old non-mandatory fields from your profiles tables.
This won't affect the fields that you created manually after Dolphin installation.
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:
{{{
-- Non mandatory Fields
}}}
Comment out the lines with the fields which you want to save using the '{{{-- }}}'  (minus, minus, space).
Also edit the file '''install/db_upg/profiles_desc.sql''' and comment out the lines with the same fields.
Do it carefully to avoid errors.
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.

'''5.''' Delete all files and folders from Dolphin's root directory. Remove the cron jobs.

'''Attention! ''' Do not delete the '''install''' and '''media''' folders.

'''6.''' Upload the latest Dolphin 6.0 package in your Dolphin's root directory.

'''7.''' Commence the standard procedure for Dolphin installation.
At the Database installation step you should indicate the file '''./sql/v60_convert.sql''' instead of the default one.
Finish the installation.

'''Upgrade is complete.'''