====== 16.410/13 Virtual Machine ======

===== VM Installation =====

  - [[https://www.virtualbox.org/ | Install Virtual Box]] (use the latest version)
  - Download the .ova virtual machine to your computer ([[https://www.dropbox.com/s/zosht6ik0k1m1pq/16.410-Fall-2016-Student-VM%20.ova?dl=0|link]])
  - Import the downloaded virtual machine to Virtual Box (double click the downloaded .ova file or select File->Import Appliance in Virtual Box)
  - Accept the recommended appliance settings for CPU, memory etc (or change if you want if you know what you are doing) -- this will take a couple of minutes. If this fail, it probably means that your download was corrupted. Download the VM again and try. You can also check the sha1 sum of the VM (posted above)
  - Start the VM (double click the VM in Virtual Box)  
  - Update the 16.410 configuration ([[vm_documentation#Update_the_16.410_VM|here]])

===== VM User access =====

<code>
User name: student
password: student
</code>

The VM may ask you for the password when you run ''sudo'' commands or when the screensaver kicks in.
===== Update the 16.410 VM =====

The following command updates the data in your 16.410 VM. You will need to do this every time we release new problem sets or when instructed to do so (for example to install new software required for the course).

In the VM, open a terminal (double click the LXTerminal shortcut in the desktop) and run

<code>
sudo apt-get update
sudo update_intro_to_autonomy
</code>

(Note that this will take a while the first time...)

This will install the Python and Jupyter/IPython system (with all required dependencies) and put a shortcut in the desktop (16.410/413 PSets).


===== Using the Jupyter/IPython system in the VM =====

If you have followed all the previous steps, Jupyter/IPython should be running in the background already.

To start using the Jupyter notebook, all you need to do is double click on the "Jupyter Notebook" desktop shortcut (or alternatively, open Firefox and navigate to http://localhost:8888/).

You should see the following:

{{ ::jupyter_file_dir.png?600 |}}

The directories shown there are the ones corresponding to the ''/home/student/jupyter'' folder.

For tips/documentation on how to use the Jupyter/IPython notebook, go [[jupyteripython_documentation|here]] 

===== Restarting Jupyter/IPython if it stops working =====


If, for some reason, Jupyter stops working, you can restart the service by executing the following commands:

<code>
service intro-to-autonomy-ipython-notebook stop
service intro-to-autonomy-ipython-notebook start
</code>

Alternatively, you can just restart the VM.


===== Opening a Python terminal =====

Although we'll be using the Jupyter/IPython notebook for most of our assignments, you may want to open a traditional Python terminal to test things.

Because we are using a ''virtualenv'' for the packages needed for the problem set, you can't just type ''python'' in the terminal to open a Python terminal. That will work, but you won't have access to the preinstalled python packages such as matplotlib, ipython and others.

To open a Python terminal with access to the installed packages, do the following:

  - Open a terminal (double click on the LXTerminal shortcut)
  - Enter the following in the terminal: <code>source /opt/16.410-psets/bin/activate</code>
  - The terminal will now say ''(16.410-psets)student@defiant:~$'', indicating that the virtualenv is loaded
  - You can now open a terminal typing ''python'', however I recommend that you use the enhanced IPython terminal, that provides TAB completion and other nice features. Type ''ipython'' to start the IPython terminal.
  - You should be able to access all the installed packages from that terminal. Try importing the ''matplotlib'' package for example: <code python>import matplotlib</code>




===== Installing the VM Guest Additions =====

The VirtualBox Guest Additions are useful to get things like shared clipboard and folders between the VM and your host OS working properly.

The VM Guest Additions should be already installed and thus, **this step is not required**. However, if you have problems, you can try reinstalling them with the following instructions:

    - With the VM open, click on Devices -> Install Guest Additions CD image (in the Virtual Box menu)
    - Open the new folder that shows up with the terminal
      - Open a terminal window using the "LXTerminal" shortcut in the desktop
      - Navigate to the "Guest Additions" folder: <code> cd /media/student/VBOXADDITIONS_5.0.4_102546 </code> Note that the exact version numbers could be different. Write up up to the first letters of VBOX.. and use TAB to autocomplete.
      - Run the LinuxAdditions program by executing <code>sudo ./VBoxLinuxAdditions.run</code> in the terminal. Remember that the password is 'student'
      - Restart the VM to let changes take effect (VirtualBox Machine->Reset)