Installasjon av Tomcat

Sist oppdatert: 14.12.2006.

Erstatter kapittel 21.2.

Du laster ned web-tjeneren gratis fra http://tomcat.apache.org/. Velg Apache Tomcat 6.x under Downloads. Velg nyeste versjon under Quick Navigation og last ned den utgaven som passer under overskriften "Core". Windowsbrukere klikker på den kjørbare filen Windows Service Installer. Du får spørsmål om administratorpassord underveis i installasjonen. Nå trenger neppe du dette i denne omgang, men du må svare på det. Pass også på at versjon 5.0 eller nyere av Java blir benyttet.

I fortsettelsen antar vi at du kjører under Windows og at web-tjeneren ligger på katalogen c:\tomcat. Du vil finne et lite ikon nederst i høyre hjørne på skjermen. Klikk på dette og se at du har valget mellom å starte og stoppe Tomcat. Dersom du ikke finner ikonet, velg Apache Tomcat 6.0 / Monitor Tomcat under Start/Alle programmer. Da skal web-tjeneren starte og ikonet komme til syne. La oss så prøve web-tjeneren:

1. Sørg for at web-tjeneren går ved å kontrollere at "Start service" er grået ut i Tomcat-ikonet nederst i høyre hjørne på skjermen.
2. Åpne siden http://localhost:8080/ i nettleseren. (Tomcat kjører på port 8080.) Dersom alt går som det skal, vil du her få opp en side med blant annet følgende melding: "If you're seeing this page via a web browser, it means you've setup Tomcat successfully. Congratulations!".
3. Stopp tjeneren ved å klikke på Tomcat-ikonet og velge Stop service.

Et tjenerprogram må vite hvor filene det skal bruke, ligger. For Tomcat gjelder følgende dersom du ikke gjør spesielle tilpasninger i konfigurasjonsfilene:

• Jsp-filer skal ligge i katalogen c:\tomcat\webapps\ROOT eller eventuelle underkataloger til denne katalogen. URL-en til en JSP kan for eksempel være http://localhost:8080/EksKap21/Tid.jsp.
• Java-filer som inneholder servleter (mer om servleter ganske snart), skal ligge i katalogen c:\tomcat\webapps\ROOT\WEB-INF\classes. I tillegg må servleten registreres i filen c:\tomcat\webapps\ROOT\WEB-INF\web.xml, eksempel:

<servlet><servlet-name>EnkelServlet</servlet-name>
<servlet-class>EnkelServlet</servlet-class></servlet>
<servlet-mapping><servlet-name>EnkelServlet</servlet-name>
<url-pattern>/EnkelServlet</url-pattern></servlet-mapping>

Dette legges inn etter linjen </description>. Her angir vi først navnet på servleten og deretter navnet på klassen. Så følger URL’en. Her har vi valgt navnet EnkelServlet på alt sammen.

• Java-filene som genereres automatisk ved oversetting av jsp-filene, blir lagt i katalogen c:\tomcat\work\Catalina\localhost\_\org\apache\jsp\. Eksempel: Dersom jsp-filen heter Tid.jsp, vil den genererte filen få navnet Tid_jsp.java.
• Vanlige Java-klasser som skal brukes i web-applikasjoner, må ligge i navngitte pakker som ligger på bestemte steder i katalogstrukturen til Tomcat. For enkelhets skyld benytter vi katalogen c:\tomcat\shared\classes. Pakker som ligger her vil være tilgjengelig for alle web-applikasjoner. (Web-tjeneren bruker ikke CLASSPATH slik den er satt opp i systeminnstillingene på maskinen.) For å kjøre det store databaseeksemplet i dette kapitlet trenger du pakken mittBibliotek.database. Det enkleste er å kopiere hele mittBibliotek-katalogen til c:\tomcat\shared\classes. Jar-filer, som f.eks. databasedriveren legger du i katalogen c:\tomcat\shared\lib.
• For at endringer i java-filer skal tre i kraft i en jsp-fil som bruker filene, kan det ofte være nødvendig å restarte web-tjeneren. (Husk å kompilere java-filene.)
• Det er ofte praktisk å skrive ut meldinger på tjenersiden. Dette gjør du med System.out.println() på vanlig måte, og utskriftene finner du i filen c:\tomcat\logs\stdout_ååååmmdd.log. Det er en ny stdout-fil pr. dag.
• Under utvikling kan det være praktisk at en kan få fram liste over filene i en katalog, dersom katalogen ikke inneholder index-fil. Dette får du til ved å gjøre følgende endring i filen c:\tomcat\conf\web.xml (linje 79-80 i min utgave av filen):
  Før endring:

<param-name>listings</param-name>
<param-value>false</param-value>

Etter endring:

<param-name>listings</param-name>
<param-value>true</param-value>

API-dokumentasjonen til servlet- og JSP-klassene er en del av dokumentasjonen til Java Enterprise Edition (Java EE), og du laster den ned fra http://java.sun.com/.