INSTALLATION GUIDE FOR SUSE
RECOMMENDED CONFIGURATION
1) MySQL 4.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 SUSE DISTRIBUTION
Below is the list of SuSE packages to be installed if you chose recommended
configuration.
apache2
apache2-mod_php4
apache2-mod_python
php4
php4-imap (SuSE 9.1)
php4-mysql (SuSE 9.1)
php4-session (SuSE 9.1)
mod_php4-core (SuSE 9.0)
phpMyAdmin
mysql
mysql-shared
mysql-client
mysql-devel
perl
perl-DBI
perl-Msql-Mysql-modules ( SuSE 9.0)
perl-DBD-mysql ( SuSE 9.1 )
perl-libxml-perl
vsftpd
postfix
qpopper
bind
bind-utils
webalizer
procmail
gcc
make
perl-spamassassin (SuSE 9.x)
spamassassin (SuSE 9.x)
zlib
zlib-devel
expat
unzip
quota
perl-Compress-Zlib
perl-Expect
perl-IO-Socket-SSL
perl-IO-Zlib
perl-IO-stringy
perl-MIME-Types
perl-MIME-tools
perl-TermReadKey
perl-XML-DOM
perl-XML-Parser
NOTE: 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 1: Make sure that the FTP server works properly: try to login after
installation of chosen FTP server (vsftp).
NOTE 2: for SuSE 9.1
If you are using SuSE 9.1, you may see messages about undefined PHP
function 'mail()' while browsing web panel. To avoid this problem
you need to upgrade the following packages:
php4
apache2-mod_php4
You can find these packages (rpm, srpm, patch rpm) at these URLs:
ftp://ftp.suse.com/pub/suse/i386/update/9.1/rpm/i586/
http://www.suse.com/us/private/download/updates/91_i386.html
It is strongly recommended to upgrade all php and apache related packages.
STEP 2.
CONFIGURING APACHE
1) mod_rewrite
Confixx requires Apache module mod_rewrite. Check file
/etc/apache2/sysconfig.d/loadmodule.conf - if the module is loaded or
not. There should be the following line:
LoadModule rewrite_module /usr/lib/apache2-prefork/mod_rewrite.so
If the line does not present in loadmodule.conf file, then you should open
file /etc/sysconfig/apache2, find there APACHE_MODULES variable and
change it adding "rewrite" word in the list assigned, e.g. (pay attention
to the end of the string):
APACHE_MODULES="access actions alias auth auth_dbm autoindex cgi dir env
expires include log_config mime negotiation setenvif ssl suexec userdir
php4 rewrite"
2) SSI (Server Side Includes)
This section is for SuSE Linux 9.1
To activate SSI feature in Apache you need to open file
/etc/apache2/mod_mime-defaults.conf
and uncomment the lines (remove '#' character at the begining of the strings)
# AddType text/html .shtml
# AddOutputFilter INCLUDES .shtml
So that they become:
AddType text/html .shtml
AddOutputFilter INCLUDES .shtml
3) mod_python
If you are going to use "mod_python" feature
ensure "python" word is in the APACHE_MODULES variable of /etc/sysconfig/apache2
It should looks like this
APACHE_MODULES="access actions alias auth auth_dbm autoindex cgi dir env
expires include log_config mime negotiation setenvif ssl suexec userdir
php4 rewrite python"
4)
Then you should restart Apache:
/etc/init.d/apache2 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
NOTE: SpamAssassin 2.64 is the last version supported by Confixx.
http://old.spamassassin.org/released/Mail-SpamAssassin-2.64.tar.gz
SpamAssassin 3.0 is NOT currently supported.
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.
You can use SpamAssassin RPM package from SuSE distribution:
just install 'perl-spamassassin' and 'spamassassin' packages.
To make SpamAssassin working properly with Confixx on SuSE you
will need to open /etc/sysconfig/spamd, find there a line
SPAMD_ARGS = "-d -c -a -L"
and edit it so that it becomes:
SPAMD_ARGS = "-d -x -q -L"
Here are some explanation of these flags:
-d -- run daemonized
-L -- Use local tests only (no DNS)
-x -- Do not use user preferences files (typicall mail users in
Confixx do not have home directories, so they can not have preferences
files).
-q -- use sql data base to keep user preferences.
You need to extract the file
/etc/procmailrc
from the files.tgz archive and place them at the location specified
(packed from / - directory).
Then edit /etc/postfix/main.cf file to set the following option:
mailbox_command = /usr/bin/procmail
Make sure that file /etc/mail/spamassassin/local.cf exists
and create it if no:
#~: touch /etc/mail/spamassassin/local.cf
Now SpamAssassin is configured.
NOTE: Never try install SpamAssassin from both RPM packages
and tarball at the same time. If both are installed, then you
may get few hard to catch and resolve problems.
If you choose to use RPM packages, do not install SpamAssassin
from tarball. If you choose to use tarball installation, do not
install SuSE RPM packages.
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/
The latest (at the moment of publishing) gzipped version can
downloaded via the following URL:
http://www.greatcircle.com/majordomo/1.94.5/majordomo-1.94.5.tar.gz
For SuSE 9.0 , 9.1 , 9.2 there is majordomo rpm package available.
#~: yast -i majordomo
So majordomo is installed!
If you are going to install majordomo
using tarball follow these instructions
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
read the 'majordomo' user id and group id in output, and remeber it.
#~: 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/
The latest (at the moment of publishing) zipped version can
downloaded via the following URL:
http://www.conveyanced.com/MajorCool/majorcool.tar.gz
INSTALL
=======
For SuSE 9.1 and SuSE 9.0 there is majorcool rpm package.
#~: yast -i majorcoo
#~: cd /usr/lib/majorcool/
Then follow steps of CONFIGURE section below.
If you are going to install majorcool using tarball
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
CONFIGURE
=========
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/apache2/]:<Enter>
$ Where is the cgi-bin directory for your Web server?
$ [/srv/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/apache2/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/apache2/icons/
So the 2nd argument in line (/usr/share/apache2/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/apache2/icons
$ Will place the icons in /usr/share/apache2/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?
$ [/srv/www/htdocs]:
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 10.
INSTALLING XML::DOM PACKAGE
Download XML::DOM package from cpan.org:
http://search.cpan.org/CPAN/authors/id/T/TJ/TJMATHER/XML-DOM-1.43.tar.gz
:~# tar -xzf XML-DOM-1.43.tar.gz
:~# cd XML-DOM-1.43
:~# perl ./Makefile.PL
:~# make
:~# make install
You may require some another perl packages depending on your OS installation.
STEP 11.
CONFIGURE AND INSTALL CONFIXX
Unpack the distribution
#~: tar xzf confixx_install_Pro_3.0.0_mysql.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
configure_session.log file.
Now you can launch the installation script:
#~: ./install.pl
The installation script may ask you for some paths - you are to give him
a correct answer.
STEP 12
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 star
STEP 11.
ACCESSING CONFIXX WEB INTERFACE
Enter the confixx web interface by accessing the url like:
http://<confixx-vhost>/admin
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.