====== Ubuntu ======
^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                                |


===== 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. [[howto:hostname|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):
  * If MySQL is not installed, it will be installed automatically in Step 3.
  * You may also need to enable the Multiverse repositories for all packages to be properly found.  To do this edit /etc/apt/sources.list , and add multiverse to each line


====== Start Installation ======

1. Untar or unzip the distribution files to a secure directory:
<code># 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</code>

2. Change to the newly created directory:
<code># cd ./ispcp-omega-1.0.6</code>

3. Install the required modules
First update your system:

 For Ubuntu 8.10 and lower :
<code># apt-get update && apt-get upgrade</code>

 For Ubuntu 9.04 and higher :
<code># aptitude update && aptitude safe-upgrade</code> 

Then install all needed packages:
<code># aptitude install $(cat ./docs/Ubuntu/ubuntu-packages-`lsb_release -cs`)</code>

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 :
<code># make -f Makefile.ubuntu install</code>

6. Copy all the directories into your system (you may make backups)
<code># cp -Rv /tmp/ispcp/* /</code>

7. Now it's time to set up the frontend. Change into the engine directory:
<code># cd /var/www/ispcp/engine/setup</code>

7a. Set the MySQL password, if not set:
<code># mysqladmin -u root password YOUR_PASSWORD</code>

8. Start the engine setup:
<code># perl ispcp-setup</code>

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:
<code># nano /etc/init.d/courier-authdaemon</code>

	change: ${libexecdir}/authlib/authdaemon stop
	with:	killall authdaemond.plain

11. Clean the temporary folders:
<code># rm -fR /tmp/ispcp</code>

====== 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 :
<code># vim /etc/default/postgrey</code>

Check the ports on which it is listening :
<code>POSTGREY_OPTS="--inet=10023"</code>

If the port is different than port 60000, do the following :

<code># vim /etc/postfix/main.cf</code>

Replace :
<code>check_policy_service inet:127.0.0.1:60000,</code>

By :
<code>check_policy_service inet:127.0.0.1:10023,</code>

Save & close.

===== Bind not listening to port 53 =====

<code># vim /etc/bind/named.conf.options</code>

Comment the following line :
<code>listen-on { 127.0.0.1; };</code>

Add, below :

<code>listen-on port 53 { any; };</code>

Restart Bind :
<code># /etc/init.d/bind9 restart</code>

===== Wrong permissions on mailboxes =====
If you get the following in /var/log/mail.err :

<code>postfix/virtual[12797]: fatal: open database /etc/postfix/ispcp/mailboxes.db: Permission denied</code>

Then do :

<code># chmod 644 /etc/postfix/ispcp/*</code>