Skip to content

Latest commit

 

History

History
46 lines (37 loc) · 1.96 KB

README.md

File metadata and controls

46 lines (37 loc) · 1.96 KB

SP Setup Scripts

Do not run these scripts on a machine you don't intend to turn into a contest image.
All scripts can be run as root, most have to be.

Installation

sudo ./install.sh
This will install all scripts to /usr/share/spsetup/ and make a symlink from /usr/bin/spsetup to spsetup.sh

Running Commands

As root:
spsetup
You will be presented with a menu with 5 option:

  1. Perform first time setup
    • Does everything required to convert a stock headless Debian 10 installation into a contest setup
    • Used for building images, should not need to be run if you received this setup as a preconfigured image
  2. Archive and reset team user
    • Archives the team user's home directory in /usr/share/spsetup/teamarchives
    • Archive file is owned by root and is non-world readable
    • Wipes all files owned by team user, deletes the account and remakes it
  3. Clear team archives
    • Erase all currently archived team home directories
  4. Enable firewall
    • Enables the firewall for contest use
  5. Disable firewall
    • Disables the firewall for admin use
  6. Quit
    • Exits the script

Image Handling

To create a bootable USB drive of this image, simply clone it to the drive using either

  • dd if=contestant.img of=/path/to/drive (may leave dead space on drive), or
  • virt-resize --expand /dev/sda1 contestant.img /path/to/drive (will expand image to fill drive)

where /path/to/drive is the path to the drive you want to write the image to.

Note: virt-resize is available in the libguestfs-tools package.

The image can be converted to different formats using qemu-img convert as detailed here. For example, qemu-img convert -f raw -O vmdk contestant.img contestant.vmdk will convert the image to VMDK format.

Alternative setups such as a virtual machine are possible, but platform dependent, so instructions are not included here.