VM Image Creation

These are instructions on creating an OVA file to be used in PC Setup for new team members.

  1. Download Ubuntu Desktop Image.

    Tip

    For a smaller VM, try Alpine Linux, Tiny Core Linux, or Slax 9. (Only Slax 9 has been tested.)

  2. Download and Install VirtualBox.

  3. New
    1. Name rUNSWift-VM
      Type Linux
      Version Ubuntu (64-bit)

    2. Next

    3. Memory Size 4096MB

      Tip

      Memory size of 2GB is a minimum. Recommendation is half your system memory.

    4. Next

    5. Create a Virtual Hard Disk now

    6. Create

    7. Expert Mode

    8. File Size 50GB
      Hard disk file Type VDI
      Storage on physical hard disk Dynamically allocated
  4. Settings
    1. System
      • Processor
        Processor(s) 4 CPUs

        Tip

        Maximum 1 CPU per 1.5GB Base Memory Recommendation is equal to the number of cores on your system. Ignore the ‘Invalid settings detected’.

    2. Storage
      1. Click on Empty under Controller:IDE.
      2. Attributess -> Optical Drive -> click on the disc icon
      3. Choose Virtual Optical Disk File
      4. Select downloaded iso file
  5. Start

    1. English

    2. Install Ubuntu

    3. Continue (US Keyboard)

    4. Continue (Minimal Installation and Download Updates)

    5. Install Now (Erase disk)

    6. Continue (write changes to disk?)

    7. Continue (Sydney)

    8. Your name (your choice)
      username (your choice)
      password (your choice)

      Tip

      Do not use the standard runswift password

    9. Continue

    10. Restart Now (after installation is complete)

  6. Inside the VM, download

    from CSE into ~/.ssh/.

    In a terminal,

    ssh-keygen -p -N '' -f ~/.ssh/id_rsa
# Enter old passphrase: the standard runswift password
sudo apt install git
git clone git@github.com:UNSWComputing/rUNSWift.git rUNSWift
rUNSWift/bin/setup-build.sh
rUNSWift/bin/setup-simulation.sh

    Note

    For passwords, please Contact us.

    Note

    Consider squashing history and removing ~/.ssh/id_rsa

    Tip

    Reduce the VM size by commenting out ctc-2.8, flite, and game controller from source.sh/setup-build.sh if you don’t need them

  7. Shutdown the VM

  8. Machine -> Export to OCI
    1. Uncheck “Write Manifest File”
    2. Next
    3. Export

  9. Upload ova file to server

    rsync -aP ~/Documents/runswift-18.04.ova runswift@runswift2.cse.unsw.edu.au:/var/www/html/