====== Upgrade 1.x.x -> ispCP 1.x.x ======

This guide will follow you through the whole Upgrade process from 1.x.x to 1.x.x. 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!!!**  
**The most up-to-date version of this document always is the INSTALL file within the download.**
\\
\\
===== 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.2.tar.bz2
tar -xjvf ispcp-omega-1.0.2.tar.bz2
</cli>

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

=== 3. Install the required modules ===
first update your system:
<cli>
aptitude update && aptitude upgrade
aptitude install $(cat ./docs/Debian/debian-packages-`lsb_release -cs`)
</cli>

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

<code>
deb     http://ftp.debian.org/debian/            lenny         main contrib non-free
deb     http://security.debian.org/              lenny/updates main contrib non-free
</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/themes/user_logos/* /tmp/ispcp/var/www/ispcp/gui/themes/user_logos/
cp -TvR /var/www/ispcp/gui/domain_default_page /tmp/ispcp/var/www/ispcp/gui/domain_default_page
cp -v /var/www/ispcp/gui/tools/pma/config.inc.php /tmp/ispcp/var/www/ispcp/gui/tools/pma/
</cli>

=== 8. Delete old files to avoid security risks ===

<cli>
rm -fR /var/www/ispcp/gui/{admin,client,include,orderpanel,themes,reseller}/
rm -fR /var/www/ispcp/gui/*.php
</cli>

=== 9. 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>

=== 10. 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>


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

=== 12. Start the engine update: ===
<cli>
perl ispcp-update
</cli>
=== 13. 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.
\\
=== 14. Clean the temporary folders: ===

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

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