Changes between Version 5 and Version 6 of GeniTutorialHints

Timestamp:

10/11/11 12:40:08 (13 years ago)

Author:

Vic Thomas

Comment:

--

GeniTutorialHints

@@ -12 +12 @@
  3. ''Client software on attendee machines.''  If you need special client side software (e.g. GENI experiment control tools) installed on the attendee machines, it might be best to pre-install this software in a virtual machine and distribute this virtual machine for the attendees to run on their computers.  We've very successfully used  [https://www.virtualbox.org/ VirtualBox] for this purpose: All client-side software needed by the attendees is installed in a !VirtualBox virtual machine running an OS such as Ubuntu.  Attendees are asked to come with !VirtualBox installed on their computers.  They can install the virtual machine with tutorial software at the tutorial or ahead of time.  We strongly encourage making the virtual machine image available to attendees ahead of time so valuable class time isn't spent installing the virtual machine image.  Additionally, these virtual machine images tend to be large (many GBs) and so downloading and installing them during the tutorial might stress the network in the classroom.
  4. ''Experimenter credentials.''  Setting up experimenter credentials, creating and installing ssh keys, etc. can be very time consuming.  So, unless an objective of your tutorial is to work through this process, we recommend creating credentials and installing the necessary keys ahead of time.  Some tutorials have created multiple user accounts on the virtual machine and have installed the necessary certificates and keys for each account.  Others have installed multiple sets of credentials in one virtual machine user account and have told each attendees which set of credentials they should be using.
+ 5. ''Dry runs''.  Dry run the tutorial.  If at all possible, do the dry-run with 20+ people in the room so you can identify  resource bottlenecks and concurrency issues.
+ 5. ''Post tutorial material online''.  Make your slides and other material (including experimenter software) available online.
  5. ''Hard copies of presentation material''.  Make a sufficient number of hardcopies of the presentation material available for distribution to all attendees.  Hardcopies are especially helpful for attendees falling behind as they can try to catch up even if the instructions they need are no longer on the projector screen in front of the classroom.  
 
@@ -19 +21 @@
  3. ''Managing bottlenecks.''  Certain steps in the experiment workflow such as slice creation tend to bog down servers such as slice controllers, especially if you have 20+ simultaneous requests to create slices.  Experience has shown it best to divide the class into three groups and stagger the start of the exercises.  For example, group 1 starts by issuing their slice creation requests and group 2 issues their requests after the slices for group 1 are created.  Staggering the exercises also distributes  over time the requests for help from the attendees.
  4. ''We are here.''  At the start of each major step in an exercise, be sure to remind the attendees what they've completed so far and what they'll be doing in the next step.
- 5. ''Continuing experimentation''.  Make sure attendees leave knowing where they can find more information about the material covered in the tutorial and how they can get the accounts and credentials needed to try the exercises on their own after the tutorial.
+ 5. ''Continuing experimentation''.  Make sure attendees leave knowing where they can find more information about the material covered in the tutorial and how they can get the accounts and credentials needed to try the exercises on their own.
  
 
 == After the Tutorial ==
   1. ''Clean up''.  Make sure all slices created during the tutorial have been deleted and all resources freed up.  Any temporary accounts created for the tutorial must be deleted.
-  2. ''Follow up''.  Ensure user guides/documents/examples related to the material covered in the tutorials are up to date.  If possible, publish the material (slides, example programs, etc.) used during the tutorial.
+  2. ''Follow up''.  Ensure user guides/documents/examples related to the material covered in the tutorials are up to date.  If necessary, update the online versions of the presentation and other material used during the tutorial.