Added instructions on adding shared folder

If the user is only using VirtualBox, they need instructions on how to add a shared folder.
Ok, so the VBoxControl permission problem was fixed by reinstalling the 
GAs after I had installed virtualbox-guest-utils, but it still doesn't 
seem to be working.  Maybe we should just require people to use sudo to 
use the shared folder for now?

On 08/09/2014 10:51 AM, Matt Bierbaum wrote:
>
> In docs/tutorial_vm.rst:
>
> > @@ -23,7 +23,25 @@ After booting the VM and logging in, you will find yourself in a bash shell with
> >      ├── openkim-repository - contains an empty copy of the OpenKIM Repository
> >      └── openkim-website - contains code to run the remote viewing panel for the VM
> >
> > -In addition to the standard KIM directories, it is important to note the existence of the ``/vagrant/`` directory.  This directory is shared between the VM and the primary OS you're running, and can be conveniently used to transfer files between the two.  Anything that you copy into ``/vagrant/`` on the VM will show up in the folder you installed the VM into on your primary OS.  Likewise, anything you place in the folder where you installed the VM will show up in ``/vagrant/`` on the VM.
> > +In addition to the standard KIM directories, it is important to create a shared folder that allows you to conveniently transfer files between your primary OS and the VM.  If you installed the VM using Vagrant, then there should already be a shared folder named ``/vagrant/`` mounted on the VM which points to the folder on your primary OS where you installed the VM (i.e., the folder containing the ``Vagrantfile`` you used).  Anything that you copy into ``/vagrant/`` on the VM will show up in this folder.  Likewise, anything you place in the folder where you installed the VM will show up in ``/vagrant/`` on the VM.
> > +
> > +If, instead, you installed the VM using only VirtualBox, you must manually create the shared folder yourself.  First, open Virtualbox and right-click on the VM you created in the pane on the left-hand side of the window.  Select "Settings".
> > +
> > +.. image:: ./img/createsharedfolder1.png
> > +
> > +Within the "Settings" menu, click on "Shared Folders".  You'll see an empty list, but a button to the right which allows you to create a new shared folder.
> > +
> > +.. image:: ./img/createsharedfolder2.png
> > +
> > +In the menu that pops up, go to "Folder Path" and select a folder on your primary OS where you'd like to share files with the VM (in this example, I've used ``/home/user/Desktop/My_OpenKIM_VM/``.  Next, select a directory on the VM where you'd like to share files with your primary OS (I chose to name this ``/My_OpenKIM_VM/``).  For convenience, you'll want to check "Auto Mount" and "Make Permanent" so that the shared folder is always available when you boot the VM.
>
> I left the second field blank (where you put /My_OpenKIM_VM/) and it 
> automatically filled it out without the slash with the base name of 
> the folder (My_OpenKIM_VM). After rebooting, the mount appeared at 
> /media/sf_{stub} where {stub} is the item that was in the second 
> field. It is mounted as root and requires sudo to read and write to.
>
> Make sure you install the virtualbox guest additions before you do 
> these steps and reboot for auto mount.
>
> —
> Reply to this email directly or view it on GitHub 
> <https://github.com/openkim/openkim-pipeline/pull/7/files#r16026348>.
>

-- 
______________________________________

Daniel S. Karls, Ph.D. Candidate

Aerospace Engineering & Mechanics
University of Minnesota
107 Akerman Hall, 110 Union St SE
Minneapolis, MN 55455
______________________________________