INSTALL

Installation process
====================

Content

 A. Overview
 B. Pre-installation step
 C. Installation step
 D. Post-installation steps

--------------------------------------------------------------------------------

A. Overview
-----------

For installation of warden-server package on local machine use install.sh.
  
Default destination directory is /opt/warden-server/.
          
For more information about install.sh options run install.sh -h.

You must be root for running this script.


B. Pre-installation step
------------------------

1) Install necessary packages
    
	# aptitude install apache2 mysql-server libapache2-mod-perl2 apache2-mpm-prefork


C. Installation step
--------------------

1) Install Warden server package

	# ./warden-server-2.1/install.sh -d /opt -k /etc/ssl/private/server.key -c /etc/ssl/certs/server.pem -a /etc/ssl/certs/bundle.pem


D. Post-installation steps
--------------------------

1) Enable of mod_ssl module

	# a2enmod ssl 


2) Apache server configuration

 a) VirtualHost section configuration

  - include parameters from the Warden server configuration file (<warden-server_path>/etc/warden-apache.conf)

	# vim /etc/apache2/sites-enables/default(-ssl)

		<VirtualHost *:443>
		...

		Include /opt/warden-server/etc/warden-apache.conf
		</VirtualHost>

    
 b) Apache server performance configuration

	# vim /etc/apache2/apache2.conf

		  - prefork module settings

			<IfModule mpm_prefork_module>
		        	StartServers          2   
		                MinSpareServers       4   
		                MaxSpareServers       8   
		                ServerLimit           700 
	                	MaxClients            700 
        		        MaxRequestsPerChild   0   
			</IfModule>

		 - connection settings
    
			Timeout 10
		        KeepAlive Off 


3) MySQL database configuration

 a) Create new user acount (optional)

 b) Create new database structure

	$ mysql -u <user> -h localhost -p <password> < {warden-server_path}/doc/warden.mysql


4) Warden server configuration

 - configure warden-server.conf, warden-client.conf and warden-apache.conf placed in <warden-server_path>/etc directory


5) Restart of Apache server

	# /etc/init.d/apache2 restart