| 1 | ispCP ω (OMEGA) HowTo Install for Debian Sarge, Etch, Lenny |
|---|
| 2 | ================================================================================ |
|---|
| 3 | For other Linux distributions please check the other INSTALL files. |
|---|
| 4 | ================================================================================ |
|---|
| 5 | |
|---|
| 6 | Table of Content |
|---|
| 7 | ================ |
|---|
| 8 | 1) Version Info |
|---|
| 9 | 2) Requirements |
|---|
| 10 | 3) Introduction |
|---|
| 11 | 4) Installation |
|---|
| 12 | 5) Update |
|---|
| 13 | 6) FAQ |
|---|
| 14 | 7) Credits |
|---|
| 15 | |
|---|
| 16 | ================================================================================ |
|---|
| 17 | 1) Version Info |
|---|
| 18 | --------------- |
|---|
| 19 | ispCP ω Version: 1.0.0 |
|---|
| 20 | INSTALL Script: 2.0 |
|---|
| 21 | Maintainer: Benedikt Heintel |
|---|
| 22 | Homepage: http://www.isp-contol.net |
|---|
| 23 | Linux Distros: Debian Sarge, Etch, Lenny |
|---|
| 24 | |
|---|
| 25 | ================================================================================ |
|---|
| 26 | 2) Requirements |
|---|
| 27 | --------------- |
|---|
| 28 | There is no must have for a system using ispCP ω. This is only a recommendation: |
|---|
| 29 | |
|---|
| 30 | Pentium III or K6-4 with 500 MHz |
|---|
| 31 | 512 MB RAM |
|---|
| 32 | 100 MB disk space (only for install of ispCP ω) |
|---|
| 33 | Debian (or even any other *NIX-Distribution) |
|---|
| 34 | |
|---|
| 35 | All Sarge required packages are listed in ./docs/Debian/debian-packages-sarge |
|---|
| 36 | All Etch required packages are listed in ./docs/Debian/debian-packages-etch |
|---|
| 37 | All Lenny/Sid required packages are listed in ./docs/Debian/debian-packages-lenny |
|---|
| 38 | |
|---|
| 39 | ================================================================================ |
|---|
| 40 | 3) Introduction |
|---|
| 41 | --------------- |
|---|
| 42 | ISPCP ω delivers a complete hosting automation appliance by offering significant |
|---|
| 43 | security, total-cost-of-ownership, and performance advantages over competing |
|---|
| 44 | commercial solutions. |
|---|
| 45 | |
|---|
| 46 | With ispCP ω you can configure your server and applications, create user with |
|---|
| 47 | domains with a few point-and-click operations that take less than a minute. |
|---|
| 48 | There is no limit to the number of resellers, users and domains that can be |
|---|
| 49 | created. The core of ispCP ω are 3 easy-to-use, web-based control panels. ispCP |
|---|
| 50 | provides graphic user interfaces for the administrators, resellers and users. |
|---|
| 51 | |
|---|
| 52 | ================================================================================ |
|---|
| 53 | 4) Installation |
|---|
| 54 | --------------- |
|---|
| 55 | Make sure you are logged in as root. |
|---|
| 56 | |
|---|
| 57 | 1. Untar or unzip the distribution files to a secure directory: |
|---|
| 58 | # cd /root |
|---|
| 59 | # tar xjvf ispcp1.0.0-omega.tar.bz2 |
|---|
| 60 | |
|---|
| 61 | 2. Change to the newly created directory: |
|---|
| 62 | # cd ./ispcp1.0.0 |
|---|
| 63 | |
|---|
| 64 | 3. Install the required modules |
|---|
| 65 | first update your system: |
|---|
| 66 | # apt-get update && apt-get upgrade |
|---|
| 67 | |
|---|
| 68 | for Debian Sarge please use: |
|---|
| 69 | # apt-get install `cat ./docs/Debian/debian-packages-sarge` |
|---|
| 70 | for Debian Etch please use: |
|---|
| 71 | # apt-get install `cat ./docs/Debian/debian-packages-etch` |
|---|
| 72 | for Debian Lenny/Sid please use: |
|---|
| 73 | # apt-get install `cat ./docs/Debian/debian-packages-lenny` |
|---|
| 74 | |
|---|
| 75 | Make sure you have added the non-free into your /etc/apt/sources.list: |
|---|
| 76 | |
|---|
| 77 | deb http://ftp.debian.org/debian/ etch main contrib non-free |
|---|
| 78 | deb http://security.debian.org/ etch/updates main contrib non-free |
|---|
| 79 | |
|---|
| 80 | If using Sarge, make sure you have added the following backport into your |
|---|
| 81 | /etc/apt/sources.list: |
|---|
| 82 | |
|---|
| 83 | # backports |
|---|
| 84 | deb http://dotdeb.pimpmylinux.org/ sarge all |
|---|
| 85 | |
|---|
| 86 | |
|---|
| 87 | (when you get to the courier screen select 'no' to web directories) |
|---|
| 88 | (when you get to the postfix screen select 'internet site' and then type 'root' |
|---|
| 89 | for mail. If you've set debian up correctly on install your domain should be |
|---|
| 90 | already on screen. Select 'no' to force sync updates.) |
|---|
| 91 | (when you get to the proftpd screen, select 'standalone') |
|---|
| 92 | (when you get to the rootkithunter screen, select two time 'yes') |
|---|
| 93 | |
|---|
| 94 | 4. Now there are two ways of install ispCP ω |
|---|
| 95 | |
|---|
| 96 | a) via install script |
|---|
| 97 | --------------------- |
|---|
| 98 | 4a. Start the script and follow the install instructions (currently not available): |
|---|
| 99 | # ./ispcp-setup.sh |
|---|
| 100 | |
|---|
| 101 | After that go to step 11. |
|---|
| 102 | |
|---|
| 103 | b) manually |
|---|
| 104 | ----------- |
|---|
| 105 | 4b. (optional) Check the ispcp.conf and adapt it to your requirements. |
|---|
| 106 | An overview over the variables you can find in the FAQ on |
|---|
| 107 | http://isp-control.net |
|---|
| 108 | |
|---|
| 109 | 5. Build the System by using make: |
|---|
| 110 | # make install |
|---|
| 111 | |
|---|
| 112 | 6. Copy all the directories into your system (you may make backups) |
|---|
| 113 | # cp -Rv /tmp/ispcp-1.0.0/* / |
|---|
| 114 | |
|---|
| 115 | 7. Now it's time to set up the frontend. Change into the engine directory: |
|---|
| 116 | # cd /var/www/ispcp/engine/setup |
|---|
| 117 | |
|---|
| 118 | 7a. Set the MySQL password, if not set: |
|---|
| 119 | # mysqladmin -u root password YOUR_PASSWORD |
|---|
| 120 | |
|---|
| 121 | 8. Start the engine setup: |
|---|
| 122 | # perl ispcp-setup |
|---|
| 123 | |
|---|
| 124 | 9. Install ispCP ω step-by-step |
|---|
| 125 | |
|---|
| 126 | If you get no error, all went good; if you get one, look at |
|---|
| 127 | http://isp-control.net to solve the problem. |
|---|
| 128 | |
|---|
| 129 | 10. There is an error in some courier-versions. Courier won't stop, if you use |
|---|
| 130 | /etc/init.d/courier-authdaemon stop, so change it: |
|---|
| 131 | # nano /etc/ini.d/courier-authdaemon |
|---|
| 132 | |
|---|
| 133 | change: ${libexecdir}/authlib/authdaemon stop |
|---|
| 134 | with: killall authdaemond.plain |
|---|
| 135 | |
|---|
| 136 | 11. Clean the temporary folders: |
|---|
| 137 | # rm -fR /tmp/ispcp-1.0.0 |
|---|
| 138 | |
|---|
| 139 | |
|---|
| 140 | ================================================================================ |
|---|
| 141 | 5) Update |
|---|
| 142 | --------- |
|---|
| 143 | |
|---|
| 144 | There are two ways of update ispCP ω |
|---|
| 145 | |
|---|
| 146 | 1. Untar or unzip the distribution files to a secure directory: |
|---|
| 147 | # cd /root |
|---|
| 148 | # tar xjvf ispcp1.0.0-omega.tar.bz2 |
|---|
| 149 | |
|---|
| 150 | 2. Change to the newly created directory: |
|---|
| 151 | # cd ./ispcp1.0.0 |
|---|
| 152 | |
|---|
| 153 | 3. Install the required modules |
|---|
| 154 | first update your system: |
|---|
| 155 | # apt-get update && apt-get upgrade |
|---|
| 156 | |
|---|
| 157 | for Debian Sarge please use: |
|---|
| 158 | # apt-get install `cat ./docs/Debian/debian-packages-sarge` |
|---|
| 159 | for Debian Etch please use: |
|---|
| 160 | # apt-get install `cat ./docs/Debian/debian-packages-etch` |
|---|
| 161 | for Debian Lenny/Sid please use: |
|---|
| 162 | # apt-get install `cat ./docs/Debian/debian-packages-lenny` |
|---|
| 163 | |
|---|
| 164 | Make sure you have added the non-free into your /etc/apt/sources.list: |
|---|
| 165 | |
|---|
| 166 | deb http://ftp.debian.org/debian/ etch main contrib non-free |
|---|
| 167 | deb http://security.debian.org/ etch/updates main contrib non-free |
|---|
| 168 | |
|---|
| 169 | If using Sarge, make sure you have added the following backport into your |
|---|
| 170 | /etc/apt/sources.list: |
|---|
| 171 | |
|---|
| 172 | # backports |
|---|
| 173 | deb http://dotdeb.pimpmylinux.org/ sarge all |
|---|
| 174 | |
|---|
| 175 | |
|---|
| 176 | (when you get to the courier screen select 'no' to web directories) |
|---|
| 177 | (when you get to the postfix screen select 'internet site' and then type 'root' |
|---|
| 178 | for mail. If you've set debian up correctly on install your domain should be |
|---|
| 179 | already on screen. Select 'no' to force sync updates.) |
|---|
| 180 | (when you get to the proftpd screen, select 'standalone') |
|---|
| 181 | (when you get to the rootkithunter screen, select two time 'yes') |
|---|
| 182 | |
|---|
| 183 | a) via install script |
|---|
| 184 | --------------------- |
|---|
| 185 | 4a. Start the script and follow the install instructions (currently not available): |
|---|
| 186 | # ./ispcp-setup.sh |
|---|
| 187 | |
|---|
| 188 | After that go to step 12. |
|---|
| 189 | |
|---|
| 190 | b) manually |
|---|
| 191 | ----------- |
|---|
| 192 | 4b. You have to set up some configuration variables for your linux distribution. |
|---|
| 193 | ispCP ω is preconfigurated for Debian 4.0 Etch. |
|---|
| 194 | If you're using another distribution please check, if config files exist in |
|---|
| 195 | ./configs/dists and use/change them. |
|---|
| 196 | |
|---|
| 197 | Check the ispcp.conf and adapt it to your requirements. |
|---|
| 198 | An overview over the variables you can find in the FAQ on |
|---|
| 199 | http://isp-control.net |
|---|
| 200 | |
|---|
| 201 | 5. Build the System by using make: |
|---|
| 202 | # make install |
|---|
| 203 | |
|---|
| 204 | 6. Save key files |
|---|
| 205 | # cp -v /var/www/ispcp/engine/ispcp-db-keys.pl /tmp/ispcp-1.0.0/var/www/ispcp/engine/ |
|---|
| 206 | # cp -v /var/www/ispcp/engine/messager/ispcp-db-keys.pl /tmp/ispcp-1.0.0/var/www/ispcp/engine/messager |
|---|
| 207 | # cp -v /var/www/ispcp/gui/include/ispcp-db-keys.php /tmp/ispcp-1.0.0/var/www/ispcp/gui/include/ |
|---|
| 208 | |
|---|
| 209 | 7. Copy /usr and /var directories into your system (you may make backups) |
|---|
| 210 | # cp -Rv /tmp/ispcp-1.0.0/usr/* /usr/ |
|---|
| 211 | # cp -Rv /tmp/ispcp-1.0.0/var/* /var/ |
|---|
| 212 | |
|---|
| 213 | 8. Backup ispcp.conf and copy the /etc dircetory into your system (you may make backups): |
|---|
| 214 | # mv -v /etc/ispcp/ispcp.conf /etc/ispcp/ispcp.old.conf |
|---|
| 215 | # cp -Rv /tmp/ispcp-1.0.0/etc/* /etc/ |
|---|
| 216 | |
|---|
| 217 | 9. Now it's time to update your installation. Change into the engine directory: |
|---|
| 218 | # cd /var/www/ispcp/engine/setup |
|---|
| 219 | |
|---|
| 220 | 10. Start the engine update: |
|---|
| 221 | # perl ispcp-update |
|---|
| 222 | |
|---|
| 223 | 11. Update ispCP ω step-by-step |
|---|
| 224 | |
|---|
| 225 | If you get no error, all went good; if you get one, look at |
|---|
| 226 | http://isp-control.net to solve the problem. |
|---|
| 227 | |
|---|
| 228 | 12. Clean the temporary folders: |
|---|
| 229 | # rm -fR /tmp/ispcp-1.0.0 |
|---|
| 230 | |
|---|
| 231 | ================================================================================ |
|---|
| 232 | 6) FAQ |
|---|
| 233 | ------ |
|---|
| 234 | |
|---|
| 235 | Q.- How can I prevent websites using more than their bandwidth limit to stop working? |
|---|
| 236 | A.- If you have installed the apache2-mod-cband (available for etch and lenny/sid) |
|---|
| 237 | all you need to do is: |
|---|
| 238 | # a2enmod cband |
|---|
| 239 | note that you might want to review /etc/apache2/mods-available/cband.conf |
|---|
| 240 | to disable the /cband-status and /cband-status-me handlers. |
|---|
| 241 | |
|---|
| 242 | Please check http://www.isp-control.net for any questions not answered in this file. |
|---|
| 243 | |
|---|
| 244 | ================================================================================ |
|---|
| 245 | 7) Credits |
|---|
| 246 | ---------- |
|---|
| 247 | |
|---|
| 248 | ispCP ω is a project of ispCP | isp Control Panel. |
|---|
| 249 | Please visit our site under http://isp-control.net for further information on |
|---|
| 250 | ispCP ω, ispCP and other themes. |
|---|
| 251 | |
|---|
| 252 | We hope you enjoy using ispCP ω. If you like it, help us, to make it better. We |
|---|
| 253 | would be glad on any help provided! |
|---|
