This page documents the process of creating and using a virtual machine for GPO-led tutorials at GEC 11.

Using the VM

1. Download the VM as an OVA archive from ​http://www.gpolab.bbn.com/internal/userdir/tmitchel/gec11-2.ova.
   Note: Higher versions are newer. gec11-2.ova is newer than gec11-1.ova. If you see a higher version number, use that VM instead.
2. Import the VM into your Virtual Machine software (​VirtualBox, VMWare, Parallels, etc.)
3. Boot the VM
4. Log in to the VM as "GENI User" with password "geni" (without the quotes)
5. Run the sample clearinghouse:
   1. Launch a terminal window (Applications->Accessories->Terminal)
   2. Type the following command:

      gcf-ch.py -f gcf.ini
      

6. Run the sample aggregate manager:
   1. Launch a terminal window (Applications->Accessories->Terminal)
   2. Type the following command:

      gcf-am.py -f gcf.ini
      

7. Run a few omni commands:
   1. Launch a terminal window (Applications->Accessories->Terminal)
   2. Type the following command:

      omni.py -c omni.ini getversion
      

      You will see version information from the sample aggregate manager.
   3. Type the following command:

      omni.py -c omni.ini listresources
      

      You will see the advertisement RSpec from the sample aggregate manager.
8. Close all three terminal windows by typing Ctrl-C followed by Ctrl-D

Creating the VM

1. Use VirtualBox to create and configure a Virtual Machine. When the machine is configured, shut it down. It should now show as Powered Off in the VirtualBox Manager.
2. Rename the Virtual Machine if necessary to the name you want importers to see:
   1. Select the Virtual Machine
   2. Choose the General Setting (right hand panel)
   3. Change the name. For instance, I changed the name gec11 to gec11-2 to export version 2 of my gec11 virtual machine
3. Select File->"Export Appliance..."
4. In the Appliance Export Wizard choose the virtual machine and click "Continue"
5. Confirm the export location or choose another location. Be sure to select the file extension ".ova" so that a self-contained archive is produced.
6. Verify that the name of the exported VM matches your expectations on the Appliance Export Settings screen
7. Optionally change some export settings (I chose not to)
8. Select Done. The export process takes a few minutes.
9. If you renamed the virtual machine prior to export, change it back at this time

Additional Notes

• If this is a Linux VM, you may want to delete the command history. You can do this using the following two commands:

  # Tell bash not to store history
  unset HISTFILE
  
  # Clear the command history
  history -c