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.

  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 4GB is a minimum. You also want to leave at least 4GB for your host machine. 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

        The number of processors should be 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)
    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/build_setup.sh
    rUNSWift/bin/sim_setup.sh
    

    Note

    For passwords, please Contact us.

  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/