wiki:GEMINI/Tutorial/GEC19/GENI_Desktop_and_GEMINI_instrumentize/ExecuteExperiment

Version 22 (modified by Hussamuddin Nasir, 6 years ago) (diff)

--

Navigation: Up

Accessing Slices: Start using the GENI Desktop (login, initialize, instrumentize)

To login to the GENI Desktop

Open a browser (Preferably Firefox) Go to https://genidesktop.netlab.uky.edu and follow the arrows to walk though the login process.


Now type in your passphrase you set when creating your ssh key pair at the GENI Portal when your account was created.

Click on the button shown below to continue



Choose Project

If you are a member of multiple projects, there will be an option to choose which project slices you want to initially view. Choose from the drop down menu. Choose "All" to see all of your projects. "None" is a legacy choice for slices not created with a project. You may change your choice at any time using the drop down.

Initialize Slice

What does Initialize mean ?

In order to use the basic functionality of the GeniDesktop, it is required to install and configure some slice, sliver and user information onto the Global Node (added by you to your slice on slice creation ). The following things happen during this operation

  • Software like webserver, MySQL Server,etc are installed on the Global Node.
  • SSH keys are generated dynamically on the Global Node. The public key is then installed on all the other nodes in your slice.
  • A software called Shellinabox is installed on the Global Node and is used as a proxy to provide web-based SSH to all experimental nodes in your slice.
  • Authentication/Authorization setup is performed in order to access the the above mentioned services.

what does this do for my slice ?

As you will see later in this session, you will now be able to use a web-console based terminal to connect to your experimental nodes just by clicking on a node in the topology diagram and a few clicks on a button. You will also be able to copy files to your nodes and the ability to run commands on your nodes simultaneouly using the web based tools provided by the GeniDesktop.

So What do I do now ?

Under the header "Next Action" there will be a button that will perform the next logical step for the slice. Once the resources are allocated, you can initialize the slice. The Next Action button will say "Initialize". Click it to start the Genidesktop Initialization process for that slice

Initialization of the slice is in progress

Instrument your Slice

What does Instrumentize mean ?

Once you have your experiment running, you may want to collect statistics (system/network). The statistics may be collected using active probing of your slice or you may just want to collect data passively from the nodes. Active Tests can include bandwidth measurement tests, Round trip time and many others. These measurements are taken by actively sending traffic on the nodes and link in your slice. Passive measurements may include, monitoring the traffic flow on links/nodes, system statistics like CPU and Memory monitoring, monitoring of system processes, IP tables and routes where in no data is actually sent through your nodes/link. All data collected is from the activity being performed by you or the Testbed on your nodes. For this to happen, we utilize the GEMINI I&M system which is installed, configured and setup for you during this phase. This involves installing a lot of software on your nodes including the global node. This operation can take quite a considerable amount of time depending on which Disk Image is loaded on your nodes. If using a GEMINI enabled Disk Image listed at this page, this phase should complete within 10 minutes. IF you use your own Disk Image on the nodes in your slice which is also supported by GEMINI, this phase may take about 30 minutes or sooner.

what does this do to my slice ?

Once instrumentized, you can use the full capability of the GeniDesktop. This includes viewing network and system graphs, tabular data collected from your nodes, reconfigure the data you want collected and displayed. You also now have the ability to archive your data to your Irods account created at the GeniPortal. Once instrumentized, there will be additional data collection routines and daemons running on your nodes. The addition system and memory load should be minimal though and should not affect the performance of your nodes. You should also be able to use features you had when you initialized your slice.

So What do I do now ?

There are two ways to perform this operation

Alternative 1

Click the button pointed by the arrow to begin Instrumenting your slices using GEMINI







Once the process is completed you may click the button to go on to the GeniDesktop

Alternative 2

View Slice In The GENI Desktop

Click on the slice name to open the slice in the GENI Desktop.

Click the button pointed by the arrow to begin Instrumenting your slices using GEMINI

A progress window will open to show the status of the intstrumentation process.

http://www.protogeni.net/wiki/starting_instrumentation.png

Once the process is completed click the button to reload the page with the instrumentized slice. You may also review the output from the instrumentation process.

http://www.protogeni.net/wiki/instrumentation_finished_arrow.png