INSTALLATION GUIDE FOR DEBIAN


RECOMMENDED CONFIGURATION

1) MySQL 3.xx (database server)

2) Postfix (mail transfer agent)

3) Qpopper (POP3 daemon)

4) Vsftpd (FTP server)


INSTALLATION

STEP 1.
	INSTALLING 3RD PARTY PRODUCTS FROM THE DEBIAN DISTRIBUTION

Below is the list of Debian packages to be installed if you choose recommended
configuration.

-------------------------------------------------------------------------------------------
    package                          
-------------------------------------------------------------------------------------------
	apache	                        	
	apache-common                   	
	apache-dev 	                        
	mysql-client                    	
	mysql-server                  	    
	mysql-common               	        
	php4 							  	
	php4-imap 						    
	php4-mysql 						    
	perl                                
	perl-base                        
	perl-modules                   	    
	libdbi-perl                       	
	libdbd-mysql-perl            	    
	libapache-mod-python                
	vsftpd                            	
	postfix                           	
	qpopper                         	
	bind9                             	
	webalizer                        	
	procmail                        	
	gcc                                 
 	libc6-dev                         	
	make                              	
	libmysqlclient10-dev                
	quota
	libquota-perl
	libnet-ssleay-perl
	libio-stringy-perl
	libdata-showtable-perl
	libapache-request-perl
	libxml-perl 
	openssl
	libssl-dev
	libexpat1
	libexpat1-dev
	zlib1g
	zlib1g-dev
-------------------------------------------------------------------------------------------
You can install them all as shown below:

#~: apt-get install apache apache-common apache-dev mysql-client mysql-server mysql-common php4 php4-imap php4-mysql perl perl-base perl-modules libdbi-perl libdbd-mysql-perl libapache-mod-python vsftpd postfix qpopper bind9 webalizer procmail gcc libc6-dev make libmysqlclient10-dev quota libquota-perl libnet-ssleay-perl libio-stringy-perl libdata-showtable-perl libapache-request-perl libxml-perl libssl openssl libssl-dev libexpat1 libexpat1-dev zlib1g zlib1g-dev

NOTE #1: Answer "yes" to all the questions of php4 modules.
NOTE #2: Make sure that the FTP server works properly: try to login after 
installation on choosed FTP server (vsftp).

Some of the packages may be reported as already installed. It is not an
error - it only means that you do not need to install the package.

NOTE #3: Some of 3rd parties could be unavailable on their public locations. You can get a copy of them at ftp://download1.sw-soft.com/Confixx/third_parties/

STEP 2.
	CONFIGURE THE APACHE WEB SERVER
	
Activate PHP4 support:
--------------------------

PHP4 module on debian is not connected to Apache web server after its
installation complete. You need to

1) open the file /etc/apache/httpd.conf
2) uncomment the line

# LoadModule php4_module /usr/lib/apache/1.3/libphp4.so

so that it becomes

LoadModule php4_module /usr/lib/apache/1.3/libphp4.so

3) find the lines like

<IfModule mod_dir.c>
    DirectoryIndex index.html index.htm index.shtml index.cgi
</IfModule>

and add index.php to the list, so that lines become

<IfModule mod_dir.c>
    DirectoryIndex index.html index.htm index.shtml index.cgi index.php
</IfModule>

4) save the changes

Activate SSI support:
---------------------

1) open the file /etc/apache/httpd.conf
2) uncomment the line

#LoadModule includes_module /usr/lib/apache/1.3/mod_include.so

so that it becomes

LoadModule includes_module /usr/lib/apache/1.3/mod_include.so

3) Uncomment lines

# AddType text/html .shtml
# AddHandler server-parsed .shtml

so that they become

AddType text/html .shtml
AddHandler server-parsed .shtml

4) save the changes

Activate mod_python support:
----------------------------
1) open the file /etc/apache/httpd.conf

2) uncomment the line

# LoadModule python_module /usr/lib/apache/1.3/mod_python.so

so that it becomes 

LoadModule python_module /usr/lib/apache/1.3/mod_python.so

Restart the apache
#~: /etc/init.d/apache restart


STEP 3.
	CONFIGURE MYSQL

Login to mysql console and execute the following commands:

#~: mysql -p (as user  root )
Enter password: <enter without password>

mysql> use mysql;
mysql> delete from user where User =  '' ;
mysql> delete from db where User =   '';
mysql> update user set Password = Password('some_passwd') where User =
'root';
mysql> flush privileges;
mysql> exit;

	It will create a password for the mysql 'root' user.


STEP 4.
	INSTALL AND CONFIGURE SPAMASSASSIN
	
The SpamAssassin software gives an ability to filter SPAM in
your customers Mailboxes when receiving mail there.

Skip the step if you do not need SpamAssassin support in Confixx.

If you use woody Debian distribution add this string to /etc/apt/sources.list file
deb http://www.backports.org/debian/ woody spamassassin
The source contains last SpamAssassin version compiled for woody distribution.
Then 
#~:apt-get update
#~:apt-get install spamassassin procmail

Edit /etc/default/spamassassin and set
ENABLED=1
OPTIONS="--sql-config --nouser-config --local --daemonize --max-children 5"

#~:/etc/init.d/spamassassin start

#~:wget http://spamassassin.apache.org/full/3.0.x/dist/procmailrc.example
#~:mv procmailrc.example /etc/procmailrc

Edit /etc/postfix/main.cf and set
mailbox_command=/usr/bin/procmail


STEP 5.
	INSTALL AND CONFIGURE MAJORDOMO

Majordomo is a program which automates the management of
Internet mailing lists. Having this program installed you can
offer your customers an ability to create and manage mailing
lists via Confixx web interface.

Skip the step if you do not need Majordomo support in Confixx.

The latest version of the product can be found on
  http://www.greatcircle.com/majordomo/
  
#~:wget  http://www.greatcircle.com/majordomo/1.94.5/majordomo-1.94.5.tar.gz

Unpack the software
#~: tar xzf majordomo-1.94.5.tar.gz
#~: cd majordomo-1.94.5

Create majordomo user and group:
#~: groupadd majordomo
#~: useradd majordomo -g majordomo
#~: cat /etc/passwd | grep majordomo
	You will see the output line like the following one:
majordomo:x:123:123::/home/majordomo:/bin/bash

	read the 'majordomo' user id ('123' in  sample output above) and group id ('123' in  sample output above) in output, and remeber it.

Create installation directory for majordomo
#~: mkdir /usr/local/majordomo


Edit the makefile
#~: vi Makefile
Change the line with PERL variable definition to
		PERL = /usr/bin/perl
Change the line with W_HOME variable definition to
		W_HOME = /usr/local/majordomo
Change the lines with W_USER and W_GROUP variables definition to
(below are sample value use the UID and GID remembered above):
		W_USER = 1000
		W_GROUP = 104

set TMPDIR = /tmp
Edit the configuration file
#~: cp sample.cf majordomo.cf
#~: vi majordomo.cf

Set $whereami variable to your host name and that is enough
	$whereami = "your-host.com";

Install the majordomo:
#~: make wrapper
#~: make install
#~: make install-wrapper

Check the installation:
#~: cd /usr/local/majordomo; ./wrapper config-test

You should see something like:
<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<

----------------------- end of tests -----------------------


Nothing bad found!  Majordomo _should_ work correctly.

If it doesn't, check your configuration file
        (/usr/local/majordomo/majordomo.cf)
closely, and if it still looks okay, consider asking the majordomo-users
mailing list at "majordomo-users@greatcircle.com" for assistance.  Be sure
and fully specify what your problems are, and what type of machine (and
operating system) you are using.

Enjoy!

I see you haven't registered this version of Majordomo.
By registering, you will be notified of patches and further releases
of Majordomo.  Shall I send email to majordomo-registration@greatcircle.com
to register this version?  (I'll cc Majordomo-Owner@deb3.victory.plesk.ru)
[yes] no
Ooooh, like to live dangerously, eh?!
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>

You have the majordomo installed. The further configuration will be performed
by Confixx software.


STEP 6.
	INSTALL AND CONFIGURE MAJORCOOL

MajorCool is an administrative front-end to the popular mailing
list manager (Majordomo), allowing list-owners to manage their
list configuration and subscriber base. If you install
MajorCool, the user interface will show a link to MajorCool.

Skip the step if you do not need Majordomo support in Confixx.

The latest software version can be found on
  http://www.conveyanced.com/MajorCool/

#~:wget  http://www.conveyanced.com/MajorCool/majorcool.tar.gz

Unpack the distribution:
#~: mkdir majorcool
#~: tar xzf majorcool.tar.gz -C majorcool
#~: cd majorcool

Fix the Configure script
#~: vi Configure
change the PERLBIN variable to be set properly:
PERLBIN="/usr/bin/perl"         # How to start a perl script

#~: mkdir /var/www/cgi-bin

Now run the configure script and be ready for lots of questions
./Configure

The most important questions are:

$ What is the root directory for your Web server? 
$ [/etc/apache/]:<Enter>

$ Where is the cgi-bin directory for your Web server?
$ [/var/www/cgi-bin]:<Enter>
$ Will place the programs in /var/www/cgi-bin.

$ What is your server's URL for '/var/www/cgi-bin'?
$ [/cgi-bin]:<Enter>

To answer the next questions properly you need to
1) open Apache configuration file (typically /etc/apache/conf/httpd.conf or /etc/httpd/conf/httpd.conf)
2) find there a line starting with
	Alias /icons/
Usually it looks like
	Alias /icons/ /usr/share/apache/icons/
So the 2nd argument in line (/usr/share/apache/icons/) is the images directory
and the 1st one (/icons/) is the server's URL for it.

$ Where is the image directory for your Web server?
$ [/usr/share/apache/icons]: /usr/share/apache/icons
$ Will place the icons in /usr/share/apache/icons

$ What is your server's URL for '/usr/share/apache/icons'?
$        [/icons]: /icons

$ Where is the root directory for documents on your Web server?
$        [/var/www/]:

It is highly recommended to answer "No" to the following questions unless you 
plan to supply your customers with list create/rename/delete abilities outside
of Confixx Control Panel. It is possible to turn the features below off after
the installation is complete.

$ Provide list CREATE access [Y]? N
$ Provide list RENAME access [Y]? N
$ Provide list DELETE access [Y]? N


STEP 7.
	INSTALL IDNKIT

	IDN (International Domain Names) - the technology allows create
and use domains having national characters in their names.
Server side of IDN support is performed by IDNKit software.

Skip the step if you do not need IDN support in Confixx.

The latest software version can be found on
  http://www.nic.ad.jp/en/idn/
The latest (at the moment of publishing)  zipped version can
downloaded via the following URL:
 http://www.nic.ad.jp/ja/idn/idnkit/download/sources/idnkit-1.0-src.tar.gz

#~: tar xzf idnkit-1.0-src.tar.gz
#~: cd idnkit-1.0-src
#~: ./configure
#~: make
#~: make install


STEP 8.
	INSTALLING COLDFUSION

Having this product installed you can offer your customers an
ability of using CFML (ColdFusion Markup Language) on their web
sites.

Unlike most of  the other described packages, Coldfusion server
is not shareware or open sourced. Trial version could be
downloaded from http://macromedia.com (about 100Mb).

Launch the downloaded binary and follow the instructions.

STEP 9.
	CONFIGURING QUOTA

Launch the following commands
:~# update-rc.d -f quotarpc remove
:~# update-rc.d -f quota remove
:~# update-rc.d quota defaults 18

Edit the /etc/fstab file, add the option 'usrquota' like in the line below
/dev/sda2       /               ext3    errors=remount-ro,usrquota      0	1

Then reboot
:~# reboot

:~# quotacheck -ma -F vfsold
:~# quotaon -a


STEP 10.
	CONFIGURE AND INSTALL CONFIXX
	
Download Confixx.
#~: wget http://download1.sw-soft.com/Confixx/ConfixxPro3/3.0.9/confixx_pro_3.0.9_install_mysql3_20050519.17.tgz

Unpack the distribution
#~: tar xzf confixx_pro_3.0.9_install_mysql3_20050519.17.tgz
#~: cd confixx-install

Launch the configure script and answer its questions accordingly to
configuration of your system
#~: ./configure.pl

The sample configure session log (with answers) could be found in
in en_install.pdf (or de_install.pdf) file.

Now you can launch the installation script:
#~: ./install.pl


STEP 11
	FINISHING THE INSTALLATION

Register the script in crontab.
#~: echo "*/1 * * * *   /root/confixx/confixx_counterscript.pl" >> tmp.cron
#~: crontab -u root tmp.cron

Restart the apache
#~: /etc/init.d/apache stop
#~: /etc/init.d/apache start
	or
#~: /etc/init.d/apache restart

STEP 12.
	ACCESSING CONFIXX WEB INTERFACE

	Enter the confixx web interface by accessing the url like:
	http://<confixx-vhost>/


STEP 13
	REGISTERING YOUR CONFIXX INSTALLATION

Enter the registraion interface by accessing the url like:
http://<confixx-vhost>/reg
or by entering the "Licensing information" menu item in admin interface.

Enter the "Unlock license" menu item there and click "Next".
You need to specify your serial number and activation key there and click
next. The registration routines will be done automatically.