Documentation: Installation

Debian

Make sure you are logged in as root.

1. Untar or unzip the distribution files to a secure directory:

# cd /root
# tar -xjvf ispcp-omega-1.0.0-rc2c.tar.bz2

2. Change to the newly created directory:

# cd ./ispcp-1.0.0

If you use a nightly build:

# cd web/svn/nightly

3.a

Note: Don't forget to add the non-free repository to your Debian apt sources list:

Example:

  # stable
  deb http://ftp.de.debian.org/debian/            stable          main contrib non-free
  deb http://security.debian.org/                 stable/updates  main contrib non-free

ONLY FOR SARGE If you want PHP5 support in Debian Sarge add these extra lines to your /etc/apt/sources.list file:

deb http://dotdeb.pimpmylinux.org/ oldstable all

3.b Install the required modules

for Debian you can use apt-get:

  # apt-get update && apt-get upgrade    
  # apt-get install `cat ./docs/Debian/debian-packages-$YOUR-SYSTEM`

where $YOUR-SYSTEM is either etch or sarge

When you get the courier screen select no to web directories.
When you get to the postfix screen select internet site
If you set debian up correctly on install your domain should be already on screen.
If not, put it in without the 'www.' portion(i.e. yourdomain.com)
Select yes when asked if you would like to continue installing without maildirs
Select no to force sync updates.
When you get to the proftpd screen, select standalone (Daemon under Sarge)

4. Build the system by using make (for Debian):

# make install

For other distros check the name of the Makefile's. E.g, for Ubuntu use:

# make -f Makefile.ubuntu install

For Fedora:

# make -f Makefile.fedora install

Same is for all other supported distributions.

5. Copy all the directories into the system (you may want to make backups)

# cp -Rv /tmp/ispcp-1.0.0/* /

PS Fedora Core 7 users - Check Known issues before continuing to step 6!

6. Now it's time to set up the system. Change into the engine/setup directory:

# cd /var/www/ispcp/engine/setup

6a. Set the MySQL password, if not set:

# mysqladmin -u root password YOUR_PASSWORD

7. Start the engine setup:

# perl ./ispcp-setup

8. Clean the temporary installation directory:

# rm -fR /tmp/ispcp-1.0.0

9. That's it!

If you got no error, all went good; if you got one, look at http://isp-control.net to solve the problem.

You can now access the control panel with your browser by going to your admin address (usually something like http://admin.your-domain.tld)

---

Known issues

Courier

There is an error in some courier-versions where Courier won't stop:

# nano /etc/init.d/courier-authdaemon

Replace: ${libexecdir}/authlib/authdaemon stop

With: killall authdaemond.plain

Fedora Core 7

Installing Courier To install Courier which is a dependency, you might want to follow the instructions here: usage_howto/install/installation/fedora_core_7_courier

Between Step 5 and 6: In case you got the following errors after performing step 5:

cp: cannot overwrite non-directory `/etc/init.d' with directory `/tmp/ispcp-1.0.0/etc/init.d'
cp: cannot overwrite non-directory `/var/mail' with directory `/tmp/ispcp-1.0.0/var/mail'

... then it is because your /etc/init.d and /var/mail are symlinks. You need to copy the necessary files manually:

cp /tmp/ispcp-1.0.0/var/mail/virtual /var/mail/ -r
cp /tmp/ispcp-1.0.0/etc/init.d/ispcp_* /etc/init.d/ -r

Then, in order for the setup to finish without the trial and error session I had to experience, try this before running setup:

mkdir /etc/httpd/mods-available
/usr/sbin/userdel vu20000
mkdir /var/cache/bind/

It seems ispCP Omega expects these things to have been executed and will halt in the middle of everything if the above isn't performed. Example of errors that you would otherwise encounter:

/bin/cp: cannot create regular file `/etc/httpd/mods-available/fastcgi.conf': No such file or directory
ERROR: External command '/bin/cp -p /etc/ispcp/apache/backup/fastcgi.conf.ispcp /etc/httpd/mods-available/fastcgi.conf' returned '1' status !

ERROR: External command '/usr/sbin/groupadd -g 2000 vu2000' returned '9' status !

ERROR: Can't open file |/var/cache/bind/admin.domain.com.db| for writing !

Also note that the setup harmfully will output

useradd: warning: the home directory already exists.
Not copying any file from skel directory into it.

If you have a /home/vmail directory on your system.