[[PageOutline(2-3, Table of Contents)]] = Using Tmix on GENI = This page describes how to run experiments with [wiki:GeniTmix Tmix] on GENI nodes. This tutorial assumes that you are already familiar with basic experimentation with GENI, and that you have access to some version of Linux/Unix running on a PC or virtual machine. We also assume basic familiarity with Linux/Unix. == 1 Reserve Resources in Omni or GENI Portal == Determine whether you wish to use Omni or GENI Portal to reserve GENI resources for this Tutorial. We recommend you use GENI Portal, unless you are experienced with, or wish to gain experience with Omni. Click one of the links below that matches your choice. [wiki:GeniTmixTutorialPortal Reserve Resources using GENI Portal] [wiki:GeniTmixTutorialOmni Reserve Resources using Omni] == 2 Login to nodes == We suggest you now open two new terminal windows, one for each node. To log into the nodes reserved in the previous step issue the following command for each node in one of the new windows. {{{ ssh -i ~/.ssh/geni_key @ }}} As expected, should be replaced with your GENI username, and is replaced with the hostname noted in the previous step. It will take several minutes (likely around 7 minutes) for the requested hosts to be imaged, and fully boot. If you are unable to login keep trying every couple of minutes. == 3 Run Tmix == Now, run the following the following command on both nodes. The script will set up the tmix.conf file correctly and configure the interface. {{{ /usr/tmix/tmix-script.sh }}} You should see some output showing the actions, followed by "Done." Next, Make yourself root and move to the tmix directory by issuing the following commands on both nodes: {{{ sudo -i cd /usr/tmix/tmix }}} Tmix relies upon a pre-determined start time to synchronize tmix on the two noded. On both nodes run the following command to determine the time and date: {{{ date }}} Note that the time may be in a different time zone. Decide on a start time about 1-2 minutes in the future, relative to the time displayed by the date command. It should be far enough in the future for you to issue the following command on both nodes with 30 seconds to spare before that start time. Finally, execute the following command on both nodes: {{{ ./tmix -s HH:MM:SS tmix.conf }}} where HH:MM:SS is the chosen start time in hours minutes and seconds. Tmix on both hosts will load the data files and then wait until the designated start time. You will see Running for 600?? seconds once tmix has started. == 4 Delete Resources == Once your experiment is complete and you have collected your results, you should return the reserved resources. To do so, follow the step below which matches your choice to use GENI Portal or Omni. === 4.1 Using GENI Portal === 1. '''Click on slices''' in the upper right-hand corner. 2. Find your slice in the list, and click on the corresponding '''Delete Resources''' button. 3. Click "Delete Resources" again to confirm that you want to delete all reserved resources. === 4.2 Using Omni === In the terminal execute the following command: {{{ omni.py -a pg-utah deletesliver }}} where is once again replaced with your chosen unique slice name.