Tomcat

Autor: Kristjan Veskimäe D32

Sissejuhatus

Tomcat on vabalt kättesaadav server Java veebirakendustele. Põhimõtteliselt on tegemist Servlet/JSP spetsifikatsiooni toetava konteineriga.

Antud töö kirjeldab Tomcati 8. versiooni. Põhiosas on kõik samasugune võrreldes paari eelmise versiooniga. Suuremad erinevused on versioonispetsiifilistes probleemides ja nende lahendamises, mida käesolev töö ei vaatle.

Mõisted

• Kontekst (context) - Tomcati mõistes üks konkreetne veebiaplikatsioon
• Konteiner (container) - veebiserver Tomcat ise
• Kontekstikirjeldus (context descriptor) - Tomcati-spetsiifiline XML-konfiguratsioonifail ühe konteksti kohta, mis aitab administraatoril konteksti kohta infot määrata ja halduseks mõeldud automaatsetel tööriistadel (näiteks Tomcat Manager ja TCD) oma tööd teha; määrab näiteks nimed ressurssidele, sessioonihalduse konfiguratsiooni jms.; varasemates versioonides sisaldusid kontekstikirjeldused põhikonfiguratsioonifailis server.xml
• Dokumendipõhi (docBase) - veebiaplikatsioooni kontekstile vastav kataloog Tomcati "webapps" kataloogis, mis tekib veebiaplikatsiooni serverisse rakendamisel

Ülesehitus

• $CATALINA_HOME - baaskataloog, kuhu on Tomcat paigutatud
• $CATALINA_BASE - parasjagu töösoleva Tomcati eksemplari baaskataloog; ainult ühe masinas kasutusel oleva Tomcati eksemplari puhul on see sama, mis $CATALINA_HOME
• $CATALINA_BASE/bin - serveri käivitus- ja abiskriptid
• $CATALINA_BASE/bin/startup.sh - serveri käivitusskript
• $CATALINA_BASE/bin/shutdown.sh - serveri peatusskript
• $CATALINA_BASE/conf - konfiguratsioonifailid
• $CATALINA_BASE/conf/server.xml - konteineri peamine konfiguratsioonifail
• $CATALINA_BASE/conf/[enginename]/[hostname]/[webappname].xml - kontekstikirjelduse fail serveriadministraatorile ja automatiseeritud tööriistadele
• $CATALINA_BASE/logs - logifailid paigutatakse vaikimisi siia
• $CATALINA_BASE/webapps - kataloog, kuhu paigutatakse serverisse juurutatavad veebiaplikatsioonid
• $CATALINA_BASE/webapps/[webappname]/META-INF/context.xml - kontekstikirjeldust mõjutada võiv fail, mille veebirakenduse programmeerija on pakendanud oma aplikatsiooniga kaasa ning millega ta saab võimaluse kontekstikirjeldust omalt poolt mõjutada; kirjutatakse rakenduse uuestijuurutamisel üle
• $CATALINA_BASE/webapps/[webappname]/WEB-INF/web.xml - ka üks oluline Java veebiaplikatsiooni konfiguratsioonifail; enamasti muudab seda ainult programeerija; määrab muu hulgas millised aplikatsiooni osad vajavad autentimist või kui kiiresti veebisessioon aegub

Installeerimine

Installeerimine paketihalduriga

apt-cache search tomcat
apt-get install tomcat[version]-webapps
apt-get install tomcat[version]-admin
apt-get install tomcat[version]

Installeerimine käsitsi

Paketihalduriga installeerides ei pruugi viimane Tomcati versioon olla kättesaadav ja see pakub ka vähem võimalusi kataloogide määramiseks jms. Käsitsi installeerimiseks tuleb laadida Tomcat kodulehelt alla. Lahtipakkimisel tekib kataloog, milles sisalduv fail "RUNNING.txt" on kõige kindlam allikas installeerimisel tekkivate probleemide vältimiseks ning lahendamiseks.

Vajaliku versiooni installeerimisfaili asukoha saab vaadata Tomcati kodulehelt sektsioonist "Download". Järgnevalt installerime kõige uuema versiooni, mida näitab nimes sisalduv RC ehk "release candidate". Produktsioonikeskkonda tuleks valida stabiilse versiooni. Käsitsi installeerimine on sarnane järgmisega:

wget http://mirror.nexcess.net/apache/tomcat/tomcat-8/v8.0.0-RC5/bin/apache-tomcat-8.0.0-RC5.tar.gz
tar -zxvf apache-tomcat-8.0.0-RC5.tar.gz
sudo mv /Users/kristjanveskimae/downloads/apache-tomcat-8.0.0-RC5 /usr/local/apache-tomcat-8.0.0-RC5
sudo rm -f /Library/Tomcat 
sudo ln -s /usr/local/apache-tomcat-8.0.0-RC5/ /Library/Tomcat 
sudo chown -R kristjanveskimae /Library/Tomcat
sudo chmod +x /Library/Tomcat/bin/*.sh

Käivitamine ja aplikatsiooni juurutamine

Käivitamine

Peale installeerimist võib kasutada skripte kataloogist $CATALINA_BASE/bin . Järgneb üks võimalik käivitamise ja peatamise näide:

/Library/Tomcat/bin/startup.sh 

ja peatamiseks

/Library/Tomcat/bin/shutdown.sh 

Näiteaplikatsiooni juurutamine

Java veebiaplikatsiooni jagatakse hea tava kohaselt üheainsa veebiarhiivi failina, mille laienditüübiks on "war". Tegemist on tegelikult zip-protokolliga kokkupakitud kataloogiga, millel on Java veebirakenduste spetsifikatsioonile vastav ülesehitus.

Näiteaplikatsiooni juurutamiseks lae see alla ning kopeeri oma konteineri juurutamiskataloogi 'webapps':

wget http://tomcat.apache.org/tomcat-8.0-doc/appdev/sample/sample.war
cp /Users/kristjanveskimae/downloads/sample.war /Library/Tomcat/webapps/sample.war

Konteiner pakib arhiveeritud faili ise lahti kausta $CATALINA_BASE/webapps ning ka rakendab selle. Tekkiv aplikatsioon on lokaalsest masinast seejärel kättesaadav aadressil http://localhost:8080/sample/ .

Näiteaplikatsiooni mahajuurutamine

Veebirakenduse mahavõtmiseks tuleb kustutada talle vastav dokumendipõhja kataloog "webapps" kataloogist. Samuti tuleks kustutada .war-fail olemaks kindel, et Tomcat ei rakenda uuel käivitamisel veebiaplikatsiooni veebiarhiivifailist.

Konfigureerimine

Konfiguratsioonifailid loetakse sisse käivitamisel. Võimalusel tuleks muutuste rakendamiseks konteiner taaskäivitada.

Kasutatud materjalid

• http://tomcat.apache.org/tomcat-8.0-doc/index.html