Department of Electrical Engineering and Computer Science



COSC 594 Fundamentals of Digital Archaeology

Virtual Machine Contents

This article describes how to set up the Ubuntu 14.4 virtual machine for Computer Science 494/594 - Fundamentals of Digital Archaeology on Microsoft Windows or Mac OS X hosts. If you are running Linux, you can install the required software:
 
  • Python 2.7.x and the following modules:
    • apiclient
    • BeautifulSoup
    • csv
    • datetime
    • email
    • envoy
    • facebook
    • feedparser
    • geopy
    • httplib
    • io
    • json
    • mailbox
    • multiprocessing
    • networkx
    • nltk
    • numpy
    • oauth
    • oauth2
    • os
    • pandas
    • prettytable
    • PyGithub
    • pymongo
    • quopri
    • random
    • re
    • requests
    • sys
    • time
    • twitter
    • urllib
  • Ipython 
  • The 'R' language including R-Kernel
  • Java Boilerpipe and its Python interface
  • MathJax

Set Up VirtualBox and VM

These instructions assume that you do not currently have VirtualBox installed on your system. If you are a current VirtualBox user, you may need to tweak your network settings to make this VM work properly. You will need at least 10GB of disk space.

  1. If you are installing this VM on a PC computer, you may have to enable "Virtualization Support" in your system's BIOS or UEFI System Settings. This may also be referred to as "Intel VT-x" and is often disabled on laptop computers. Other names for this setting include "Intel Virtualization Technology," "Virtualization Extensions," and "Vanderpool." Please refer to your computer manufacturer's instructions.
  2. Download latest VirtualBox for your OS 
  3. Download Virtual Box Oracle VM VirtualBox Extension Pack 
  4. Install VirtualBox and follow the on-screen prompts. Defaults are OK.
  5. Run VirtualBox and select “Preferences” from the File (Windows) or VirtualBox (OS X) menu, select “Extensions” and add the previously downloaded Extension Pack.
  6. Download the OVA virtual appliance file (3.8GB).
    MD5 Sum: 1ff5f6a041d9e23e3532e3303e00948d
  7. Select “Import Appliance” from the File menu and select the previously downloaded OVA file.
  8. Accept the imported appliance settings (you can increate the RAM if you have a lot of memory available). Be sure to leave “Reinitialize the MAC address of all network cards” unselected.

  9. Start the Virtual Machine. On Windows version of VirtualBox, you may receive the following error:vbox_error.png
    This is caused by Mac OS (where the VM was created) and Windows versions of VirtualBox have different name for the host-only networks. Simply click the "Change Network Settings" button and accept the settings.

  10. If you get a similar error on MacOS X, you're missing the host-only network. Open the VirtualBox preferences and select Network. Add a new host-only network. The name should automatically be set to "vboxnet0":
     vboxnet0.png
    The default settings should be ok:
     vboxnet0settings.png
    Restart the VM.

Using the Virtual Machine

Default Username: cosc
Default Password: Fall2014@C594
Host-only IP Address: 192.168.56.2 
 
You can use the virtual machine directly by logging into the Ubuntu graphical user interface. Alternatively, you can use SSH to connect to the running VM from your host operating system. If you wish to use the host OS's web browser to access your iPython Notebook, you will need to forward network port 8888 from the host to the guest OS. You can then start iPython Notebook with the --no-browser option and use the URL: http://localhost:8888 in your host's browser.
 
Your VM should have access to the Internet through your host operating system. If you experience problems, check the VM's network settings and ensure that both network adapters have the "Cable Connected" setting checked:
cable_connected.png

Port Forwarding using Putty (Windows)

  1. Download and install the Putty SSH client.
  2. Select "Tunnels" from the SSH "Category" and forward Source port 8888 to Destination localhost:8888.putty_port_forward.png
  3. Connect to host 192.168.56.2 and log in a user "cosc" with password "Fall2014@C594".
  4. Start iPython Notebook with the --no-browser option, e.g.:

    cosc@cosc594da:~$ ipython notebook --no-browser
    2014-08-10 18:43:30.387 [NotebookApp] Created profile dir: u'/home/cosc/.ipython/profile_default'
    2014-08-10 18:43:30.392 [NotebookApp] Using MathJax from CDN: http://cdn.mathjax.org/mathjax/latest/MathJax.js
    2014-08-10 18:43:30.436 [NotebookApp] Serving notebooks from local directory: /home/cosc
    2014-08-10 18:43:30.437 [NotebookApp] 0 active kernels
    2014-08-10 18:43:30.438 [NotebookApp] The IPython Notebook is running at: http://localhost:8888/
    2014-08-10 18:43:30.439 [NotebookApp] Use Control-C to stop this server and shut down all kernels (twice to skip confirmation). 

  5. Open your host operating system's browser and connect to http://192.168.65.2:putty_browser.png

Port Forwarding using Putty (Mac OS X)

  1. Open the Terminal application (in the Utilities folder).
     
  2. Connect to the virtual machine using ssh, forwarding port 8888. Use username "cosc" and password "Fall2014@C594":
    $ ssh cosc@192.168.56.2 -L 8888:localhost:8888

    cosc@192.168.56.2's password:
    Welcome to Ubuntu 14.04.1 LTS (GNU/Linux 3.13.0-32-generic x86_64)

    * Documentation: https://help.ubuntu.com/

    Last login: Sun Aug 10 18:43:18 2014 from 192.168.56.1
    cosc@cosc594da:~$

  3. Start iPython Notebook with the --no-browser option, e.g.:
    cosc@cosc594da:~$ ipython notebook --no-browser
    2014-08-10 18:43:30.387 [NotebookApp] Created profile dir: u'/home/cosc/.ipython/profile_default'
    2014-08-10 18:43:30.392 [NotebookApp] Using MathJax from CDN: http://cdn.mathjax.org/mathjax/latest/MathJax.js
    2014-08-10 18:43:30.436 [NotebookApp] Serving notebooks from local directory: /home/cosc
    2014-08-10 18:43:30.437 [NotebookApp] 0 active kernels 
    2014-08-10 18:43:30.438 [NotebookApp] The IPython Notebook is running at: http://localhost:8888/
    2014-08-10 18:43:30.439 [NotebookApp] Use Control-C to stop this server and shut down all kernels (twice to skip confirmation). 
  4. Open your host operating system's browser and connect to http://192.168.65.2:
     osx_forwarded.png

Notes and Troubleshooting

Other Hypervisors

The COSC 594 virtual machine was designed to run under the VirtualBox Hypervisor. However, it is possible to run this VM using other virtualization software such as VMWare Player, Workstation, or Fusion, Parallels Desktop, or even Linux KVM. However, the VirtualBox Guest additions are loaded in this VM and you may need to uninstall them if you experience problems. Please see the VirtualBox manual for more information. You will also need to re-configure your VM's networking interfaces to suit your current configuration.
 

Error in "supR3HardenedWinReSpawn"

Certain versions of Microsoft Windows in combination with some Antivirus software may cause VirtualBox to display an error similar to the one shown below:
VBError.png
This is a known issue with the most recent version (4.3.14) of VirtualBox. The workaround is to uninstall version 4.3.14 and download/install the previous version of VirtualBox (4.3.12). The developers are working on a fix for version 4.3.15.
 

 

The University of Tennessee, Knoxville. Big Orange. Big Ideas.

Knoxville, Tennessee 37996 | 865-974-1000
The flagship campus of the University of Tennessee System