Abitti 2 koetilan palvelin
Koetilan palvelimet
- jakavat kokelaiden koneille koetehtävät ja kokeessa käytössä olevat oheisohjelmat
- tallentavat koevastaukset ja varmuuskopioivat oheisohjelmien käytössä syntyvät tiedostot
- jakavat valvojien tietokoneille valvontanäkymän kokeen hallinointiin.
Suurilla kokelaismäärillä koetilan palvelimia voi yhdistää kuorman jakamiseksi. Usea koetilan palvelin toimii myös varatoimenpiteenä sille, että jokin palvelin vikaantuu koetilaisuuden aikana.
Koetilan palvelin käynnistetään Docker-konttina Linux (Ubuntu) käyttöjärjestelmässä. Windows 11 -käyttöjärjestelmässä koetilan palvelimen voi käynnistää Linux-virtuaalikoneessa (WSL).
Palvelimen uusin versio: 0.21.0 (5.5.2025)
- Muutosloki (englanniksi)
Asennuskoodi
Ennen koetilan palvelimen asennusta tarvitset asennuskoodin, joka syötetään Naksu 2 -ohjelmalle.
Lukion asennuskoodi
Lukiot voivat asentaa Abitti 2 –palvelimen, joille YTL on sopinut lisenssin oheisohjelmien tuottajien kanssa. Nämä oheisohjelmat tulevat vain lukioiden asennuskoodeilla asennetuille palvelimille, koska YTL:n ja ohjelmatoimittajien lisenssisopimus sallii jakelun vain lukioille. Lukioiden rehtorit näkevät asennuskoodin YTL:n tutkintopalvelun välilehdellä “asennuskoodit”. Samalta välilehdeltä löytyy myös ylioppilaskokeessa käytettävän Abitti 1 –palvelimen asennuskoodi.
Testikoodi
Testikäyttöön tarkoitettuja asennuskoodeja voi tilata ottamalla yhteyttä Abitti-tukeen. Koodit ovat henkilökohtaisia ja ne myönnetään kaikille, joilla on tarvetta testikäyttöön.
Asennuskoodin avulla voi asentaa Abitti-palvelimen, jossa on käytettävissä ainoastaan avoimen lähdekoodin oheisohjelmat.
Linux-ympäristön asennus
Linux-asennus
Tässä ohjeessa kerrotaan kuinka Abitti 2 -palvelimen ylläpitoon ja käyttöön tarvittava Naksu 2 -ohjelma asennetaan tyhjälle tietokoneelle.
- Asennus vaatii ylläpitäjän oikeudet, mutta palvelimen käyttö tai päivitys onnistuvat käyttäjän oikeuksin.
- Abitti 2 -palvelimen on oltava sekä asennuksen että käytön aikana yhteydessä internetiin.
- Abitti 2 -palvelimessa on oltava vähintään 12 gigatavua muistia
- Lataa levynkuva ja kirjoita se USB-muistitikulle esim. Etcher-ohjelmalla
- Liitä palvelimeksi asennettava tietokone kaapeliverkkoon, käynnistä tietokone kirjoittamaltasi USB-tikulta ja valitse käynnistysvalikosta “Install YTL Ubuntu Server 24.04”
- Asennus on valmis, kun kone sammuu tai palautuu käynnistysvalikkoon
- Käynnistä kone uudelleen ja kirjaudu sisään käyttätunnuksella “school”, jonka salasana on “school”
- Vaihda salasana: Menu (vasen alanurkka) > Preferences > Account Details > Password
- Jos Naksu 2 -ohjelmaa ei löydy jo valmiiksi sovellusvalikosta, voit asentaa sen näin:
- Kirjaudu Linux-koneelle ja avaa näytän alalaidasta pääteikkuna.
- Päivitä pakettihakemiston tiedot:
sudo apt update - Asenna tarvittavat ohjelmistot:
sudo apt install -y ytl-linux-digabi2
Käynnistä kone uudelleen. Löydät Naksu 2 -ohjelman sovellusvalikosta.
Windows-asennus
Tässä ohjeessa kerrotaan kuinka Abitti 2 -palvelimen ylläpitoon ja käyttöön tarvittava Naksu 2 -ohjelma asennetaan Windows 11 -tietokoneelle. Abitti 2 -palvelinta ei voi asentaa Windows 10 -palvelimelle.
- Asennus vaatii ylläpitäjän oikeudet, mutta palvelimen käyttö tai päivitys onnistuvat käyttäjän oikeuksin.
- Abitti 2 -palvelimen on oltava sekä asennuksen että käytön aikana yhteydessä internetiin.
- Abitti 2 -palvelimessa on oltava vähintään 12 gigatavua muistia
Ohjeet eivät toimi Windows 10:ssa, koska siinä verkkoasetukset poikkeavat Windows 11:stä.
- Paina Windows-nappia > kirjoita
powershell> klikkaa Windows PowerShell –ikonista hiiren oikealla napilla > klikkaa “Run as administrator”. Windows pyytää ylläpitäjän oikeuksia. - Aloitetaan ottamalla Windows Subsystem for Linux (WSL) käyttöön. Kopioi PowerShellin komentoriville seuraava komento ja paina enter:
wsl --install --no-distribution[paina enter] - Seuraavaksi sinun pitäisi määritellä kuinka paljon muistia Abitti 2 –palvelimelle annetaan. Mitä enemmän muistia, sitä useampi opiskelija voi tehdä koetta samanaikaisesti. Hyvä nyrkkisääntö on se, että Windowsille on jätettävä muistia 2 gigatavua. Jos koneessa on 8 gigatavua muistia, voit antaa Abitti 2:lle 6 gigatavua. Abitti 2 tarvitsee vähintään 2 gigatavua muistia.Luo käyttäjän kotihakemistoon (esim.
C:\Users\digabi) tiedosto nimeltä.wslconfigesim. komennolla
notepad "$env:HOMEPATH\.wslconfig."[paina enter]
Huomaa piste tiedostonimen alussa ja lopussa! - Kopioi tiedostoon seuraavat rivit:
[wsl2]
memory=4GB
networkingMode=mirrored
[experimental]
hostAddressLoopback=true
Esimerkissä Abitti 2 -palvelin saa 4 gigatavua muistia. - Talleta tiedosto painamalla Ctrl+S ja sulje Notepad-editori.
- Käynnistä tietokone uudelleen. Osa WSL:sta asentuu vasta tässä vaiheessa.
- Kirjaudu Windowsiin ja ja käynnistä Windows PowerShell ylläpitäjän oikeuksin kuten kohdassa 1.
- Asenna Ubuntu 22.04:
wsl --install Ubuntu-22.04[paina enter] - Sinua pyydetään luomaan Linux-käyttäjätunnus. Tähän voi käyttää jotain yleiskäyttöistä käyttäjätunnus-salasanaparia, esim. “abitti” ja “abitti”.
- Nyt näet Linuxin komentorivin. Anna komentoriville seuraavat komennot (voit liittää komennon leikepöydältä klikkaamalla WSL-pääteikkunaa hiiren oikealla napilla):
sudo apt update && sudo apt -y upgrade[paina enter ja anna kohdassa 9 luomasi käyttäjän salasana]
Tämän komennon seurauksen näytölle pitäisi tulla paljon tekstiä, joka kertoo asennuksesta.
bash <(curl -s https://static.abitti.fi/abitti-2-test/init-digabi2-package-repositories.sh)[paina enter]
Tämänkin komennon seurauksena näytölle pitäisi tulla paljon tekstiä, jotka kertovat asennuksesta.
sudo apt-get install -y ytl-linux-digabi2-wsl[paina enter]
Tämän komennon seurauksena näytölle pitäisi tulla vielä enemmän tekstiä, jotka kertovat asennuksesta.
exit[paina enter] - Anna PowerShellin komentoriville seuraava komento, joka avaa palomuuriin pääsyn Abitti 2 –palvelimelle:
Set-NetFirewallHyperVVMSetting -Name $(Get-NetFirewallHyperVVMCreator | Select -ExpandProperty VMCreatorId) -Enabled True -DefaultInboundAction Allow[paina enter] - Sulje PowerShell-ikkuna.
- Windows-sovellusvalikosta löytyy nyt ohjelma “Naksu 2 (Ubuntu 22.04)”, jolla voit asentaa Abitti 2 –palvelimen. Jatka seuraamalla Naksu 2 -ohjelman käyttöohjeita.
Palvelimen päivitys, käynnistys ja sammutus
Abitti 2 -palvelinta päivitetään, käynnistetään ja sammutetaan Naksu 2 -ohjelman avulla. Toimenpiteet eivät vaadi ylläpitäjän oikeuksia.
Naksu 2:n käyttöönotto
Ensimmäisellä käyttökerralla tehdään Naksu 2:n asetuksia.
- Käynnistä Naksu 2 käynnistysvalikosta.
- Aluksi Naksu 2 testaa koneen toiminnot. Klikkaa “Siirry eteenpäin”.
- Liitä asennuskoodi sille varattuun kenttään.
- Valitse verkkolaite, joka on yhdistetty internetiin ja joka näkyy kokelaille.
- Valitse uusin saatavilla oleva versio.
- Klikkaa “Asenna palvelin”.
Asennus kestää kauan, jopa 20-30 minuuttia verkkoyhteyden nopeudesta riippuen. Asennuksen etenemistä ei tällä hetkellä voi seurata mitenkään. - Onnistuneen asennuksen jälkeen alalaidan nappiin päivittyy teksti “Käyttöönotto valmis”. Klikkaa nappia ja sulje Naksu 2.
Naksu 2:n käyttö
Nämä toimenpiteet toistetaan aina, kun palvelimella järjestetään koe.
- Käynnistä Naksu 2 käynnistysvalikosta.
- Käynnistä Abitti 2 -palvelin klikkaamalla nappia “Käynnistä palvelin”.
- Kun palvelin on käynnistynyt voit ilmoittaa kokelaille palvelimen osoitteen kohdasta “Palvelimen osoite”:
- Jos kokelaat käyttävät Abitti 2 -sovellusta, kerro heille kaksi sanaa. He kirjoittavat nämä sanat omaan sovellukseensa.
- Jos kokelaat käyttävät selainta, kerro heille osoite https://kaksi-sanaa.koe.abitti.net:8010
- Pääset itse valvojan näyttöön klikkaamalla osoitteen oikealla puolella olevaa nuolta.
- Valvojan näytön käyttäjätunnus ja salasana näkyvät osoiterivin alta.
- Valvojan näyttö toimii kuten Abitti 1:ssä.
- Jos et saa yhteyttä valvojan näyttöön tai kokelaat eivät saa yhteyttä palvelimeen, tarkista palvelimen osoite (ks. alla).
Palvelimen verkkolaitteen valinta
Jos koneessa on useita verkkolaitteita (esim. kaapeliliitäntä ja langaton verkko), Naksu 2:lle on kerrottava mitä verkkoa palvelimen tulee kuunnella. Tämä valinta tehdään asetussivulla:
Palvelimen osoitteen päivitys
Palvelimen IP-osoitteen (esim. 192.168.32.13) muuttuessa sille on haettava uusi osoite (esim. nerokas-transitio.koe.abitti.net). Naksu 2 huomauttaa tarpeesta:
- Hallintasivulla:
- Asetussivulla:
Voit päivittää palvelimen osoitteen asetussivulla klikkaamalla “Hae uusi osoite” -nappia.
Linux-ympäristön päivitys
Tässä ohjeessa neuvotaan, miten saat käyttöösi uusimman Naksu 2 -ohjelman ja samalla päivität käyttämäsi Linuxin muutkin ohjelmistot ajan tasalle.
Koska Abitti 2 -palvelinta ajetaan Windows 11:n Linux-virtuaalikoneessa (WSL), löydät ohjeet myös Windows 11 -asennuksen päivittämiseen tältä sivulta.
Nämä ohjeet eivät päivitä Abitti 2 -palvelinta, eli koetilan palvelinta oheisohjelmistoineen. Abitti 2 -palvelin päivitetään Naksu 2 -ohjelmalla.
YTL Linux (Ubuntu)
YTL Linux eli Ubuntu ilmoittaa uusista ohjelmistoista heti havaitessaan ne. Päivitykset asentavan Update Managerin ilmoitus näyttää tältä:
Päivitykset voi asentaa myös seuraavalla pääteikkunaan syötettävällä komennolla:
sudo apt update && sudo apt -y upgrade
Komentorivi hakee ensin tiedon uusimmista ohjelmistopaketeista ja sen jälkeen asentaa päivittyneet paketit.
Windows / WSL
Windowsin WSL:ssä ajettava YTL Linux eli Ubuntu ei ilmoita ohjelmistopäivityksistä. Päivitykset voi asentaa seuraavalla WSL:n pääteikkunaan syötettävällä komennolla:
sudo apt update && sudo apt -y upgrade
Komentorivi hakee ensin tiedon uusimmista ohjelmistopaketeista ja sen jälkeen asentaa päivittyneet paketit.
Päivityksen yhteydessä saatat saada eteesi seuraavanlaisen virheilmoituksen:
Error: This appears to be a WSL installation. This package does not work in WSL.
You're probably looking for this package instead: ytl-linux-digabi2-wsl
Tässä tapauksessa anna seuraavat komennot:
sudo apt purge ytl-linux-digabi2
sudo apt install ytl-linux-digabi2-wsl