README.warden-apache

Strucny technicky navod pro preklopeni Warden serveru pod Apache a mod_perl
===========================================================================

INSTALACE
=========

1) Instalace Apache a MySQL DB
	
	aptitude install apache2 mysql-server

2) Povoleni mod_ssl

	an2enmod ssl

3) Instalace knihovny mod_perl

	libapache2-mod-perl2

4) Instalace podpory metody prefork pro Apache

	apache2-mpm-prefork

5) Instalace nove pridanych modulu

	aptitude install libcrypt-x509-perl libmime-base64-perl


KONFIGURACE
===========

1) Nastaveni APACHE 

	a) /etc/apache2/sites-enables/default
		- konfigurace sekce <VirtualHost *:443>
		- includovani potrebnych parametru ze souboru {warden-server}/etc/warden-apache.conf
			Include /opt/warden-server/etc/warden-apache.conf
	
	b) Nastaveni vykonovych parametru Apache (/etc/apache2/apache2.conf)
		- modul prefork (nastavujte dle vykonu vaseho serveru)
		= pro 12C, 16GB RAM funguje dobre

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


		- parametry spojeni
			
			Timeout 10
			KeepAlive Off


	c) restartovani Apache po kazde zmene Warden.pm (serverova cast)


2) Nastaveni DB

	a) (volitelne) Vytvoreni noveho uzivatele
	b) Vytvoreni databazove struktury

		mysql -u uzivatel -p heslo < {warden-server}/doc/warden.mysql

3) Nastaveni warden-server.conf, warden-client.conf, {warden-server}/etc/warden-apache.conf

	a) Zkontrolovat spravnost IP adres, portu a hlavne cest k certifikatum + nove udaje pro pripojeni do DB
	b) Pro klienta a server na jednom stroji jsou zrejme treba 2 ruzne certifikaty (me to jinak nejde, zkuste;))
	
	Tato chyba se vypisuje pri problemu s certifikaty (chybna adresa serveru, chybne cesty pro certifikat, stejny certifikat pro klienta a server)

	DEBUG: .../IO/Socket/SSL.pm:420: fatal SSL error: SSL connect attempt failed with unknown errorerror:14090086:SSL routines:SSL3_GET_SERVER_CERTIFICATE:certificate verify failed not well-formed (invalid token) at line 1, column 3, byte 3 at /usr/lib/perl5/XML/Parser.pm line 187


SLEDOVATKO
==========
	
	Pro sledovani stavu Apache, poctu prijatych udalosti, poctu klientu lze pouzit sledovatko
	{warden-server}/bin/getWebStatus.sh