[[PageOutline(1-2)]]

= CHK-003 GENI Network Stitching Checks =

This procedure defines how GENI Network Stitching status can be verified. Checks to be verified include:
  - Status of the Stitching Computation Service (SCS)
  - Status of the GENI Stitching Sites 

= 1.0 GENI SCS Check =

== 1.1 Goals of SCS Check ==

The SCS is a service that provides stitching path information for known sites.  This section defines to verify that the SCS is up and providing path information for the known stitching sites. All information used is found in the [http://genimon.uky.edu/ GENI Monitoring System] and available via alerts to [http://tamassos.gpolab.bbn.com/nagios3/ GPO Nagios System]. Checks are run for:
 * scs-geni - The Internet2 Production SCS server 
 * scs-geni-test - The Test SCS which is used for testing purposed by GPO, InstaGENI, CloudLab and iMind teams.

== 1.2 Steps for SCS Check ==

 1. Login to [http://tamassos.gpolab.bbn.com/nagios3/ GPO Nagios System]
 2. Select `Service Groups->Summary` in the left hand navigation bar.
 3. Look for `GENI Stitching Computation Services`, and  select the `"Host Status Summary"` for the SCS check to see details.
 4. Resulting page shows the SCS systems being monitored. There are currently 2 instances being monitored: Internet2 SCS and the Test SCS at MAX.
 5. Review the Internet2 SCS `scs-geni` status, which can be `UP` or `DOWN`.
 6. Review the Test SCS `scs-geni-test` status, which can be `UP` or `DOWN`.

== 1.3 SCS Check - Pass Criteria ==

If step 5 shows `UP`, than the Production Internet2 SCS check passes.  A value of `UP` means that the SCS service is running and answering a `listaggregates` request. The monitoring system also verifies that the list of aggregates returned includes the expected sites.

If step 6 shows `UP`, than test SCS check passes.  A value of `UP` means that the SCS service is running and answering a `listaggregates` request. The monitoring system also verifies that the list of aggregates returned includes the expected sites.
 
== 1.4 SCS Check - Fail Criteria and Escalation ==

If step 5 shows `DOWN`, than the Production SCS check fails.  A value of `DOWN` means that the SCS system is either not responding or responding with the wrong list of site aggregates.

'''__Escalation:__''' SCS status issues should be escalated to GMOC.


If step 6 shows `DOWN`, than the check fails.  A value of `DOWN` means that the test SCS system is either not responding or responding with the wrong list of site aggregates.

'''__Escalation:__''' Test SCS issues should be escalated to the MAX Development team.

= 2.0 GENI Stitching Sites - Path Check =

== 2.1 Goals of Stitching Sites - Path Check ==

The Stitching Site check verifies that the SCS knows all path combinations between all aggregates that support stitching. This check does no actually verify that the paths are able to exchange traffic over the paths at this time.

== 2.2 Steps for Stitching Sites - Path Check ==

Nagios alerts are available for failed checks of stitching paths. Alerts can be found as follows:

 1. Login to [http://tamassos.gpolab.bbn.com/nagios3/ GPO Nagios System]
 2. Select `Service Groups->Summary` in the left hand navigation bar.
 3. Look for `GENI SCS Path Availability -> Service Status Summary` for the SCS check. This provides an overall status.
 4. Status can be `UP`, `DOWN` or `PENDING`. If some results are `DOWN` or `PENDING`, select each to see the details.

== 2.3 Stitching Sites - Path Check - Pass Criteria ==

If Step 3 shows all results as `UP`, then there are no path checks failing and therefore this check passes and you can skip subsequent step 4.

== 2.4 "Stitching Sites -Path Check - Fail Criteria and Escalation ==

If step 4 shows status as `DOWN` or `PENDING` then check path function failed and issue need to be investigated.

'''__Escalation:__''' SCS path issues should be escalated to GMOC.