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

Kõige lihtsam on Tomcat installeerida paketihalduriga

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

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.

Käsitsi installeerimine on sarnane järgmisega (installeerimisfaili asukoha saab vaadata Tomcati kodulehelt sektsioonist "Download"):

wget http://mirror.nexcess.net/apache/tomcat/tomcat-8/v8.0.0-RC5/bin/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

Edasi võib käivitamiseks juba kasutada skripti

/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