Table of Contents

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: 

deb     http://ftp.debian.org/debian/            lenny         main contrib non-free
deb     http://security.debian.org/              lenny/updates main contrib non-free

(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>