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 konteksti konfiguratsioonimääratlus, mis pannakse kokku failidest $CATALINA_HOME/conf/[enginename]/[hostname]/context.xml ja $CATALINA_HOME/webapps/[webappname]/META-INF/context.xml, Tomcati-spetsiifiline XML-konfiguratsioonifail ühe konteksti kohta; fail $CATALINA_HOME/conf/[enginename]/[hostname]/context.xml aitab administraatoril konteksti info ära kirjeldada ja halduseks mõeldud automaatsetel tööriistadel (näiteks Tomcat Manager ja TCD) oma tööd teha; kontekstikirjeldus määrab näiteks nimed ressurssidele, sessioonihalduse konfiguratsiooni jms.; Tomcati 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 - konfiguratsioonifail, 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, mis on kasutatav eelnevalt kirjeldatud käsitsi installeerimise juhul:
/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.
Käsitsi juurutamine
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/ .
Kui masinapõhine ("Host") atribuut "autoDeploy" väärtus on "true", installeerib ja uuendab masin aplikatsioone dünaamiliselt töötamise ajal.
==
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.
