\section*{Järjestelmän asennusohje (EM)}

Tässä luvussa kuvataan järjestelmän asennus puhtaaseen koneeseen. Jos
koneessa on jo tarpeeksi tuoreet versiot tarvittavista
taustaohjelmista, voidaan siirtyä suoraan varsinaisen järjestelmän
asennukseen ja konfigurointiin.

\subsection*{Vaadittavat apuohjelmat}
Järjestelmä tarvitsee pohjakseen vähintään versiota 1.1
JSP-spesifikaatiosta tukevan servlet-ympäristön. Itse käytimme
Tomcatin versiota 4.0.3 ilman Apachea, jolle konfiguraatio-ohjeemmekin
kirjoitettu. Projektin kotisivuilta
\newline
(http://jakarta.apache.org/tomcat/index.html) ladattava binääriversio
toimii purkamisen jälkeen käytännössä suoraan.

RDF-metadatan käsittelyyn käytetään HP Labsin Jena-työkalupakettia,
jonka lataaaminen onnistuu osoitteesta http://www.hpl.hp.com/semweb/.

\subsection*{Järjestelmän tiedostot}
Järjestelmä koostuu varsinaisen ohjelmiston luokkakirjastosta w3m.jar,
konfiguraatiotiedostosta web.xml, käyttöliittymän jsp-,
html- ja kuvatiedostoista, sekä varsinaisesta rdf- ja kuvadatasta.

\subsection*{Asennus}
Asenna Tomcat omien ohjeidensa mukaan. 

\begin{itemize}
\item Muokkaa Tomcatin conf/server.xml -tiedostoa, lisää <Server> -tagin sisään
\begin{verbatim}
<!-- wwwmuseo Context -->
<Context path="/wwwmuseo" docBase="wwwmuseo" debug="0">
  <Logger className="org.apache.catalina.logger.FileLogger"
          prefix="localhost_wwwmuseo_log." suffix=".txt"
          timestamp="true"/>
</Context>
\end{verbatim}
\item luo webapps/wwwmuseo hakemisto.
\item luo webapps/wwwmuseo/WEB-INF hakemisto.
\item luo webapps/wwwmuseo/WEB-INF/lib hakemisto.
\item kopioi käyttöliittymän jsp-tiedostot webapps/wwwmuseo hakemistoon
\item kopioi järjestelmän konfiguraatiotiedosto web.xml
webapps/wwwmuseo/WEB-INF hakemistoon
\item kopioi käytettävät museon kuvat jonnekin www:ssä näkyvään
paikkaan (alihakemisto pictures/0 alkuperäisille kuville ja
alihakemisto pictures/1 thumbnaileille)
\item muokkaa lähdekoodista (W3m.java) url-parametri osoittamaan
kuvien sijaintipaikkaa webissä
\item kopioi järjestelmän RDF-tiedostot paikkaan, joka on ohjelmiston
ulottuvissa (webapps/wwwmuseo/WEB-INF/data on oletuspaikka, jota
käyttämällä koodia ei tarvitse muuttaa)
\item etsi koodista RDF-tiedostoihin viittaavat polut ja muuta ne
oikeiksi
\item jos olet muuttanut tiedostopolkuja koodissa, käännä uusi versio
w3m.jar-kirjastosta
\item kopioi w3m.jar hakemistoon webapps/wwwmuseo/WEB-INF/lib
\item käynnistä Tomcat sen omalla start-skriptillä
\item järjestelmän pitäisi olla toiminnassa osoitteessa 
\newline
http://tomcat-palvelimennimi:tomcatinportti/wwwmuseo/
\end{itemize}
