== Upgrade Instructions from 6.1.6 to 7.0 ==


'''Step 0''': Back up all Dolphin 6.1.6 files, folders and database. Before installing Dolphin 7.0 please also check these [http://www.boonex.com/trac/dolphin/wiki/DolTech technical requirements] because Dolphin 7.0 needs a more sophisticated server setup than Dolphin 6.1.6 used to do.

'''Step 1''': Install Dolphin 7.0 on the same server as Dolphin 6.1.6 but in a different directory, for example, if Dolphin 6.1.6 is installed at http://yoursite.com/, then install Dolphin 7.0 at http://yoursite.com/Dolphin7.

'''Step 2''': Your Dolphin 6.1.6 site will stay put, so you can play with it a few times, no sweat. Anyway do the backup as stated in Step 0 above.

'''Step 3''': You can only migrate from 6.1.6 (6.1.5 could play ball too, but we haven't checked). That is, your templates and custom modifications won't be transferred. And you will have to re-develop them afterwards.

'''Step 4''': The Dolphin 7 installation must be a "clean install" with all the modules installed (at least those you used to use in 6.1.6). The '''Data migration from Dolphin 6.1.6''' module should be installed as well. All necessary modules can be installed in '''Tools -> Modules'''.

Migration is a "cron job" thing, so cron jobs for Dolphin 7.0 have to be properly configured. You can learn how to configure them [http://www.boonex.com/trac/dolphin/wiki/DetailedInstall70#SettingupCronjobs here].

'''Step 5''': Now navigate to '''Modules -> Data migration -> Set configuration'''. Here you should specify the server path to Dolphin 6.1.6 installation folder, for example: '''/home/user/public_html/'''.

You can learn this path from the '''inc/header.inc.php''' file inside Dolphin 6.1.6 installation folder. Look for the line containing '''$dir[ ' root ' ]''' statement and copy its right part inside the quotation marks, for example:
{{{
$dir['root'] = "/home/user/public_html/";
}}}

Click the '''Submit''' button to save the changes.

'''Step 6''': Now switch to '''Data migration''' tab and choose the first option in '''Select the data''' drop-down list. This option is '''Profiles'''. If your Dolphin 7.0 cron is properly running, the profiles should get transferred during 5 minutes. You can meanwhile refresh the page to check the status of the job. Once they are transferred (the word "transferred" will appear next to them in the list) you can go on to "Polls". The procedure here is similar.

'''NOTE 1''': If you have custom profile fields, you can transfer them using the "''Custom Fields''" function in the "''Data Migration from Dolphin 6.1.6''" module of Dolphin 7.0. All the fields will be transferred automatically without any manual assistance.

'''NOTE 2''': The RMS which you have used with Dolphin 6.1.x will not work in Dolphin 7.0. You will have to install the latest RMS for Dolphin 7.0.

'''NOTE 3''': The memberships will be also transferred but they won't have any assigned actions because these actions are added by every module. So, as soon as you have transferred everything, you will have to assign membership actions. You can do it in '''Dashboard -> Settings -> Membership Levels -> Levels -> click on a level -> tick all appropriate actions -> click Enable or Disable'''.


[[BR]]
[[BR]]
'''IMPORTANT'''
[[BR]]
To make sure you are not banned by search engines and save all old links from Dolphin 6.1.6, do the following: 
[[BR]]

Add these modrewrite rules to your .htaccess file:

{{{

RewriteBase /path-to-your-dolphin-url-folder/

RewriteRule ^articles/{0,1}$	m/articles/index/ [QSA,L,R=permanent]
RewriteRule ^articles/entry/([^/.]+)/{0,1}$   m/articles/view/$1 [QSA,L,R=permanent]
RewriteRule ^articles/entry/{0,1}$   m/articles/view/$1 [QSA,L,R=permanent]
RewriteRule ^articles/category/([^/.]+)/{0,1}$   m/articles/category/$1 [QSA,L,R=permanent]

RewriteRule ^news/{0,1}$	m/news/index/ [QSA,L,R=permanent]
RewriteRule ^news/([^/.]+)/{0,1}$	m/news/view/$1 [QSA,L,R=permanent]

RewriteRule ^ads/search/{0,1}$	classifieds.php?SearchForm=1 [QSA,L,R=permanent]
RewriteRule ^ads/my/{0,1}$	modules/boonex/ads/classifieds.php?action=my_page [QSA,L,R=permanent]
RewriteRule ^ads/new/{0,1}$	modules/boonex/ads/classifieds.php?action=show_all_ads [QSA,L,R=permanent]

RewriteRule ^events/{0,1}$  m/events/home/ [QSA,L,R=permanent]
RewriteRule ^events/all/([0-9]+)/([0-9]+)/{0,1}$  m/events/browse/upcoming/$2/$1  [QSA,L,R=permanent]
RewriteRule ^events/part/{0,1}$  m/events/browse/upcoming/ [QSA,L,R=permanent]
RewriteRule ^events/search/{0,1}$  m/events/browse/ [QSA,L,R=permanent]
RewriteRule ^events/search/([^/.]+)/{0,1}$  m/events/browse/tag/$1 [QSA,L,R=permanent]
RewriteRule ^events/my/{0,1}$  m/events/browse/my [QSA,L,R=permanent]
RewriteRule ^events/new/{0,1}$  m/events/browse/upcoming [QSA,L,R=permanent]
RewriteRule ^events/entry/([^/.]+)/{0,1}$  m/events/view/$1 [QSA,L,R=permanent]
RewriteRule ^events/part/([^/.]+)/{0,1}$  m/events/browse_participants/$1 [QSA,L,R=permanent]

RewriteRule ^groups/all/{0,1}$	m/groups/home/ [QSA,L,R=permanent]
RewriteRule ^groups/entry/([^/.]+)/{0,1}$	m/groups/view/$1	[QSA,L,R=permanent]
RewriteRule ^groups/category/([^/.]+)/{0,1}$	m/groups/browse/category/$1	[QSA,L,R=permanent]
RewriteRule ^groups/keyword/([^/.]+)/{0,1}$	m/groups/browse/tag/$1	[QSA,L,R=permanent]

RewriteRule ^photo/all/([0-9]+)/([0-9]+)/{0,1}$ m/photos/browse/all/&page=$2&per_page=$1 [QSA,L,R=permanent]
RewriteRule ^photo/gallery_top/{0,1}$ m/photos/browse/top/ [QSA,L,R=permanent]
RewriteRule ^photo/gallery_top/([0-9]+)/([0-9]+)/{0,1}$  m/photos/browse/top/&page=$2&per_page=$1 [QSA,L,R=permanent]
RewriteRule ^photo/gallery_top/([0-9]+)/([0-9]+)/{0,1}$  m/photos/top/&page=$2&per_page=$1 [QSA,L,R=permanent]
RewriteRule ^photo/gallery_tag/([^/.]+)/([0-9]+)/([0-9]+)/{0,1}$  m/photos/browse/tag/$1&page=$3&per_page=$2 [QSA,L,R=permanent]
RewriteRule ^photo/gallery_tag/([^/.]+)/([0-9]+)/([0-9]+)/$  m/photos/browse/tag/$1&page=$3&per_page=$2 [QSA,L,R=permanent]
RewriteRule ^photo/gallery_tag/([^/.]+)/{0,1}$  m/photos/browse/tag/$1 [QSA,L,R=permanent]
RewriteRule ^photo/gallery/all/([^/.]+)/([0-9]+)/([0-9]+)$  m/photos/albums/browse/owner/$1&page=$3&per_page=$2 [QSA,L,R=permanent]
RewriteRule ^photo/gallery/all/([^/.]+)/([0-9]+)/([0-9]+)/$  m/photos/albums/browse/owner/$1&page=$3&per_page=$2 [QSA,L,R=permanent]
RewriteRule ^photo/gallery/all/([^/.]+)/{0,1}$  m/photos/albums/browse/owner/$1 [QSA,L,R=permanent]
RewriteRule ^photo/gallery/([^/.]+)/{0,1}$  m/photos/view/$1 [QSA,L,R=permanent]
RewriteRule ^photo/gallery/{0,1}$  m/photos/view/$1 [QSA,L,R=permanent]

RewriteRule ^music/all/([0-9]+)/([0-9]+)/{0,1}$ m/sounds/browse/all/&page=$2&per_page=$1 [QSA,L,R=permanent]
RewriteRule ^music/gallery_top/{0,1}$ m/sounds/browse/top/ [QSA,L,R=permanent]
RewriteRule ^music/gallery_top/([0-9]+)/([0-9]+)/{0,1}$  m/sounds/browse/top/&page=$2&per_page=$1 [QSA,L,R=permanent]
RewriteRule ^music/gallery_top/([0-9]+)/([0-9]+)/{0,1}$  m/sounds/top/&page=$2&per_page=$1 [QSA,L,R=permanent]
RewriteRule ^music/gallery_tag/([^/.]+)/([0-9]+)/([0-9]+)/{0,1}$  m/sounds/browse/tag/$1&page=$3&per_page=$2 [QSA,L,R=permanent]
RewriteRule ^music/gallery_tag/([^/.]+)/([0-9]+)/([0-9]+)/$  m/sounds/browse/tag/$1&page=$3&per_page=$2 [QSA,L,R=permanent]
RewriteRule ^music/gallery_tag/([^/.]+)/{0,1}$  m/sounds/browse/tag/$1 [QSA,L,R=permanent]
RewriteRule ^music/gallery/all/([^/.]+)/([0-9]+)/([0-9]+)$  m/sounds/albums/browse/owner/$1&page=$3&per_page=$2 [QSA,L,R=permanent]
RewriteRule ^music/gallery/all/([^/.]+)/([0-9]+)/([0-9]+)/$  m/sounds/albums/browse/owner/$1&page=$3&per_page=$2 [QSA,L,R=permanent]
RewriteRule ^music/gallery/all/([^/.]+)/{0,1}$  m/sounds/albums/browse/owner/$1 [QSA,L,R=permanent]
RewriteRule ^music/gallery/([^/.]+)/{0,1}$  m/sounds/view/$1 [QSA,L,R=permanent]
RewriteRule ^music/gallery/{0,1}$  m/sounds/view/$1 [QSA,L,R=permanent]

RewriteRule ^orca/$  forum/ [QSA,L,R=permanent]
RewriteRule ^orca/(.*)$  forum/$1 [QSA,L,R=permanent]

RewriteRule ^video/all/([0-9]+)/([0-9]+)/{0,1}$ m/videos/browse/all/&page=$2&per_page=$1 [QSA,L,R=permanent]
RewriteRule ^video/gallery_top/{0,1}$ m/videos/browse/top/ [QSA,L,R=permanent]
RewriteRule ^video/gallery_top/([0-9]+)/([0-9]+)/{0,1}$  m/videos/browse/top/&page=$2&per_page=$1 [QSA,L,R=permanent]
RewriteRule ^video/gallery_top/([0-9]+)/([0-9]+)/{0,1}$  m/videos/top/&page=$2&per_page=$1 [QSA,L,R=permanent]
RewriteRule ^video/gallery_tag/([^/.]+)/([0-9]+)/([0-9]+)/{0,1}$  m/videos/browse/tag/$1&page=$3&per_page=$2 [QSA,L,R=permanent]
RewriteRule ^video/gallery_tag/([^/.]+)/([0-9]+)/([0-9]+)/$  m/videos/browse/tag/$1&page=$3&per_page=$2 [QSA,L,R=permanent]
RewriteRule ^video/gallery_tag/([^/.]+)/{0,1}$  m/videos/browse/tag/$1 [QSA,L,R=permanent]
RewriteRule ^video/gallery/all/([^/.]+)/([0-9]+)/([0-9]+)$  m/videos/albums/browse/owner/$1&page=$3&per_page=$2 [QSA,L,R=permanent]
RewriteRule ^video/gallery/all/([^/.]+)/([0-9]+)/([0-9]+)/$  m/videos/albums/browse/owner/$1&page=$3&per_page=$2 [QSA,L,R=permanent]
RewriteRule ^video/gallery/all/([^/.]+)/{0,1}$  m/videos/albums/browse/owner/$1 [QSA,L,R=permanent]
RewriteRule ^video/gallery/([^/.]+)/{0,1}$  m/videos/view/$1 [QSA,L,R=permanent]
RewriteRule ^video/gallery/{0,1}$  m/videos/view/$1 [QSA,L,R=permanent]


}}}


after the following line:
{{{
RewriteEngine on 
}}}


Don't forget to replace '''/path-to-your-dolphin-url-folder/''' with your real path. For example if your site is '''http://www.mysite.com/dolphin/''' then it will look like this:

{{{
RewriteBase /dolphin/
}}}