## page was renamed from OPWfirstpatchAlt
= Running Linux in a VM =

= Hardware Requirements =

You need a system with virtualization (VT-d), at least 4GB of RAM, and 40GB of free hard drive space in order to run Linux in a VM.

== Alternatives ==

If your system doesn't meet those requirements, you will need to be running Linux, or dual boot your machine so you can run both Linux and Windows.   We strongly suggest you use the [[http://www.ubuntu.com/download/desktop/thank-you?distro=desktop&bits=64&release=lts|Ubuntu 12.04 64-bit version]].  If your machine doesn't have 64-bit support, you can use the [[http://www.ubuntu.com/download/desktop/thank-you?release=lts&bits=32&distro=desktop&status=zeroc|32-bit version]].  Once you have Ubuntu installed, please follow the directions [[OPWfirstpatch|here]].

= Download Ubuntu 12.04 =

[[http://www.ubuntu.com/download/desktop/thank-you?distro=desktop&bits=64&release=lts|Download link to]] Ubuntu 12.04 64-bit version.

= Install VMPlayer =

Go to the [[http://www.vmware.com/products/player/|VMPlayer website]] and click the 'download' link.  Download the VMPlayer that's appropriate for your operating system (e.g. Windows or Linux 64-bit), and install it.

== Linux VMPlayer installation instructions ==

The [[http://www.vmware.com/products/player/|VMPlayer download]] comes as a .bundle file.  That's a binary executable, that will launch a setup wizard.

First, change to the directory where you downloaded the VMPlayer binary by using the command {{{cd}}}.

   Tip: {{{cd}}} changes the current working directory to a different directory.  You can learn more about any command by reading the manual pages.  Simply prefix the command with the word "man", e.g. {{{man cd}}}.

Next, check to see if the file is executable.  Run this command:

{{{
ls -l}}}

Then look at at the file's listing, and see if it has the executable ("x") bit set:

{{{
$ ls -l
total 181056
-rw-rw-r-- 1 sarah sarah 185386101 Apr 26 22:19 VMware-Player-5.0.2-1031769.x86_64.bundle}}}

If it doesn't show the executable bit, make the file executable by running:

{{{
chmod a+x VMware-Player-5.0.2-1031769.x86_64.bundle}}}

Then execute the binary by prefixing it with a ./ and running it as the root user with sudo:

{{{
sudo ./VMware-Player-5.0.2-1031769.x86_64.bundle}}}

   Tip: Be careful about what you run as root!  The root user has access to all the files on your system, so you usually don't want to run arbitrary commands as root.  Always run commands without sudo, and without changing to a root terminal, where ever possible.

= Running Ubuntu 12.04 in a VM =

== VMPlayer Setup ==

Click "Create a New Virtual Machine".  "Use an ISO image" and select the Ubuntu 12.04 ISO you downloaded.  Hit "Next".  Fill in your name, username, and a password, and hit "Next".

The next screen is your computer's information.  The "Name" will be used for the machine name, and shown in all terminal prompts, so pick something short and sweet.  You can change the Location of your VM independent of what you name the machine.

The next screen is hardware info.  Increase the disk size to 40 GB, and chose "Store virtual disk as a single file".  This makes it easier to copy the VM image from computer to computer.  Uncheck "Automatically Start the VM".

Before you start the VM, you need to make some adjustments to the emulated hardware.  Click "Edit virtual machine settings".  Now, adjust the amount of memory available to the VM to be the recommended amount of memory.  You also want to adjust the number of CPUs available to the guest.  It should not be more CPUs than you have available (e.g. if you have a dual core, it should not be more than 2).  Click the 'Save' button.

Once you've adjusted the emulated hardware, start the VM by clicking "Play virtual machine".  If a "Removable devices" window pops up, click "ok".  On the Software Updates window, click "Download and install".

Please wait for the software updates to download and install before you start using the VM.  Otherwise the VM will be very VERY slow.

After Ubuntu 12.04 has finished installing, you can proceed to these [[OPWfirstpatch#kernel-setup-done|instructions]]