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.