CHipCie Startup scripts

This repository contains docker compose files, shell scripts, and example environments to start systems used during the programming contests.

domserver

Rename the env file to remove the .example extension:

cp domserver.env.example domserver.env

Open domserver.env and update the MYSQL_PASSWORD to a strong password.
Optionally, Add a printer:
- Get a printer URL via linuxprint.tudelft.nl
  - Login using the CH account, Go to Driver Print > Linux.
  - Select Advanced, click Continue and select Follow Me Employee > Follow Me.
  - Scroll down to the url that looks similar to ipps://linuxprint.tudelft.nl:443/ipp/r/abc/def.
- Copy this and update PRINTER_URL
Start domserver

docker compose up -d

DOMjudge is now running on port 8080. The default password for the admin user is in the logs. These can be accessed using:

docker compose logs

Add the -f flag to follow the logs live.

The database can also be accessed through phpMyAdmin on port 8081.

judgehost

To run a Judgehost, use the start-judgehost.sh script.

Run the script with a number as the argument. The container will be limited to that cpu core, starting from 0. Example:

./start-judgehost.sh 0

See the help:

Start a judgehost container on a certain core
Usage: ./start-judgehost.sh [-h|--help] [-u|--domserver-baseurl <arg>] [-p|--password <arg>] [-c|--container <arg>] [-v|--version <arg>] <cpu-core>
	<cpu-core>: Which cpu core to run the judgehost container on
	-h, --help: Prints help
	-u, --domserver-baseurl: Baseurl of the DOMserver (default: 'https://dj.chipcie.ch.tudelft.nl/')
	-p, --password: Password of the judgehosts in the domserver (leave empty for prompt) (no default)
	-c, --container: Docker container to use as judgehost (default: 'ghcr.io/wisvch/domjudge-packaging/judgehost')
	-v, --version: Version of the container (default: '8.2.0')

You can run multiple judgehosts on one machine if desired. Make sure to leave enough resources for the machine itself.

judgehost on ubuntu

Use start-judgehosts-gui.sh to start multiple judgehosts on ubuntu. It will ask for the necessary information in a GUI and lock each judgehost to a different core.

judgehost in the google cloud

To run the judgehosts in the cloud, start them using the following command:

gcloud compute instances create judgehost-1 --project=chipcie --zone=europe-west4-a --machine-type=e2-medium --metadata=judgehost_password=CHANGEME,startup-script=wget\ https://raw.github.com/WISVCH/chipcie-startup-scripts/main/start-judgehost-gcp.sh\ -v\ -O\ start-judgehost-gcp.sh\ \&\&\ chmod\ \+x\ start-judgehost-gcp.sh\ \&\&\ ./start-judgehost-gcp.sh\;\ rm\ -rf\ start-judgehost-gcp.sh --create-disk=auto-delete=yes,boot=yes,image=projects/ubuntu-os-cloud/global/images/ubuntu-minimal-2204-jammy-v20220712,size=10

You should change the CHANGEME to the judgehost password. This will use the start-judgehost-gcp.sh script to start a judgehost on a VM. It will install all the dependencies, and then reboot and start the judgehost. This takes a few minutes.

Start multiple at the same time using:

gcloud compute instances create judgehost-1 judgehost-2 judgehost-3 judgehost-4 --project=chipcie --zone=europe-west4-a --machine-type=e2-medium --metadata=judgehost_password=CHANGEME,startup-script=wget\ https://raw.github.com/WISVCH/chipcie-startup-scripts/main/start-judgehost-gcp.sh\ -v\ -O\ start-judgehost-gcp.sh\ \&\&\ chmod\ \+x\ start-judgehost-gcp.sh\ \&\&\ ./start-judgehost-gcp.sh\;\ rm\ -rf\ start-judgehost-gcp.sh --create-disk=auto-delete=yes,boot=yes,image=projects/ubuntu-os-cloud/global/images/ubuntu-minimal-2204-jammy-v20220712,size=10

ICPC tools CDS

Rename the cds directory to remove the .example extension:

cp -r cds.example cds

Create a user in DOMjudge with the role API reader and Source code reader.
Update these credentials in cds/config/cdsConfig.xml
Optionally, add another contest in this file for the test session.
Update the credentials in cds/config/accounts.yaml
Start the CDS using:

docker compose up -d

Photos or promo material can be added in the cds/config/present/photos and cds/config/present/promo directories.
Affiliantion logos can be put in the cds/contest*/organizations directories, which you can automatically do with the download_affiliations_with_background.sh script in cds.
A logo and a banner can be put in cds/contest*/contest/logo.png and cds/contest*/contest/banner.png.

Port bindings

The folowing ports are used by the containers:

Service	Port
domserver	8080
mariadb	13306
phpmyadmin	8081
domserver spectator	8082
mariadb spectator	13307
phpmyadmin spectator	8083
csd http	8084
csd https	8443
icinga http	8085