PRIMUS W4 - StarSoft Oy
PRIMUS W4 Käyttöönotto-opas 4.6.2014 StarSoft Oy www.starsoft.fi sähköposti: tuki@starsoft.fi puh. (06) 320 2500 fax. (06) 320 2599 PRIMUS W4 Sivu 1/36 4.6.2014 Primuksen käyttöönöttö-öpäs SISÄLLYS 1 Käyttöönotto ja ylläpito .................................................................................................. 5 1.1 Asennus .................................................................................................................. 5 1.1.1 Laitteistovaatimukset ........................................................................................ 5 1.1.2 Asennuksen vaiheet ......................................................................................... 6 1.1.3 Asennushakemistot .......................................................................................... 7 1.1.4 Useita Primuksia samalla palvelimella ............................................................. 9 1.1.5 Asennus palveluksi (prservice) ......................................................................... 9 1.1.6 Tiedostot ........................................................................................................ 10 1.1.7 Mahdolliset virhetilanteet ................................................................................ 13 1.2 Käynnistys ............................................................................................................ 14 1.2.1 Palvelinosan käynnistäminen ......................................................................... 14 1.2.2 Asiakasosan käynnistäminen ja ensimmäinen kirjautuminen ......................... 15 1.2.3 Pikakuvakkeet Primus-käyttäjille .................................................................... 16 1.2.4 Kirjautuminen ................................................................................................. 17 1.2.5 Kirjautumisen erikoistapauksia ....................................................................... 18 1.3 Päivitys ................................................................................................................. 20 1.3.1 Päivityksien lataaminen .................................................................................. 20 1.3.2 Päivityksen valmistelut ................................................................................... 20 1.3.3 Päivityspaketin sisältö ja asentaminen ........................................................... 21 1.3.4 Automaattipäivitys asiakasosalle.................................................................... 21 1.3.5 Päivitys hosting-palvelussa ............................................................................ 21 PRIMUS W4 Sivu 2/36 4.6.2014 1.3.6 Versionhallinta................................................................................................ 22 1.4 Varmuuskopiointi .................................................................................................. 22 1.4.1 Paikallinen varmuuskopio............................................................................... 23 1.4.2 Varmuuskopion palauttaminen ....................................................................... 24 1.4.3 Varmuuskopion lähetys sähköpostina ............................................................ 25 1.4.4 Aukoton varmuuskopiointi .............................................................................. 25 1.4.5 Automaattinen varmuuskopiointi .................................................................... 27 1.5 LDAP-tunnistus ..................................................................................................... 28 1.6 Primuksen käyttötuki............................................................................................. 30 1.6.1 Asiakastuki ..................................................................................................... 30 1.6.2 Tukiyhteys ...................................................................................................... 31 1.7 Käyttökatko ........................................................................................................... 33 2 Muut ohjelmat .............................................................................................................. 34 2.1 Kurre ..................................................................................................................... 34 2.2 Wilma.................................................................................................................... 34 2.3 PrimusQuery ......................................................................................................... 34 2.4 PrimusToAd .......................................................................................................... 35 3 Ohjelmakirjastot........................................................................................................... 36 PRIMUS W4 Sivu 3/36 4.6.2014 KÄYTTÄJÄLLE Käyttöoikeus StarSoft-ohjelmien kaikki tekijänoikeudet kuuluvat StarSoft Oy:lle, jolle kuuluu myös omistusoikeus alkuperäiseen ohjelmistotuotteeseen ja sen osiin sekä näistä otettuihin kopioihin. Käyttöoikeuden haltijalla ei ole oikeutta kopioida, lainata, myydä, eikä millään muullakaan tavalla luovuttaa ohjelmaa edelleen, ellei luovutuksesta ole etukäteen kirjallisesti sovittu StarSoft Oy:n kanssa. Ohjelman käyttö on sallittu vain toimitussopimuksessa ja ohjelmatuotteessa mainittuun tarkoitukseen. Käyttöoikeuden haltija sitoutuu huolehtimaan siitä, ettei kukaan muu kuin käyttökohteen oma henkilökunta pääse käsiksi ohjelmatuotteeseen. Ohjelman käyttäjän edellytetään noudattavan käyttöehtoja. Tarkempia tietoja saa toimitussopimuksesta. Primus W4 Primuksen dokumentaatioon kuuluu tämä ohjekirja ja StarSoftin kotisivujen materiaali. Ohjekirjassa on ohjeistettuna Primuksen käyttöönottoon ja ylläpitoon liittyvät toiminnot, jotka pysyvät samanlaisina versiosta toiseen. Ohjekirjaa ei päivitetä aina uuden ohjelmaversion ilmestyessä, vaan uudet toiminnot ohjeistetaan StarSoftin kotisivujen Ohjeita-osiossa. Otamme mielellämme vastaan sekä ohjelmaa että dokumentointia koskevaa palautetta. Ohjelma sisältää toimintoja, jotka muuttuvat lähes vuosittain, esimerkiksi tiedonsiirrot viranomaisjärjestelmiin. Toimintojen ohjeet päivitetään StarSoftin kotisivuille. Etusivulla on linkit uusiin ja päivitettyihin ohjeisiin. Käyttäjän tuki- ja ohjemateriaali kotisivuillamme on kattava, ja kehitämme sitä koko ajan. Etusivun Ajankohtaista-palstalla on kouluhallinnon vuodenkiertoa seuraava linkkilista, josta ohje kulloinkin ajankohtaiseen asiaan löytyy nopeasti. Ellet löydä tarvitsemaasi tietoa ohjekirjasta tai StarSoftin kotisivuilta, ota yhteyttä sähköpostitse osoitteeseen tuki@starsoft.fi tai kiireellisessä tapauksessa soita tukipalveluumme numeroon (06) 320 2500. Primuksen toimitussopimus sisältää puhelintuen ilman minuuttilaskutusta. Asiakastuki neuvoo kaikissa ohjelman käyttöön liittyvissä asioissa. Koska mo- PRIMUS W4 Sivu 4/36 4.6.2014 net asiat voidaan toteuttaa Primuksella useammalla tavalla, kannattaa paikalliset toimintatavat ja tehtävänjako varmistaa kunnan koulutoimistosta. StarSoft järjestää myös ohjelmien käyttökoulutusta. Alueelliset kurssit ovat kaikille avoimia ja niitä järjestetään ympäri Suomea. Koulutusta järjestetään myös tilauksesta. Tilauskoulutus on tarkoitettu erityisesti Primuksen ensi kertaa käyttöön ottaville oppilaitoksille ja kunnille. Kurssien päätteeksi on mahdollista antaa näyttö ohjelman hallinnasta ja suorittaa Primus-sertifikaatti. Lisätietoja kursseista löytyy StarSoftin kotisivuilta kurssikalenterista. Ohjekirjan versiopvm. 4.6.2014 PRIMUS W4 Sivu 5/36 4.6.2014 1 KÄYTTÖÖNOTTO JA YLLÄPITO 1.1 Asennus Tässä luvussa ohjeistetaan ohjelman asentaminen sekä ohjelma-asetusten muuttaminen. Ohjeet ovat luettavissa myös StarSoftin kotisivuilla (Ohjelmapäivitys & asennus / Primus W4 asennus). Primuksen asennusohjelmalla voidaan asentaa yhdelle koneelle samalla asennuksella palvelinosa, asiakasosa ja tietokanta, tai jokin näiden yhdistelmä. Kun halutaan käyttää Primusta, on verkossa oltava ainakin yhdellä tietokoneella asennettuna palvelinosa. Tarpeettoman verkkoliikenteen välttämiseksi tietokanta kannattaa asentaa samalle tietokoneelle kuin palvelinosa. Asennettaessa kaikki kolme osaa samalle tietokoneelle on Primus käytettävissä tältä koneelta suoraan. Palvelimen asennuksen yhteydessä tulee mukana aina uusin versio tietokannasta. Jos käytössä on jo ennestään vanha kanta, siihen päivitetään uudet kentät palvelimen käynnistyksen yhteydessä. Jos kantaa ei ole ennestään, Primuksen asennusohjelma asentaa tyhjän tietokannan, johon on määritelty oletusnäkymät. Primus Server -apuruudussa valitaan Primus-palvelimen asennuspaikka. Oletusarvona on C-asema. Sekä Primuksen palvelinosa että asiakasosa kannattaa asentaa verkon palvelimelle. Tällöin työasemille tehdään vain pikakuvakkeet, joilla asiakasosat käynnistetään. Näin päivitykset voidaan tehdä suoraan palvelimelle, kaikille käyttäjille kerralla. 1.1.1 Laitteistovaatimukset Ennen asennusta tarkista, että sekä asiakastietokoneet että palvelin täyttävät seuraavat vähimmäisvaatimukset: PRIMUS W4 Sivu 6/36 4.6.2014 Taulukko 1: Laitteistovaatimukset Käyttöjärjestelmä Primuksen palvelinosan Windows-version käyttöjärjestelmäksi käy Windows 2000 ja sitä uudemmat. Primuksen palvelinosan Linux-version käyttöjärjestelmäksi käy esim. Ubuntu tai muu yleisesti käytössä oleva Linux-jakelu. Primuksen asiakasosasta on vain Windows-versio, ja sen käyttöjärjestelmäksi käy Windows 2000 ja sitä uudemmat. Levytila Yksittäiselle Primukselle vähintään 1 Gt vapaata tilaa. Suuren kaupungin (yli 100 000 asukkaan) MultiPrimukselle 10–20 Gt vapaata tilaa. Käyttömuisti Primuksen ja Kurren palvelimelle väh. 2 Gt, suuressa kunnassa suositus 16–24 Gt. 1.1.2 Asennuksen vaiheet Ohjelma ladataan StarSoftin kotisivuilta Ohjelmapäivityspalvelusta. Asennusohjeet ovat tämän ohjekirjan lisäksi StarSoftin kotisivuilla Ohjelmapäivitys & asennus -sivulla. 1. Klikkaa sivun yläreunasta Primus W4 -linkkiä. Lataa ohjelma tietokoneellesi. 2. Avaa kansio, johon latasit ohjelman, ja tuplaklikkaa setup-tiedostoa. Ohjelman käynnistyessä aukeaa ikkuna (kuvassa 1). 3. Valitse asennettavat osat. Verkkoasennus rastitaan, jos haluat määritellä serverin IP-osoitteen ja portin itse. Ilman rastia Primuksen palvelinosa asennetaan Localhost-osoitteeseeen (IP 127.0.0.1) ja TCP/IP-portiksi tulee 1222. Jätä Verkkoasennus rastimatta vain, jos asennat Primuksen paikalliseksi. 4. Jos valitsit palvelinosan asentamisen, asetetaan seuraavaksi palvelinosan asetukset. Tarkasta ja tarvittaessa korjaa asetukset. Asetukset on kuvattu tarkemmin taulukossa 1.2. PRIMUS W4 Sivu 7/36 4.6.2014 5. Jos valitsit asiakasosan asentamisen, asetetaan seuraavaksi asiakasosan asetukset. Tarkasta ja tarvittaessa korjaa asetukset. Asetukset on kuvattu tarkemmin taulukossa 1.3. 6. Asentamisen jälkeen näytetään ilmoitus, jossa asennusohjelma kertoo asennuksen päättyneen. Primuksen asennus on nyt valmis. 7. Jos haluat jo tässä vaiheessa tehdä ensimmäisen kirjautumisen ja siihen liittyvät toimenpiteet, siirry lukuun 1.2. Tässä ohjekirjassa ohjeistetaan ennen sitä vielä asennukseen liittyvät asiat sekä ohjelman ja palvelimen asetukset tarkemmin. Kuva 1: Asennusohjelmassa asennettavien osien valinta 1.1.3 Asennushakemistot Primuksen asennusohjelman oletusarvot sopivat täysin normaaliin käyttöön. Suosittelemme arvojen muuttamista vain, mikäli jokin syy sitä vaatii. Muista neuvotella oppilaitoksen Primus-pääkäyttäjän kanssa mahdollisista muutoksista, jotta myös hän tietää niistä. PRIMUS W4 Sivu 8/36 4.6.2014 Taulukko 2: Palvelinasetukset Asetus Selite Asennushakemisto Hakemisto, johon palvelimen ohjelmat asennetaan Data-hakemisto Hakemisto, johon Primuksen tietokanta asennetaan Temp-hakemisto Hakemisto, johon Primus voi tehdä väliaikaistiedostoja Backup-hakemisto Hakemisto, johon Primus tallettaa varmuuskopiot Portti Palvelimen TCP/IP-portti Käyttäjätunnuksella, jonka omistuksessa Primus-palvelinta ajetaan, on oltava kirjoitusoikeus tietokanta-, varmuuskopio- ja väliaikaishakemistoihin. Myös Primuksen asiakasosan voi asentaa verkkopalvelimelle siten, että asennushakemisto on jaettuna verkon asiakkaille. Asiakasosan käyttäjät eli verkkoasiakkaat eivät tarvitse kirjoitusoikeutta hakemistoon, johon Primus asiakasosa on asennettu. Primus asiakasosan voi tarvittaessa asentaa myös paikallisesti jokaiselle tietokoneelle, jolta sitä käytetään. Asiakasosan hakemistosta tai pikakuvakkeen työkansiosta tulee aina löytyä asetustiedosto prclient.ini, jossa määritellään, palvelinosan sijainti sekä kirjautumiseen ja käyttökieleen liittyvät asiat. Taulukko 3: Asiakasosan asetukset Asetus Selite Asennushakemisto Hakemisto, johon Primus-asiakasosan tiedostot kopioidaan Palvelimen IP-osoite Primus-palvelimen IP-osoite, esimerkiksi 192.168.0.1 Palvelimen portti Primus-palvelimen TCP/IP-porttinumero, jota käytettiin palvelinta asennettaessa Käyttökieli Primus-asiakasosan käyttökieli PRIMUS W4 Sivu 9/36 4.6.2014 1.1.4 Useita Primuksia samalla palvelimella Primus on monen käyttäjän ohjelma, jossa yhtäaikaisten käyttäjien määrää rajoittavat vain palvelinkoneen resurssit. Samaan tietokoneeseen voi asentaa useita Primus-palvelinosia. Jokaisella rinnakkaisella palvelinosalla on oltava oma asennushakemisto ja oma yksilöllinen TCP/IP-porttinumero, joka asetetaan prserver.ini-tiedostoon. Asiakasosan prclient.initiedostoon on muistettava korjata vastaava palvelimen TCP/IP-porttinumero. Kun samaan koneeseen asennetaan useita Primus-palvelinosia, on tarkoin huolehdittava siitä, että asiakasosan tiedostopolut ovat oikein. Kaikkien saman oppilaitoksen käyttäjien on käytettävä samaa Primus-palvelinta ja samaa tietokantaa. Kaikissa asennusongelmissa voit ottaa yhteyttä tukipalveluumme. Kuvaile ongelma mahdollisimman tarkasti ja mainitse viestissä nimesi, oppilaitoksesi, käyttöjärjestelmäversiot, Primuksen versionumero, mahdolliset virheilmoitukset ja niiden koodinumerot. 1.1.5 Asennus palveluksi (prservice) Primuksen voi asentaa myös siten, että se toimii palveluna Windows-käyttöjärjestelmissä. Käytännössä se tarkoittaa, että Primus käynnistyy automaattisesti serveriosan käynnistyessä. Primuksen asentaminen palveluna tarkoittaa, että asennuksessa käytetään ohjelman serveriosana prservice.exe-tiedostoa tavanomaisen prserver.exe-tiedoston sijaan. Primuksen päivitys kotisivujemme Ohjelmapäivityspalvelusta tuo molemmat tiedostot samaan hakemistoon ilman käyttäjän toimenpiteitä. Asennus: 1. Avaa Komentokehote. Kirjoita Primuksen asennuskansion polku ja prservice /install, eli esimerkiksi C:\Primus\prservice /install ja suorita kehote. 2. Avaa Windowsin Palvelut, etsi luettelosta “StarSoft Primus server” ja käynnistä se. Palvelun poistaminen: 1. Pysäytä Palveluista “StarSoft Primus server” 2. Avaa Komentokehote. Kirjoita Primuksen asennuskansion polku ja prservice /uninstall, eli esimerkiksi C:\Primus\prservice /uninstall ja suorita kehote. PRIMUS W4 Sivu 10/36 4.6.2014 Primuksen päivittäminen: 1. Pysäytä palvelu yllä olevien ohjeiden mukaan. 2. Asenna Primuksen päivitys. 3. Asenna palvelu yllä olevien ohjeiden mukaan. Useamman palvelun ajaminen samalla palvelimella: Jos samalla koneella ajetaan useampaa Primuksen serveriosaa, tulee jokaisella palvelulla olla eri nimi. Palvelun nimi määritellään prserver.ini-tiedostossa: [Service] ServiceName=Haluttu palvelun nimi. Kun Primus on asennettu toimimaan palveluna, odottaa se käynnistyessään ensin, että verkkotoiminnot ja levyjaot ovat toiminnassa. Tällöin varmuuskopiohakemisto voi sijaita verkkolevyllä. Apua asennukseen voit kysyä oppilaitoksesi tai kuntasi atk-tuesta sekä StarSoftin tukipalvelusta. 1.1.6 Tiedostot Primuksen asennuksessa tulevat mukana seuraavat tiedostot: Palvelinosa: prserver.exe (ohjelma), prservice.exe (ohjelma, jonka avulla Primuksen voi asentaa palveluksi Windows-käyttöjärjestelmissä) prserver.ini (asetustiedosto), prserver.lic (lisenssitiedosto), prserver.loc (kielitiedosto), prserver.hlp (ohjetiedosto) Asiakasosa: prclient.exe (ohjelmatiedosto), prclient.ini (asetustiedosto) , prclient.hlp (ohjetiedosto) Tietokanta: *.prd (tietokantatiedostot) Mikäli myöhemmin haluat muuttaa ohjelmien asetuksia, ei ohjelmia tarvitse asentaa uudelleen. Asetukset tallennetaan ohjelmakohtaisiin tiedostoihin, joiden loppupäätteet ovat *.ini. PRIMUS W4 Sivu 11/36 4.6.2014 Niitä voi muokata millä tahansa puhdasta ascii-tekstiä tuottavalla editorilla, esim. Muistiolla. Taulukoista 1.4 ja 1.4 selviää ini-tiedostojen esimerkkisisällöt. Palvelinosan asetukset (prserver.ini) Dirs-osiossa määritellään palvelimen tarvitsemien hakemistojen tietoja. DataDir määrittelee hakemiston, josta palvelin etsii tietokantaa. TempDir määrittelee hakemiston, jota Primus palvelin käyttää väliaikaistiedostojen tallennukseen. BackupDir määrittelee hakemiston, johon varmuuskopiot tallentuvat. Liitetiedostoja varten määritellään DocsDir. Tähän hakemistoon Primus tallentaa kopion käyttäjän valitsemasta dokumentista. Jokaisen henkilön (rekisterikortin) jokainen dokumentti tallentuu erillisenä tiedostona. Tiedoston nimi on muotoa opphenk_850_hops.doc, jossa “opphenk” tarkoittaa opiskelijarekisteriä, “850” henkilön rekisterikorttinumeroa ja “hops.doc” alkuperäisen dokumentin nimeä. Socket-osiossa määritellään Primuksen palvelinosan ip-osoite ja portti. Primuksen asia- kasosien (clientien) tulee saada yhteys tähän osoitteeseen ja porttiin. IpAllow-kohtaan luetellaan ne IP-osoitteet, joista saa ottaa yhteyden Primuksen palvelimeen. Osoitteet erotetaan toisistaan pilkulla ja tähteä voi käyttää jokerimerkkinä. IpDeny-määritys puolestaan sisältää ne osoitteet, joista asiointi Primuksen serverille nimenomaan kielletään. Yhtä hyvin voi käyttää pelkästään IpDeny-määritystä, jolloin kaikki muut osoitteet ovat sallittuja. Primus tarkistaa tilanteen seuraavasti: Onko IP-osoite IpAllow-määrityksessä? Jos on, asiointi sallitaan. Onko IP-osoite IpDeny-määrityksessä? Jos on, asiointi kielletään. Jos IpAllow-määritys on olemassa, mutta IpDeny on tyhjä, sallitaan asiointi vain IpAllow-määrityksessä mainituista osoitteista. Language-osiossa valitaan palvelinosan kieli. LangID:n arvoksi annetaan joko 1 (suomi), 2 (ruotsi) tai 3 (englanti). Asiakasosille on omat kielimäärityksensä, jotka annetaan asiakasosien ini-tiedostoissa. Settings-osio Varmuuskopioinnin asetukset annetaan Settings-osiossa, ks. tarkemmin luku 1.4.5. Jos palvelinosaa joudutaan käynnistämään ja sammuttamaan useita kertoja esim. testauksen takia, voi Settings-osioon määritellä testauksen ajaksi Nocheck, joka nopeuttaa palvelinosan uudelleenkäynnistystä. Nocheck=1 jättää kannan ja suoritukset tarkistamatta, Nocheck=2 tarkistaa kannan mutta ei suorituksia. PRIMUS W4 Sivu 12/36 4.6.2014 Log-osion lisäämällä voi kerätä lokitiedostoa mm. sisäänkirjautumisista. LogFilen arvoksi annetaan syntyvälle lokitiedostolle haluttu nimi, esim. Primus.log. Lokitiedosto syntyy palvelinosan asennushakemistoon. Windowsin maa-asetuksilla ei ole merkitystä Primuksen toiminnalle. Taulukko 4: Palvelinosan ja asiakasosan asetustiedostot, prserver.ini ja prclient.ini Palvelinosan asetukset Asiakasosan asetukset Osio Osio Määritys Arvo esim. [Socket] Määritys Arvo esim. [Socket] Bind= 192.168.0.1 Host= 192.168.0.1 Port= 1222 Port= 1222 IpAllow= 192.168.0.1,10.0.0.* Enable= False IpDeny= 10.0.0.5 KurreHost= 192.0.0.1 KurrePort= 2000 KurreEnable= False LangId= 1 [Language] LangId= 1 [Dirs] [Language] DataDir= C:\Primus\data TempDir= C:\Primus\temp BackupDir= C:\Primus\backup ReadOnlyTimeOut= 1000 DocsDir= C:\Primus\docs Font= Arial FontSize= 10 School= ask Webpage1= (nimi,osoite / esi- [Settings] [Log] LogFile= tiedosto.log [Login] [Info] merkiksi:) Primusohje, www.kunta.fi/pr_ohje Asiakasosan asetukset (prclient.ini) Asiakasohjelman asetustiedoston esimerkki on esitetty taulukossa 1.4. Socket-osiossa on määritelty käytettävän Primuksen palvelinosan IP-osoite ja TCP/IP- porttinumero. Enable=False estää käyttäjiä vaihtamasta näitä tietoja sisäänkirjautumisruudussa. KurreHost, KurrePort ja KurreEnable ovat vastaavat tiedot Kurrelle. Primuksen PRIMUS W4 Sivu 13/36 4.6.2014 asiakasosan tulee saada yhteys sekä Primuksen palvelinosaan että Kurren palvelinosaan (jos koulu käyttää Kurrea). Language-osiossa määritellään asiakasosan käyttämä kieli. Käytettävien kielten koodeista 1 on suomi, 2 on ruotsi ja 3 on englanti. Settings-osiossa määritellään salaus, rekisterikorttien vapautuminen lukutilaan sekä fonttikoko ja -tyyppi. Login-osiossa valitaan, mihin kouluun käyttäjä pystyy kirjautumaan. “Ask”-arvolla käyttä- jä näkee valikon, josta hän voi itse valita koulun, arvo “8” taas tarkoittaa, että käyttäjä kirjautuu siihen kouluun, jonka rekisterikortin numero Koulun tiedot -rekisterissä on 8. Info-osiossa voi lisätä rekisteri-ikkunaan linkkejä esim. Wilmaan tai StarSoftin tuloste- pankkiin. Nimeksi annetaan käyttäjälle näkyvän linkin teksti ja osoitteeksi sivun osoite. 1.1.7 Mahdolliset virhetilanteet Tiedostoa ei voi avata/kirjoittaa: Käyttäjätunnuksella on oltava kirjoitusoikeus hakemis- toon, johon haluat ohjelman asentaa. Primus-palvelimeen ei saada yhteyttä: Mahdollisesti IP tai portti ei ole oikea tai palvelin ei ole käynnissä. Division by zero: Tarkista, että tietokannan polku on oikein ja täydellinen palvelimen asetustiedostossa, eli sisältää C:\polku- tai \polku-muotoisen hakemistopolun. Virheilmoitukset Primuksessa on erillinen Virheilmoitukset-rekisteri auttamassa tietojärjestelmän ylläpitäjän työtä. Virheilmoitukset-rekisteri löytyy päävalikon Ylläpidon rekisterit -osiosta. Rekisteriin tallentuu Primuksen palvelinosan saamat virheilmoitukset sekä muuta ongelmatilantee- PRIMUS W4 Sivu 14/36 4.6.2014 seen liittyvää tietoa. Virheilmoitukseen johtaneista ongelmatilanteista Primuksen käytössä tulee tähän rekisteriin uusi kortti. 1.2 Käynnistys Primukseen voi kirjautua, kun ohjelma on asennettu ja palvelinosa on käynnissä. Kun Primusta otetaan ensimmäistä kertaa käyttöön, kannattaa palvelinosana käynnistää prserver.exe. Näin näet heti käynnistysruudusta mahdolliset virheilmoitukset ja sen, onko ohjelma varmasti jo käynnissä. Kun ohjelmaan on päästy kirjautumaan kerran ja tiedetään, että kaikki on kunnossa, voit jatkossa käynnistää palvelinosan palveluna käyttämällä prservice.exe-tiedostoa. 1.2.1 Palvelinosan käynnistäminen Palvelinosa käynnistetään tuplaklikkaamalla prserver.exe-kuvaketta. Avautuu pieni apuruutu, joka on tyhjä, kunnes asiakasosa on käynnistetty. Silloin “Käyttäjiä: 0” muuttuu ykköseksi ja ruutuun tulee sisäänkirjoittautuneen käyttäjätunnus ja työaseman IP-numero. Muuta palvelinosalle ei tarvitse tehdä. Jos palvelinohjelmaa ei ole käynnistetty, sisäänkirjoittautuminen pysähtyy ilmoitukseen Serveriin ei saatu yhteyttä. Tarkista, että palvelinohjelma on käynnissä. Jos palvelinohjelma on käynnissä, mutta virheilmoitus tulee silti, tarkista prserver.ini-tiedostosta, missä IP-osoitteessa ja portissa palvelinosa on käynnissä. Tarkista sitten prclient.ini-tiedostosta, että asiakasosa ottaa varmasti yhteyttä samaan osoitteeseen ja porttiin. PRIMUS W4 Sivu 15/36 4.6.2014 Kuva 2: Palvelinosan ja asiakasosan käynnistysikkunat 1.2.2 Asiakasosan käynnistäminen ja ensimmäinen kirjautuminen Kun palvelinosa on käynnissä, voidaan käynnistää asiakasosa klikkaamalla prclient.exekuvaketta. Kirjautumisruutuun annetaan tunnus (root) ja salasana (root). Root-tunnukset on tarkoitettu ainoastaan ohjelman ylläpitäjän käyttöön ja ensimmäiseen kirjautumiseen. Root-tunnukset ovat ohjelman yleiset asennustunnukset, joten kuka tahansa saattaa tietää kyseiset tunnukset. Ohjelman käyttöä ei pidä jatkaa root-tunnuksilla. Uusi pääkäyttäjätunnus root-tunnuksien tilalle 1. Kun olet ensimmäisen kerran kirjautunut sisään root-tunnuksilla, tee itsellesi uusi pääkäyttäjätunnus. Avaa Primuksen päävalikon Ylläpidon rekisterit -osiossa oleva Käyttäjätunnukset-rekisteri. Valitse ylävalikosta Toiminnot / Uusi rekisterikortti. Täytä tarvittavat tiedot (ainakin käyttäjätunnus, salasana ja käyttäjän nimi). Tunnuksen ryhmä -kenttään on valittava Täydet oikeudet. Tiedot täytettyäsi valitse ylävalikosta Toiminnot / Tallenna rekisterikortti. Sulje rekisteri. 2. Sulje Primus ja kirjaudu uudelleen ohjelmaan luomallasi uudella tunnuksella. Jos pääset kirjautumaan sisään, uusi tunnus toimii niin kuin pitääkin. Varmista myös, että tunnuksella todella on kaikki oikeudet. 3. Avaa jälleen Käyttäjätunnukset-rekisteri. Poista rekisteristä root-kortti valitsemalla oikeasta reunasta root-kortti aktiiviseksi ja valitsemalla ylävalikosta Toiminnot / Poista rekisterikortti. Ei siis riitä, että olet tehnyt uuden pääkäyttäjätunnuksen, vaan vanha root-tunnus on poistettava. Jos asennustunnusta ei poisteta, se jää voimaan ja kuka tahansa pääsee edelleen root-tunnuksella Primukseen täysin oikeuksin. PRIMUS W4 Sivu 16/36 4.6.2014 Jos olet sisäänkirjautuneena asennustunnuksella (root) ja poistat kyseisen tunnuksen kortin, ohjelma ei enää avaudu. Tällöin ota yhteyttä StarSoftin tukipalveluun. Varmuuskopion palauttaminen aiemmasta hallinto-ohjelmasta Jos ohjelmatoimituksen mukana tuli oppilaitoksen aiemmasta hallinto-ohjelmasta konvertoitu tietokanta, se luetaan tässä vaiheessa Primukseen. Tämä tehdään Varmuuskopiointirekisterissä. Rekisterin valikosta valitaan Lisätoiminnot / Lue paikallinen varmuuskopio ja valitaan StarSoftin toimittama tgz-päätteinen tiedosto. Tiedoston nimi ilmestyy ikkunan oikeaan reunaan. 1. Valitse korttilistasta tiedosto ja klikkaa Palauta varmuuskopio -painiketta. Näytölle tulee ilmoitus “Palvelimella tehtiin varmuuskopion palautus”. Klikkaa OK, jolloin Primuksen asiakasosa sulkeutuu. 2. Käynnistä Primus uudelleen. Kirjaudu StarSoftin ilmoittamalla tunnuksella. Selaa esim. Opiskelijat-rekisterin tai Kurssit-rekisterin tietoja: Primuksessa pitäisi nyt näkyä aiemmasta hallinto-ohjelmasta siirretyt tiedot. Käyttäjätunnukset muille käyttäjille Jos tietojen syöttäminen aloitetaan tyhjästä ilman aiempaa tietokantaa, voi nyt luoda tunnukset myös muille Primus-käyttäjille Käyttäjätunnukset-rekisterissä. Tunnus voi olla mikä tahansa, mutta käytännössä henkilön nimeen perustuva tunnus on paras. Salasanat voi syöttää käsin tai generoida (tarkempi ohje sisällön generoinnista löytyy StarSoftin kotisivuilta). 1.2.3 Pikakuvakkeet Primus-käyttäjille Primuksen asiakasosa asennetaan yleensä palvelimelle, ja Primuksen käyttäjille tehdään vain asiakasosan pikakuvakkeet työpöydälle. Jos kunta/oppilaitos ei käytä Kurrea, käytetään asiakasosana prclient.exeä. Tee tästä ohjelmasta pikakuvakkeet käyttäjille. Jos kunta/oppilaitos käyttää Kurrea, käytetään asiakasosana primuskurre.exeä, joka löytyy oletuksena Kurren asennushakemistosta. Tee tästä ohjelmasta pikakuvakkeet käyttäjille. PRIMUS W4 Sivu 17/36 4.6.2014 Kummankin asiakasosan asetukset ovat prclient.ini-asetustiedostossa. Tässä tiedostossa määritellään, missä osoitteessa sijaitsevaan Primukseen asiakasosa ottaa yhteyttä, sekä muut kirjautumiseen liittyvät asiat. Tämä tiedosto tulee aina löytyä asiakasosan hakemistosta tai pikakuvakkeen työkansiosta riippumatta siitä, kumpaa asiakasosaa käytetään ja minne se on asennettu. Etenkin MultiPrimus-kunnissa voi olla käytössä useampia asiakasosia, esim. kouluvirastolle prclient.exe ja kouluille primuskurre.exe. Jos nämä on asennettu samaan hakemistoon, voi niillä olla yhteinen ini-tiedosto. Jos asiakasosia on eri hakemistoissa tai pikakuvakkeilla on eri työhakemistot, on initiedostojakin oltava useampia. Esim. kaksikielisessä MultiPrimuksessa suomen- ja ruotsinkieliset koulut voivat käyttää samaa yhteistä asiakasosaa, mutta siitä tehdään kaksi erillistä pikakuvaketta. Kummankin työhakemistoon tehdään muuten identtiset ini-tiedostot, mutta toisessa käyttökieleksi valitaan suomi, toisessa ruotsi. Samalla tavalla voi tehdä muita käyttäjä- tai koulukohtaisia asetuksia, esim. jos osa käyttäjistä haluaa ohjelmaan suuremman fonttikoon tai haluaa kirjautua suoraan tiettyyn kouluun ilman koulun valintaa valikosta. 1.2.4 Kirjautuminen Kun käyttäjä on avannut ohjelman joko prclient.exe-kuvakkeesta tai primuskurre.exekuvakkeesta, avautuu kirjautumisruutu. Sen yläpalkissa on ohjelman nimi ja versionumero. Sinipohjaisissa kentissä näkyy palvelinosan IP-osoite ja porttinumero. Näitä käyttäjän ei tarvitse muuttaa, tiedot on laitettu asennusvaiheessa valmiiksi oikein. PRIMUS W4 Sivu 18/36 4.6.2014 Kuva 3: Kirjautuminen Jos ruudulla näkyy Koulu-valikko, valitaan siitä se koulu, johon halutaan kirjautua. Pääkäyttäjä voi jättää kouluvalinnan tyhjäksi, jolloin hän näkee kerralla kaikkien koulujen asiat (vaatii MultiPrimuksen). Seuraavaksi annetaan ruudun kenttiin käyttäjätunnus ja salasana. Nämä saa ohjelman pääkäyttäjältä tai oman oppilaitoksen Primus-tunnusten luonnista vastaavalta henkilöltä. Jos Koulu-kohtaan valittiin jotain, tulee tunnuksen kuulua juuri tähän kouluun. Käyttäjätunnus näkyy kentässä selkokielellä, mutta salasana tulostuu ***-merkkeinä. 1.2.5 Kirjautumisen erikoistapauksia Kirjautuminen hostausympäristössä StarSoft tarjoaa hosting-palvelua, jossa Primuksen palvelinosa on asennettu StarSoftin palvelimille. Kun vanha asiakas siirtyy hosting-palveluun, kirjautuu hän edelleen samalla tunnuksella ja salasanalla kuin aiemmin, mutta kirjautumisruudulla näkyvä IP-osoite ja portti muuttuvat. StarSoft ilmoittaa uudet osoitteet ja portit asiakkaalle. Kaikkiin Primuksen asiakasosan ini-tiedostoihin vaihdetaan tämä uusi osoite. Tämä on erittäin tärkeää, jotta kaikki käyttäjät siirtyvät varmasti käyttämään uutta, StarSoftin ylläpitämää Primusta, eikä kirjauksia tehdä kahteen eri paikkaan. Vanha, asiakkaan itse ylläpitämä Primus-palvelin kannattaakin sammuttaa heti, kun siirtyminen hosting-ympäristöön on tehty. PRIMUS W4 Sivu 19/36 4.6.2014 Kirjautuminen multiyhdistämisen jälkeen Yksittäisen Primusten yhdistäminen MultiPrimukseksi tehdään siten, että yksittäisten Primus-käyttäjien tunnukset ja salasanat pysyvät samoina. Tunnuksille lisätään koulutieto, jolloin yhdistetyssäkin kannassa jokainen näkee vain oman koulunsa asiat. Multiyhdistämisessä Primus-palvelimen osoite ja portti saattaa muuttua. Kaikkiin Primuksen asiakasosan ini-tiedostoihin päivitetään uusi osoite ja portti. Tämä on erittäin tärkeää, jotta kaikki käyttäjät siirtyvät varmasti käyttämään uutta, yhdistettyä kantaa, eikä kirjauksia tehdä edelleen myös koulun vanhaan, omaan Primukseen. Vanhat koulukohtaiset palvelinosat kannattaakin sammuttaa heti, kun yhdistetty kanta otetaan tuotantokäyttöön. Kirjautuminen Kurren hankinnan jälkeen Kun Kurre otetaan käyttöön, vaihdetaan Primus-käyttäjien asiakasosaksi primuskurre.exe. Aiemmin käytössä olleen prclient.exe-ohjelman pikakuvakkeet voi poistaa. Nekin Primuskäyttäjät, jotka käyttävät ainoastaan Primusta ja eivät koskaan Kurrea, voivat silti käyttää primuskurre.exe-asiakasosaa, sillä Kurren toiminnot näkyvät vain niille kouluille, joilla on Kurren lisenssi ja vain niille käyttäjille, joille annetaan Kurreen liittyviä oikeuksia. Päivityksen kannalta on helpompaa, jos käytössä on vain yksi, kaikille yhteinen asiakasosa. Halutessa voi kuitenkin osalle käyttäjistä, esim. kouluviraston henkilökunnalle, jättää käyttöön prclient.exe-asiakasosan. Kirjautuminen paikalliseen kantaan, esim. koulutus- tai testiympäristöön Paikallinen asennus tarkoittaa, että Primuksen palvelinosa ja asiakasosa on asennettu palvelimen sijaan jollekin yksittäiselle työasemalle, esim. kannettavalle “koulutuskoneelle”. Tällöin Primus-käyttäjän tulee käynnistää myös palvelinosa itse ja vasta sen jälkeen asiakasosa. Palvelinosa käynnistetään prserver.exe-kuvakkeesta. Kun palvelinosa on käynnissä, käynnistetään asiakasosa ja kirjaudutaan normaalisti. Kirjautumistunnukset tällaiseen koulutuskantaan saa henkilöltä, joka ko. kannan on tehnyt. Tunnukset voivat olla samat kuin tuotantokannassa tai täysin erilaiset. Jos koulutuskanta on tuotantokannan kopio, tulee tunnuksien käytössä ja tietoturva-asioissa noudattaa samoja periaatteita ja samaa huolellisuutta kuin varsinaisessa Primus-käytössä. PRIMUS W4 Sivu 20/36 4.6.2014 1.3 Päivitys Kun ohjelmasta julkaistaan uusi versio, lähetetään asiasta sähköpostitiedote kunnan/oppilaitoksen nimeämille henkilöille. Tiedotteessa kerrotaan versionumero, uudet ominaisuudet ja virhekorjaukset sekä mitä koulutasoa päivitys erityisesti koskee. Primukseen tehdyt muutokset dokumentoidaan StarSoftin Ohjelmapäivitys & asennus -sivuilla kohdassa Ohjelmien uudet ominaisuudet. 1.3.1 Päivityksien lataaminen Uusi ohjelmaversio ladataan StarSoftin kotisivuilla olevasta Ohjelmapäivityspalvelusta. Tunnukset palveluun on toimitettu oppilaitokselle ohjelmatoimituksen yhteydessä. Jos tunnukset ovat unohtuneet, ota yhteyttä StarSoftin tukipalveluun, jolloin tunnukset lähetetään sähköpostitse oppilaitoksen/kunnan nimeämille henkilöille. Kirjauduttuasi sisään näkyy sivun ylälaidassa oppilaitoksen hankkimat ohjelmat. Primus W4 -linkkiä klikkaamalla pääset osioon, josta voit ladata Primuksen Windows-version (sis. palvelinosan ja asiakasosan) Primuksen Linux-version (sis. vain palvelinosan). Tallenna haluamasi tiedosto koneellesi. Kaikki StarSoftin ohjelmat päivitetään yleensä samalla kerralla, joten lataa seuraavaksi myös Kurre ja Wilma, jos ne ovat koulussanne/kunnassanne käytössä. 1.3.2 Päivityksen valmistelut Primus sammutetaan päivityksen ajaksi, joten tiedota muille käyttäjille etukäteen käyttökatkosta. Primuksen päävalikon Muut toiminnot -osiossa on käyttäjäluettelo, josta voit tarkistaa sisäänkirjautuneet käyttäjät ja milloin he ovat viimeksi tehneet Primuksella muutoksia. Esimerkiksi root [ip] 0:18 kertoo, että root-tunnus on kirjautuneena ohjelmaan ja on tehnyt jotain muutoksia viimeksi 18 minuuttia sitten. PRIMUS W4 Sivu 21/36 4.6.2014 1.3.3 Päivityspaketin sisältö ja asentaminen Primus päivitetään asentamalla se uudelleen edellisen asennuksen päälle. Päivitys tehdään samojen ohjeiden mukaan kuin uuden ohjelman asentaminen (ks. luku 1.1.3). Muista tarkistaa asennuspolut, niiden on oltava samat kuin mihin Primus alun perin asennettiin. Asennus Kurren kanssa Jos käytössä on myös Kurre, asennetaan Primuksen asennuspaketista pelkkä palvelinosa eli prserver.exe tai prservice.exe. Primuksella ja Kurrella on yhteinen asiakasosa, ja se sisältyy Kurren asennuspakettiin. Kurrea käyttävissä kunnissa asennetaan/päivitetään siis: Primuksen palvelin (Primuksen asennuspaketista) Kurren palvelin (Kurren asennuspaketista) PrimusKurre-asiakasosa (Kurren asennuspaketista). Kurrea käyttävissä kunnissa/oppilaitoksissa käyttäjille EI pidä asentaa/päivittää Primuksen asennuspaketin sisältämää prclient.exeä, sillä se sisältää ainoastaan Primuksen toiminnot. 1.3.4 Automaattipäivitys asiakasosalle Primuksen asiakasosalle on automaattinen päivitys. Kun asiakasosa käynnistetään, se tarkistaa, onko sen versio sama kuin palvelinosalla. Jos asiakasosa on vanhempi kuin palvelinosa, kysytään käyttäjältä, päivitetäänkö asiakasosa. Päivityskysymys tulee vain, jos käyttäjällä on kirjoitusoikeus siihen hakemistoon, johon asiakasosa on asennettu - käytännössä siis palvelinasennuksissa pääkäyttäjältä ja työasema-asennuksissa käyttäjältä. Automaattipäivitys koskee sekä prclient.exeä että primuskurre.exeä. Päivitystä varten ei tarvitse avata erillisiä portteja tai tehdä muutoksia palomuuriin. 1.3.5 Päivitys hosting-palvelussa Jos kunnalla/oppilaitoksella on käytössä hosting-palvelu, hoitaa StarSoft ohjelmien palvelinosien päivitykset. Päivitysajankohta sovitaan kunkin asiakkaan kanssa erikseen. Ota PRIMUS W4 Sivu 22/36 4.6.2014 yhteys StarSoftin asiakastukeen sopiaksesi päivityshetken. Asiakkaat hoitavat kuitenkin itse asiakasosien päivityksen. 1.3.6 Versionhallinta Primuksen ohjelmaversion numero näkyy heti kirjautumisen jälkeen ohjelman päävalikossa. Tarkemmat versiotiedot näet valitsemalla Muut toiminnot -kohdasta Versiotiedot. Ruudussa kerrotaan versionumeron lisäksi sen julkaisupäivämäärä. Primus-clientilla ja Primusserverillä tulisi olla aina sama versionumero. Kun Primuksesta julkaistaan uusi versio, ohjelman versionumeron desimaaliosaa kasvatetaan yhdellä, esim. W4.45 -> W4.46. Jos julkaistusta versioista löytyy virheitä tai ohjelmaan tulee pieniä päivityksiä, saa versio saman numeron ja sen perään kirjaimen, esim. W4.46b. Seuraava vastaavanlainen versiopäivitys on W4.46c jne. Lisäksi Primuksesta on saatavilla kehitysversioita (devel-versiot) testikäyttöön ennen virallisia versiojulkaisuja. Lisätietoa kehitysversioista saat StarSoftin tukipalvelusta. 1.4 Varmuuskopiointi Säännöllinen varmuuskopiointi on tärkeä osa tietoturvaa. Varmuuskopiointi on rekisteri, joka käynnistetään päävalikon kohdasta Ylläpidon rekisterit. Aikaisemmin tehdyt kopiot näkyvät ikkunan oikean reunan rekisterikorttilistassa. Aloita varmuuskopiointi klikkaamalla Ota varmuuskopio -painiketta, jolloin avautuu Anna varmuuskopion kuvaus -apuruutu, johon voit kirjoittaa kuvauksen, esim. ”Viimeinen kopio ennen hiihtolomaa.” Kuvaksen täyttäminen ei ole välttämätöntä, sillä sen tarkoitus on vain olla muistin tukena. Klikkaa OK, jolloin kopio muodostetaan palvelimen kovalevylle. PRIMUS W4 Sivu 23/36 4.6.2014 Kuva 4: Varmuuskopiot listattuna päivämäärän ja kellonajan mukaan Näin tehty varmuuskopio on pakkaamaton, ja Primus nimeää sen automaattisesti muotoon prdata1.tar (juokseva numerointi) ja tunnistaa sen myös päivämäärä- ja aikatiedon perusteella. Kopio tallennetaan prserver.ini-tiedostossa määriteltyyn hakemistoon. Jos varmuuskopio halutaan toiseen paikkaan tai käyttäjä haluaa jatkaa työskentelyä kannan kanssa kotona omalla kannettavallaan, käytetään alla ohjeistettua Kopioi paikalliseksi tiedostoksi -toimintoa. Huom! MultiPrimus-käytössä varmuuskopioon tulee mukaan kaikkien samaan multiPrimukseen kuuluvien koulujen tiedot. Siksi oikeus kopion ottamiseen ja etenkin sen palauttamiseen annetaan vain multiPrimuksen pääkäyttäjälle. 1.4.1 Paikallinen varmuuskopio Paikallinen varmuuskopio tehdään palvelimella olevasta kopiosta. Ennen paikallisen varmuuskopion tekemistä kannattaa siis tehdä palvelimelle uusi varmuuskopio. Valitse pääikkunasta haluttu kopio aktiiviseksi ja klikkaa sitten Kopioi paikalliseksi tiedostoksi painiketta. Valitse tallennuspaikka ja tallenna tiedosto. Tallennuspaikka voi olla mikä tahansa kansio omassa työasemassa tai verkossa oleva tallennusväline, johon sinulla on oikeus. Paikallisen varmuuskopion tiedosto on pakattu, ja ohjelma ehdottaa tallennuksessa prdata.tgz-muotoista nimeä. Nimen ja myös tarkenteen voi muuttaa, mutta sitä ei kannata teh- PRIMUS W4 Sivu 24/36 4.6.2014 dä ilman erityistä syytä. Jos tallennuspaikassa on jo ennestään samanniminen tgztiedosto, Primus ilmoittaa asiasta ja kysyy, korvataanko vanha uudella. Nimen voi tarvittaessa tässä vaiheessa muuttaa. Varmuuskopiointi tallentaa kaikkien rekisterien tiedot, tulostearkiston sekä rekisteriin tehdyt muutokset. 1.4.2 Varmuuskopion palauttaminen Huom! Ohjelmapäivityksen jälkeen EI palauteta varmuuskopiota. Uusi ohjelmaversio sisältää yleensä myös uusia kenttiä, ja jos päivityksen jälkeen palautetaan vanha varmuuskopio, eivät uudet kentät tule Primukseen. Ohjelmapäivitys ei muuta itse tietokantaa eli Primukseen kirjattuja tietoja, ainoastaan ohjelman toimintoja ja kenttiä. Ennen päivitystä voi ottaa varmuuskopion, mutta se palautetaan vain, jos tietokannassa ilmenee jotain ongelmia päivityksen jälkeen. Jos ongelmia ilmenee, ota ennen palautusta yhteys StarSoftin asiakastukeen. Varmuuskopio palautetaan valitsemalla hiirellä ikkunan oikean laidan listasta se kopio, jonka tiedot halutaan palauttaa. Ennen kuin jatkat, tarkista palautettavan kopion tunnistetiedoista, että kyseessä on varmasti oikea kopio. Ylärivin kentissä on kopioinnin päivämäärä ja kellonaika sekä käyttäjätunnus, jolla kopio on tehty. Alarivin ensimmäisessä kentässä on kuvausteksti ja toisessa kentässä kopiotiedoston nimi. Klikkaa Palauta varmuuskopio -painiketta. Saat viestin “Palvelimella tehtiin varmuuskopion palautus.” Kun klikkaat OK-painiketta, Primuksen asiakasosa sulkeutuu, sillä palautustoiminto kirjoittaa palautettavat tiedot avoinna olevan päälle. Käynnistä Primus uudelleen ja jatka työskentelyä palautetun varmuuskopion tiedoilla. Jos palautettava varmuuskopio ei näy oikean laidan varmuuskopiolistassa, se on todennäköisesti tallennettu jonnekin muualle kuin muut varmuuskopiot eli paikalliseksi varmuuskopioksi. Tällaisia ovat esim. StarSoftin uusille asiakkaille tai multiPrimukseen siirtyneille toimittamat Primus-kannat. Tarkista siis ensin, mihin tallensit varmuuskopion. Paikallisen varmuuskopion palauttaminen aloitetaan valitsemalla Lisätoiminnot-valikosta Lue paikallinen varmuuskopio. Primus ilmoittaa, että paikallinen varmuuskopio luettiin palvelimelle, minkä jälkeen ko. varmuuskopio näkyy myös vasemman laidan varmuuskopiolistassa. PRIMUS W4 Sivu 25/36 4.6.2014 Tarkista vielä, että kopion päivämäärä ja kuvaus vastaavat sitä kopiota, jonka haluat palauttaa. Klikkaa sitten Palauta varmuuskopio -painiketta ja jatka kuten edellä on neuvottu. Luettelojärjestys -painikkeella voit valita varmuuskopiosta näytettävät tiedot kuten muissakin rekistereissä. Tarkempi ohjeistus luettelojärjestyksen käytöstä löytyy StarSoftin kotisivuilta. 1.4.3 Varmuuskopion lähetys sähköpostina Valitse oikean reunan listasta varmuuskopio, jonka haluat lähettää, ja sitten Lisätoiminnotvalikosta Lähetä varmuuskopio sähköpostina. Näytölle avautuu apuruutu, jossa annetaan lähettäjän ja vastaanottajan sähköpostiosoitteet ja otsikko. Lisäksi tekstialueelle voi kirjoittaa asiaan liittyvän viestin. Vastaanottaja saa sähköpostin tiedostoliitteenä pakatun tietokannan. Ennen kuin Primuksesta voi lähettää varmuuskopion sähköpostina, on päivitettävä tiedot kolmeen kenttään (ota tarvittaessa kentät käyttöön Kenttäeditorilla). Käyttäjätunnuksetrekisterissä on täytettävä lähettäjän oman kortin Sähköpostiosoite-kenttä. Koulun tiedot rekisterissä on täytettävä kentät SMTP server ja SMTP port. (Kenttäeditorin Muut kentät haarasta löytyvään) SMTP server -kenttään kirjoitetaan sen palvelinkoneen IP-osoite (IPnumero riittää), joka toimii internetyhteytesi postipalvelimena. SMTP port -kenttään kirjoitetaan 25, ellei postia paikallisesti ole jostakin syystä ohjattu johonkin toiseen porttiin. Internetissä postinvälittäjänä toimiva Simple Mail Transfer Protocol -ohjelma käyttää oletusarvoisesti porttia numero 25. Toiminnon käyttäminen edellyttää siis, että Primuksen SMTP-asetukset ovat kunnossa. Voit lähettää paikallisen varmuuskopion myös tavalliseen tapaan sähköpostin liitetiedostona sillä sähköpostiohjelmalla, jota tavallisestikin käytät. 1.4.4 Aukoton varmuuskopiointi Seuraavaa käytännön koulutyössä kehitettyä menetelmää seuraamalla tiedot pysyvät varmasti tallessa. PRIMUS W4 Sivu 26/36 4.6.2014 1. Tehdään päivittäin varmuuskopio toiseen koneeseen (kovalevylle) niin, että joka viikonpäivästä on oma kopio. 2. Kerran viikossa tiettynä päivänä kopio tallennetaan siirrettävälle välineelle (vaihdettava kovalevy tai nauhavarmistin). Kuukaudessa tulee neljä kopiota, jotka käytetään seuraavassa kuussa uudestaan. 3. Joka kuukauden viimeinen kopio jätetään talteen. Vuodessa kertyy 10–12 kopiota, jotka käytetään seuraavana vuonna uudestaan. 4. Joka syyskuun ja tammikuun viimeinen päivä otetaan yhdet ylimääräiset kopiot, joita ei käytetä uudestaan vaan arkistoidaan turvalliseen paikkaan. Näin kahdella arkistoitavalla kopiolla per vuosi päästään siihen, että jokaisen opiskelijan koko opintohistoria on varmuuskopioilla. Kirjoittavan CD-aseman tai muistitikun avulla tällainen arkisto saadaan helposti talteen. Kuukausikopiot ja mielellään myös viikkokopiot säilytetään palo- ja varkaussuojatussa tilassa, joka on fyysisesti eri paikka kuin se, jossa lähiverkon palvelin sijaitsee. Primuksen palvelinosasta on mahdollista tehdä myös ajettava lukuversio CD-levylle. Tämä on hyödyllinen ominaisuus, jos halutaan ottaa jostain tilanteesta varmuuskopio ja tarkastella sitä myöhemmin (esim. varmuuskopio tilastointipäivältä tai lukuvuoden lopussa oleva tilanne). Varmuuskopion voi helposti arkistoida kopioimalla se CD:lle. CD:n saat tehtyä seuraavasti: 1. Tee ensin uusi hakemisto koneen kovalevylle, esim “primus-cd”. 2. Asenna Primuksen server ja client tekemääsi hakemistoon paikallisesti (ei verkkoasennusta). 3. Palauta haluamasi varmuuskopio ja varmista sen jälkeen, että Primus toimii myös tekemästäsi hakemistosta, ohjelmaan pääsee kirjautumaan ja tietoja pääsee selailemaan. 4. Lisää ini-tiedostoihin alla olevat määritykset. Lisää prserver.ini-tiedostoon: [Dirs] DataDir=data TempDir=temp BackupDir=backup DocsDir=docs PRIMUS W4 Sivu 27/36 4.6.2014 [Socket] Port=1222 [Language] LangId=1 [Settings] ReadOnly=1 NoCache=1 NoCheck=1 Autosave=7000 Autosavetime=9999 Lisää prclient.ini-tiedostoon: [Language] LangId=1 [Socket] Host=127.0.0.1 Port=1222 Tallenna sitten koko hakemisto CD:lle ja varmista, että Primus toimii myös CD:ltä käytettynä. 1.4.5 Automaattinen varmuuskopiointi Primuksessa on taustalla toimiva automaattinen varmuuskopiointi. Primus autosave toiminto tarkistaa joka päivä klo 12.00, onko viikon sisällä otettu varmuuskopio. Jos ei ole, tietokannasta tehdään automaattisesti kopio palvelimen kovalevylle, jolle tiedot muutenkin tallennetaan. Autosave-toiminto voidaan ohjata tekemään varmuuskopio toiseen tallennuspaikkaan. Se määrätään prserver.ini-tiedostossa. Siellä on normaalisti rivi BackupDir=backup. Asetus siis viittaa Primuksen ohjelmakansiossa sijaitsevaan kansioon nimeltä backup. Kirjoita sen PRIMUS W4 Sivu 28/36 4.6.2014 tilalle polku siihen tallennuspaikkaan, jonne haluat automaattisten varmuuskopioiden syntyvän, ja tallenna prserver.ini-tiedosto. Myös Autosave-toiminnon numeroarvo tarkoittaa vuorokausia, joten oletusarvona oleva Autosave=7 ottaa varmuuskopion kerran viikossa. Varmuuskopion ottamisen voi määrätä esim. näin: Autosave=1 (jos edellisenä päivänä ei ole otettu varmuuskopiota) Autosave=0 (jos tänään ei vielä ole otettu varmuuskopiota) Autosave=-1 (joka päivä) Autosave=999999 (ei oteta koskaan) AutosaveTime määrää ajankohdan, jolloin Primus tarkistaa tilanteen ja ottaa kopion, jos ehto täyttyy. Oletusarvo on AutosaveTime=1200, joka on siis klo 12.00. Jos keskipäivä on työrutiinien kannalta huono ajankohta, asetuksen voi muuttaa. Jos varmuuskopiota ei haluta otettavaksi koskaan, voi kellonajaksi merkitä esim. 2500 tai muun mahdottoman ajan. Autosavemax määrää automaattisten varmuuskopioiden maksimimäärän. Oletusarvona on 30, mutta esim. komennolla Autosavemax=10 voi rajoittaa varmuuskopioiden määräksi 10. Tämä määritellään myös Settings-osiossa. Windowsin maa-asetuksilla ei ole merkitystä Primuksen toiminnalle. 1.5 LDAP-tunnistus Primuksen käyttäjät voidaan tunnistaa LDAP-protokollalla Active Directorysta (AD). Tämä ominaisuus kytketään päälle lisäämällä prserver.ini-tiedostoon tarvittavat määritykset. Tapoja autentikoinnin toteutukseen on kaksi: 1. LDAP:n dn-määritys on systemaattinen ja täsmää Primuksen käyttäjätunnukseen. [Ldap] Library=synapse Host=ldap_serverin_osoite Port=389 Dn=uid=$USERNAME,ou=People,dc=starsoft,dc=fi PRIMUS W4 Sivu 29/36 4.6.2014 Käyttäjäkohtaisen dn-määrityksen voi syöttää myös Primuksessa Käyttäjätunnuksetrekisterissä olevaan LDAP dn-kenttään. Tämä määritys on silloin ensisijainen verrattuna prserver.ini-tiedoston määritykseen. 2. LDAP:n dn-määritys vaihtelee tai se ei täsmää Primuksen käyttäjätunnukseen. [Ldap] Library=wldap32.dll Host=ldap_serverin_osoite Port=389 MainDn=dc=hakutunnus,ou=palvelutunnukset,dc=starsoft,dc=fi MainPasswd=hakutunnuksen_salasana Search=(mail=$EMAIL) SearchBase=dc=starsoft,dc=fi SearchScope=2 Tapa 2 tekee ensin LDAP-haun ja vasta sitten autentikoinnin haun palauttamalla dnmäärityksellä. Haun tekemistä varten AD:hen kirjaudutaan MainDn- ja MainPasswd-tunnuksilla. Asetuksiin määritelty käyttäjätunnus on oltava luotuna. Search-määritys on LDAP:n tehtävä haku. Esimerkissä 2 haetaan Primuksen Käyttäjätunnukset-rekisterissä olevaa sähköpostiosoitetta AD:n mail-kentästä. Yleisesti käytetään myös määritystä Search=(samaccountname=$USERNAME). Tällöin Primuksen Käyttäjätunnukset-rekisterissä määriteltyä käyttäjätunnusta etsitään AD:n käyttäjätileistä (määritellään Account-välilehdellä). Kun käytössä on Linux-versio Primuksen palvelinosasta, tulee käytettävän ohjelmakirjaston nimeä muuttaa. Kyseeseen tulee esim. libldap.so.2. Määritys olisi siis tällöin Library=libldap.so.2 Dn- ja Search-määrityksessä voi käyttää hyväksi Primuksessa olevaa tietoa: $USERNAME = käyttäjän syöttämä käyttäjätunnus $EMAIL = käyttäjän sähköpostiosoite PRIMUS W4 Sivu 30/36 4.6.2014 $CRYPTID = käyttäjän salattu henkilötunnus $AD-USERNAME = käyttäjän kuntalaisverkon AD-tunnus LDAP-autentikoinnin voi kytkeä pois päältä tietyn tunnuksen osalta (esim. Wilma) rastimalla Käyttäjätunnukset-rekisteristä Älä käytä LDAP-tunnustusta -kentän. 1.6 Primuksen käyttötuki Oppilaitoksella tulee olla nimetty pääkäyttäjä, joka opettelee Primuksen läpikotaisin, opastaa muita, jakaa käyttöoikeudet ja ylläpitää tietojärjestelmää. StarSoft järjestää jatkuvasti koulutusta, joka auttaa tarvittavan taitotason saavuttamisessa. Tarvittaessa StarSoft siirtää tiedot oppilaitoksen aikaisemmasta hallinto-ohjelmasta Primukseen. Kysy tästä mahdollisuudesta StarSoftin tukipalvelusta. Jos vanhaa tietoympäristöä ei ole, sisältää Primus kyseisen koulumuodon tyyppiasetukset. Varsinainen työskentely voi alkaa vasta, kun rekistereihin on syötetty tarvittavat tiedot. Jos oppilaitoksella on valmiit tiedostopohjat, voit aloittaa luokkien ja opiskelijatietojen syöttämisestä. 1.6.1 Asiakastuki Primuksen toimitussopimus sisältää automaattisesti käyttäjätuen vuosimaksua vastaan. Sähköposti osoitteeseen tuki@starsoft.fi on ensisijainen yhteydenottomuoto silloin, kun tilanne ei ole akuutti. Vastaus sähköpostitse lähetettyyn kysymykseen tulee useimmiten saman työpäivän aikana. Asian laajuudesta ja ajankohdastakin riippuen vastaus tulee enintään parin päivän viiveellä. Hankintasopimus sisältää periaatteen, että asiakkaalla on nimetty ja koulutettu tukihenkilö sekä tällä lähes samantasoinen varahenkilö. Asiakkaan oikeusturvankin kannalta ratkaisevaa on, että opastamme vain koulun nimeämiä henkilöitä. Tukihenkilöt huolehtivat siitä, että ohjelman käyttäjillä on työskentelyssä tarvittavat perusvalmiudet. He ovat ensisijaisia auttajia ongelmatilanteissa ja ottavat tarvittaessa yhteyttä StarSoftin tukeen. Aikaisemmin ilmoitetut yhteystiedot ja -henkilöt ovat tarkistettavissa StarSoftin sivuilta Ohjelmapäivity- PRIMUS W4 Sivu 31/36 4.6.2014 palvelusta. Yhteystietojen muutospyynnöt voi lähettää sähköpostitse osoitteeseen tuki@starsoft.fi. Puhelintuki on tehokkainta silloin, kun asiakkaalla on ohjelma avattuna ja kun hän osaa kuvailla ongelman, tarvittaessa toistaa sen puhelun aikana ja toimia annettujen ohjeiden mukaan. Lisäksi on hyvä varautua vastaamaan kysymyksiin koneen käyttöjärjestelmästä ja asetuksista sekä ohjelman asennuksesta ja asetuksista. Asiakastuki ei voi korvata sitä, että ohjelman käyttäjä perehtyy ohjeisiin ja osallistuu koulutukseen. Koulutuskalenteri ja koulukohtainen koulutus hinnastoineen löytyy kotisivuiltamme kohdasta Koulutus. Koulutustilaukset voi tehdä puhelimitse numeroon (06) 320 2500 tai sähköpostitse osoitteeseen koulutus@starsoft.fi. Tukipalvelun puhelinnumerot: Yleissivistävä koulutus: 06 320 2500 Ammatillinen koulutus: 06 320 2510 Ammattikorkeakoulutus: 06 320 2550 1.6.2 Tukiyhteys Primuksesta voi avata tukiyhteyden StarSoftin asiakastukeen internetin välityksellä. StarSoft ei voi avata tukiyhteyttä, vaan asiakkaan on avattava se. Ennen tukiyhteyden avaamista sovi asiasta puhelimessa StarSoftin tukipalvelun kanssa. Primuksen päävalikon Muut toiminnot -osiosta valitaan Avaa tukiyhteys. Toiminnolla oppilaitoksen Primus-käyttäjä avaa StarSoftin tukipalvelun työntekijälle yhteyden oppilaitoksen Primus-tietokantaan. Tällöin ongelmatilanteen analysointi ei perustu pelkästään käyttäjän kuvaukseen vaan asiakastuki näkee asiat suoraan omalta näyttöruudultaan. PRIMUS W4 Sivu 32/36 4.6.2014 Kuva 5: Tukiyhteyden avaaminen Kirjoita jokin sana yhteyden tunniste- ja salasana-kenttiin ja kerro ne puhelimessa tukihenkilölle. Käytä yksinkertaisia tunnisteita, jotka voit virheettömästi ilmoittaa puhelimessa. Niiden avulla StarSoftin tukihenkilö kirjautuu sisään oppilaitoksen Primukseen. Tukiyhteys on ikään kuin toinen samalla käyttäjätunnuksella ja avattu Primus-ikkuna. Myös käyttäjäoikeudet ovat samat, joten jos yhteyden avaajalla ei ole oikeuksia esim. varmuuskopiointiin, ei StarSoftin tukihenkilökään pääse varmuuskopiointiin. Tukiyhteys ei syrjäytä oppilaitoksen Primus-käyttäjää, vaan hän voi jatkaa työskentelyä alkuperäisenä käyttäjänä, jota StarSoftin tukihenkilö neuvoo. Tukiyhteyden avulla tukihenkilö saa tilanteesta tietoa nopeammin ja tehokkaammin. Avatun tukiyhteyden olemassaolon voi todeta siitä, että server-ikkunassa sama käyttäjätunnus näkyy kahteen kertaan. Jos tukiyhteyden avausikkuna häiritsee, sen voi siirtää sivuun tai pienentää. Kun tilanne on hoidettu, paina Katkaise yhteys -painiketta, jolloin tukiyhteys katkeaa. Tukiyhteyden muodostaminen on aina käyttäjän oma toimenpide, sitä ei voi muodostaa ulkopuolelta. Käytetty tunnus ja salasana ovat voimassa vain tuossa istunnossa. Tunnukset eivät tallennu mihinkään, eikä niiden avulla voi ulkopuolelta muodostaa uutta yhteyttä. Tukiyhteyden tietoliikenne on voimakkaasti salattu. Kun käyttäjä avaa tukiyhteyden, Primus ottaa yhteyden www.starsoft.fi -palvelimen porttiin 5111. Käyttäjän koneeseen ei siis avata mitään palvelua tai avointa porttia, jonka kautta tietokoneeseen voitaisiin murtautua. Yhteys StarSoftin palvelimelle salataan 128-bittisellä avaimella ja istuntokohtainen tunnistetieto 512-bittisellä avaimella. PRIMUS W4 Sivu 33/36 4.6.2014 1.7 Käyttökatko Kun pääkäyttäjä haluaa tilapäisesti estää Primus-käytön muilta käyttäjiltä, asetetaan Primuksen käyttökatko. Käyttökatko asetetaan joko kaikille käyttäjäryhmille tai valituille ryhmille. Katko asetetaan Käyttäjäryhmät-rekisterissä, joka löytyy Primuksen päävalikon Ylläpidon rekisterit -kohdasta. Tätä varten tulee esillä olla kentät Käyttökatko ja Käyttökatkon lisätiedot. Jos kentät eivät ole valmiiksi esillä, valitse yläpalkista Ylläpito / Kenttäeditori, klikkaa oikeasta laidasta pientä +-merkkiä Muut kentät -tekstin edessä ja rasti aukeavasta luettelosta kentät Käyttökatko ja Käyttökatkon lisätiedot. Kentät ilmestyvät vasemmanpuolisen ruudun alalaitaan, josta voit vetää ne hiirellä sopivaan kohtaan. Valitse Toiminnot / Tallenna. Rekisterikorttien listasta valitaan ne käyttäjäryhmät, joille käyttökatko asetetaan. Käyttökatko-kohta rastistaan ja kenttään Käyttökatkon lisätiedot kirjataan tieto, jonka halutaan näkyvän sisäänkirjautuvalle käyttäjälle. Mikäli käyttökatko asetetaan jokaiselle käyttäjäryhmälle, estää se silloin jokaisen käyttäjän pääsyn Primukseen - siis myös käyttökatkon asettajan. Jos käyttökatko asetetaan vahingossa kaikille käyttäjille, pääsee ohjelmaan kirjautumaan siltä koneelta, jossa Primuksen palvelinosa sijaitsee. Tällöin sisäänkirjautumisikkunan kenttään Primus-palvelinosan osoite pitää muuttaa osoitteeksi 127.0.0.1. Tämä osoite tarkoittaa aina kyseistä tietokonetta. Käyttökatko lopetetaan poistamalla rasti kentästä Käyttökatko. Kuva 6: Käyttökatkon asettaminen Primuksessa PRIMUS W4 Sivu 34/36 4.6.2014 2 MUUT OHJELMAT 2.1 Kurre Kurre 7 on opetusjärjestelyiden suunnitteluohjelma. Kurrella tehdään työjärjestykset, suunnitellaan seuraavaa lukuvuotta ja hoidetaan opettajien työmäärälaskenta. Kurre soveltuu erinomaisesti moniyksikköisille oppilaitoksille ja 2. asteen yhteistyöhön. Kurrella on oma ohjekirjansa, joka on ladattavissa PDF-tiedostona Ohjelmapäivityspalvelusta. Jos käytössä on sekä Primus että Kurre, ovat ne molemmat integroituna samaan asiakasosaan, jolloin liikkuminen Primuksen ja Kurren välillä on helppoa ja nopeaa. 2.2 Wilma Wilma on ohjelma, jonka avulla osaa Primuksen ja Kurren toiminnoista voidaan käyttää internetselaimella. Wilmalla on oma ohjekirjansa, joka on ladattavissa PDF-tiedostona Ohjelmapäivityspalvelusta. 2.3 PrimusQuery PrimusQuery on Primuksen apuohjelma, jonka avulla on mahdollista tehdä automatisoituja kyselyitä Primuksen tietokantaan. Ohjelman avulla voidaan luoda Primuksen tiedoista esim. CSV-tiedostoja tai HTML-sivuja. PrimusQuerysta on saatavissa Windows- ja Linuxversio. PrimusQuery toimii siten, että se lukee kaikki tarvitsemansa tiedot kyselytiedostosta ja ottaa yhteyden Primuksen tietokantaan. Sen jälkeen ohjelma luo halutun siirtotiedoston ja poistuu Primuksesta. Tarkemmat ohjeet PrimusQueryn hankintaan ja käyttöön löytyvät StarSoftin www-sivuilta, Ohjelmapäivitys ja asennus -sivulta kohdasta Yhteydet muihin järjestelmiin. PRIMUS W4 Sivu 35/36 4.6.2014 2.4 PrimusToAd PrimusToAd on Primuksen lisäosa, jonka avulla pystytään automatisoimaan opiskelijoiden, opettajien ja henkilökunnan Active Directory-tunnusten luominen, siirto ja poistaminen. (esim. AD- ja LDAP-tunnukset). Tarkemmat ohjeet PrimusToAd-ohjelman hankintaan ja käyttöön löytyvät StarSoftin www-sivuilta, Ohjelmapäivitys ja asennus -sivulta kohdasta Yhteydet muihin järjestelmiin. PRIMUS W4 Sivu 36/36 4.6.2014 3 OHJELMAKIRJASTOT Kurren, Primuksen ja Wilman toteutuksessa käytetään avoimen ohjelmakehityksen piiriin lukeutuvaa Internet Direct -kirjastoa: LicenseBSD Copyright Portions of this software are Copyright (c) 1993 - 2002, Chad Z. Hower (Kudzu) and the Indy Pit Crew - www.nevrona.com/Indy/ License Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: * Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. * Redistributions in binary form must reproduce the above copyright notice, this list of condit ions and the following disclaimer in the documentation, about box and/or other materials provided with the distribution. * No personal names or organizations names associated with the Indy project may be used to endorse or promote products derived from this software without specific prior written permission of the specific individual or organization. THIS SOFTWARE IS PROVIDED BY Chad Z. Hower (Kudzu) and the Indy Pit Crew ”AS IS” AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. OpenSSL libraries for Indy Copyright 2000-2002 Gregor Ibic, gregor.ibic@intelicom.si Intelicome d.o.o. www.intelicom.si
© Copyright 2024