====== Upgrade VHCS -> ispCP RCx ======

This guide will follow you through the whole Upgrade process from VHCS to ispCP RCx.
\\
\\
**PLEASE NOTE: YOU DO THIS UPGRADE ON YOUR OWN RISK. THERE IS NO WARRANTY FOR AN SUCCESSFUL UPGRADE. FOLLOW THIS GUIDE STEP BY STEP!!!** 
\\
\\
===== Preparing your System for Upgrade =====

=== 1. Making Backups ===
Please make a FULL backup of your existing VHCS installation.
\\
=== 2. Upgrade to Debian Etch ===
If you are using Debian Sarge, please upgrade to Debian Etch. If you don't know how -> [[sarge2etch|klick]]
\\
=== 3. Check your database ===
To check, if there are any wrong Database Entry's do the following steps:

<cli>

# mysql -u root -p<yourpassword>
> USE vhcs2
> UPDATE domain SET domain_status = "change";
> UPDATE subdomain SET subdomain_status = "change";
> UPDATE domain_aliasses SET alias_status = "change";
> quit
</cli>
\\
Now start:
<cli> 
/var/www/vhcs2/engine/vhcs2-rqst-mngr
</cli>
\\
After this log into your admin account and check if the status is O.K. (vhcs debugger). 
\\
If there are errors search the wrong entry, set it to **delete** and start vhcs2-rqst-mngr again.
\\
If there are no errors you can start the upgradeprocess.
\\
===== The Upgradeprocess =====

=== 1. Download and extract the distribution files to /root ===

Download the lastest RC from [[http://sourceforge.net/project/showfiles.php?group_id=189485&package_id=222121|here]]

<cli>
# cd /root
# tar -xjvf ispcp-omega-1.0.0-rcXX.tar.bz2
</cli>
\\
=== 2. Change to the ispcp directory ===
<cli>
# cd ./ispcp
</cli>

If you use a nightly build:

<cli>
# cd web/svn/nightly
</cli>
\\
=== 3. Install the required modules ===

Make sure, you added **non-free** to your [[sources.list]] 
\\ 
install the packages with apt-get
<cli>      
# apt-get update
# apt-get upgrade    
</cli>

Install the needed packages for ispCP:
<cli>
# apt-get install `cat ./docs/Debian/debian-packages-etch`
</cli>
If the installation ask you to install mod_cband, select **YES** 
\\
=== 4. Build the system ===
<cli>
# make install
</cli>
Note: By default, this will copy all the files and folders ready for the installation in the folder /tmp/ispcp
\\
=== 5. Copy all the directories into the system === 
(you may want to make backups)

<cli>
# cp -Rv /tmp/ispcp/* /
</cli>
\\
=== 6. Change into setup directory ===
Change into the engine/setup directory:

<cli>
# cd /var/www/ispcp/engine/setup
</cli>
\\
=== 7. Setup the ispcp system ===
 
<cli>
 # perl ./ispcp-setup
</cli>
\\
Note: Enter your password for MySQL root user as you are asked.
Follow the steps on the screen.

After succesful installation, the migration of the old vhcs2 database is done in the next step:
\\
=== 8. Start the update-script ===
<cli>
# perl ./ispcp-update
</cli>

Follow the steps on the screen.

If no error was shown, your VHCS installation should be successfully upgraded to ispCP.