Changes between Initial Version and Version 1 of GEMINI/Tutorial/GEC20/GENI_Desktop_and_GEMINI_instrumentize/ExecuteExperiment


Ignore:
Timestamp:
06/03/14 15:11:12 (7 years ago)
Author:
Jeanne Ohren
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • GEMINI/Tutorial/GEC20/GENI_Desktop_and_GEMINI_instrumentize/ExecuteExperiment

    v1 v1  
     1[[PageOutline]]
     2
     3Navigation: [wiki:GEMINI/Tutorial/GEC19/GENI_Desktop_and_GEMINI_instrumentize Up]
     4
     5{{{
     6#!html
     7<h1> <font color="Blue">Accessing Slices:</font> Start using the GENI Desktop (login, initialize, instrumentize) </h1>
     8}}}
     9
     10
     11== To login to the GENI Desktop ==
     12
     13Open a browser (Preferably Firefox)
     14Go to https://genidesktop.netlab.uky.edu and follow the arrows to walk though the login process.
     15
     16    [[Image(wiki:GEMINI/Tutorial/Images:gec17_Slide1.png)]]
     17
     18    [[Image(wiki:GEMINI/Tutorial/Images:gec17_Slide2.png)]]
     19
     20[[BR]]
     21
     22Now type in your passphrase you set when creating your ssh key pair at the [http://portal.geni.net GENI Portal] when your account was created.
     23
     24    [[Image(wiki:GEMINI/Tutorial/Images:gec17_Slide1.2.png)]]
     25
     26Click on the button shown below to continue
     27
     28    [[Image(wiki:GEMINI/Tutorial/Images:gec17_Slide1.3.png)]]
     29
     30[[BR]][[BR]]
     31
     32== Choose Project ==
     33If 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.
     34
     35
     36    [[Image(wiki:GEMINI/Tutorial/Images:select_project_init_gec18.png)]]
     37 
     38[[BR]][[BR]][[BR]]
     39
     40== The GENI Desktop Slice List Page ==
     41
     42Once you are logged into the GENI Desktop, you will be presented with the "Slice List" page as shown below.
     43
     44
     45    [[Image(wiki:GEMINI/Tutorial/Images:gec_has_init_button_arrow.png)]]
     46
     47The slice list page provides a list of all your slices.  It allows you to create new slices and to work with your existing slices.
     48Each line lists the name of the slice, a description of the RSPEC (if available), the number of Aggregate Managers (AMs) used by the slice,
     49whether the slice has resources (slivers) allocated to the slice, whether the slice lifetime should be automatically renewed by the GENI Desktop,
     50the slice's expiration date/time, and the next action to take on this slice. 
     51
     52In this exercise, we assume you have already created a slice and allocated slivers (resources) to the slice resulting in a
     53slice line like that shown above.  At this point your next step is to "Initialize" the slice for use in the GENI Desktop.
     54
     55== Initializing a Slice ==
     56
     57=== What does Initialize mean? ===
     58  In order to use the basic functionality of the !GeniDesktop, the !GeniDesktop must install and configure the Global Node (GN) -- which you added at slice creation time.  In particular, it must:
     59    * Install and configure software on the GN  such as the apache webserver, a mysql server, a content management system, etc.
     60    * Generate ssh keys dynamically on the Global Node, and then distribute the public key to the other nodes in the slice so that they can be controlled/monitored by the GN.
     61    * Install software called [https://code.google.com/p/shellinabox/ Shellinabox] on the Global Node which is used as a proxy to provide web-based ssh access to all other nodes in your slice.
     62    * Setup the necessary authentication/authorization in order to access the the above-mentioned services.
     63
     64=== Why is Initialize Needed? ===
     65  As you will see later in this session, once the slice is initialized, you will be able to use a web-based terminal to connect to your nodes just by clicking on a node in the topology diagram. You will also be able to copy files to your nodes and will have the ability to run commands on all the nodes (or a subset of nodes) in your topology at the same time.
     66
     67=== So What do I do next? ===
     68
     69Under 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
     70
     71
     72    [[Image(wiki:GEMINI/Tutorial/Images:gec_has_init_button_arrow.png)]]
     73
     74Initialization of the slice is in progress
     75
     76    [[Image(wiki:GEMINI/Tutorial/Images:initializing.png)]]
     77
     78
     79== Instrument your Slice ==
     80
     81=== What does Instrumentize mean ? ===
     82  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 [http://groups.geni.net/geni/wiki/GEMINIv3 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 [http://groups.geni.net/geni/wiki/GEMINIv3#GEMINIGlobalNodeImages 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.
     83
     84=== Why is Instrumentize Needed? ===
     85  Once instrumentized, you can use the full capability of the !GeniDesktop. This includes viewing network and system graphs, tabular data collected from your nodes, and reconfiguring 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 additional 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.
     86
     87=== So What do I do now ? ===
     88
     89There are two ways to perform this operation
     90
     91==== Alternative 1 ====
     92
     93Click the button pointed by the arrow to begin Instrumenting your slices using GEMINI
     94
     95    [[Image(wiki:GEMINI/Tutorial/Images:begin_instrumentize_alt1.png, 95%)]][[BR]][[BR]]
     96    [[Image(wiki:GEMINI/Tutorial/Images:instrumentizing_alt1.png, 95%)]][[BR]][[BR]]
     97    [[Image(wiki:GEMINI/Tutorial/Images:instrumentized_alt1.png, 95%)]][[BR]][[BR]]
     98
     99Once the process is completed you may click the button to go on to the !GeniDesktop.
     100
     101You should see a pop up tab/window  in your browser before you were taken to the Genidesktop page. All services run on the Global Node under apache's web server that runs using a self-signed certificate. This has to be accepted by you when presented in the browser. [[br]]
     102
     103||    In Google Chrome    ||
     104||   [[Image(wiki:GD:cert_accept_chrome.png,25%)]]     ||
     105[[BR]]
     106||   In Mozilla Firefox    ||
     107||   [[Image(wiki:GD:cert_accept_firefox.png,25%)]]   ||
     108
     109You may see multiple pages like these , one from each Global Node (or GN Node) if your slice has nodes from multiple aggregates (AM) . You have to accept each one of them (Self signed cert pages).
     110If you missed or cannot see the pages to accept the Self Signed certificate messages, close the tab or window that has the genidesktop webpage and launch the page again. Make sure to watch for it this time.   [[BR]][[BR]][[BR]]
     111
     112==== Alternative 2 ====
     113
     114    ===== View Slice In The GENI Desktop =====
     115
     116Click on the slice name to open the slice in the GENI Desktop.
     117
     118You should see a pop up tab/window  in your browser before you were taken to the Genidesktop page. All services run on the Global Node under apache's web server that runs using a self-signed certificate. This has to be accepted by you when presented in the browser. [[br]]
     119
     120||    In Google Chrome    ||
     121||   [[Image(wiki:GD:cert_accept_chrome.png,25%)]]     ||
     122[[BR]]
     123||   In Mozilla Firefox    ||
     124||   [[Image(wiki:GD:cert_accept_firefox.png,25%)]]   ||
     125
     126You may see multiple pages like these , one from each Global Node (or GN Node) if your slice has nodes from multiple aggregates (AM) . You have to accept each one of them (Self signed cert pages).
     127If you missed or cannot see the pages to accept the Self Signed
     128
     129
     130    [[Image(wiki:GEMINI/Tutorial/Images:initialized_arrow.png)]]
     131
     132
     133
     134Click the button pointed by the arrow to begin Instrumenting your slices using GEMINI
     135
     136    [[Image(wiki:GEMINI/Tutorial/Images:gec17_Slide6.png)]]
     137
     138A progress window will open to show the status of the intstrumentation process.
     139
     140
     141    [[Image(http://www.protogeni.net/wiki/starting_instrumentation.png)]]
     142
     143
     144Once 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.
     145
     146    [[Image(http://www.protogeni.net/wiki/instrumentation_finished_arrow.png)]]