Working With Abitti Live

The heart of Abitti is the live image based on Debian GNU/Linux. We have to images: one for a server and another for the test taker. If you are developing package for the server's or the test taker's image read on!
Our build process expects you to ship your product as a .deb file. When we get your production-ready .deb we put it to our CI and instruct our build process to install this package (i.e. "dpkg -i ...deb"). Before shipping your shiny .deb to us to might want to test it in the real production/testing environment.
Installing Your Package to the Server Live
When working with the server it is trivial to make yourself as root:

  1. Boot a laptop with the server image
  2. Click on the top of the screen where you see an open terminal session called "verkko/nätet"
  3. Right-click on the terminal window and select "Avaa välilehti" (open a tab)
  4. sudo su -

Is is this easy to hack an examination system? Don't worry, in real life the servers are physically monitored.

Now let's profit:

  1. Insert your FAT-formatted USB stick which holds your diamond .deb.
  2. lsblk
  3. Your USB-stick is typically "sdb" or "sdc" depending the mass drive of the laptop. Start checking the last entry on the list.
  4. mount /dev/sdc1 /mnt # or /dev/sdc1...
  5. cd /mnt
  6. dpkg -i yourpackage.dev
Installing Your Package to the Test Taker's Live
When working with the test taker's image you need the root password from the MEB. Just put on your yellow vest and ask the password from our janitor. If you're working remotely, please contact us by email.

  1. Hit Ctrl-Alt-F1 to get to the text console
  2. Log in as "root" and enter the password.

There are two ways you can import files to the live:
  • Mount an USB stick by following exactly the same procedure as above.
  • Place the files to the server (/usr/local/share/map-tiles/tiles/filename) and fetch them at http://localhost/tiles/filename

To get back to the X session (GUI) press Ctrl-Alt-F7.

Reverting Back to Normal
Don't forget you're working on a live image. All the changes you make to the filesystem are just in the RAM. When you want to revert to the original state just power off your laptop and boot again.