Kun korkeakoulu on esim. vaihtamassa opintotietojärjestelmäänsä josta Virta tiedonsiirrot muodostetaan on suositeltavaa että perustetaan
korkeakoululle testiorganisaatio Virtaan. Tällä testiorganisaatiolla voi huoletta testata, sen tiedot eivät kulje varsinaiseen Virta tietovarantoon.
Tiedonsiirrossa saa testattua että tiedonsiirto toimii, Virta XML-tiedostot ovat virheettömät, tietosisällön puutteet saa korjattua ennen tuotantoon siirtoa,
sama määrä tietoja jotka vanhasta saadaan myös uudesta jne.
Suositeltavaa että käytetään tuotantodataa (ei ainakaan käytetä "feikkihetuja" -9xxx tai A9xx päättyviä jotka eivät ole valideja). Testiorganisaatiot perustetaan tuotantojärjestelmään jolloin kaikki tiedot käyvät läpi
samat tarkistukset, tietoturva ja laadunvarmennukset ovat samat kuten tuotantoorganisaation tiedostot.
Korkeakoululta tarvittavat tiedot testiä varten
Kaksi asiaa tarvitaan organisaatioilta jotka haluavat testata Virta tiedonsiirtoa:
- IP osoite, palvelimen, koneen josta aineisto lähetetään palomuurin avausta varten
(ulospäin näkyvä IPv4-osoite) - SSH-avain, julkinen osa (public key) tunnistautumista varten
(RSA 2048 bit)
IP ja julkinen SSH-avaimen osa (public key) lähetetään sähköpostitse virta-admin(a)postit.csc.fi (mielellään tekstitiedostona liitetiedostona esim. testpubkey.pub)
Yksityinen SSH-avain tulee aina olla yksityinen, ei jaeta tai lähetetä muille. SSH-avaimen voi luoda itse esim näillä ohjeilla: SSH-avainparin luominen
Lähettävän koneen IP numero voi olla sama kuin nykyinen tuotannon, mutta SSH-avain tunnistautumisen on oltava eri.
Kun nämä tiedot on välitetty, palomuurin avaus tehty ja testikanta perustettu Virta-tiimi ilmoittaa testiorganisaation käyttäjätunnuksen jota tiedonsiirrossa käytetään.
Käyttäjätunnus on 8-merkkinen TEST-alkuinen. SFTP-yhteyttä testatessa tulee käyttää SFTP ohjelmaa, interaktivinen ssh-konsoli yhteys ei toimi.
Testiaineisto lähetetään SFTP-yhteydellä virtasftp.csc.fi palvelimelle samoin kuin tuotannon tiedonsiirrossa, eli SFTP-yhteydellä lähetetään ja voidaan hakea latauksen jälkeen muodostetut csv-tarkistustiedostot, CSVExport.zip.
Tiedonsiirron ajankohta voidaan sopia erikseen, mielellään ajoitus sellaiseen aikaan kun ei tuotannon ajoissa ole paljon yhtäaikaisia, tai joku iso korkeakoulu vuorossa.
Tiedonsiirron ajastukset tuotannossa: Ajastusten+tilanne
Tiedonsiirron jälkeen muodostuva Virta_latausraportti kertoo onnistuiko lataus, virheet, puutteet, lukumäärät Opiskelijat, opintosuorituksia, ilmoittautumisia ynm.
Testiorganisaation lataukset käy samat validoinnit ja virhetarkistukset läpi kuten tuotannon tiedonsiirrot.
Tiedonsiirron virheistä ei tule sähköpostia. Latausraportti Virtasftp hakemistossa kertoo tiedonsiirron onnistumisesta tai epäonnistumisesta.
Huom! Testi pysyy testinä, eli ei kuten uuden organisaation toteutusten kohdalla laiteta ns. tuotantovipua päälle testausten edetessä, tuotantoon tullessa.
Testi vaatii että on tuotantokelpoista dataa, esim. feikkihetut eivät kelpaa, tuotannon skeeman mukaista tulee olla.
Testi ja tuotanto eivät eroa toisistaan muuten kuin että testiin lähettävä aineisto ei menee yhteiseen Virta tietovarantoon tiedonkeruisiin, tilastoihin tai operatiiviseen Virran rajapinnan
sitä käyttävien asiakkaiden käyttöön. Kun testin avulla on saatu tuotannon datat kuntoon Virtaa varten on korkeakoulun omissa käsissä, yhdessä toimittajansa kanssa, milloin siirrytään lähettämään uudesta järjestelmästä tuotannon puolelle.
Kysymykset Virta tiedonsiirtoon liittyen tulee lähettää virta (a) csc.fi
Kun testiorganisaatiota ei enään tarvita toivotaan että asiasta ilmoitetaan Virta tiimille virta (a) csc.fi
Testiorganisation käyttäjätunnus ja IP-numero joka tulee poistaa.
Latausraportti ja csv-aineistojen ohjeet
Latausraportti: Virta_Latausraportti
CSV-aineistojen ohjeet: CSV-Aineistojen+ohje
XML-validoinnin ohjeistus
Tiedonsiirron määrityssivuilta, Tiedonsiirtomaaritykset+korkeakouluille#Tiedonsiirtomaarityksetkorkeakouluille-XML-tiedostontarkastaminenskeemaavasten
SSH avain
SSH-avaimen voi tehdä itse esim. Puttygen ohjelmalla