Description of files

Dhcp

Provisioning process is happening as follows:

0. Flush the DHCP lease database (Danger: should only be done once throughout the event)

• flush-dhcp.sh - Flushes the databae and gives out information

1. Parse the DHCP lease file for MAC addresses

• parse-dhcp.sh - Output is a CSV file with MAC per line called ioi2019.csv

2. Assign IPs to these MAC addresses

• append-ip.sh - Variables are configured inside the script. Input is the output of parse-dhcp.sh. Output is a CSV file with MAC,IP per line called IP_ioi2019.csv

3. MAC,IP CSV file will be provisioned to DHCP

• provision-csv.sh - Variables are configured inside the script. Input is the output of append-ip.sh. Output is a DHCP conf file with MAC,IP reservations (contestant-static.conf))that should be copied to /etc/dhcp/. Then run: sudo systemctl restart isc-dhcp-server

4. Get seat id by web service and add it as a new column: MAC, IP, seat

• sudo cp IP_ioi2019.csv ../../../SeatLocator/data.csv needs to be run to copy MAC,IP pair to seat web service. Everytime an update occurs to a location, DATA_Export.csv is the one which needs to be exported out of the web service. Relocation scripts will need this file.

Isolation-Installation-Configuration

To create an IOI 2019 contestant image, follow the instructions below:

• download and install Ubuntu 18.04 (Bionic Beaver) into your computer machine
• create an user under the name of contestant
• run either sudo ./isolate-install-configure.sh or sudo bash isolate-install-configure.sh command

Relocation

Everytime a contestant is moved to a new location, seat web service is needed to be run. However, in case, a new laptop is given to the contestant, then relocate.sh is needed to be run (you would need ioidhcp user's password):

./relocate.sh seat reserve_laptop_number, where seat is the current location of the contestant and reserve_laptop_number is the spare laptop (to be given) number in laptops.csv file.

The script backs up the current DHCP reservations file (contestant-static.conf) and creates a new one. Then, after manually verifying it, an admin should move it to /etc/dhcp/ folder and restart the DHCP server with sudo systemctl restart isc-dhcp-server

TODO: Recover backup files.