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.
          
For more information about install.sh options run install.sh -h.


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 (examples)

	$ ./warden-server-2.2/install.sh -d /opt/warden-server -k /etc/ssl/private/server.key -c /etc/ssl/certs/server.pem -a /etc/ssl/certs/bundle.pem -e admin@domain.com

	or (if you want to create symlinks to Warden server control scripts during the installation process - optional)

	$ ./warden-server-2.2/install.sh -d /opt/warden-server -k /etc/ssl/private/server.key -c /etc/ssl/certs/server.pem -a /etc/ssl/certs/bundle.pem -e admin@domain.com -s /usr/local/bin


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-enabled/warden

		<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 < {warden-server_path}/doc/warden.mysql


4) Warden server configuration

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


5) Restart of Apache server

	# /etc/init.d/apache2 restart


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

Copyright (C) 2011-2014 Cesnet z.s.p.o