Konfigurace Tomcatu

Instalace knihoven

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 <GlobalNamingResources> 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ů

DamisMail používá uživatelskou rolí LiviusAdmin. 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:

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>