Before you can start the installation of Monzai Enterprise 1.0,
please remember that you must have already installed the following software:

- Apache http-server 1.3.x+ from http://www.apache.org
- MySQL Database 3.23.x+ from http://www.mysql.com
- MySQL Client from http://www.mysql.org
- Perl 5.6.1+ from http://www.cpan.org (untested with older versions)
- CPAN LWP-MODULE from http://www.cpan.org and install like in 1a) or 1b)
- CPAN DBI-Module from http://www.cpan.org and install like in 1a) or 1b)
- CPAN DBD::mysql-Module from http://www.cpan.org and install like in 1a) or 1b)

1a) Go to http://www.cpan.org/authors/id/TIMB/ and download the newest
DBI-Module unzip and untar, perl Makefile.PL, make, make test and finally make install.
Same with http://www.cpan.org/modules/by-module/DBD/DBD-mysql-2.1026.tar.gz
or any newer version of DBD.
Same for http://www.linpro.no/lwp/libwww-perl-5.64.tar.gz

**************** OR ***********
******** __mouch__ easier(!!!): ***

1b) Let cpan make all that stuff for you...

perl -MCPAN -e shell

NOTE: If you run CPAN for the first time it will ask you a few questions about your configuration.
Usually you can leave the default settings with one exception:
If you use a proxy to connect to the internet, you have to provide your proxy's IP and port.

Now type in to the shell (meanwhile you can prepare and drink a coffee... :-) ):

install LWP
install DBI
install DBD::mysql

After CPAN has finished the installations type:

exit

2) Add these options in your apache-config-file (/path/to/conf/httpd.conf) and restart apache:

2a) Options +ExecCGI <--- right under the <Directory "/var/www/html/">
entry in your httpd.conf

NOTE: If you don't do that you will get a Forbidden! You don't have permission to access ....
error message! We suggest you to create a new name-, ip- or port-based
virtual host (sample) within your httpd.conf and allow the execution of .cgi and .pl-
scripts only within this virtual host!

CAUTION: If you don't create a virtual host, all of your old folders will allow
the execution of .cgi and .pl-scripts!

2b) A few lines below your <Directory "/var/www/html/"> entry change the line:

AllowOverride None <----- old!

with this one:

AllowOverride All <----- new!

NOTE: If you created a new virtual host place the new entry somewhere between your
<VirtualHost> and your </VirtualHost> in the /path/to/conf/httpd.conf file. See sample

NOTE: If you forget that you will get a really unsecure and open entry to your
management station since Monzai places a .htpasswd and a .htaccess into its path!!!

2c) AddHandler cgi-script .cgi .pl <--- somewhere near the other AddHandler entries

2d) /path/to/apache/bin/apachectl stop

2e) /path/to/apache/bin/apachectl start
or
/path/to/apache/bin/apachectl startssl depends on you...

3) Start the installer programm

perl installer.pl

Now follow the instructions in the programm.
It will configure and install everything according to your environment!!!

:-)

Sample part for the end of your httpd.conf:

<VirtualHost 192.168.1.2>
ServerName monzai.yourcompany.com
DocumentRoot /var/www/html/monzai/
AllowOverride All
Options +ExecCGI
User apache
Group apache
</VirtualHost>