SETUP GUIDE FOR DEBIAN WOODY 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 DirectoryIndex index.html index.htm index.shtml index.cgi and add index.php to the list, so that lines become DirectoryIndex index.html index.htm index.shtml index.cgi index.php 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: 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/]: $ Where is the cgi-bin directory for your Web server? $ [/var/www/cgi-bin]: $ Will place the programs in /var/www/cgi-bin. $ What is your server's URL for '/var/www/cgi-bin'? $ [/cgi-bin]: 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 -F vfsold :~# quotaon -a Now your server is ready for Confixx installation read Release Notes for installation instructions.