= Konfigurace Tomcatu =

== Instalace knihoven ==

|| Knihovna ( třída ) || Cíl || Popis ||
|| derby.jar || ${tomcat}/common/lib || Databáze Apache Derby ( IBM Cloudscape) ||

== Modifikace server.xml ==

Soubor je umístěn v {{{${tomcat}/conf/server.xml}}} (hlavní konfigurační soubor pro Tomcat)

Do tagu <server> přidat 
{{{
 <Listener className="LightComp.Derby.CatalinaLoader" cacheSize="10000"/>
}}}
Třída uvedená v attributu className je zavolána při startu TOMCATU a nahraje do paměti třídy potřebnou pro práci s databází Derby. Atribut cacheSize obsahuje velikost cache databáze. Velikost je udávána v počtu stránek ( 1 stránka = 4 kB ). 


Do tagu  <Global``Naming``Resources> přidat
{{{   
 <Resource
      auth="Container"
      description="DamisMail databaze"
      name="jdbc/LiviusDB"
      type="javax.sql.DataSource"
      driverClassName="org.apache.derby.jdbc.EmbeddedDriver"
      maxIdle="10"
      maxWait="20000"
      url="jdbc:derby:${db}"
      maxActive="10"/>
}}}
místo ${db} zadat cestu k adresáři s databází viz. vytvoření databáze

== Vytvoření uživatelů ==

Damis``Mail používá uživatelskou rolí Livius``Admin. V souboru {{{${tomcat}/conf/tomcat-users.xml}}} je potřeba vytvořit příslušnou uživatelskou roli a uživatele. 

Vzor souboru tomcat-users.xml 
{{{
<?xml version='1.0' encoding='utf-8'?>
<tomcat-users>
  <role rolename="LiviusAdmin"/>
  <user username="admin" password="password" roles="LiviusAdmin"/>
</tomcat-users>
}}}

= Konfigurace aplikace =

== Vytvoření adresářové struktury ==

V adresáři {{{config_template}}} je skript {{{create}}} (vyžaduje bash). Skript má dva parametry.

 1. adresář, kam bude adresářová struktura vygenerována ( pomocný adresář )
 2. adresář (dále ${repository}), kde budou uložena interní data serveru ( adresář musí být na lokálním disku ). 

Tímto se na disku v pomocnném adresáři vytvoří příslušné adresáře a konfigurační soubor, který je potřeba nastavit. Adresářovou strukturu 
je pak nutné překopírovat z pomocného adresáře do adresáře ${repository}.

{{{
Příklad:
Interní data serveru budou uložena v adresáři c:/liviusrepository, pomocný adresář je /home/user/tmp
./create /home/user/tmp c:/liviusrepository
potom zkopírovat obsah /home/user/tmp do c:/liviusrepository
}}}


== Vytvoření databáze ==

Skripty pro vytvoření databáze jsou v adresáři sql. Nejprve je potřeba nastavit proměnnou DB_FILE v souboru {{{environment.bat}}} na absolutní cestu ${repository}/db (vypsat plnou cestu).
Poté spustit soubor {{{create.bat}}} s parametrem {{{create.sql}}}.


== Konfigurace aplikace ==

Vlastní server je distribuován v souboru livius_template.war. Je potřeba do něj přihrát soubor {{{context.xml}}} a {{{logging.properties}}}. Vzorové soubory jsou umístěny v adresáři {{{war-generation}}}.
K vygenerování potřebné konfigurace je potřeba provést následující kroky:
 1. V souboru {{{${war-generation}/META-INF/context.xml}}} nastavit absolutní cestu k souboru {{{config.xml}}} ( ${repository}/config/config.xml )
 2. V souboru {{{${war-generation}/WEB-INF/classes/logging.properties}}} nastavit absolutní cestu k adresáři s logy ( ${repository}/logs )
 3. Nahrát do adresáře {{{${war-generation}}}} soubor {{{livius_template.war}}}
 4. spustit soubor {{{pack.bat}}}
Soubor {{{Livius.war}}} je takto rozšířen o potřebné soubory

Alternativní způsob

Pro opakované generování souboru Livius.war je možné si pomocí skriptu create vytvořit předkonfigurované soubory {{{context.xml}}} a {{{logging.properties}}}. Výstupem skriptu
je adresář sestejnou strukturou jako má {{{war-generation}}}, ale konfigurační soubory již obsahují správně nastavené cesty ( jako v bodu 1. a 2. ). V takto vytvořeném adresáři
se pak provedou body 3. a 4. . Pro instalaci ka6d0 další verze serveru je pak provést pouze body 3. a 4. .


{{{
Příklad
./create zde_chci_mit_predkonfigurovane_soubory ${reposiotry}
}}}


Konfigurační soubor je umístěn na následující cestě. {{{${reposiotry}/config/config.xml}}}.
V konfigura4n9m souboru {${reposiotry}/config/config.xml}}} jsou správně nastaveny pouze cesty k vnitřnímu repozitáři. Je potřeba nastavit ještě následující parametry:
|| Tag || Atribut || Význam ||
|| Input``Domain || inputDirectory || vstupní monitorovaný adresář ||
|| Mail``Output || host || smtp server ||
|| Mail``Output || from || odesílací adresa ||
|| Transformer || command || příkaz pro transformaci souboru .doc na .pdf (absolutní cesta ) ||


== Instalace aplikace do Tomcatu ==

Soubor {{{Livius.war}}} vygenerovaný v předchozím kroku se nahraje do instalace Tomcatu do adresáře {{{webapps}}}.

== Konfigurační soubor == 
{{{
<?xml version="1.0"?>
<Livius>
<LiviusParams>
	<Param name="dataPath" value="w:/damismailrepository"/>	
	<Param name="CMServer2" value="w:/damismailrepository/cmserver2.xml"/>
	<Param name="areaAttribute" value="Golem.Area"/>
	<Param name="outputErrorDirectory" value="w:/damismailrepository/errorOutput"/>
</LiviusParams>

<InputDomain>
	<Param name="inputDirectory" value="w:/damismailrepository/input"/>
	<Param name="inputErrorDirectory" value="w:/damismailrepository/error"/>
</InputDomain>	

<MailOutput>
	<Param name="host" value="server"/>
	<Param name="protocol" value="smtp"/>
	<Param name="from" value="user@domain.cz"/>
	<Param name="identsmap" value="c:/karel/DamisMail/trunk/WEB-INF/idents.map.xml"/>
</MailOutput>

<ArchiveOutput>
	<Param name="server" value="server"/>
	<Param name="port" value="21"/>
	<Param name="user" value="username"/>
	<Param name="password" value="password"/>
	<Param name="path" value="archive/%USER%"/>
	<Param name="ftp_mode" value="0"/>
	<Param name="ftp_chmod" value="770"/>
</ArchiveOutput>

<PrintOutput>
	<Param name="server" value="server"/>
	<Param name="port" value="21"/>
	<Param name="user" value="username"/>
	<Param name="password" value="password"/>
	<Param name="path" value="print/%USER%"/>
	<Param name="ftp_mode" value="0"/>
	<Param name="ftp_chmod" value="770"/>
</PrintOutput>

	
<Transformer>
	<Param name="errorDirectory" value="w:/damismailrepository/error_transformation"/>

	<ExternalTransformService name="Doc2Pdf" 
		fromType="application/msword"
		toType="application/pdf"
		toTypeExtension=".pdf"
		input="w:/damismailrepository/transf/in"
		output="w:/damismailrepository/transf/out"
		command="c:/karel/Damis/Livius/doc2pdf.exe %in% %out% 20"
	/>
</Transformer>

</Livius>
}}}