| 1 | ISPCP ω (OMEGA) HowTo Install for Fedora Core 4 - 6 |
|---|
| 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 Skript: 1.0 |
|---|
| 21 | Maintainer: |
|---|
| 22 | Homepage: http://isp-contol.net |
|---|
| 23 | Linux Distris: Fedora Core 4 - 6 |
|---|
| 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 required packages are listed in ./docs/fc4-packages.txt |
|---|
| 36 | |
|---|
| 37 | ================================================================================ |
|---|
| 38 | 3) Introduction |
|---|
| 39 | --------------- |
|---|
| 40 | ISPCP ω delivers a complete hosting automation appliance by offering significant |
|---|
| 41 | security, total-cost-of-ownership, and performance advantages over competing |
|---|
| 42 | commercial solutions. |
|---|
| 43 | |
|---|
| 44 | With ISPCP ω you can configure your server and applications, create user with |
|---|
| 45 | domains with a few point-and-click operations that take less than a minute. |
|---|
| 46 | There is no limit to the number of resellers, users and domains that can be |
|---|
| 47 | created. The core of ISPCP ω are 3 easy-to-use, web-based control panels. ISPCP |
|---|
| 48 | provides graphic user interfaces for the administrators, resellers and users. |
|---|
| 49 | |
|---|
| 50 | ================================================================================ |
|---|
| 51 | 4) Installation |
|---|
| 52 | --------------- |
|---|
| 53 | Make sure you are logged in as root. |
|---|
| 54 | |
|---|
| 55 | 1. Untar or unzip the distribution files to a secure directory: |
|---|
| 56 | # cd /root |
|---|
| 57 | # tar -xjvf ispcp1.0.0-omega.tar.bz2 |
|---|
| 58 | |
|---|
| 59 | 2. Change to the newly created directory: |
|---|
| 60 | # cd ./ispcp1.0.0 |
|---|
| 61 | |
|---|
| 62 | 3. Install the required modules from 'fedora-packages' |
|---|
| 63 | |
|---|
| 64 | 4. Now there are two ways of install ISPCP ω |
|---|
| 65 | |
|---|
| 66 | a) via install script |
|---|
| 67 | --------------------- |
|---|
| 68 | 4a. Start the script and follow the install instructions: |
|---|
| 69 | # ./install-ispcp.sh |
|---|
| 70 | |
|---|
| 71 | After that return to step 13. |
|---|
| 72 | |
|---|
| 73 | b) manualy |
|---|
| 74 | ---------- |
|---|
| 75 | 4b. Change into the configuration directory: |
|---|
| 76 | # cd ./configs |
|---|
| 77 | |
|---|
| 78 | 5. Open the ispcp.conf and make some changes. |
|---|
| 79 | You have to set up some configuration variables for your linux distribution. |
|---|
| 80 | ISPCP ω is preconfigurated for Debian 3.1 Sarge. |
|---|
| 81 | If you're using another distribution please check, if config files exist in |
|---|
| 82 | ./configs/dists/ and use/change them. |
|---|
| 83 | |
|---|
| 84 | These are the Variables you have to look at: |
|---|
| 85 | |
|---|
| 86 | AWSTATS_DIR = no # Either no or path to the awstats configs dir |
|---|
| 87 | SECONDARY_DNS = |
|---|
| 88 | MYSQL_PREFIX_TYPE = # '' for MYSQL_PREFIX = yes, |
|---|
| 89 | # infront or behind for MYSQL_PREFIX = no |
|---|
| 90 | |
|---|
| 91 | Check the ispcp.conf and adapt it to your requirements. |
|---|
| 92 | An overview over the variables you can find in the FAQ on |
|---|
| 93 | http://isp-control.net |
|---|
| 94 | |
|---|
| 95 | 6. Return to the parent direction and build the System by using make: |
|---|
| 96 | # cd ../ |
|---|
| 97 | # mv Makefile.fedora Makefile |
|---|
| 98 | # make install |
|---|
| 99 | |
|---|
| 100 | 7. Copy all the directories into the system (you may make backups) |
|---|
| 101 | # cp -Rv /tmp/ispcp-1.0.0/* / |
|---|
| 102 | |
|---|
| 103 | 8. Create the courier user database |
|---|
| 104 | # cp -a /etc/courier/userdb /etc/authlib/userdb |
|---|
| 105 | # makeuserdb |
|---|
| 106 | |
|---|
| 107 | 9. Now it's time to set up the frontend. Change into the engine directory: |
|---|
| 108 | # cd /var/www/ispcp/engine/setup |
|---|
| 109 | |
|---|
| 110 | 9a. Set the MySQL password, if not set: |
|---|
| 111 | # mysqladmin -u root password YOUR_PASSWORD |
|---|
| 112 | |
|---|
| 113 | 10. Start the engine setup: |
|---|
| 114 | # ./ispcp-setup |
|---|
| 115 | |
|---|
| 116 | 11. Install ISPCP ω step-by-step |
|---|
| 117 | |
|---|
| 118 | If you get no error, all went good; if you get one, look at |
|---|
| 119 | http://isp-control.net to solve the problem. |
|---|
| 120 | |
|---|
| 121 | 12. There is an error in some courier-versions. Courier won't stop, if you use |
|---|
| 122 | /etc/init.d/courier-authdaemon stop, so change it: |
|---|
| 123 | # nano /etc/ini.d/courier-authdaemon |
|---|
| 124 | |
|---|
| 125 | change: ${libexecdir}/authlib/authdaemon stop |
|---|
| 126 | into: killall authdaemond.plain |
|---|
| 127 | |
|---|
| 128 | 13. Modify some system values: |
|---|
| 129 | |
|---|
| 130 | * Open /etc/ispcp/ispcp.conf and change |
|---|
| 131 | AUTHLIB_CONF_DIR = /etc/authlib |
|---|
| 132 | |
|---|
| 133 | * create sasl2 database: |
|---|
| 134 | # touch /etc/sasldb2 |
|---|
| 135 | |
|---|
| 136 | * Install Daemon: |
|---|
| 137 | # chmod +x /etc/init.d/ispcp |
|---|
| 138 | # chkconfig --add ispcp |
|---|
| 139 | # service ispcp start |
|---|
| 140 | |
|---|
| 141 | 12. Clean the temporary folders: |
|---|
| 142 | # rm -R /tmp/ispcp-1.0.0 |
|---|
| 143 | |
|---|
| 144 | |
|---|
| 145 | ================================================================================ |
|---|
| 146 | 5) Update |
|---|
| 147 | --------- |
|---|
| 148 | |
|---|
| 149 | There are two ways of update ISPCP ω |
|---|
| 150 | |
|---|
| 151 | a) via install script |
|---|
| 152 | --------------------- |
|---|
| 153 | 1. Start the script and follow the update instructions: |
|---|
| 154 | # ./install-ispcp.sh |
|---|
| 155 | |
|---|
| 156 | b) manualy |
|---|
| 157 | ---------- |
|---|
| 158 | 1. Please check the update From-To-Files in the ./docs directory |
|---|
| 159 | |
|---|
| 160 | ================================================================================ |
|---|
| 161 | 6) FAQ |
|---|
| 162 | ------ |
|---|
| 163 | |
|---|
| 164 | Please check http://isp-control.net for any questions not answered in this file. |
|---|
| 165 | |
|---|
| 166 | ================================================================================ |
|---|
| 167 | 7) Credits |
|---|
| 168 | ---------- |
|---|
| 169 | |
|---|
| 170 | ISPCP ω is a project of ispCP | isp Control Panel. |
|---|
| 171 | Please visit our site under http://isp-control.net for further information on |
|---|
| 172 | ISPCP ω, ispCP and other themes. |
|---|
| 173 | |
|---|
| 174 | We hope you enjoy using ISPCP ω. If you like it, help us, to make it better. We |
|---|
| 175 | would be glad on any help provided! |
|---|
