Skip to content

Latest commit

 

History

History
72 lines (50 loc) · 4.5 KB

lab-setup.md

File metadata and controls

72 lines (50 loc) · 4.5 KB

RX-M - Lab System Setup

The lab exercises for RX-M courses are designed for completion on a base Ubuntu 16.04 64 bit system. The system should have 2+ CPUs, 2+ GBs of RAM and 30+ GB of disk. Students who have access to an appropriate existing system (e.g. a typical cloud instance) can perform the lab exercises on that system, however, RX-M provides a prebuilt lab VM which offers a more reliable and safe environment for experimentation.

Supported Platforms

The RX-M lab VM can be run on any of these virtualization platforms:

Download the VM

The RX-M VMware configured lab virtual machine is 770MB in 7z compressed format and can be downloaded here: https://s3-us-west-1.amazonaws.com/rx-m-vms/ubuntu-16.04.7z (shasum b8f0b56170324cd616e5d58bea1c11a29ccb39bf)

The RX-M VirtualBox configured lab virtual machine is 1GB in OVA compressed format and can be downloaded here: https://s3-us-west-1.amazonaws.com/rx-m-vms/Ubuntu_Xenial_Xerus.vbvm.ova (shasum 18fe67e3e88e06207c54316be79d898a1a1cc6b9)

Run the VM

To run the lab VM:

  1. Download the lab system fully (do not attempt to manipulate the file until it has completely downloaded)
  2. If using the .7z file, use any 7Zip compatible archiver:
  3. Launch the VM:
    • VMware: double click the .vmx file (e.g. Ubuntu_Xenial_Xerus.vmx) inside the decompressed folder (when asked, say you copied the VM)
    • VirtualBox: double click the OVA file (when asked, agree to import the VM)
  4. Login to the VM with the username "user" and the password "user"

What could go wrong?

For most people (95%) the above steps work perfectly. However there are some common issues that may keep you from running the lab virtual machine (which are easily fixed):

  • The virtualization system (VMware/VirtualBox) says it can not run a 64 bit virtual machine because "VTx is not enabled" (or similar message).

    • Intel/AMD processors have virtualization extensions (VT) that hypervisors use to improve VM performance and enable advanced functionality. If these extensions are not enabled you will not be able to run a 64 bit VM like the lab system. This is not generally a problem on Macs but many PCs (Lenovo laptops in particular) come with VTx disabled. To fix this, simply enter the BIOS configuration and enable VTx (your BIOS may call it "Virtualization Technology", "Intel VT", "AMD-V", "VT-d" or something else depending on your CPU and chipset). To enter the BIOS configuration you will need to reboot your computer and then press a key (usually <Enter>, <F10> or something similar) quickly before the OS starts. Every BIOS configuration menu is different but the settings are often found under "general" or "security" menus. Enable all of the virtualization features (there may be one or more options to enable), save the changes and reboot. You should now be able to run the lab VM.

  • VMware complains that the VM was created by a VMware product that is incompatible with your version of VMware and cannot be used

    • For Player and/or Workstation: open the file: Ubuntu_Xenial_Xerus.vmx with a text editor, find the property: virtualHW.version = "12" and change it to your version.

    • For Fusion:

      • Select the VM from the list in the Virtual Machine Library
      • Open Settings by either: using the Command + E shortcut (⌘E), clicking on the wrench icon, or right-clicking and choosing "Settings..." from the right-click menu, or opening the "Virtual Machine" menu and selecting "Settings..."
      • In the Settings dialog, select "Compatibility" (icon looks like a motherboard)
      • Open the "Advanced Options" drop-down option
      • Under the "Use Hardware Version" selector, select your hardware version

  • DNS causes problems when the VM suspends on Virtual Box

    • On some (older?) versions of Virtual Box DNS issues can occur after suspending the VM and or moving between networks (e.g. wifi hot spots). Solution (on OSX) is to run: VBoxManage modifyvm "VM name" --natdnshostresolver1 on