Java-servletti-moottorin minimaalinen käyttöohje
------------------------------------------------

Servletti-moottorin käynnistämiseen tarvittavat konfiguraatiotiedostot
ja skriptit on nyt asennettu db.cs.helsinki.fi-koneeseen
(alias alkokrunni) /home/local/sqltr/servlet-hakemistoon.

Eli servlettejä voi pyörittää vain db.cs.helsinki.fi-koneella, jossa
on kaikilla käyttäjillä paikalliset kotihakemistot. Oikeat 
kotihakemistot ja ryhmähakemistot näkyvät vain read-only tilassa.

Hakemistosta löytyvät seuraavat tiedostot:

- jserv.properties on servletti-moottorin konfigurointitiedosto
- sqltr.properties on sqltr-servletti-zonen konfigurointitiedosto
- repository-hakemisto sisältää sqltr-zone:n servletit. Sieltä
  löytyy valmiina "Hello World"-esimerkki servletti.
- jserv.log sisältää servletti-moottorin lokitiedon
  (jos jserv.properties tiedostossa log=true)
- secret.key sisältää salaisen avaimen jolla servletti-moottori varmistuu
  WWW-serverin identiteetistä (ja päinvastoin)
- start-jserv skriptillä käynnistetään servletti-moottori
- OHJE.txt, eli tämä teksti

Servletti-moottori käynnistetään näin:
luser@alkokrunni:/home/local/sqltr/servlet$ ./start-jserv

Servletti-moottori on ihan tavallinen Linux-prosessi, johon pätee
samat säännöt kuin muihinkin Linux-prosesseihin. Eli sen voi
tappaa ^C:llä tai lähettämällä sille signaalin kill:illä.
Sen konfiguraatiotiedostoja voit vapaasti muokata hyväksi katsomallasi
tavalla ja myös siirtää sen kokonaan jonnekin aivan muualle (esim. 
johonkin ryhmähakemistoon).

Kun servletti-moottori on käynnissä, voi selaimen osoittaa 
"Hello World"-servlettiin seuraavalla URL:illa:

http://db.cs.helsinki.fi/sqltr/Hello

Servletti-moottori osaa ladata muuttuneet servletti-luokat automaattisesti,
joten sitä ei tarvitse käynnistää jokaista servletti-luokkien muutosta
varten erikseen. Tämä ei välttämättä päde muihin JVM:n käyttämiin
luokkiin.

Muita kuin servletti-luokkia ei pitäisi laittaa repository hakemistoon:
servletti-moottori nimittäin olettaa, että kaikkia repositorysta löytyviä
luokkia voi käyttää servletteinä ja siten niitä voi (kuka tahansa) 
kutsua WWW-serverin kautta. Eli muut luokat pitäisi löytyä joko JVM:n
CLASSPATH:ista, tai servletti-moottorin konfiguraatiotiedostosta.

Jos kysyttävää ilmenee, niin kysymyksen voi osoittaa allekirjoittaneelle:

- Jani Jaakkola, jjaakkol@cs.helsinki.fi