Table of Contents

Ubuntu

ispCP Version 1.0.6
INSTALL Script1.5
Maintainer Kommius
Linux Distros Ubuntu 8.04, 9.04, 9.10, 10.04
Last Update 04.08.2010

Preinstallation

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>

Installation

Make sure you are logged in as root and MySQL is running.

For Hardy (Ubuntu 8.04):

Start Installation

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

Bug fixing

Depending on the distribution you use, you might encounter the following bugs. Listed below are the steps to solve them

Postgrey and Postfix not listening to the same port

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.

Bind not listening to port 53

# 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

Wrong permissions on mailboxes

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/*