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.

To work with the server you need the root password. To get one, just put on your yellow vest and ask the password from our janitor. If you're working remotely, please contact us by email.

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. su -
5. Enter the root password

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.deb

To get anything done in the test taker's image you need the root password. It is sooo easy to get it, just check the instructions above.

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.

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.