Alustava asennusohje:

0. Jos ohjelma asennetaan sellaisen käyttäjätunnuksen alle, 
   jolla ei vielä ole yhtään tomcatissa toimivaa websovellusta, 
   aja käyttäjän kotihakemistossa 
   
   $ wanna-tomcat

   (tai muulla tavoin valmisteltava tomcat-asennus siten, 
   että löytyy normaalit webapps- logs- conf- jne 
   hakemistorakenteet)

1. Pura paketti kata.tar.gz tomcat/webapps -hakemistoon. 
   Tiedoston tulisi purkautua hakemistona 'kata'.

   $ tar -xvzf kata.tar.gz

2. Lisää tomcat/conf/server.xml -tiedostoon elementti:

   <Context
     path="/tomcat/USERNAME/kata"
     docBase="/home/USERNAME/tomcat/webapps/kata/"
     debug="0"
     reloadable="true"
     crossContext="true"
     override="true"/>
  
   Sopivaan host-elementtiin.

   (vaihda kohtaan USERNAME se käyttäjätunnus, jonka alla 
   sovellus ajetaan)

3. siirry USERNAME -käyttäjän hakemistoon ~/tomcat/webapps/kata 
   ja editoi tiedostoon dbconf.txt TKTL:n tietokannan tiedot.

4. Muokkaa tiedostossa WEB-INF/web.xml olevia context-param 
   -elementtien sisällä olevia param-value -elementtejä niin, 
   että niissä on oikea polku. Saatat joutua kokeilemaan 
   absoluuttista tai suhteellista polkua.

5. Ennen tomcatin käynnistystä on asetettava ympäristömuuttujaan 
   LC_CTYPE arvo fi_FI.UTF-8 , mutta on (mahdollisesti) myös 
   muistettava tarkistaa mitä muuttujassa oli ennen.

   Seuraavilla komennoilla pidetään huoli, että tomcatin käynnistyessä
   ympäristömuuttujassa on oikea arvo ja tomcatin käynnistyksen 
   jälkeen sinne asetetaan sama arvo kuin mikä siellä oli 
   aluksi. Mikäli tomcat-instanssissa toimii muitakin sovelluksia,
   joiden toiminta häiriintyy tämän ympäristömuuttujan muutoksen 
   takia, on harkittava oman tomcat-instanssin perustamista.

   $ export VANHA_LC_CTYPE=$LC_CTYPE
   $ export LC_CTYPE=fi_FI.UTF-8
   
     ... käynnistä tomcat tässä välissä!

   $ export LC_CTYPE=$VANHA_LC_CTYPE

   (käynnistystä varten voi myös avata uuden bashin jonka sulkee
    käynnistyksen jälkeen, jos ei halua että jää VANHA_LC_CTYPE
    kummittelemaan prosessiin)
   
   Vaikuttaa, että ohjelma antaa joskus tämän prosessin jälkeen JasperExceptionin.
   Tästä pääsee eroon kääntämällä ohjelman uudestaan (sanotaan "ant" WEB-INF/src-kansiossa)
   ja käynnistämällä tomcatin uudestaan.