Author www.debianhelp.co.uk

Install Steps VHCS 2.4.6.2 in Debian 3.1 base install

On install of Debian, select no packages to be installed, allow it to connect to the internet and let it download anything it needs, usually its libs etc. Exim is most likely installed at this point so dont worry it will be removed shortly.

1).vi /etc/apt/sources.list (add the following sources)

Code:
deb ftp://ftp.uk.debian.org/debian/ stable main
deb-src ftp://ftp.uk.debian.org/debian/ stable main

deb http://security.debian.org/ stable/updates main

(dont forget to run "apt-get update" after)

2). apt-get install postfix postfix-tls proftpd-mysql courier-authdaemon courier-base courier-imap courier-maildrop courier-pop libberkeleydb-perl libc-dev libcrypt-blowfish-perl libcrypt-cbc-perl libcrypt-passwdmd5-perl libdate-calc-perl libdate-manip-perl libdbd-mysql-perl libdbi-perl libio-stringy-perl libmail-sendmail-perl libmailtools-perl libmd5-perl libmime-base64-perl libmime-perl libnet-dns-perl libnet-netmask-perl libnet-perl libnet-smtp-server-perl libperl5.8 libsnmp-session-perl libterm-readkey-perl libtimedate-perl perl perl-base perl-modules bind9 diff gzip iptables libmcrypt4 mysql-client-4.1 mysql-common-4.1 mysql-server-4.1 patch php4 php4-mcrypt php4-mysql php4-pear procmail libterm-readpassword-perl libsasl2-modules libsasl2 sasl2-bin apache2 apache2-common apache2-mpm-prefork libapache2-mod-php4 gawk libgd1g bzip2 wget make

(when you get to the courier screen screen select no to web directories)
(when you get to the postfix screen select internet site and then type root for mail. If you set debian up correctly on install your domain should be already on screen. Select no to force sync updates.)
(when yo get to the mysql screen, select standalone)

3). mysql -u root (no password at this stage, change it later!)

Code:

create database vhcs2;
use vhcs2
grant all privileges on *.* to 'vhcs2'@'localhost' identified by 'vhcs2' with grant option;
\q (quit program)

4). apt-get remove apache-common (if installed - not needed)

5). wget http://ufpr.dl.sourceforge.net/sourceforge/vhcs/vhcs2.4.6.2.tar.bz2

6). tar -xjvf vhcs2.4.6.2.tar.bz2

7). cd vhcs2.4.6.2

8). cd configs

9). vi vhcs2.conf (make the changes to match your requirements, dont forget to change database name, username and password, these are what you need to change)

Code:

DEFAULT_ADMIN_ADDRES = your email
SERVER_HOSTNAME = your hostname
BASE_SERVER_IP = your ip
DATABASE_TYPE = mysql
DATABASE_HOST = localhost
DATABASE_NAME = vhcs2
DATABASE_PASSWORD = vhcs2
DATABASE_USER = vhcs

10). cd .. (back to the root of the vhcs2 directory)

11). make install (if command not found run 'apt-get install make')

12). cd /tmp/vhcs2*

13). cp -R * /

14). cd /var/www/vhcs2/engine/setup

15). ./vhcs2-setup (install script)

Code:

Wlecome to VHCS2 '2.4 Spartacus' Setup Dialog.

This program will set up VHCS2 system on your server.

Please press 'Enter' to continue.

Please enter system hostname (Enter for defaults) [debian]: yourhostname

Please enter system network address (Enter for defaults) [192.168.0.128]: your ipaddress

Please enter SQL server host (Enter for defaults) [localhost]:

Please enter system SQL database (Enter for defaults) [vhcs2]: vhcs2

Please enter system SQL user (Enter for defaults) [root]: vhcs2

Please enter system SQL password (Enter for defaults) [none]: vhcs2
Please repeat system SQL password: vhcs2

Please enter VHCS ftp SQL user (Enter for defaults) [vftp]: vftp

Please enter VHCS ftp SQL user password (Enter for defaults) [none]: vftp
Please repeat VHCS ftp SQL user password: vftp

Please enter administrator login name (Enter for defaults) [admin]:

Please enter administrator password: your password
Please repeat administrator password: your password

Please enter admininistrator email address: your email address

16). echo "Include /etc/apache2/sites-available/vhcs2.conf" >> /etc/apache2/httpd.conf (forgotten in install script)

17). sh /etc/init.d/apache2 restart

18). vi /etc/init.d/courier-authdaemon

Code: (change this line) ${libexecdir}/authlib/authdaemon stop
(to this) killall authdaemond.plain

19). sh /etc/init.d/courier-authdaemon restart

20). vi /etc/resolv.conf (and add to the top)

Code:

nameserver your ip (this removes errors about virtual hosts when starting apache)

21). (vhcs2 does not start automatically on reboot so we need to add it as a startup script )

First, you must get the startup runlevel by the command "runlevel" in the bash. You'll get something like N 2, N means there was no previous runlevel, 2 is the actual runlevel.

For those who don't have an N, you know what you're doing, simply look in your inittab, then go in the folder /etc/rc2.d (if 2 is your startup runlevel)

Make an ls -al to see how it works, it isn't hard to understand. At startup everthing from S01xx to S99xx is started in that order.

Code:

Example: ln -s /etc/init.d/vhcs2_daemon /etc/rc2.d/S98vhcs

22). (You may need to change permissions on the tools folder)

Code:

chmod -R 766 /var/www/vhcs2/gui/tools

23) Thats about it, vhcs should be installed and working now visit http://localhost/vhcs/