Projekti harri - Oppimistavoitteiden hallintajärjestelmän asennusohje

			  kirjoittanut Lasse Leino

------------------------------------------------------------------------------
 Yleistä
------------------------------------------------------------------------------

 Tämä asennus kertoo miten saat Oppimistavoitteiden hallintajärjestelmän, eli
 harrin, toimimaan Helsingin yliopiston Tietojenkäsittelytieteen laitoksen 
 tietokantapalvelimella. Tietokanta ympäristöksi oletetaan Oracle 10.2.0 ja
 sovelluspalvelinalustaksi Apache Tomcat 4.1.18.

 Asennukseen tarvittava materiaali löytyy osoitteesta:
 http://cs.helsinki.fi/group/harri/final/

 Tästä eteenpäin sanalla "materiaali" viitataan juuri tähän materiaaliin.

------------------------------------------------------------------------------
 Tietokanta
------------------------------------------------------------------------------

 Oracle-tunnusten voit käydä luomassa tämän linkin kautta:
 https://ilmo.cs.helsinki.fi/ilmotest/servlet/Account2

 Tarvitset tunnuksen luontiin tunnukset Tietojenkäsittelytieteen laitoksen
 omaan tietojärjestelmään (cs-tunnus).

 Tunnusten luonnin jälkeen ota ssh-yhteys palvelimeen melkki.cs.helsinki.fi.
 Kopioi materiaalin hakemistosta "testitietokanta" löytyvät addAll.sql ja
 rmAll.sql tiedostot palvelimelle.

 Komenna setup oracle ja käynnistä sqlplus komennolla "sqlplus /nolog" 
 samasta hakemistosta mihin kopioit edellä mainitut tiedostot.

 Ota yhteys Oracle tietokantaasi komennolla:
 "connect OMATUNNUS/SALASANA@bodbacka/test", jossa OMATUNNUS on oma 
 cs-tunnuksesi ja SALASANA se salasana, jonka syötit Oracle tunnusten luonnin
 yhteydessä.

 Lisää testitietokanta tietokantaasi komentamalla "start addAll.sql".
 Vastaavasti voit poistaa kaikki tietokantataulut komentamalla "start 
 rmAll.sql".

 Testitietokanta on nyt pystytetty.

------------------------------------------------------------------------------
 harri
------------------------------------------------------------------------------

 Ota yhteys Tietojenkäsittelytieteen laitoksen tietokantapalvelimelle
 db.cs.helsinki.fi .

 Komenna "wanna-tomcat".

 Kopioi materiaalin juurihakemisto kaikkine tiedostoineen ja 
 alihakemistoineen hakemistoon ~/tomcat/webapps/ .

 Editoi tiedostoa ~/tomcat/webapps/harri/konfiguraatio.txt, joka sisältää
 seuraavat rivit:

 	dblogin = OMATUNNUS
 	dbpassword = SALASANA
 	admin = jbauer

 Korvaa OMATUNNUS omalla cs-tunnuksellasi ja SALASANA omalla Oracle-tunnuksen 
 salasanallasi. Muuttuja admin määrittelee järjestelmän järjestelmävastaavan,
 joka on testitietokannassa käyttäjä tunnuksella "jbauer". Oletusarvoa voi
 muuttaa koska tahansa.

 Komenna "setup-oracle", "setup tomcat" ja "start tomcat".

 Järjestelmä on nyt toiminta kunnossa ja on käytettävissä osoitteesta:
 http://db.cs.helsinki.fi/tomcat/OMATUNNUS/harri/ .

------------------------------------------------------------------------------
 Muuta
------------------------------------------------------------------------------

 Tietokannan pystytyksessä on mukailtu syksyn 2007 Tietokantasovelluksen 
 ohjeita, jotka löytyivät kirjoitushetkellä osoitteesta:
 http://www.cs.helsinki.fi/u/laine/tikas/material/tietokannat.html .

 Apache Tomcatin tapauksessa on tehty samoin. Ohje löytyy osoitteesta: 
 http://www.cs.helsinki.fi/u/laine/tikas/material/servlet_ohje.html .

 Ongelmatilanteissa suosittelen konsultoimaan näitä ohjeita.