Tik-76.115 Vaatimusmäärittely

Synapsi: Automaattinen ohjelmiston etäpäivitys
NetSeal Technologies
Tietojenkäsittelyn ohjelmatyö Tik-76.115

Dokumentin muutoshistoria
Versio	Editoija	Päiväys	Kommentti
1.0	Marko Rantee	15.10.2000	1. Palautettava versio
2.0	Juho Anttila	6.11.2000	Versiohistoria lisätty
2.1	Marko Rantee	15.11.2000	Muutettu vaatimuksia
2.2	Cemo Timucin	11.12.2000	Lisätty vaatimuslista loppuun
3.0	Juho Anttila, Mika Mäntylä	11.12.2000	Katselmoitu ja hyväksytty
3.1	Cemo Timucin	1.3.2001	Lisätty vaatimuksia ja poistettu duplikaatteja
4.0	Juho Anttila, Mika Mäntylä	19.03.2000	Katselmoitu ja hyväksytty
5.0	Juho Anttila, Mika Mäntylä	23.04.2000	Tarkistettu ja hyväksytty lopulliseksi versioksi

Sisällysluettelo

1. Johdanto
2. Yleiskuvaus
3. Toiminnot
4. Ulkoiset liittymät
5. Muut ominaisuudet
6. Vaatimuslista

1. Johdanto

Ohjelmisto tehdään NetSeal Technologies:in RoamMate-ohjelmiston moduleiden etäpäivityksen mahdollistamiseksi. Tämä tarkoittaa sitä, että RoamMate-palvelin voi asiakkaan tullessa sen alueelle päivittää RoamMate:n moduleita esim. vaihtaa koneessa oleva NetSeal-ajuri uudempaan tms. Järjestelmän tavoitteena on saada kyseinen toimenpide periaatteessa automatisoitua mahdollisimman pitkälle.

2. Yleiskuvaus

Asiakkaan päässä käyttöliittymässä ei tarvitse olla paljoakaan toiminnallisuutta. Asiakkaassa pitää voida kytkeä etäpäivitys pois päältä, jos käyttäjä ei halua ohjelmistoa päivitettävän. Asiakkaan pitää myös kysyä käyttäjältä, haluaako hän päivittää ohjelmiston juuri sillä hetkellä, kun palvelin sitä yrittää. Tämä siksi, että asiakas joudutaan ainakin Windows-ympäristössä käynnistämään uudelleen ja sitä ei mielellään saisi tehdä kysymättä, koska käyttäjällä voi olla jotain kesken. Asiakkaan tulee myös pystyä lähettämään nykyinen ohjelmiston versionumero.

Palvelinpäässä onkin huomattavasti monimutkaisempi käyttöliittymä. Pitää pystyä määrittelemään asiakasryhmiä ja näitä vastaava ohjelmiston versio. Alaspäinpäivitys toimii samalla lailla kuin ylöspäinkin päivitys eli palvelimessa on määritelty versio, joka tietyllä asiakkaalla pitäisi olla.

3. Toiminnot

Palvelinpään toiminnot:

Uusien moduulien lataaminen järjestelmään. Tämän pääsee tekemään vain administrator-oikeuksilla.
Asiakasryhmien muodostus: voidaan määrittää, mitkä asiakkaat saavat mitkäkin päivitykset
Päivityspaketit ovat ajettavia setup tiedostoja, jotka purkavat itsensä. Päivityksen tulee olla atominen
Palvelin saa asiakkaalta tiedon ohjelmiston versiosta.
Rajapinta, jolla nähdään onko asiakas linjalla. Asiakkaat laitetaan jonoon, jos maksimimäärä päivityksiä on käynnissä.

Asiakaspään toiminnot:

Vipu jolla estetetään automaattiset ohjelmistopäivitykset.
Kysytään haluaako käyttäjä päivittää ohjelmiston.

4. Ulkoiset liittymät

Käyttöliitymästä ei tässä vaiheessa ole vielä tarkempaa kuvausta, mutta tavoite on luonnollisesti, että järjestelmää olisi helppo käyttää. Ohjelma käyttää normaalia IP-osoitteeseen perustuvaa liikennettä ja se tarkistaa, että RoamMate on käynnissä ja tekee päivitykset RoamMaten IPsec tunnelin läpi.

5. Muut ominaisuudet

Käytettävyys on tärkeässä osassa asiakkaan päässä, mutta koska se on yksinkertainen toiminnallisuudeltaan, niin siinä ei pitäisi olla vaikeuksia. Vaikka palvelimen pää onkin huomatttavasti monimutkaisempi, niin sitä käyttää kuitenkin asiansa osaava ammattilainen. Siitä huolimatta toteutuksessa pyritään toki helppokäyttöisyyteen.

Päivityksen täytyy olla atominen. Tämä siksi, että moduuleissa saattaa olla riippuvuuksia. Virhetilanteissa pitää saada, mikäli mahdollista tehtyä kaikki sitä ennen tehdyt tekemättömäksi. Eli Windows:in rekisteri pitää saattaa vanhaan tilaan ja tiedostot palauttaa aikaisempiin versioihin yms.

Turvallisuudesta ei tarvitse välittää paitsi uudelleenkäynnistyksen yhteydessä. Sitä ei saa tehdä, mikäli suoritetut operaatiot eivät ole aivan varmasti onnistuneet tai jos käyttäjä ei ole antanut suostumustaan uudelleenkäynnistämisen suorittamiseksi. Käyttäjä tosin suostuu siihen, kun hän suostuu päivityksen aloittamiseen. Tietenkään turhaa uudelleenkäynnistystä ei tule tehdä.

Tuote tulee asiakasyrityksen ohjelmiston osaksi, joten sitä tullaan päivittämään. Päivitys pitää onnistua siis helposti, joten dokumentaatio pitää tehdä yrityksenkin haluamilta osin hyvin. Projekti käsittää Windows NT 4.0 työaseman RoamMate ohjelmiston päivityksen, mutta jatkossa vastaava pitää todennäköisesti tehdä myös muillekin alustoille, joten projektissa pitää tehdä mahdollisimman paljon alustasta riippumatonta koodia.

6. Vaatimuslista

VaaatimusID	Vaatimuksen kohde	Vaatimuksen nimi	Vaatimuksen kuvaus
J-1	Koko ohjelmisto	Automaattinen etäpäivitys	Ohjelmiston avulla pitää pystyä päivittämään tarvittaessa NetSeal Technologies:in RoamMate-ohjelmiston moduuleita automaattisesti.
Y-2	Asiakas	Etäpäivityksen tila	Asiakkaassa pitää voida kytkeä etäpäivitys pois päältä, jos käyttäjä ei halua ohjelmistoa päivitettävän.
Y-3	Asiakas	Päivityshetki	Asiakkaan pitää kysyä käyttäjältä, haluaako hän päivittää ohjelmiston juuri sillä hetkellä, kun palvelin sitä yrittää.
Y-4	Asiakas	Nykyisen ohjelmistoversion lähettäminen	Asiakkaan pitää pystyä lähettämään nykyinen ohjelmiston versionumero.
Y-5	Palvelin	Asiakasryhmät	Pitää pystyä määrittelemään asiakasryhmiä ja näitä vastaava ohjelmiston versio.
Y-6	Palvelin	Päivitys vanhempaan versioon	Alaspäinpäivitys toimii samalla lailla kuin ylöspäinkin päivitys eli palvelimessa on määritelty versio, joka tietyllä asiakkaalla pitäisi olla.
T-7	Palvelin	Uusien moduulien lataaminen	Uusien moduulien lataaminen järjestelmään. Tämän pääsee tekemään vain administrator-oikeuksilla.
T-9	Palvelin	Päivityspaketit	Päivityspaketit ovat ajettavia setup tiedostoja, jotka purkavat itsensä. Päivityksen tulee olla atominen.
T-10	Palvelin	Versiotiedon vastaanotto	Palvelin saa asiakkaalta tiedon ohjelmiston versiosta.
T-11	Palvelin	Päivitysten status	Rajapinta, jolla nähdään onko asiakas linjalla. Asiakkaat laitetaan jonoon, jos maksimimäärä päivityksiä on käynnissä.
T-12	Asiakas	Etäpäivityksen tila	Vipu jolla estetetään automaattiset ohjelmistopäivitykset.
T-13	Asiakas	Päivityshetki	Kysytään haluaako käyttäjä päivittää ohjelmiston.
U-14	Koko ohjelmisto	Tietoliikenne	Ohjelma käyttää normaalia IP-osoitteeseen perustuvaa liikennettä ja tekee päivitykset RoamMaten IPsec tunnelin läpi.
M-15	Koko ohjelmisto	Uudelleenkäynnistys	Uudelleenkäynnistystä ei saa tehdä, mikäli suoritetut operaatiot eivät ole aivan varmasti onnistuneet tai jos käyttäjä ei ole antanut suostumustaan uudelleenkäynnistämisen suorittamiseksi.
U-16	Verkko	Tiedoston nimen välitys	Asennustiedoston nimi pitää välittyä Palvelimelta Asiakkaalle asennuksen yhteydessä.
U-17	Asiakas	Integrointi olemassaolevaan järjestelmään	Asiakasohjelmisto pitää integroida olemassaolevan asiakkaan ympäristöön asiakkaan ja ryhmän vaatimalla tavalla.
U-18	Palvelin	Integrointi olemassaolevaan järjestelmään	Palvelinohjelmisto pitää integroida olemassaolevan asiakkaan ympäristöön asiakkaan ja ryhmän vaatimalla tavalla.