Kuha ei ole enää käytössä. 25.9.2007

-------------------

Tämä on lyhyt asennusohje, jonka avulla
voidaan KuHa 4.x -asennusohjelman avulla asentaa
KuHan ajettava versio UNIX-ympäristöön.

Tarvitset UNIX-käyttäjätunnuksen koneelle, jolla on 
perl-tulkki ja www-serveri. KuHa toimii myös Linux-ympäristössä.

Hanki käsiisi kuha_rel2.xx -niminen tiedosto. Saat sen
helpoiten seuraamalla kuhan kotisivuilla http://www.cs.tut.fi/~kuha/
annettuja ohjeita. Kirjaimet xx korvataan siis viimeisimpään
julkaistuun versioon viittaavilla numeroilla (17.10.2002 se on 2.04).

1. Siirrä tämä asennusskripti haluamaasi UNIX-kotihakemistoon ja
varmista että sillä on ajo-oikeudet 
(esim. komennolla chmod u+x kuha_rel2.04 ).

2. Mieti paikka, jonne haluat sijoittaa KuHan ajettavat skriptit.
Esim lintulassa (cs.tut.fi-domain) hyvä sijoituspaikka on

/home/tunnuksesi/cgi-bin/ tai tämän alla hakemisto kuha.

Jos sinulla ei ole näitä hakemistoja olemassa, voit luoda ne komennoilla 

mkdir ~/cgi-bin   ja
mkdir ~/cgi-bin/kuha

3. Aja skripti: (komennolla ./kuha_rel2.xx tai komennolla 
perl kuha_rel2.xx). Skripti kyselee sinulta kysymyksiä, joihin pitäisi 
vastailla. 

Ensiksi udellaan perl-tulkin sijaintia. Kokeile ensin asennusohjelman
ehdotusta, jos se ei toimi kysy ylläpidoltasi tai tarkista, mitä
komento 'which perl' antaa vastaukseksi (esim. /usr/local/bin/perl )

"Hakemisto, jonka alle kuha asennetaan?" -kysymykseen olet jo
miettinyt kohdassa 2 valmiin vastauksen.(esim. /home/tunnuksesi/cgi-bin/kuha )

URL antamaasi hakemistoon esim. lintulassa kannattaa antaa muodossa

www.cs.tut.fi/cgi-bin/run/~käyttäjätunnus/kuha

(Lintulassa on olemassa cgi-wrapperi, joka mahdollistaa skriptin ajamisen
käyttäjän omilla oikeuksilla, ts. kaikki tiedostot voidaan suojata
ulkopuolisilta tämän ansiosta.)

4. Asennusohjelma antaa sinulle vielä polun, josta kuhan päävalikko 
löytyy (se esim. muotoa
https://www.cs.tut.fi/cgi-bin/run/~käyttäjätunnus/kuha/mainpage.pl   )

5. Tämän jälkeen voit kirjautua järjestelmään kuhan antamalla 
oletustunnuksella. Kirjautumisen jälkeen valitse linkki
'Kurssinhallinta (assarit)', josta pääset assistenttien
toimintoihin. Assistentti viittaa tässä käyttäjään, jolla on
kaikki oikeudet muokata KuHaa. 

6. Luo uusi tunnus menemällä toimintoon 
'Henkilökunnan tietojen hallinta'. KuHan luoma oletustunnus
kannattaa poistaa mahdollisimman pian (tämän kannattaa tehdä
kirjautumalla uudella, äsken luomallasi assistentti-tunnuksella
sisään ja poistamalla sitten 'Henkilökunnan tietojen hallinta'-
toiminnossa oletusassistentti.

7. Aseta kurssin perustiedot toiminnossa 'Konfiguraatiotiedot'.
Näitä tietoja voi muokata myös myöhemmin.

8. Haluat ehkä itsekin kurkata, miltä Kuha näyttää opiskelijan
silmin, se on (versio 2.04) ikävä kyllä mahdollista vain luomalla
'keinotekoinen' opiskelija, ts. ilmoittaudu kuhaan kuten normaali
opiskelija tekisi toiminnossa 'Ilmoittaudu kurssille'.

9. Olet valmis julkaisemaan linkin KuHaan esim. kurssisi
kotisivuilla.

PS: ennen julkaisua voit vielä ehkä haluat kirjata jotain
vastaanottoaikoja tai esim. viikkoharjoiutusten pitoajat,
paikat ja koot...


Kuhan 'ylimääräisissä' työkaluissa on myös mm. tunnustenluontiskripti, 
jonka voit ajaa UNIX-komentoriviltä, mutta se ei kuulu ainakaan 
rel2.04 -asennuspakettiin.

Eipä muuta!