ispCP Version | 1.0.6 |
---|---|
INSTALL Script | 1.5 |
Maintainer | Kommius |
Linux Distros | Ubuntu 8.04, 9.04, 9.10, 10.04 |
Last Update | 04.08.2010 |
Before you consider installing ispCP make sure you cared about the following issues:
<fc #FF0000>ONLY the two last LTS UBUNTU VERSIONS ARE SUPPORTED SINCE 1.0.7</fc>
<fc #FF0000>Your Server has to be configured to use a resolvable fully qualified domain name. Here can you find hoster specific information how to do so.</fc>
Make sure you are logged in as root and MySQL is running.
For Hardy (Ubuntu 8.04):
1. Untar or unzip the distribution files to a secure directory:
# cd /root # wget http://sourceforge.net/projects/ispcp/files/ispCP%20Omega/ispCP%20Omega%201.0.6/ispcp-omega-1.0.6.tar.gz/download # tar xvzf ispcp-omega-1.0.6.tar.gz
2. Change to the newly created directory:
# cd ./ispcp-omega-1.0.6
3. Install the required modules First update your system:
For Ubuntu 8.10 and lower :
# apt-get update && apt-get upgrade
For Ubuntu 9.04 and higher :
# aptitude update && aptitude safe-upgrade
Then install all needed packages:
# aptitude install $(cat ./docs/Ubuntu/ubuntu-packages-`lsb_release -cs`)
During the Install process you might encounter some config screens, here's what you should fill in there (some screens described here might not show up anymore in newer versions of the services to be configured):
On the courier screen select 'no' to web directories. When you get to the postfix screen select 'internet site', eventually type in 'root' for mail. If you've set your system up correctly on install your domain should already be on screen in the next step, otherwise fill in the host domain name of your server. Eventually select 'no' to force sync updates. Proftpd should be configured as standalone (i.e. not inetd) If you get to the rootkithunter screen, select two times '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 -f Makefile.ubuntu 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/init.d/courier-authdaemon
change: ${libexecdir}/authlib/authdaemon stop with: killall authdaemond.plain
11. Clean the temporary folders:
# rm -fR /tmp/ispcp
Depending on the distribution you use, you might encounter the following bugs. Listed below are the steps to solve them
Make sure Postfix and Postgrey are listening to the same port :
# vim /etc/default/postgrey
Check the ports on which it is listening :
POSTGREY_OPTS="--inet=10023"
If the port is different than port 60000, do the following :
# vim /etc/postfix/main.cf
Replace :
check_policy_service inet:127.0.0.1:60000,
By :
check_policy_service inet:127.0.0.1:10023,
Save & close.
# vim /etc/bind/named.conf.options
Comment the following line :
listen-on { 127.0.0.1; };
Add, below :
listen-on port 53 { any; };
Restart Bind :
# /etc/init.d/bind9 restart
If you get the following in /var/log/mail.err :
postfix/virtual[12797]: fatal: open database /etc/postfix/ispcp/mailboxes.db: Permission denied
Then do :
# chmod 644 /etc/postfix/ispcp/*