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/logs - logifailid paigutatakse vaikimisi siia
- $CATALINA_BASE/webapps - kataloog serverisse juurutatavate veebiaplikatsioonide paigutamiseks
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.
