Programmer's Reference
Moving Servers in Six Easy Steps
If your discussion board grows beyond the capabilities offered by your current host, then you can migrate the whole vBulletin installation from one server to another with the minimum of fuss and effort. In this section we will look at how to do this.
We can break down the server move into six easy steps.
•Cookie check
•Back up database
•Download the vBulletin installation
•Transfer to new server
•Restore database
•Back online!
Cookie Check
The first thing to do is check on the current cookie settings. Setting a specific cookie domain and cookie paths can cause problems for you when moving servers or even changing the URL of the discussion board. To prevent these problems, reset your cookie path to / and remove any cookie domain value that might be present before carrying out the server move.
A warning about cookies!
An incorrectly set cookie domain or path can prevent you from accessing your control panel!
Back up Database
The next step is to back up the database. Refer to Chapter 5 for full details on how to do this. Make sure that you use an up-to-date backup and that you've locked the forum prior to carrying out the backup so that there can be no changes made to the data.
Download the vBulletin Files
Using an FTP program, download your current vBulletin installation to your PC. You could reinstall vBulletin onto the new server, but you will lose any changes you made.
Transfer to New Server
The quickest and easiest way to transfer the database to a new server is using SSH or Telnet.
198
Chapter 9
New Host Tips
Make sure that your new host allows you to have such shell access. (They might not allow it as standard, but check to see if they will allow it temporarily to allow you to carry out the move.)
Follow this simple transfer process.
1.Telnet into your existing server.
2.Type the following:
ftp NEWSERVER
Where NEWSERVER is the hostname or IP address of your new server. You will be prompted for a username and password to login.
3.Next, type:
bin
cd /PATH/TO/NEW/DIRECTORY
put /PATH/TO/DATABASE/DUMP.SQL
replacing /PATH/TO/NEW/DIRECTORY by the path to the directory where you want to place the database backup and /PATH/TO/DATABASE/DUMP.SQL by the path to the database dump. If you omit this step, the backup will be put into the root of the server.
4.This process will now transfer the database.
5.When completed, type:
close quit
6.Verify that the database has been transferred.
Database Restoration
1.On the new server, create the database in which your vBulletin data will be installed.
2.Telnet/SSH into the new server.
3.Type:
mysql -USERNAME -p NEWDATABASENAME < PATH/TO/DUMP.SQL
replacing USERNAME by the username to access the database, NEWDATABASENAME by the name of the new database, and /PATH/TO/DUMP.SQL by the path to the database backup file.
Back Online
Upload your vBulletin files (the ones you downloaded earlier) remembering first to edit the
includes/config.php file. Edit $servername, $dbusername, $dbpassword, and $dbname with the
values that correspond with the new server.
199