This guide deals primarily with issues related to the VirtualBox hypervisor. Other hypervisors may be used to run our Virtual Machines, such as VMware, KVM, hyper-V, Parallels, but we do not provide technical support for those.
This guide is not intended to provide detailed steps for every item on every operating system. It is meant as a general guide, and you will have to google to find the procedure for your particular operating system and computer model.
Remember this terminology: The host is your computer on which you are running VirtualBox. A guest is a Virtual Machine running on your host that you imported into VirtualBox.
Preparing your Computer for VirtualBox
Before getting started with VirtualBox, there is a few things you will want to check on your host computer. Checking these before attempting to install and run your virtual machine reduces the chance that something will go wrong.
If you have already tried to install VirtualBox, and you received an error, or the virtual machine is running very slowly, these preparation steps may help with your problems.
- Enable Processor Virtualization: Ensure Virtualization is enabled on your Computer. See the Virtualization Error (VT-d/VT-x or AMD-V) in the Trouble-Shooting section below for instructions.
- Disable OneDrive, DropBox Sync, iCloud, etc If you are using a data synchronization service, make sure it does not (or at least not frequently) synchronize the folder in which you have VirtualBox import and run the Virtual Machines. This can cause a dramatic fall-off of performance for you entire system as these services try to synchronize these massive files.
- Sufficient Disk Space: Virtual Machines require a significant amount of Disk space (10 GB or more each). Ensure you have sufficient space on your computer
Click Here for a video tutorial on installing VirtualBox and running a course VM.
Please complete BOTH of these steps to install VirtualBox:
- Download and install the latest VirtualBox for your host OS from https://www.virtualbox.org/wiki/Downloads
- Download the VirtualBox Extension Pack from https://www.virtualbox.org/wiki/Downloads
Open Preferences… -> Extensions and click the little Add New Package button, then browse to the Extension Pack you just downloaded and follow the instructions
IMPORTANT: ALL of the SCS Virtual Machines require the Extension Pack which provides critical tools and drivers for the Virtual Machines.
WARNING: It is important to update VirtualBox each term. Older version of VirtualBox are not tested with our newer Virtual Machines. Older Virtual Machines generally+ work fine with newer version of VirtualBox.
Importing a Virtual Machine with VirtualBox
Click Here for a video tutorial on installing VirtualBox and importing a course VM.
To import one of the SCS Virtual Machines as a guest into VirtualBox (which you already installed using the VirtualBox Installation steps above), follow these steps:
- Download the Virtual Machine for your course from our Course Virtual Machines page. This will download the .ova file which – if you are curious – is a compressed tarball of the Virtual Machine exported from VirtualBox
- In VirtualBox go to File -> Import Appliance (or press CTRL-I)
- In the Appliance Import Window that opens, click the folder icon to browse for the .ova file you just downloaded, then click Next
- Do NOT change any of the Appliance Settings, these have already been optimized for most systems
NOTE: Importing an Appliance can take 5-10 minutes depending on the speed of your computer and the size of the Virtual Machine
- When the import is complete, you will see the new Virtual Machine guest in VirtualBox’s guest list.
Using VirtualBox Virtual Machines
Starting a Virtual Machine
To start-up a Virtual Machine guest, simply click on the desired one and click the Start button (or double-click the Virtual Machine). Some of our larger Virtual Machines can take up to a minute to boot up the linux operating system and show you the login screen. It the boot-up is a lot slower, or if the performance when logged into the Virtual Machine Desktop or Shell is poor, then consult the Trouble-Shooting section below.
Using a Virtual Machine
How you use a Virtual Machine will depend on your course, so consult your TAs. Some useful things to know:
- Sharing files between the guest and host: To learn about different ways of sharing files, check out this guide. To quickly get a folder that is shared between the host and guest on your own PC, check out this quick-start guide.
- Create a Host-Only Adapter: For information on network adapters in VirtualBox, click here. To get started fast, check out this quick-start guide on creating a host-only adapter.
- Run a command with sudo (root) privileges: Open a terminal and type any command with
sudoin front to run that command as root.
sudo apt-get install vim– will install the vim text editor package on an ubuntu linux Virtual Machine
- Find the IP address of your Host-Only Network connection: Open a terminal and type
ifconfig | more– The | more (pronounced “pipe more”) will “pipe” the output of the
ifconfigcommand to the
morecommand which will show the results one page at a time, so it doesn’t scroll by before you see it all.
If you have a Host-Only Network IP address you will see an IP of 192.168.56.101 (or something similar). Check the Trouble-Shooting section below for more information about the Host-Only Network.
Shutting down a Virtual Machine
When you are done using a Virtual Machine, you need to shut it down properly. This can be done in three ways:
- Press the the shut down button found on the desktop, task bar, or task menu of the guest operating system
- Open a terminal and type the command:
sudo shutdown -h now
- In the guest window click Machine (menu) -> ACPI Shutdown – This will simulate the power button being pressed
WARNING: If you shutdown a guest operating system any other way, such as by just pressing the “X” button on the guest window or File (menu) -> Close, this is the same as pulling the power cord out of your desktop computer. This can result in hard drive errors depending on what the guest operating system was doing when you killed it.
NOTE: Some of our VMs can take as much as a minute to shut down depending on what the system was doing, please be patient.
Troubleshooting Issues with VirtualBox
For a curated list of Virtual Machine troubleshooting steps and quick-start guides, click here.
These are some of the most frequent issues when getting started with VirtualBox:
- Extension Pack Missing
- Virtualization Error (Intel VT-d/VT-x or AMD-V)
- This issue can appear with different error messages or could contribute to poor system performance.
- Follow the Troubleshooting Steps
- Graphics Controller (VMSVGA) Settings
- For best performance, you should enable the VMSVGA, instructions available here
- Sometimes your graphics controller can contribute to crashing, boot errors, or very poor performance. If you encounter these issues, try changing your graphics controller using the instructions found in the Graphics Controller Troubleshooting Steps
Virtual Machine Troubleshooting Articles
Below is a list of all of the current virtual machine help articles. For a compact and curated view, visit the troubleshooting and guides page.
Thursday, October 10, 2019
VirtualBox Crashing on Mac after Update
Multiple people have reported VirtualBox crashing after the latest macOS update to macOS Catalina. In particular, when virtual machines are launched, they may crash immediately or may crash when you deselect the active instance window. This article describes the likely causes of VirtualBox crashes after the Catalina update and how you can attempt...
Friday, September 13, 2019
Creating a Permanently Shared Folder in VirtualBox
This guide shows you how to set up a folder which will be shared between your host machine and your guest machine. For more information on transferring files between virtual machines, click here. For a video tutorial on Windows, click here. Setting Up the Shared Folder Select the guest machine you wish to share...
Friday, September 13, 2019
VirtualBox Graphics Controller (VMSVGA) Settings
Sometimes when VirtualBox is updated, or when a Virtual Machine is imported, a non-optimal Graphics Controller may be enabled in the Display Settings for the Virtual Machine. All of our Virtual Machines are designed with the VMSVGA Graphics Controller, which should normally provide the most stability and the best performance. To apply this VMSVGA...
Friday, September 13, 2019
VirtualBox Virtualization Error (Intel VT-d/VT-x or AMD-V)
Is your virtual machine not launching, providing some kind of error, or has very poor performance? This may be caused by your operating system or motherboard settings. This issue can take many forms, so if you are experiencing any problems you should start by checking your system's virtualization settings. Processor Virtualization must be enabled...
Thursday, September 12, 2019
Creating a New Host-Only Adapter in VirtualBox
This page describes how to create a new host-only adapter in VirtualBox. For more information on host-only adapters and virtual networks in VirtualBox, click here. Create the Virtual Network First you must set up a virtual network that the host-only adapter(s) will communicate through. In the VirtualBox window, click File > Host Network Manager...