This howto explains th instllation of Interis on FC8. Binary Installation of Interis on FC8 is explained at this tutorial;

Before starting to the documantation, let's explain which packages are required to start instllation of Interis and after installation which fonctionalities Interis will provide.

Installation script of Interis requires following packages:

  1. bind-9.5.0b2.tar.gz
  2. bind_conffiles_v0.30.tar.gz
  3. openssl-0.9.8g.tar.gz
  4. db-4.6.18.tar.gz
  5. mysql-5.1.22-rc-linux-i686-glibc23.tar.gz
  6. courier-authlib-0.60.2.tar.bz2
  7. cyrus-sasl-2.1.22-nodlcompat.tar.gz
  8. pam_mysql-0.7RC1.tar.gz
  9. mysql_pam_lib.fc8.v-0.01.tar.gz
  10. gsasl-0.2.24.tar.gz
  11. postfix-2.5.1.tar.gz
  12. courier-imap-4.3.0.tar.bz2
  13. httpd-2.2.8.tar.gz
  14. php-5.2.5.tar.bz2
  15. squirrelmail-1.4.13.tar.gz
  16. interismng.v-0.05.tar.gz
  17. amavisd-new-2.5.3.tar.gz
  18. amavisd.fc8
  19. amavisd.conf.sample
  20. clamav-0.92.1.tar.gz
  21. mailman-2.1.9.tgz
  22. mailman_2_1_9_newlist
  23. proftpd-1.3.1.tar.gz
  24. apache_virtual_conffiles_v0.1.tar.gz
  25. libidn-1.4.tar.gz
  26. mngserver.linux.fc8-v0.26.tar.gz
  27. clamd.conf.sample
  28. freshclamd.conf.sample
  29. Defaults.py.tmpl
  30. perllib.fc8.v-0.09.tar.gz
  31. serverproperties.txt
  32. Installer.pm
  33. installer.pl

If you have all the packages above, you have got all tools needed for installation.

You may notice that there are lots of packages. Yes, there are many, because Interis provides you a turn key product where you do not need anything else.

Now, to start installation, you have to download each packages and construct the installation directory structure. And you see that it is time consuming. Because of this, we did that for you. If you click this link, you will get all packages and installer program in a tarball. Intallation document will continue on this tarball.

Now lets explain what features Interis will provide for you fater instllation.

Here are the functionalities of Interis.

 

  1. Web based management system
    1. Email Server which supports virtual domains and users and quota management system
      1. adding/deleting/listing Email domains
      2. adding/deleting/listing Email users
      3. Emailing system which is protected by Anti-Virus
      4. Emailing system which is protected by Anti-Spam
    2. Mailing List System which supports virtual domains and users and quota management system
      1. adding/deleting/listing Mailing Lists
      2. Mailing List system which is protected by Anti-Virus
      3. Mailing List system which is protected by Anti-Spam
    3. DNS Management System
      1. adding/deleting/listing Domains
      2. adding/deleting/listing Sub Domains
      3. Time Based Dns registration
    4. Virtual Host enabled Web Server
      1. adding/deleting/listing Virtual Hosts
      2. Quota management for Virtual Hosts
      3. Integrating Virtual FTP to Virtual Host
    5. Virtual FTP Management System
      1. adding/deleting/listing Virtual FTP Servers
      2. adding/deleting/listing FTP User Accounts for FTP Servers
      3. Quota management for Virtual FTP Servers
      4. Integrating Virtual FTP to Virtual Host
    6. Web Based Mangement System
      1. Multiple language support
      2. Multi-User Control Panel
      3. Managing Servers from Control Panel (Starting/stopping/restarting, Viewing statuses)
      4. Multi-Layer Infrastructure
      5. Communication Protolcs for Standalone windows and linux manager clients
If you installed Interis successfully, you will have all the aboce features.

Let's start to installation

 

Installation

 

This documents explains how to installa Interis from Source Code.

Please, do installation procedures as root user. Before starting to action, check whether ports of 110(POP3), 143(IMAP), 3306(MySQL), 25(SMTP), 53(DNS) are closed or not. Before the installation process, no process should take these ports.

Because, while installing Interis, port 3306 will be used MySQL server, MySQL server can not take the 3306 port, the installation process will fail.

Morover, this instllation requires that SELinux be disabled for Fedora Core 8 Linux Distribution. Therefore, please make SELinux passive before installation. SELinux enabled Interis still on testing process, when it is finished, it will be announced.

We assume that you have a fresh FC8 which ins installed with minimum required package lists. After installation of FC8, some package sometimes not being installed as default. Therefore, please install below packages with the help of yum. (-y option is to answer yes for yum questions as default)

yum -y install glibc-headers
yum -y install pam-devel
yum -y install pcre pcre-devel
yum -y install db4-devel.i386
yum -y install libxml2.i386
yum -y install libxml2-devel.i386
yum -y install libjpeg-devel.i386
yum -y install libpng-devel.i386
yum -y install python-devel
yum -y install perl-devel.i386


Next, please download last interis tarball from this link and extract to /tmp directory with below command.


$ tar xvzf interis.fc8.src.20080315.tar.gz -C /tmp



Now you have a directory with path /tmp/fc8 .

Change directory to in as below.

 

$ cd /tmp/fc8

 

When you list files, you will see such a directory structure:

(filenames end with "/" points to directory names )

  1. Installer.pm
  2. installer.pl
  3. packages/
  4. conf/

Samples of Configuration files are in the conf directory. All packages are in the packages directory.

installer.pl ve Installer.pm files are script files which do installation. All the installation codes are at the Installer.pm Perl modules. installer.pl is only a wrapper script which instantiate Installer Perl Module and calls its functions.

Now, Lets introduce the structure of Installer.pm perl module. By introducing, you will learn how to do installation.

Installe.pm perl module has typical Perl module structure. It introduces the package named "Installer" and has some member functions.

These member functions are mostly named as <Package_name>_maker and <Package_name>_confer, and rarely named as <Package_name>_Installer.

_maker functions do pakage compilation and installation whereas _confer functions do configuration of the installed pakage. _Installer functions are used for packages which only need installation and no configuration. Meanly, they only do copying or extracting tarballs.

For example, Installer.pm has two member function named as maildrop_maker and maildrop_confer. These functions do installtion and configuration of the Courier Maildrop package, respectively. maildrop_maker is responsible for compiling and installing of Courier Maildrop package where as maildrop_confer is responsible of configuring the installed Courier Maildrop package.

If you execute a maker function, you have to execute the related confer function. If not, your installation will not be completed.

There is one more thing about maker and confer functions. Each maker and confer function is numbered starting from 0 and counting 100 by 100 increasingly.

 

For example, 0 numbered function is init function, and 100 numbered function is bind_maker function. The last numbered function is cleaner function and its number is 5100. You see that there are 52 functions.

These member functions are called from installer.pl perl script.

The main content of installer.pl is as below.

 

 



my $installer = new Installer('server_host' => 'localhost');

$installer->start ( startpoint => 5100, execution_type => "onlythis" );

1.line show the instantiation of Installer Perl modeul which is defined in Installer.pm file. 2. line shows how the start function is called.

Start function has two parameter:startpoint and execution_type. startpoint shows the start point of the installation meanly, which numbered function will be starting point of installation process. execution_type has aspecial meaning for the installation process. Sometimes, you will only need an instllation of one package, for example the function numbered 1600. Sometimes you will need the functions numbered as 1200, 1300, .. .. 5100. Meanly you will want to start from a point(here 1200) and go to at the end of the function list (here 5100). Now, execution_type help you select an execution type: you want to execute only one function with "onlythis" parameter, or you want to start from a point and goes to the end of function list with "startfrom". The above lines show that you only want to install the function numbered as 5100.

If you have a line like below in the installer.pl file, your installation will start from the function numbered as 300, and will go to the end of the function list.

 


$installer->start ( startpoint => 300, execution_type => "startfrom");

 

Now, why do I explain such a technical detail of installation script files. Because, you will have to change the content of the installer.pl file while installing.

If you are sure everything will be okey installing, you can change the content of the installer.pl as below

 


$installer->start ( startpoint => 0, execution_type => "startfrom");

 

and execute the installer.pl on the command line as below.

$ ./installer.pl

 

However, I do not recommend this installation procedure. Because, you may encounter a problem while installing and if you chose the above installation type, I cannot help you since, you cannot stop the installation process, it will be executed untill it reached the last function (5100. function).

So I recommend you go over step by step.

Meanly, change the content of the installer.pl file as below

 


$installer->start ( startpoint => 0, execution_type => "onlythis");

 

execute it as below.

$ ./installer.pl

 

Then, change the startpoint parameter of start function to 100 and execute the installer.pl function. Next, make startpoint parameter 200 and at each step increment startpoint parameter by 100 untill reacing 5100.

If at some points, you encounter a problem please inform me. If you do not encounter a problem, congrutulation!, you have installed Interis successfully.

 

Important Note 1:


After installation you will see that there is a version missmatch between amavis and File::Temp perl module. The new amavis package requires version 0.20 where as there is an older version of File::Temp at the perl library of the host system. Therefore you have to update your File::Temp Perl package to the new version. To update, execute below command and get a cpan shell command promt.

 

$ perl -MCPAN -e shell

after that enter the below command. At the end, the new version of File::Temp Perl package will be installed to your host system.

 

install File::Temp

 

Important Note 2:

 

After installation, you have to create a mailman list. If you did not create a list you will see that you mail server not work. Because in main.cf file of Postfix package, there is a configuration parameter which indicates that mailing comming to and outgoing from a mailing list will be forwarded to the mailman query runner daemond. Postfix knows the addresses of these mailing lists by the help of virtual-mailman.db file located in the "<prefix>/mailman/data". The problem is that there is no such file at first installation but this non-exist file is indicated in the main.cf file of Postfix. When you start the interis, Postfix will start also and postfix will see that there is no such file and will throw an error which is logged into maillog file. Therefore, your mailing system will not work.

So, what do we have to do? we have to create that virtual-mailman.db file. To create that file, we have to create a mailing list and run "bin/genaliases" command and finally restart postfix.

 

Now, let's do it. we assume that you have a virtual domain named virtualdomainsample.com.

The below command will create a mailing list named mailmanlistsample. The admin mailing list is nonexist_mail@nonexistdomain.comma and password is "1234".

 

 

$ newlist -q --url-host=nonexistdomain.comma --mail-host=nonexistdomain.comma mailmanlistsample nonexist_mail@nonexistdomin.comma 1234

then execute the below command and restart your postfix service.

bin/genaliases

It is finished. Now, you can use interis.

 

After installation, please read the user manual, before reading please do not do anything, because it will not work. You have to do some more things which are mentioned in that manual.

 

Regards,

 

Halil AŠIN

 


SourceForge.net Logo