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, in a terminal,

    ZID=your_zid
    mkdir -p ~/.ssh
    cd ~/.ssh
    wget --user=$ZID --ask-password https://www.cse.unsw.edu.au/~robocup/Nao/Downloads/vm-files/.ssh/id_rsa https://www.cse.unsw.edu.au/~robocup/Nao/Downloads/vm-files/.ssh/config
    ssh-keygen -p -N '' -f ~/.ssh/id_rsa
    # Enter old passphrase: the standard runswift password
    sudo apt install git
    cd ~
    git clone git@github.com:UNSWComputing/rUNSWift.git rUNSWift
    rUNSWift/bin/setup-build.sh
    rUNSWift/bin/setup-simulation.sh
    rm -rf ~/.ssh/id_rsa
    

    Note

    For passwords, please Contact us.

    Note

    Consider squashing history

    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/