== GEMINI Portal == The GEMINI Portal allows you to easily visualize and monitor a slice. The portal can be accessed at [https://geminiportal.netlab.uky.edu/ https://geminiportal.netlab.uky.edu/]. === Log On === Log on using the information given on the handout. [[Image(gemini_portal_logon.png)]] === Overview === [[Image(initial_slice_view.png, 600)]] The initial overview contains a geographic map with the slice's nodes represented by terminal icons[[Image(terminal_icon.png)]]. The global node, or measurement controller is labeled with an MC icon [[Image(mc_icon.png)]]. To the right is a control group that lists the slice's name along with the following controls. [[Image(gemini_portal_control_panel.png)]] Logout - logs the user out Archive - takes you to the archiving page Overview - centers and displays entire slice Collapse All/Expand All - shows all the nodes at their actual locations/adjusts nodes so that they are all visible VM-1...GN - centers the map on the labeled node = INSTOOLS Portal = [[Image(portal_overview.jpg, link=)]] == What is it? == The [https://portal.uky.emulab.net/ INSTOOLS Portal] gives a graphical overview of an experiment and quick access to each node's measurements. Through the Portal you can: * see the experiment's topology * display measurement graphs for a node or link, updated in real time * access each node's Live View web page * access each node via VNC * create an Archive point * access Archived points == Quick Start == Use the [http://protogeni.net/flack.html FLACK] client to instrumentize your slice by pressing the "Instrumentize" button. Once the slice is instrumentized, press the "Go to Portal" button. You will automatically be redirected to and logged in to the portal. ----- T * The Experiment's Slice must have been [wiki:Instrumentize instrumentized] using [wiki:InstrumentationTools INSTOOLS]. * Go to the [https://portal.uky.emulab.net/ Portal], https://portal.uky.emulab.net/ . Please accept our self-signed certificate. [[Image(log_on.png)]] * Enter your slice information into the log on form. * '''User Name''' used to create the slice. * '''Certificate Issuer''' the certificate issuer (clearinghouse) associated with your '''User Name'''. * '''Slice Name''' name of slice to be shown. * '''Password''' password given when slice was instrumentized. * Click '''Map Slice''' button to see the mapped layout of the slice topology. ---- == INSTOOLS Portal Interface == The Portal uses [http://maps.google.com/ Google Maps] to display the network topology for the given slice. The main map components are: * '''Machine node''' displayed at it's geographical location. [[Image(terminal_purple.png)]] * '''Measurement Controller''' (MC) displayed at it's geographical location. [[Image(mc.png)]] * '''Links''' are displayed as lines connecting the nodes. [[Image(link_line.png)]] * '''Menu''' displayed on the right along with Zoom and Centering controls for each machine node and MC. [[Image(menu.png)]] * Chosen '''Graphs''' will be displayed on the left. These are updated every 5 seconds. Mouse over them to enlarge. [[Image(sample_graph.png)]] === Available Actions === ==== Menu Controls ==== [[Image(menu.png)]] * Top item is the '''Slice Name'''. * '''Logout''' to logout of the portal. * '''Make Archive''' displays the control to create an Archive point. * '''View Archive''' brings up the Instrumentation Tools Archive Site. * '''Overview''' resizes map to show all nodes. * '''Collapse All''' or '''Expand All''' expands or collapses nodes that are in the same geographic location. Expanded nodes are relocated so that they are all visible instead of collocated. * '''Node Name''' Each node is listed. Click on the magnifying glass to zoom in and center the node. Click on the name to just center the node on the screen. || ==== Control forms ==== Clicking on a Machine Node, MC or Link line brings up a Control form * '''Machine Node''' [[Image(machine_control_checked.png)]] * Link to the node's Live View page ('''All Graphs'''). * Link to the node's VNC for access to the machine's Desktop ('''VNC'''). * A list of check boxes for showing the node's graphs. Checked graphs are shown to the left. * '''MC''' * Link to the MC's [wiki:INSTOOLSInterface INSTOOLS Live View]('''Main Page''') * '''Link''' * A list of check boxes for showing the link's graphs. Checked graphs are shown to the left. ==== Graphs ==== [[Image(sample_graph.png)]] To add a graph, open the control form for the node or link by clicking on it. Select the check boxes and the corresponding graphs will be shown on the left of the page. Mouseover a graph to enlarge it. Click on a graph to bring up its control form. Double click a graph to open it into its own window. == Passive Measurements == The set of passive measurements being collected include === Graphs === ''For each Node'' * CPU Utilization * Memory Utilization * UDP Traffic * TCP Traffic * ICMP Traffic * IP Traffic * Total Traffic ''For each Link Interface'' * Link packets count * Link Octet count === 7.2 Tables === * Routing Table * ARP Table * Interface Address Table * TCP Connections Table * UDP Listeners Table * Kernel Modules Table * Process List Table|| These tables and graphs are collected live and refreshed every 5 seconds and can be accessed using the geminiportal site as shown in the screenshots below. [[Image(s7.2.png,50%,border=1)]] [[Image(down-arrow.png)]] [[Image(s8.png,50%,border=1)]] [[Image(down-arrow.png)]] [[Image(s11.png,50%,border=1)]] [[BR]] [[BR]] === 7.3 Reconfigure Passive Data Collection and Display === The data collection and display of these graphs and tables can be reconfigured as per your requirement by accessing the config page from the Global Node which is linked from the GEMINIportal. [[Image(s12.png,50%,border=1)]] [[Image(down-arrow.png)]] [[Image(s13.png,border=1)]] As shown in the screenshots above, select/deselect the options according to your requirement and click ''Apply Configuration'' at the bottom of the page. Please wait for the reconfiguration to complete and the page stops loading. Then ''Refresh/Reload'' the Main Graph display page in your browser to view the changes. [[BR]] [[BR]] [[BR]]