Differences between revisions 12 and 25 (spanning 13 versions)
⇤ ← Revision 12 as of 2006-08-21 15:26:53 →
Size: 3189
Editor: 10
Comment:
← Revision 25 as of 2006-08-21 15:59:15 → ⇥
Size: 3765
Editor: 10
Comment:
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
= Konfigurace Tomcatu =
Line 2: Line 3:
= Konfigurace Tomcatu = == Instalace knihoven ==

|| Knihovna ( třída ) || Cíl || Popis ||
|| derby.jar || ${tomcat}/common/lib || Databáze Apache Derby ( IBM Cloudscape) ||
Line 6: Line 10:
Soubor je umístěn v ${tomcat}/conf/server.xml Soubor je umístěn v {{{${tomcat}/conf/server.xml}}} (hlavní konfigurační soubor pro Tomcat)
Line 32: Line 36:
Damis``Mail používá uživatelskou rolí Damis``Mail``Admin. V souboru ${tomcat}/conf/tomcat-users.xml je potřeba vytvořit příslušnou uživatelskou roli a uživatele. Damis``Mail používá uživatelskou rolí Damis``Mail``Admin. V souboru {{{${tomcat}/conf/tomcat-users.xml}}} je potřeba vytvořit příslušnou uživatelskou roli a uživatele.
Line 47: Line 51:
V adresáři config_template je skript create (potřebuje 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 donastavit.		 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}}.
Line 50: Line 57:
V configuračním souboru je potřeba nastavit následující parametry:
|| Parametr || Význam ||
|| inputDirectory || vstupní monitorovaný adresář ||
|| host || smtp server ||
|| from || odesílací adresa ||
|| command || příkaz pro transformaci souboru (absolutní cesta ) ||
V konfiguračním souboru je potřeba nastavit 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 ) ||


== 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}}}.
Line 59: Line 74:
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. 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}}}.
Line 61: Line 76:
 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 Damis``Mail.war
 4. spustit soubor pack.bat
Soubor Damis``Mail.war je takto rošířen o potřebné soubory

== 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.		  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
Line 74: Line 84:
Soubor Damis``Mail.war vygenerovaný v předchozím kroku se nahraje do instalace Tomcatu do adresáře webapps. Soubor {{{DamisMail.war}}} vygenerovaný v předchozím kroku se nahraje do instalace Tomcatu do adresáře {{{webapps}}}.

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 <GlobalNamingResources> přidat 

 <Resource
      auth="Container"
      description="DamisMail databaze"
      name="jdbc/DamisMailDB"
      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í DamisMailAdmin. 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="DamisMailAdmin"/>
  <user username="admin" password="damis" roles="DamisMailAdmin"/>
</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:

Tag

Atribut

Význam

InputDomain

inputDirectory

vstupní monitorovaný adresář

MailOutput

host

smtp server

MailOutput

from

odesílací adresa

Transformer

command

příkaz pro transformaci souboru .doc na .pdf (absolutní cesta )

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.

DamisMailKonfigurace (last edited 2006-09-19 21:06:53 by hercules)