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). Spustit s parametrem udávajícím adresář (dále ${repository}), kde budou uložena interní data. Tímto se na disku vytvoří příslušné adresáře a konfigurační soubor, který je potřeba nastavit. Adresářovou strukturu je možné vygenerovat i na jiném počítači ( např. s linuxem ), potom je však nutné změnit cesty v souboru ${reposiotry}/config/config.xml.

V konfiguračním souboru je potřeba nastavit následující parametry:

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 jako .war soubor. 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 DamisMail.war

4. spustit soubor pack.bat

Soubor DamisMail.war je takto rozšířen o potřebné soubory

Instalace aplikace do Tomcatu

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