Almu
Ylläpitodokumentti

Versio 0.1

Projektiryhmä:

Peter Ahlberg

Marika Korhonen

Tomi Kuittinen

Jukka Narkiniemi

Iikka Meriläinen

27.04.2006

HELSINGIN YLIOPISTO

Tietojenkäsittelytieteen laitos

Versiohistoria

Päivämäärä	Versio	Muuttaja	Muutokset
27.04.2006	0.1	Peter Ahlberg	Luotu: dokumentin runko

Sisällys

1 Johdanto	4

1.1 Dokumentin tarkoitus	4

1.2 Dokumentin rakenne	4

2 Järjestelmän yleiskuvaus	4

2.1 Järjestelmän tarkoitus	4

2.1 Järjestelmän arkkitehtuuri	4

3 Parannusehdoituksia	5

3.1 Kielituki eri kielille	5

4 Virheet ja puutteet	5

5 Asennus	5

5.1 Asennusohje ajoa varten	5

5.2 Tietokantannan asennus	6

5.3 Tomcat palvelimen konfigurointi	6

5.4 Koodin asennus	6

6

1 Johdanto

Almu-projekti on suunnitellut ja toteuttanut Helsingin yliopiston kehittämisosastolle apurahojen hakemista ja hakemusten käsittelyä helpottavan ohjelmiston. Ohjelmisto tarjoaa hakijoille apuvälineen sähköisten hakemusten tallentamista ja allekirjoitusta varten sekä keinon toimittaa hakemuksiin liittyviä lisädokumentteja sähköisesti. Hakemusten käsittelijöille ohjelmisto tarjoaa apuvälineen hakemusten tietojen automaattiseen keräämiseen sekä keinon käydä läpi edellisten vuosien sähköisiä hakemuksia.

Ohjelmisto tarjoaa apurahojen hakijoille web-käyttöliittymän, jota kautta he voivat jättää hakemuksensa käsiteltäväksi sekä pystyvät seuraamaan oman hakemuksensa tilaa. Lisäksi tarjotaan web-käyttöliittymä apurahahakemusten käsittelijöille, jotka pääsevät Almu-järjestelmän kautta katselemaan sekä yksittäisiä hakemuksia että hakemuksista tehtyä yhteenvetoa. Yhteenvetoa on helppo käyttää päätöksenteossa apuna.

1.1 Dokumentin tarkoitus

Ylläpitodokumentin tarkoituksena on tarjota ohjelmiston ylläpitäjälle yleiskuvaus ohjelmistosta, sekä riittävät tiedot myöhempää kehittämistä varten. Tiukan aikataulun vuoksi projektiryhmä joutui jättämään ominaisuuksia kokonaan toteuttamatta, ja joihinkin toteutettuihin ominaisuuksiin jäi parantamisen varaa. Tämä dokumentti toimii ohjekirjana kehitystyöhön projektin jälkeen.

1.2 Dokumentin rakenne

Luvussa 2 kuvataan järjestelmän arkkitehtuuri yleisellä tasolla lähdekoodin ymmärtämisen helpottamiseksi. Luvussa 3 on lueteltu ohjelmistoon suunniteltujen, mutta totettamatta jätettyjen ominaisuuksien lisäksi sellaisia ominaisuuksia, joiden projektiryhmä katsoo parantaan ohjelmiston laatua. Ominaisuuksien yhteydessä on kuvattu lyhyesti, millaisia muutoksia lähdekoodiin kunkin ominaisuuden korjaaminen tai lisääminen ylläpitäjältä vaatii. Luvussa 4 on lueteltu virheet, joita ei ole projektin puitteissa saatu korjattua tai mitä jäi tekemättä. Luvussa 5 käsitellään asennukseen liittyvät asiat.

2 Järjestelmän yleiskuvaus

Jukka lisää tähän lukuun tarvittavat asiat, saat ne varmaan suoraan suunnitteludokkarista.

2.1 Järjestelmän tarkoitus

2.1 Järjestelmän arkkitehtuuri

2.1.1 Tietokanta

2.1.3 Käyttöliittymä

2.1.4 Java-moduuli

3 Parannusehdoituksia

Tässä luvussa esitellään toteuttamatta jääneitä alemman prioriteetin ideoita sekä parannusehdoituksia. Jokaisen parannusehdoituksen yhteydessä kuvataan lyhyesti, mitä muutoksia järjestelmään on tehtävä.

3.1 Kielituki eri kielille

Yleistä Ohjelmiston käyttöliittymäkieleksi on valittu suomi.

Parannusehdoitus Käyttöliittymästä tulee tehdä myös ruotsin- ja englanninkielisiä versioita, jotta ohjelma täyttää kieliasetukset. Kielitiedostojen avulla ohjelman käyttöliittymän voisi muuttaa helposti myös muille kielille.

Ohjelmisto ei tue tällä hetkellä kielitiedostojen käyttöä, vaan kaikki käyttöliittymätekstit on kova koodattu Java-tiedostoihin ja JSP-sivuille.

4 Virheet ja puutteet

5 Asennus

Luvussa käydään läpi kuinka ohjelmisto asennetaan ajoa sekä kehitystä varten.

Tämä lienee sopivan Iikalle ja Jukalle täydennettäväksi.

5.1 Asennusohje ajoa varten

Järjestelmän ajoa varten tarvitaan neljää eri palvelinta:

Tietokantapalvelin (Tyyppi)

Palvelin JSP-, Java Servlet- sekä Java-luokkia varten

LDAP-palvelin autentikointiin

DAWA-palvelin käyttäjä kohtaisiin tietojen hakemiseen

5.2 Tietokantannan asennus

5.3 Tomcat palvelimen konfigurointi

5.4 Koodin asennus

6 Almu – Ylläpitodokumentti

NJC1

Sasu Liuhanen

2006-04-19T11:42:00