SETUP GUIDE FOR DEBIAN SARGE
RECOMMENDED CONFIGURATION
1) MySQL 4.xx (database server)
2) Postfix (mail transfer agent)
3) Qpopper (POP3 daemon)
4) Vsftpd (FTP server)
5) Apache 2 ( WWW 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
-------------------------------------------------------------------------------------------
apache2
apache2-common
libapache2-mod-php4
libapache2-mod-python
mysql-client
mysql-server
mysql-common
php4
php4-imap
php4-mysql
perl
perl-base
perl-modules
libdbi-perl
libdbd-mysql-perl
vsftpd
postfix
qpopper
bind9
webalizer
procmail
gcc
libc6-dev
make
libmysqlclient12-dev
quota
libquota-perl
libnet-ssleay-perl
libio-stringy-perl
libdata-showtable-perl
libxml-perl
openssl
libssl-dev
libexpat1
libexpat1-dev
zlib1g
zlib1g-dev
-------------------------------------------------------------------------------------------
You can install them all as shown below:
#~: apt-get install apache2 apache2-common libapache2-mod-php4 libapache2-mod-python mysql-client mysql-server mysql-common php4 php4-imap php4-mysql perl perl-base perl-modules libdbi-perl libdbd-mysql-perl vsftpd postfix qpopper bind9 webalizer procmail gcc libc6-dev make libmysqlclient12-dev quota libquota-perl libnet-ssleay-perl libio-stringy-perl libdata-showtable-perl libxml-perl openssl libssl-dev libexpat1 libexpat1-dev zlib1g zlib1g-dev
NOTE #1: 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 #2: 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 APACHE WEB SERVER
Confixx require the following modules to be enabled
cgi php4 rewrite ssl suexec mod_python include
Enable them
#~:for mod in cgi php4 rewrite ssl suexec mod_python include; do a2enmod $mod; done
#~: /etc/init.d/apache2 restart
STEP 3.
CONFIGURE MYSQL
Login to mysql console and execute the following commands:
#~: mysql (as root )
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.
#~:apt-get install spamassassin
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
# mount -o remount /
:~# quotacheck -ma
:~# quotaon -a
Now your server is ready for Confixx installation
read Release Notes for installation instructions
