ispCP ω (OMEGA) HowTo Install for Debian Sarge, Etch, Lenny ================================================================================ For other Linux distributions please check the other INSTALL files. ================================================================================ Table of Content ================ 1) Version Info 2) Requirements 3) Introduction 4) Installation 5) Update 6) FAQ 7) Credits ================================================================================ 1) Version Info --------------- ispCP ω Version: 1.0.0 RC4 INSTALL Script: 2.0 Maintainer: Benedikt Heintel Homepage: http://www.isp-contol.net Linux Distros: Debian Sarge, Etch, Lenny ================================================================================ 2) Requirements --------------- There is no must have for a system using ispCP ω. This is only a recommendation: Pentium III or K6-4 with 500 MHz 512 MB RAM 100 MB disk space (only for install of ispCP ω) Debian (or even any other *NIX-Distribution) All Sarge required packages are listed in ./docs/Debian/debian-packages-sarge All Etch required packages are listed in ./docs/Debian/debian-packages-etch All Lenny/Sid required packages are listed in ./docs/Debian/debian-packages-lenny ================================================================================ 3) Introduction --------------- ispCP ω delivers a complete hosting automation appliance by offering significant security, total-cost-of-ownership, and performance advantages over competing commercial solutions. With ispCP ω you can configure your server and applications, create user with domains with a few point-and-click operations that take less than a minute. There is no limit to the number of resellers, users and domains that can be created. The core of ispCP ω are 3 easy-to-use, web-based control panels. ispCP provides graphic user interfaces for the administrators, resellers and users. ================================================================================ 4) Installation --------------- Make sure you are logged in as root. 1. Untar or unzip the distribution files to a secure directory: # cd /root # tar xjvf ispcp-omega-1.0.0-rc4.tar.bz2 2. Change to the newly created directory: # cd ./ispcp-omega-1.0.0 3. Install the required modules First update your system: # apt-get update && apt-get upgrade for Debian Sarge please use: # apt-get install `cat ./docs/Debian/debian-packages-sarge` for Debian Etch please use: # apt-get install `cat ./docs/Debian/debian-packages-etch` for Debian Lenny/Sid please use: # apt-get install `cat ./docs/Debian/debian-packages-lenny` Make sure you have added the non-free into your /etc/apt/sources.list: deb http://ftp.debian.org/debian/ etch main contrib non-free deb http://security.debian.org/ etch/updates main contrib non-free If using Sarge, make sure you have added the following backport into your /etc/apt/sources.list: # backports deb http://dotdeb.pimpmylinux.org/ sarge all (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. (optional) 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: # make install 6. Copy all the directories into your system (you may make backups) # cp -Rv /tmp/ispcp/* / 7. Now it's time to set up the frontend. Change into the engine directory: # cd /var/www/ispcp/engine/setup 7a. Set the MySQL password, if not set: # mysqladmin -u root password YOUR_PASSWORD 8. Start the engine setup: # perl ispcp-setup 9. Install 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. 10. There is an error in some courier-versions. Courier won't stop, if you use /etc/init.d/courier-authdaemon stop, so change it: # nano /etc/ini.d/courier-authdaemon change: ${libexecdir}/authlib/authdaemon stop with: killall authdaemond.plain 11. Clean the temporary folders: # rm -fR /tmp/ispcp ================================================================================ 5) Update --------- Make sure you are logged in as root. 1. Untar or unzip the distribution files to a secure directory: # cd /root # tar xjvf ispcp-omega-1.0.0-rc4.tar.bz2 2. Change to the newly created directory: # cd ./ispcp-omega-1.0.0 3. Install the required modules first update your system: # apt-get update && apt-get upgrade for Debian Sarge please use: # apt-get install `cat ./docs/Debian/debian-packages-sarge` for Debian Etch please use: # apt-get install `cat ./docs/Debian/debian-packages-etch` for Debian Lenny/Sid please use: # apt-get install `cat ./docs/Debian/debian-packages-lenny` Make sure you have added the non-free into your /etc/apt/sources.list: deb http://ftp.debian.org/debian/ etch main contrib non-free deb http://security.debian.org/ etch/updates main contrib non-free If using Sarge, make sure you have added the following backport into your /etc/apt/sources.list: # backports deb http://dotdeb.pimpmylinux.org/ sarge all (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. (optional) 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: # make install 6. Save key files # 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/ 7. Copy /usr and /var directories into your system (you may make backups) # cp -Rv /tmp/ispcp/usr/* /usr/ # cp -Rv /tmp/ispcp/var/* /var/ 8. Backup ispcp.conf and copy the /etc dircetory into your system (you may make backups): # mv -v /etc/ispcp/ispcp.conf /etc/ispcp/ispcp.old.conf # cp -Rv /tmp/ispcp/etc/* /etc/ 9. Now it's time to update your installation. Change into the engine directory: # cd /var/www/ispcp/engine/setup 10. Start the engine update: # perl ispcp-update 11. 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. 12. Clean the temporary folders: # rm -fR /tmp/ispcp ================================================================================ 6) FAQ ------ Q.- How can I prevent websites using more than their bandwidth limit to stop working? A.- If you have installed the apache2-mod-cband (available for etch and lenny/sid) all you need to do is: # a2enmod cband note that you might want to review /etc/apache2/mods-available/cband.conf to disable the /cband-status and /cband-status-me handlers. Please check http://www.isp-control.net for any questions not answered in this file. ================================================================================ 7) Credits ---------- ispCP ω is a project of ispCP | isp Control Panel. Please visit our site under http://isp-control.net for further information on ispCP ω, ispCP and other themes. We hope you enjoy using ispCP ω. If you like it, help us, to make it better. We would be glad on any help provided!