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

This guide will follow you through the whole Upgrade process from RCx to ispCP RCx. IT'S NOT POSSIBLE TO USE THIS GUIDE TO UPGRADE A NIGHTLY TO RCx!!!
\\
\\
**PLEASE NOTE: YOU DO THIS UPGRADE ON YOUR OWN RISK. THERE IS NO WARRANTY FOR AN SUCCESSFULL UPGRADE. FOLLOW THIS GUIDE STEP BY STEP!!!** 
\\
\\
===== Preparing your System for Upgrade =====
\\
Make Backups from your whole ispCP installation. Don't forget your databases! 

===== The Upgradeprocess =====

=== 1. Untar or unzip the distribution files to a secure directory: ===

<cli>
mkdir -p /usr/local/src/ispcp 
cd /usr/local/src/ispcp 
wget http://downloads.sourceforge.net/ispcp/ispcp-omega-1.0.0-rc6.tar.bz2  
tar -xjvf ispcp-omega-1.0.0-rc6.tar.bz2
</cli>

=== 2. Change to the newly created directory: ===
<cli>
cd ./ispcp*
</cli>

=== 3. Install the required modules ===
first update your system:
<cli>
apt-get update && apt-get upgrade
</cli>

for Debian Sarge please use:
<cli>
apt-get install `cat ./docs/Debian/debian-packages-sarge`

</cli>
for Debian Etch please use:
<cli>
apt-get install `cat ./docs/Debian/debian-packages-etch`
</cli>

for Debian Lenny/Sid please use:
<cli>
apt-get install `cat ./docs/Debian/debian-packages-lenny`
</cli>

Make sure you have added the non-free into your /etc/apt/sources.list:

<code>
deb     http://ftp.debian.org/debian/            etch         main contrib non-free
deb     http://security.debian.org/              etch/updates main contrib non-free
</code>

If using Sarge, make sure you have added the following backport into your
   /etc/apt/sources.list:

<code>
# backports
deb     http://dotdeb.pimpmylinux.org/          sarge          all
</code>

(when you get to the courier screen select 'no' to web directories)
\\
\\
(when you get to the postfix screen select 'internet site' and then type 'root'
for mail. If you've set debian up correctly on install your domain should be
already on screen.
\\
\\
Select 'no' to force sync updates.)
\\
\\
(when you get to the proftpd screen, select 'standalone')
\\
\\
(when you get to the rootkithunter screen, select two time 'yes')
\\
\\
=== 4. You have to set up some configuration variables for your linux distribution. ===
ispCP is preconfigurated for Debian 4.0 Etch.\\
If you're using another distribution please check, if config files exist in
./configs/dists and use/change them.
\\
\\
Check the ispcp.conf and adapt it to your requirements.
An overview over the variables you can find in the FAQ on
[[http://isp-control.net]]
\\
\\
=== 5. Build the System by using make: ===
<cli>
make install
</cli>

=== 6. Backups ===
<cli>
mkdir -p /tmp/backup/usr/sbin/
cp -Rv /usr/sbin/maillogconvert.pl /tmp/backup/usr/sbin/
mkdir -p /tmp/backup/var/log/
mkdir -p /tmp/backup/var/mail/
mkdir -p /tmp/backup/var/www/
cp -Rv /var/log/* /tmp/backup/var/log/
cp -Rv /var/mail/* /tmp/backup/var/mail/
cp -Rv /var/www/* /tmp/backup/var/www/
mkdir -p /tmp/backup/etc/
cp -Rv /etc/* /tmp/backup/etc/
</cli>
=== 7. Save key files ===
<cli>
cp -v /var/www/ispcp/engine/ispcp-db-keys.pl /tmp/ispcp/var/www/ispcp/engine/
cp -v /var/www/ispcp/engine/messager/ispcp-db-keys.pl /tmp/ispcp/var/www/ispcp/engine/messager
cp -v /var/www/ispcp/gui/include/ispcp-db-keys.php /tmp/ispcp/var/www/ispcp/gui/include/
cp -v /var/www/ispcp/gui/tools/pma/config.inc.php /tmp/ispcp/var/www/ispcp/gui/tools/pma/config.inc.php
</cli>

or from Backup

<cli>
cp -v /tmp/backup/var/www/ispcp/engine/ispcp-db-keys.pl /tmp/ispcp/var/www/ispcp/engine/ 
cp -v /tmp/backup/var/www/ispcp/engine/messager/ispcp-db-keys.pl /tmp/ispcp/var/www/ispcp/engine/messager 
cp -v /tmp/backup/var/www/ispcp/gui/include/ispcp-db-keys.php /tmp/ispcp/var/www/ispcp/gui/include/ 
cp -v /tmp/backup/var/www/ispcp/gui/tools/pma/config.inc.php /tmp/ispcp/var/www/ispcp/gui/tools/pma/config.inc.php
</cli>

=== 8. Copy /usr and /var directories into your system (you may make backups) ===
<cli>
cp -Rv /tmp/ispcp/usr/* /usr/
cp -Rv /tmp/ispcp/var/* /var/
</cli>

=== 9. Backup ispcp.conf and copy the /etc dircetory into your system (you may make backups): ===

<cli>
mv -v /etc/ispcp/ispcp.conf /etc/ispcp/ispcp.old.conf
</cli>

If updating from RC5:
<cli>
cp -Rv /tmp/ispcp/etc/ispcp/* /etc/ispcp
</cli>

else:
<cli>
cp -Rv /tmp/ispcp/etc/* /etc/
</cli>


=== 10. Now it's time to update your installation. Change into the engine directory: ===
<cli>
cd /var/www/ispcp/engine/setup
</cli>

=== 11. Start the engine update: ===
<cli>
perl ispcp-update
</cli>
=== 12. Update ispCP step-by-step ===
\\
\\
If you get no error, all went good; if you get one, look at
[[http://isp-control.net]] to solve the problem.
\\
\\

After installation please check your proftp.conf and disable **IPv6** Support.
\\
=== 13. Clean the temporary folders: ===

ispcp setup:
<cli>
rm -fR /tmp/ispcp
</cli>

and the backups (after tests)
<cli>
rm -fR /tmp/backup
</cli>