| 1 | ispCP ω (OMEGA) HowTo Install for Debian |
|---|
| 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) Uninstall |
|---|
| 14 | 7) Credits |
|---|
| 15 | |
|---|
| 16 | ================================================================================ |
|---|
| 17 | 1) Version Info |
|---|
| 18 | --------------- |
|---|
| 19 | ispCP ω Version: 1.1.0 |
|---|
| 20 | INSTALL Script: 2.9 |
|---|
| 21 | Maintainer: Benedikt Heintel |
|---|
| 22 | Homepage: http://www.ispcp.net |
|---|
| 23 | Linux Distros: Debian |
|---|
| 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 Lenny required packages are listed in ./docs/Debian/debian-packages-lenny |
|---|
| 36 | All Squeeze required packages are listed in ./docs/Debian/debian-packages-squeeze |
|---|
| 37 | All Wheezy required packages are listed in ./docs/Debian/debian-packages-wheezy |
|---|
| 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 and MySQL is running. |
|---|
| 56 | |
|---|
| 57 | 1. Untar or unzip the distribution files to a secure directory: |
|---|
| 58 | # cd /usr/local/src |
|---|
| 59 | # tar xjvf ispcp-omega-1.1.0.tar.bz2 |
|---|
| 60 | |
|---|
| 61 | 2. Change to the newly created directory: |
|---|
| 62 | # cd ./ispcp-omega-1.1.0 |
|---|
| 63 | |
|---|
| 64 | 3. Install the required packages |
|---|
| 65 | |
|---|
| 66 | First update your system: |
|---|
| 67 | # aptitude update && aptitude safe-upgrade |
|---|
| 68 | |
|---|
| 69 | Make sure you have added the non-free into your /etc/apt/sources.list: |
|---|
| 70 | |
|---|
| 71 | Lenny: |
|---|
| 72 | deb http://ftp.debian.org/debian/ lenny main contrib non-free |
|---|
| 73 | deb http://security.debian.org/ lenny/updates main contrib non-free |
|---|
| 74 | |
|---|
| 75 | Squeeze: |
|---|
| 76 | deb http://ftp.debian.org/debian/ squeeze main contrib non-free |
|---|
| 77 | deb http://security.debian.org/ squeeze/updates main contrib non-free |
|---|
| 78 | |
|---|
| 79 | Wheezy: |
|---|
| 80 | deb http://ftp.debian.org/debian/ wheezy main contrib non-free |
|---|
| 81 | deb http://security.debian.org/ wheezy/updates main contrib non-free |
|---|
| 82 | |
|---|
| 83 | Install all required packages: |
|---|
| 84 | |
|---|
| 85 | # aptitude install lsb-release |
|---|
| 86 | # aptitude install $(cat ./docs/Debian/debian-packages-`lsb_release -cs`) |
|---|
| 87 | |
|---|
| 88 | (if you get to the courier screen select 'no' to web directories) |
|---|
| 89 | (if you get to the postfix screen select 'internet site'. 'mail name' should |
|---|
| 90 | be the server's domain. If you've set debian up correctly on install your |
|---|
| 91 | domain should be already shown.) |
|---|
| 92 | (if you get to the proftpd screen, select 'standalone') |
|---|
| 93 | |
|---|
| 94 | 4. (optional) Check the ispcp.conf and adapt it to your requirements. |
|---|
| 95 | |
|---|
| 96 | 5. Build the Software by using make: |
|---|
| 97 | # make install |
|---|
| 98 | |
|---|
| 99 | 6. Copy all the directories into your system. If you have not yet, now is a good |
|---|
| 100 | time to make backups of your server. The following steps do fundamental |
|---|
| 101 | changes to your system configuration. |
|---|
| 102 | # cp -R /tmp/ispcp/* / |
|---|
| 103 | |
|---|
| 104 | 7. Change or create MySQL root password, remove anonymous users, disallow root |
|---|
| 105 | login remotely, remove test database (and access to it), reload privilege tables. |
|---|
| 106 | # mysql_secure_installation |
|---|
| 107 | |
|---|
| 108 | 8. Now it's time to set up the frontend. Change into the engine directory and |
|---|
| 109 | start the engine setup: |
|---|
| 110 | # cd /var/www/ispcp/engine/setup |
|---|
| 111 | # perl ispcp-setup |
|---|
| 112 | |
|---|
| 113 | 9. Install ispCP ω step-by-step |
|---|
| 114 | |
|---|
| 115 | If you get no error, all went good; if you get one, look at |
|---|
| 116 | http://ispcp.net to solve the problem. |
|---|
| 117 | |
|---|
| 118 | 10. Clean the temporary folders: |
|---|
| 119 | # rm -fR /tmp/ispcp/ |
|---|
| 120 | |
|---|
| 121 | ================================================================================ |
|---|
| 122 | 5) Update |
|---|
| 123 | --------- |
|---|
| 124 | NOTE: ispCP ω can only be updated from post 1.0.0. If you have a |
|---|
| 125 | version prior 1.0.0 (final release) installed, update to ispCP ω 1.0.0 first. |
|---|
| 126 | |
|---|
| 127 | Make sure you are logged in as root and MySQL is running. |
|---|
| 128 | |
|---|
| 129 | 1. Untar or unzip the distribution files to a secure directory: |
|---|
| 130 | # cd /usr/local/src |
|---|
| 131 | # tar xjvf ispcp-omega-1.1.0.tar.bz2 |
|---|
| 132 | |
|---|
| 133 | 2. Change to the newly created directory: |
|---|
| 134 | # cd ./ispcp-omega-1.1.0 |
|---|
| 135 | |
|---|
| 136 | 3. Install the required packages |
|---|
| 137 | |
|---|
| 138 | First update your system: |
|---|
| 139 | # aptitude update && aptitude safe-upgrade |
|---|
| 140 | |
|---|
| 141 | Make sure you have added the non-free into your /etc/apt/sources.list: |
|---|
| 142 | |
|---|
| 143 | Lenny: |
|---|
| 144 | deb http://ftp.debian.org/debian/ lenny main contrib non-free |
|---|
| 145 | deb http://security.debian.org/ lenny/updates main contrib non-free |
|---|
| 146 | |
|---|
| 147 | Squeeze: |
|---|
| 148 | deb http://ftp.debian.org/debian/ squeeze main contrib non-free |
|---|
| 149 | deb http://security.debian.org/ squeeze/updates main contrib non-free |
|---|
| 150 | |
|---|
| 151 | Wheezy: |
|---|
| 152 | deb http://ftp.debian.org/debian/ wheezy main contrib non-free |
|---|
| 153 | deb http://security.debian.org/ wheezy/updates main contrib non-free |
|---|
| 154 | |
|---|
| 155 | Install all required packages: |
|---|
| 156 | |
|---|
| 157 | # aptitude install lsb-release |
|---|
| 158 | # aptitude install $(cat ./docs/Debian/debian-packages-`lsb_release -cs`) |
|---|
| 159 | |
|---|
| 160 | (if you get to the courier screen select 'no' to web directories) |
|---|
| 161 | (if you get to the postfix screen select 'internet site' and then type 'root' |
|---|
| 162 | for mail. If you've set debian up correctly on install your domain should be |
|---|
| 163 | already on screen. Select 'no' to force sync updates.) |
|---|
| 164 | (if you get to the proftpd screen, select 'standalone') |
|---|
| 165 | (if you get to the rootkithunter screen, select two time 'yes') |
|---|
| 166 | |
|---|
| 167 | 4. Stop the ispcp_deamon and build the Software by using make: |
|---|
| 168 | # /etc/init.d/ispcp_daemon stop |
|---|
| 169 | # make install |
|---|
| 170 | |
|---|
| 171 | 5. Backup files |
|---|
| 172 | # cp -v /var/www/ispcp/gui/themes/user_logos/* /tmp/ispcp/var/www/ispcp/gui/themes/user_logos/ |
|---|
| 173 | # cp -TRv /var/www/ispcp/gui/domain_default_page /tmp/ispcp/var/www/ispcp/gui/domain_default_page |
|---|
| 174 | # cp -v /var/www/ispcp/gui/tools/webmail/data/* /tmp/ispcp/var/www/ispcp/gui/tools/webmail/data/ |
|---|
| 175 | |
|---|
| 176 | For ispCP Omega prior version 1.0.8 |
|---|
| 177 | # cp -v /var/www/ispcp/engine/ispcp-db-keys.pl /tmp/ispcp/var/www/ispcp/engine/ |
|---|
| 178 | # cp -v /var/www/ispcp/engine/messenger/ispcp-db-keys.pl /tmp/ispcp/var/www/ispcp/engine/messenger/ |
|---|
| 179 | # cp -v /var/www/ispcp/gui/include/ispcp-db-keys.php /tmp/ispcp/var/www/ispcp/gui/include/ |
|---|
| 180 | |
|---|
| 181 | For ispCP Omega prior version 1.0.7 RC2 |
|---|
| 182 | # cp -v /var/www/ispcp/gui/tools/pma/config.inc.php /tmp/ispcp/etc/ispcp/pma/working/ |
|---|
| 183 | |
|---|
| 184 | 6. Delete old files to avoid security risks: |
|---|
| 185 | # rm -Rf /var/www/ispcp/engine/ |
|---|
| 186 | # rm -Rf /var/www/ispcp/gui/{admin,client,include,orderpanel,themes,reseller}/ |
|---|
| 187 | # rm -Rf /var/www/ispcp/gui/tools/{pma/,filemanager/,webmail/,index.php} |
|---|
| 188 | # rm -Rf /var/www/ispcp/gui/{*.php,favicon.ico,robots.txt} |
|---|
| 189 | |
|---|
| 190 | 7. Copy /usr and /var directories into your system (you may make backups) |
|---|
| 191 | # cp -R /tmp/ispcp/usr/* /usr/ |
|---|
| 192 | # cp -R /tmp/ispcp/var/* /var/ |
|---|
| 193 | |
|---|
| 194 | 8. Backup ispcp.conf and copy the /etc directory into your system (you may make |
|---|
| 195 | backups): |
|---|
| 196 | # mv /etc/ispcp/ispcp.conf /etc/ispcp/ispcp.old.conf |
|---|
| 197 | # cp -R /tmp/ispcp/etc/* /etc/ |
|---|
| 198 | |
|---|
| 199 | 9. Now it's time to update your installation. Change into the engine directory: |
|---|
| 200 | # cd /var/www/ispcp/engine/setup |
|---|
| 201 | |
|---|
| 202 | 10. Start the engine update: |
|---|
| 203 | # perl ispcp-update |
|---|
| 204 | |
|---|
| 205 | 11. Update ispCP ω step-by-step |
|---|
| 206 | |
|---|
| 207 | If you get no error, all went good; if you get one, look at |
|---|
| 208 | http://ispcp.net to solve the problem. |
|---|
| 209 | |
|---|
| 210 | 12. Clean the temporary folders: |
|---|
| 211 | # rm -fR /tmp/ispcp/ |
|---|
| 212 | |
|---|
| 213 | ================================================================================ |
|---|
| 214 | 6) Uninstall |
|---|
| 215 | ------------ |
|---|
| 216 | Make sure you are logged in as root and MySQL is running. |
|---|
| 217 | |
|---|
| 218 | 1. Change into the engine directory: |
|---|
| 219 | # cd /var/www/ispcp/engine/setup |
|---|
| 220 | |
|---|
| 221 | 2. Start the uninstall script: |
|---|
| 222 | # perl ispcp-uninstall |
|---|
| 223 | |
|---|
| 224 | 3. Clean up your system |
|---|
| 225 | |
|---|
| 226 | ================================================================================ |
|---|
| 227 | 7) Credits |
|---|
| 228 | ---------- |
|---|
| 229 | |
|---|
| 230 | ispCP ω is a project of ISPCP. |
|---|
| 231 | ispCP, ispCP ω, ISP Control Panel, the ispCP logo and the ω Logo are trademarks |
|---|
| 232 | of the ISPCP Project Team. |
|---|
| 233 | |
|---|
| 234 | Please visit our site under http://ispcp.net for further information on |
|---|
| 235 | ispCP ω, ispCP and other themes. |
|---|
| 236 | |
|---|
| 237 | We hope you enjoy using ispCP ω. If you like it, help us, to make it better. We |
|---|
| 238 | would be glad on any help provided! |
|---|
