.. _vm-install: **************************************** Download And Install The Virtual Machine **************************************** .. _the-vm: The Virtual Machine ====================== A Virtual Machine is basically a whole computer that runs inside your computer and shares it's resources. For instance, you could be running windows on a Virtual Machine that is running in MacOS that is on your actual computer. We'll be installing a Virtual Machine that has Linux Mint that can run on whatever system you happen to currently be running. This Virtual Machine already has all of the software and modules that you'll need for the class. .. _download-virtual-box: Get Virtual Box ------------------ You must first download the Virtual Box environment from: `https://www.virtualbox.org/wiki/Downloads `_ On this page, click on the Downloads link and then choose the version appropriate for your laptop. Make sure you download and install both the **Virtual Box platform package** and the **Virtual Box Extension Pack** (same one for all kinds of laptops). You must first install the Virtual Box and start it. Then, double click on the extension pack to install it. After installation, you can remove the downloaded files. .. _download-vm: Get The Virtual Machine ------------------------ Download either the full (2.5GB) or the min (2.0GB) VM (the full just has the OS up-to-date. Both have identical python environments.) from https://copy.com/7OruieFgU3c6 Open Virtual Box, click the ``file`` menu and then click ``import appliance``. Navigate to where you saved the .ova file and start the process of loading the virtual machine. Accept all requests for default settings. Now, right click on mint in the left-hand side panel and enable PAE mode in settings. .. image:: ../../_static/python_environment/enable.PNG Once this has loaded, inside of Virtual Box, double-click on the **mint** machine to get it started. It may take a view moments. Eventually, it will ask you for a user name and password. Click on the *CS1100* user. The password is *python*. .. _poke-around: Poke Around ------------ Now it'll be a good idea to just poke around. The environment is not entirely dissimilar to windows, so you should be able to find your way around. Everything that you'll need for the class has already been installed, but you should try to use it all anyway. * Register and set up your Dropbox account. * Open Wing IDE, type **print "hello world!"** and hit the green *play* button. * Also: * Download the `Test File <../_static/python_environment/csci1100-python-modules-test.py>`_ * Open it in Wing IDE * Push the green *play* button * Look for error messages in the text output area. We've already tested the python installation on the VM, so this should be fine. * Open Firefox and watch a youtube video about the mimic octopus to test your internet connection in the VM. * Enjoy.