| 1 | This page documents the process of creating and using a virtual machine for GPO-led tutorials at GEC 11. |
| 2 | |
| 3 | = Using the VM = |
| 4 | 1. Download the VM as an OVA archive from http://www.gpolab.bbn.com/internal/userdir/tmitchel/gec11-2.ova. [[BR]] |
| 5 | ''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.'' |
| 6 | 1. Import the VM into your Virtual Machine software ([http://www.virtualbox.org/ VirtualBox], VMWare, Parallels, etc.) |
| 7 | 1. Boot the VM |
| 8 | 1. Log in to the VM as "GENI User" with password "geni" (without the quotes) |
| 9 | 1. Run the sample clearinghouse: |
| 10 | 1. Launch a terminal window (Applications->Accessories->Terminal) |
| 11 | 1. Type the following command: |
| 12 | {{{ |
| 13 | gcf-ch.py -f gcf.ini |
| 14 | }}} |
| 15 | 1. Run the sample aggregate manager: |
| 16 | 1. Launch a terminal window (Applications->Accessories->Terminal) |
| 17 | 1. Type the following command: |
| 18 | {{{ |
| 19 | gcf-am.py -f gcf.ini |
| 20 | }}} |
| 21 | 1. Run a few omni commands: |
| 22 | 1. Launch a terminal window (Applications->Accessories->Terminal) |
| 23 | 1. Type the following command: |
| 24 | {{{ |
| 25 | omni.py -c omni.ini getversion |
| 26 | }}} |
| 27 | You will see version information from the sample aggregate manager. |
| 28 | 1. Type the following command: |
| 29 | {{{ |
| 30 | omni.py -c omni.ini listresources |
| 31 | }}} |
| 32 | You will see the advertisement RSpec from the sample aggregate manager. |
| 33 | 1. Close all three terminal windows by typing Ctrl-C followed by Ctrl-D |
| 34 | = Creating the VM = |
| 35 | 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. |
| 36 | 1. Rename the Virtual Machine if necessary to the name you want importers to see: |
| 37 | 1. Select the Virtual Machine |
| 38 | 1. Choose the General Setting (right hand panel) |
| 39 | 1. Change the name. For instance, I changed the name {{{gec11}}} to {{{gec11-2}}} to export version 2 of my gec11 virtual machine |
| 40 | 1. Select File->"Export Appliance..." |
| 41 | 1. In the Appliance Export Wizard choose the virtual machine and click "Continue" |
| 42 | 1. Confirm the export location or choose another location. Be sure to select the file extension ".ova" so that a self-contained archive is produced. |
| 43 | 1. Verify that the name of the exported VM matches your expectations on the Appliance Export Settings screen |
| 44 | 1. Optionally change some export settings (I chose not to) |
| 45 | 1. Select Done. The export process takes a few minutes. |
| 46 | 1. If you renamed the virtual machine prior to export, change it back at this time |
| 47 | == Additional Notes == |
| 48 | * If this is a Linux VM, you may want to delete the command history. You can do this using the following two commands: |
| 49 | {{{ |
| 50 | # Tell bash not to store history |
| 51 | unset HISTFILE |
| 52 | |
| 53 | # Clear the command history |
| 54 | history -c |
| 55 | }}} |