Join · Login ·

Tutorial

How to move Dolphin to another location in your web space or hosting account:

For 6.1x Versions

Move your website from:
yoursite.com

To:
yoursite.com/dolphin


Aside from moving the actual files and folders which I will explain in a moment there are a number of important files that need to be update to reflect the changes. You also need to update your cron jobs with the new paths in your hosting control panel. If you forget or don't make all the necessary changes your site will either not work at all or you will get errors and email error reports. So it is important that you do not miss one of these. Take your time and double check.

The files that need changes:

/inc/header.inc.php
$site['url']               = "http://www.yoursite.com/";

$dir['root']               = "/home/your-account-name/public_html/";


/periodic/cmd.php
require_once( '/home/your-account-name/public_html/inc/header.inc.php' );

/periodic/cupid.php
require_once( '/home/your-account-name/public_html/inc/header.inc.php' );

/periodic/notifies.php
require_once( '/home/your-account-name/public_html/inc/header.inc.php' );

/periodic/periodic.file
MAILTO=you@yoursite.com
0 0 * * *  /usr/local/bin/php -q /home/your-account-name/public_html/periodic/cmd.php
*/10 * * * *  /usr/local/bin/php -q /home/your-account-name/public_html/periodic/notifies.php
* */1 * * *  /usr/local/bin/php -q /home/your-account-name/public_html/periodic/cupid.php


/ray/modules/global/inc/header.inc.php
include("/home/your-account-name/public_html/inc/header.inc.php");


In your hosting control panel the cron jobs:
/usr/local/bin/php -q /home/your-account-name/public_html/periodic/cmd.php
/usr/local/bin/php -q /home/your-account-name/public_html/periodic/notifies.php
/usr/local/bin/php -q /home/your-account-name/public_html/periodic/cupid.php



In the following instructions I will be using the host control panel "cpanel" to move the Dolphin files and folders. This is probably the best way to move them from one location to another. Using cpanel to move them will keep the file and folder permissions intact. All those 644, 666, 755, and 777 permissions you were asked to change during the installation process will remain if you use cpanel. However, if you move the files and folders using a ftp client such as filezilla they may reset and change to the standard permission levels determined by the host server configuration. Which means you would then need to change many of the permissions again. Which can be a long tedious task. So the better solution is to use "cpanel" to move them.

I will be moving from the main root home directory folder (public_html) http://www.yoursite.com to http://www.yoursite.com/dolphin (public_html/dolphin) which is a subfolder/subdirectory.


This example will assume that you do not have anything uploaded to your home directory (public_html).

Now login to your hosts cpanel and navigate to "File Manager"


Cpanel File Manager

 

 


Select "Web Root (public_html/www)" and make sure you also select "Show Hidden Files (dotfiles)" so you can see and select .htaccess files as well then click "Go"

 

File Manager Web Root

 

 


First we want to create the folder/directory named dolphin (yoursite.com/dolphin) to move the files to.

Click on "New Folder


New Folder

 

 

Enter "New Folder Name:" dolphin
"New Folder will be created in:" /public_html (this is the default location and you shouldn't need to change this).
Click Create New Folder Button

 

Name Folder

 

 


Next

If you only have Dolphin installed you can use the "Select all" option here to check them all at once rather than clicking each individually. If you do have other files and folders you will need to deselect them, if you don't want to move them.

 

Select All

 



After you have selected all the files and folders choose "Move File"

 

Move File

 



On this screen at the very bottom change /public_html
to:
/public_html/dolphin

And then click "Move File(s)" button.

 

Move Files & Directories to Dolphin

 



After this, all your files in your main root home directory (public_html) should now be in public_html/dolphin or yoursite.com/dolphin

If you used this cpanel method of moving files, then all permissions should remain intact and no further permission changes should be necessary.

Now in the next steps we need to edit and update some important files to reflect the new location yoursite.com/dolphin (public_html/dolphin) so that it will work properly. We will do each one by one.

You can use the same cpanel file manager's edit file feature for this, or you may now use your ftp client like filezilla to do this.

I will continue using cpanel file manager since the above instructions to move the files used this.


First navigate to and select /inc/header.inc.php and click "Edit"

 

Edit Header

 



We need to change near the first part of the file:
$site['url']               = "http://www.yoursite.com/";

To:
$site['url']               = "http://www.yoursite.com/dolphin/";

(make sure there is a trailing slash (/) (dolphin/) exactly as displayed here)
(obviously the yoursite.com would really be your site name)

Then scroll down the file a little further and find:
$dir['root']               = "/home/your-account-name/public_html/";

Change to:
$dir['root']               = "/home/your-account-name/public_html/dolphin/";

(again don't forget the trailing slash (/) (dolphin/) exactly as displayed here)

Save the changes.

 

Before:

 

Before

 


After Changes:

 

After

 

 

 

Save Changes Button:

 

Save Changes

 

 


Now on to the period folder. Navigate to /periodic folder and select /periodic/cmd.php and select "edit" again.

Near the first part of the file
require_once( '/home/your-account-name/public_html/inc/header.inc.php' );

Change it to:
require_once( '/home/your-account-name/public_html/dolphin/inc/header.inc.php' );

Save the changes.

 

Before:

 

Before

 

 

 

After:

 

After

 

 


Open /periodic/cupid.php with the cpanel file manger and select "Edit"

Find near the top:
require_once( '/home/your-account-name/public_html/inc/header.inc.php' );

Change to:
require_once( '/home/your-account-name/public_html/dolphin/inc/header.inc.php' );

Save the changes.

 

Before:

 

Before

 

 

 

After:

 

After

 

 


Open and "edit" /periodic/notifies.php

Find near the top:
require_once( '/home/your-account-name/public_html/inc/header.inc.php' );

Change to:
require_once( '/home/your-account-name/public_html/dolphin/inc/header.inc.php' );

Save the changes.

 

Before:

 

Before

 

 

 

After:

 

After

 



Open and "edit" /periodic/periodic.file

Find:
MAILTO=you@yoursite.com
0 0 * * *  /usr/local/bin/php -q /home/your-account-name/public_html/periodic/cmd.php
*/10 * * * *  /usr/local/bin/php -q /home/your-account-name/public_html/periodic/notifies.php
* */1 * * *  /usr/local/bin/php -q /home/your-account-name/public_html/periodic/cupid.php

Change to:
MAILTO=you@yoursite.com
0 0 * * *  /usr/local/bin/php -q /home/your-account-name/public_html/dolphin/periodic/cmd.php
*/10 * * * *  /usr/local/bin/php -q /home/your-account-name/public_html/dolphin/periodic/notifies.php
* */1 * * *  /usr/local/bin/php -q /home/your-account-name/public_html/dolphin/periodic/cupid.php

Save the changes.

 

Before:

 

Before

 

 

 

After:

 

After

 


Now one more file and then the cron jobs.

Open and "edit" /ray/modules/global/header.inc.php

Near the top of the file find:
include("/home/your-account-name/public_html/inc/header.inc.php");

Change to:
include("/home/your-account-name/public_html/dolphin/inc/header.inc.php");

Save the changes.

 

Before:

 

Before

 

 

 

After:

 

After

 

 


Whooo that was a lot of work, but we are almost done.

You can close the "Cpanel file manger" now if you followed these steps correctly.

Then in your standard "cpanel" main account area scroll down until you find "Cron Jobs"

 

Cpanel Cron Jobs

 



The fastest easiest way to change a cron is to select the "Advanced (Unix Style)" button / option since we just need to edit the location. So click on the "Advanced (Unix Style)" button.

Advanced Unix Style

 


Now in the cron command box we just need to add the folder/directory dolphin to each cron.

So in each cron command box you will find:
/usr/local/bin/php -q /home/your-account-name/public_html/periodic/cmd.php
/usr/local/bin/php -q /home/your-account-name/public_html/periodic/notifies.php
/usr/local/bin/php -q /home/your-account-name/public_html/periodic/cupid.php

You need to change each to:
/usr/local/bin/php -q /home/your-account-name/public_html/dolphin/periodic/cmd.php
/usr/local/bin/php -q /home/your-account-name/public_html/dolphin/periodic/notifies.php
/usr/local/bin/php -q /home/your-account-name/public_html/dolphin/periodic/cupid.php

Then just click "Commit Changes" button.

 

Before:

 

Before

 

 

 

After:

 

After

 

 

 

Commit Changes (Save Changes):

 

Commit Changes - Save Changes

 

 


(you are just adding the location or path to the new folder dolphin basically.)

You do not need to change any of the minute-hour-day-month-weekday settings. They should all remain the same as the current settings.




OK take a deep breath. If all is well your website should now be totally moved from:
yoursite.com

To:
yoursite.com/dolphin

Your admin login would now be:
yoursite.com/dolphin/admin
or
yoursite.com/dolphin/admin/index.php

If not you missed a step, file, moved it to another location by accident, or entered/edited the paths wrong.



Notes:

You are just moving the files with cpanel filemanger to /dolphin. Then updating the files to reflect the new location or path.

 

In the above instructions you will notice paths such as:

  • /home/your-account-name/public_html/inc/header.inc.php

 

Obviously your-account-name would be your actual cpanel hosting account name. It should already be filled in and you don't need to touch this. You only need to add /dolphin to the path like:

  • /home/your-account-name/public_html/dolphin/inc/header.inc.php
 
Tutorial by: Jeremy LeSarge (AKA Ray)

I am the owner and administrator of DialMe.com. I write Tutorials for Boonex Dolphin as well as tips and resources surrounding website programming and development. I enjoy working with WordPress, SEO, and Web Hosting / Servers. I also maintain a WordPress Blog here on this site where you will find a variety of technology and webmaster resources.

Actions
Recommend