INSTALL – ispCP 1.07 on ubuntu 10.04

ispCP ω (OMEGA) HowTo Install for Ubuntu 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.0.7 20 INSTALL Script:         1.8 21 Maintainer: 22 Homepage:                       http://isp-contol.net 23 Linux Distros:          Ubuntu 24 25 ================================================================================ 26 2) Requirements 27 --------------- 28 There is no must have for a system using ispCP ω. This is only a recommendation: 29 30 Penitum 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 8.04 LTS required packages are listed in ./docs/Ubuntu/ubuntu-packages-hardy 36 All 9.10 required packages are listed in ./docs/Ubuntu/ubuntu-packages-karmic 37 All 10.04 LTS required packages are listed in ./docs/Ubuntu/ubuntu-packages-lucid 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 56 1. Untar or unzip the distribution files to a secure directory: 57         # cd /usr/local/src 58         # tar xjvf ispcp-omega-1.0.7.tar.bz2 59 60 2. Change to the newly created directory: 61         # cd ./ispcp-omega-1.0.7 62 63 3. Install the required modules 64    First update your system: 65         # sudo aptitude update && aptitude upgrade 66         # sudo aptitude install lsb-release 67         # sudo aptitude install $(cat ./docs/Ubuntu/ubuntu-packages-`lsb_release -cs`) 68 69    Make sure you have added multiverse into your /etc/apt/sources.list 70 71         (if you get to the courier screen select 'no' to web directories) 72         (if you get to the postfix screen select 'internet site' and then type 'root' 73         for mail. If you've set debian up correctly on install your domain should be 74         already on screen. Select 'no' to force sync updates.) 75         (if you get to the proftpd screen, select 'standalone') 76         (if you get to the rootkithunter screen, select two time 'yes') 77 78 4. (optional) Check the ispcp.conf and adapt it to your requirements. 79 80 5. Build the System by using make: 81         # sudo make -f Makefile.ubuntu install 82 83 6. Copy all the directories into your system (you may make backups) 84         # sudo cp -Rv /tmp/ispcp/* / 85 86 7. Now it's time to set up the frontend. Change into the engine directory: 87         # cd /var/www/ispcp/engine/setup 88 89 7a. Set the MySQL password, if not set: 90         # sudo mysqladmin -u root password YOUR_PASSWORD 91 92 8. Start the engine setup: 93         # sudo perl ispcp-setup 94 95 9. Install ispCP ω step-by-step 96 97         If you get no error, all went good; if you get one, look at 98         http://isp-control.net to solve the problem. 99 100 10. Activate php mcrypt extension for Ubuntu 101         # sudo touch /etc/php5/conf.d/mcrypt.ini 102         # sudo echo "extension=mcrypt.so" > /etc/php5/conf.d/mcrypt.ini 103         # sudo chmod 644 /etc/php5/conf.d/mcrypt.ini 104         # sudo cp /etc/php5/conf.d/mcrypt.ini /etc/php5/cgi/conf.d/ 105         # sudo /etc/init.d/apache2 restart 106 107 11. Clean the temporary folders: 108         # sudo rm -fR /tmp/ispcp 109 110 ================================================================================ 111 5) Update 112 --------- 113 NOTE: ispCP ω can only be updated from post 1.0.0. If you have a 114 version prior 1.0.0 (final release) installed, update to ispCP ω 1.0.0 first. 115 116 Make sure you are logged in as root and MySQL is running. 117 118 1. Untar or unzip the distribution files to a secure directory: 119         # cd /usr/local/src 120         # tar xjvf ispcp-omega-1.0.7.tar.bz2 121 122 2. Change to the newly created directory: 123         # cd ./ispcp-omega-1.0.7 124 125 3. Install the required modules 126    first update your system: 127 128         # sudo aptitude update && aptitude safe-upgrade 129         # sudo aptitude install lsb-release 130         # sudo aptitude install $(cat ./docs/Ubuntu/ubuntu-packages-`lsb_release -cs`) 131 132    Make sure you have added multiverse into your /etc/apt/sources.list 133 134         (if you get to the courier screen select 'no' to web directories) 135         (if you get to the postfix screen select 'internet site' and then type 'root' 136         for mail. If you've set debian up correctly on install your domain should be 137         already on screen. Select 'no' to force sync updates.) 138         (if you get to the proftpd screen, select 'standalone') 139         (if you get to the rootkithunter screen, select two time 'yes') 140 141 4. Stop the ispcp_deamon and build the Software by using make: 142         # /etc/init.d/ispcp_daemon stop 143         # make -f Makefile.ubuntu  install 144 145 5. Backup files 146         # sudo cp -v /var/www/ispcp/engine/ispcp-db-keys.pl /tmp/ispcp/var/www/ispcp/engine/ 147         # sudo cp -v /var/www/ispcp/engine/messenger/ispcp-db-keys.pl /tmp/ispcp/var/www/ispcp/engine/messenger/ 148         # sudo cp -v /var/www/ispcp/gui/include/ispcp-db-keys.php /tmp/ispcp/var/www/ispcp/gui/include/ 149         # sudo cp -v /var/www/ispcp/gui/themes/user_logos/* /tmp/ispcp/var/www/ispcp/gui/themes/user_logos/ 150         # sudo cp -v /var/www/ispcp/gui/tools/pma/config.inc.php /tmp/ispcp/var/www/ispcp/gui/tools/pma/ 151         # sudo cp -v /var/www/ispcp/gui/tools/webmail/data/* /tmp/ispcp/var/www/ispcp/gui/tools/webmail/data/ 152 153 6. Delete old files to avoid security risks: 154         # sudo rm -Rf /var/www/ispcp/engine/ 155         # sudo rm -Rf /var/www/ispcp/gui/{admin,client,include,orderpanel,themes,reseller}/ 156         # sudo rm -Rf /var/www/ispcp/gui/tools/{pma/,filemanager/,webmail/,index.php} 157         # sudo rm -Rf /var/www/ispcp/gui/{*.php,favicon.ico,robots.txt} 158 159 7. Copy /usr and /var directories into your system (you may make backups) 160         # sudo cp -Rv /tmp/ispcp/usr/* /usr/ 161         # sudo cp -Rv /tmp/ispcp/var/* /var/ 162 163 8. Backup ispcp.conf and copy the /etc directory into your system (you may make backups): 164         # sudo mv -v /etc/ispcp/ispcp.conf /etc/ispcp/ispcp.old.conf 165         # sudo cp -Rv /tmp/ispcp/etc/* /etc/ 166 167 9. Now it's time to update your installation. Change into the engine directory: 168         # cd /var/www/ispcp/engine/setup 169 170 10. Start the engine update: 171         # sudo perl ispcp-update 172 173 11. Update ispCP ω step-by-step 174 175         If you get no error, all went good; if you get one, look at 176         http://isp-control.net to solve the problem. 177 178 12. Clean the temporary folders: 179         # sudo rm -fR /tmp/ispcp/ 180 181 ================================================================================ 182 6) Uninstall 183 ------------ 184 Make sure you are logged in as root and MySQL is running. 185 186 1. Change into the engine directory: 187         # cd /var/www/ispcp/engine/setup 188 189 2. Start the uninstall script: 190         # perl ispcp-uninstall 191 192 3. Clean up your system 193 194 ================================================================================ 195 7) Credits 196 ---------- 197 198 ispCP ω is a project of ispCP | isp Control Panel. 199 ispCP, ispCP ω, isp Control Panel, the ispCP logo and the ω Logo are trademarks 200 of the ispCP | isp Control Panel Project Team. 201 202 Please visit our site under http://isp-control.net for further information on 203 ispCP ω, ispCP and other themes. 204 205 We hope you enjoy using ispCP ω. If you like it, help us, to make it better. We 206 would be glad on any help provided! http://isp-control.net/ispcp/browser/trunk/docs/Ubuntu/INSTALL