Installare Tomcat su Ubuntu e Linux in generale

Tomcat è un servlet container o in parole semplici è un server su cui è possibile far girare Servlet e JSP che sono alcune delle tecnologie Java (J2EE) più utilizzate nella programmazione web. Alcune cose utili da sapere prima di procedere con l’installazione:

• Tomcat è free, open source ed è scritto in Java per cui è anche multipiattaforma
• Essendo scritto in Java dovete avere Java installato. Vedere qui per come fare
• tecnologie come EJB, JMS, ecc. richiedono per l’appunto un EJB container: vale a dire non potete far girare EJB su Tomcat.
• Tomcat può anche servire normali pagine statiche HTML ma a questo scopo e per usi professionali si tende ad utilizzare Apache. In ambito aziendale Tomcat trova spesso il suo impiego “dietro” un server Apache che si occupa di servire i contenuti statici e demanda a Tomcat il compito di servire pagine dinamiche.

Su Ubuntu Tomcat è disponibile nei repository ufficiali nella versione 5.5 ed è facilmente inspallabile attraverso Synaptic (System -> Administration -> Synaptic Manager) o se preferite da terminale:

sudo apt-get install tomcat5

Tuttavia la versione nel repository non è la più aggiornata. Sul sito è disponibile la versione 6 che al di là degli ovvi bug fixing supporta una versione più aggiornata della specifiche Servlet e JSP di Sun.

Brevemente:

• Tomcat 6.0.x supporta le specifice Servlet 2.5 e le specifiche JSP 2.1
• Tomcat 5.5.x supporta le specifice Servlet 2.4 e le specifiche JSP 2.0
• Tomcat 4.1.x supporta le specifice Servlet 2.3 e le specifiche JSP 1.2
• Tomcat 3.3.x supporta le specifice Servlet 2.2 e le specifiche JSP 1.1

Ne consegue che se volete installare la versione più aggiornata o una datata, dovrete installare Tomcat a mano (il che è veramente semplice)

La seguente procedura è testata su Tomcat 6.0.14 e Ubuntu 7.04 con java settato come in uno dei miei precedenti post ma sarei veramente sorpreso se non si adattasse alle altre principali distribuzioni Linux e alle altre versioni di Tomcat. Iniziamo con lo scaricare Tomcat da qua per la versione 6 oppure scegliete un’altra versione da qua. Selezionate il file tar.gz sotto “Core” sotto “Binary Distributions” a fate il download.
Scaricato il file spostatelo sotto /opt o in un’altra directory di vostra scelta e scompattatelo. Vi ritroverete con una directory dal probabile nome di apache-tomcat-6.0.14 e potete anche rimuovere il file .tar.gz. Di fatto l’installazione è terminata. Per usare il server appena installato vi potrebbero far comodo le seguenti basilari informazioni.

• Avvio e shutdown del server: potete avviare e stoppare tomcat attraverso due script che trovate nella directory bin. Da terminale eseguite:

  /opt/apache-tomcat-6.0.14/bin/startup.sh (per avviare il server)

  /opt/apache-tomcat-6.0.14/bin/shutdown.sh (per stoppare il server)

  Ora dipende dai vostri gusti ma se volete semplificarvi la vita ed evitare ogni volta di digitare tutta la stringa potete aggiungere al $PATH anche la directory di Tomcat (vedi env_vars nel post su Java) o creare un link e metterlo in una delle directory già nel $PATH (per vederlo: echo $PATH) o creare un launcher sulla barra delle applicazioni, ecc.

• Log del server: per qualsiasi problema il primo posto dove guardare è il log del sistema che si troverà in questo esempio in:

  /opt/apache-tomcat-6.0.14/logs/catalina.out

  Se è molto lungo potete utilizzare da terminale:

  tail -500 /opt/apache-tomcat-6.0.14/logs/catalina.out

  che stamperà a video solo le ultime 500 righe del file.

• Configurazione: non dovreste avere bisogno di cambiare niente dei settaggi di default, almeno per una configurazione standard. In ogni caso il comportamento del server è regolato attraverso una serie di file presenti sotto la cartella /opt/apache-tomcat-6.0.14/conf e principalmente il file server.xml dove tra le altre cose è definita la porta di default su cui il server si pone in ascolto (8080) e altre opzioni avanzate (cluster, connectors, ecc.)
• Amministrazione se il server è stato avviato senza intoppi (ed è stato installato in locale come si suppone in questo esempio) potete inserire in un browser in seguente indirizzo:

  http://127.0.0.1:8080/

  e vi apparirà la schermata di amministrazione del server. Le finzioni sotto administration richiedono il login quindi prima dovete creare uno user. Aprite il file/opt/apache-tomcat-6.0.14/conf/tomcat-users.xml e aggiungete le seguenti due righe:

  
<role rolename="manager"/>
<user username="manager" password="password" roles="manager"/>


  in modo che il file finale assomigli a qualcosa di questo tipo:

  
<?xml version='1.0' encoding='utf-8'?>
<tomcat-users>
.
.
<role rolename="manager"/>
<user username="manager" password="password" roles="manager"/>
</tomcat-users>


  Riavviate il server e ora dovreste essere capaci di accedere a “Tomcat Manager” con le credenziali appena create. Da questa sezione di amministrazione potrete poi controllare le java web applications attive sul sistema, deployarle, aggiungerne di nuove attraverso l’upload di un file .war e tante altre belle cose ancora.

• Monitoraggio: per monitorare il server potete sempre usare i seguenti due comandi da terminale:

  ps -ef | grep tomcat

  per controllare se Tomcat è tra i processi attivi sul vostro pc oppure:

  sudo nmap -sS 127.0.0.1

  per controllare le porte aperte sul vostro computer e il particolare quella su cui Tomcat è in ascolto. Tenete presente che nmap potrebbe non essere installato sul vostro sistema.
  Questi basilari comandi vi aiutano anche in un primo troubleshooting. Se per esempio il server non parte e controllando catalina log vedete qualcosa del tipo:

  
LifecycleException: service.getName(): "Catalina"; Protocol handler start failed: java.net.BindException: Address already in use:8080

  vuol dire che la porta 8080 è già occupata da un altro processo, forse una precedente istanza di tomcat che non è stata propriamente stoppata (ve lo potrebbe dire ps -ef) oppure c’è un qualche altro programma in ascolto su quella porta (ve lo potrebbe dire nmap).