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) - veebiaplikatsioon
• Konteiner (container) - veebiserver Tomcat ise

Ülesehitus

• $CATALINA_HOME - kataloog, kuhu on Tomcat paigutatud
• $CATALINA_BASE - parasjagu töösoleva Tomcati eksemplari kataloog; 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/ .

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