User Tools

Site Tools


vm_documentation

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
vm_documentation [2015/09/08 22:25]
efernan
vm_documentation [2016/09/06 14:19] (current)
aytonb [VM Installation]
Line 3: Line 3:
 ===== VM Installation ===== ===== VM Installation =====
  
-  - [[https://​www.virtualbox.org/​ | Install Virtual Box]] (use the latest version, 5.04+  - [[https://​www.virtualbox.org/​ | Install Virtual Box]] (use the latest version) 
-  - Download the .ova virtual machine to your computer ([[https://​www.dropbox.com/​s/​xhxjyzk5s03gz4w/​16.410-Fall-2015-Student-VM.ova?​dl=0|link]])+  - 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)   - 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 +  - 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+  - Start the VM (double click the VM in Virtual Box)   
-  - Install the "Guest Additions"​ in the VM (this will get you clipboard sharing between your OS and the VM and other nice things) +  - Update the 16.410 configuration ([[vm_documentation#​Update_the_16.410_VM|here]])
-    - 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+
-  - Update the 16.410 configuration ([[vm_documentation#​Update_16.410_configuration|here]])+
  
 ===== VM User access ===== ===== VM User access =====
Line 24: Line 17:
 </​code>​ </​code>​
  
-===== Update 16.410 ​configuration ​=====+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). 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).
Line 31: Line 25:
  
 <​code>​ <​code>​
 +sudo apt-get update
 sudo update_intro_to_autonomy sudo update_intro_to_autonomy
 </​code>​ </​code>​
Line 66: Line 61:
  
  
 +===== 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)
vm_documentation.1441765549.txt.gz · Last modified: 2015/09/08 22:25 by efernan