wiki:OperationsProcedures/URNRename

Version 11 (modified by lnevers@bbn.com, 7 years ago) (diff)

--

GENI Internet2 Switch URN Renaming

Internet2 plans an effort to migrate from SDN to MPLS in the AL2S backbone. The implementation of MPLS is to be verified by the ability to exchange GENI experiment traffic both via stitching or OpenFlow Over stitching after the upgrade has taken place. (Validation covered in step 7 in the procedure below.)

This effort also includes a task to rename AL2S Switches from sdn-sw to rtsw. The renaming effort impacts: 1) GENI Aggregates, 2) Stitching Computation Services and 3) GENI Monitoring 4) Numerous wiki pages capturing network connectivity details. Thus is the bulk of the effort covered in all sections below.

AL2S Switches

The AL2S renaming effort impacts 26 AL2S switches whose URN is to be changed. Only 9 AL2S switches that are to be renamed have have stitching sites and require updates to GENI Aggregates, GENI Stitching Computation Service and GENI Monitoring. The AL2S switches with GENI Stitching sites connected are:

Old URN New URN
sdn-sw.alba.net.internet2.edu rtsw.alba.net.internet2.edu
sdn-sw.ashb.net.internet2.edu rtsw.ashb.net.internet2.edu
sdn-sw.bato.net.internet2.edu rtsw.bato.net.internet2.edu
sdn-sw.houh.net.internet2.edu rtsw.houh.net.internet2.edu
sdn-sw.jack.net.internet2.edu rtsw.jack.net.internet2.edu
sdn-sw.loui.net.internet2.edu rtsw.loui.net.internet2.edu
sdn-sw.phil.net.internet2.edu rtsw.phil.net.internet2.edu
sdn-sw.pitt.net.internet2.edu rtsw.pitt.net.internet2.edu
sdn-sw.star.net.internet2.edu rtsw.star.net.internet2.edu

GENI Sites

The 9 AL2S switches have 23 GENI aggregates whose advertisement is to be reconfigured (1 AL2S +22 GENI Sites) to pick up the URN name changes. Following are details for the AL2S switches and the GENI sites they support:

AL2S Switch Switch Port GENI Stitching Sites
sdn-sw.star.net.internet2.edu et-1/0/0.0 uchicago-ig, wisconsin-ig, wisc-clab[1], umich-ig
sdn-sw.star.net.internet2.edu et-7/0/0.0 northwestern-ig
sdn-sw.star.net.internet2.edu et-8/0/0.0 savi
sdn-sw.star.net.internet2.edu et-9/0/0.0 illinois-ig
sdn-sw.pitt.net.internet2.edu et-4/0/0.0 psc-eg[1]
sdn-sw.phil.net.internet2.edu et-3/0/0.0 rutgers-ig
sdn-sw.loui.net.internet2.edu et-3/0/0.0 uky-pg, uky-ig, ukypks2-ig, ukymcv-ig
sdn-sw.jack.net.internet2.edu et-4/0/0.0 *[2], unf-eg[1], fiu-eg[1], ufl-eg[1]
sdn-sw.houh.net.internet2.edu et-0/3/0.0 tamu-eg, [1], uh-campus
sdn-sw.alba.net.internet2.edu xe-5/2/2.0 uvm-ig
sdn-sw.ashb.net.internet2.edu et-3/0/0.0 vt-ig
sdn-sw.bato.net.internet2.edu et-8/0/0.0 ullafayette-ig

[1] Test SCS only. All other sites apply to both Test and Production SCS.
[2] Not sure how this stitching endpoint is used or how to test.

Remember!!! Each AL2S Switch renaming impacts the AL2S Aggregate which advertises the network topology and must always capture the correct naming for each switch in the network.

URN Renaming Procedure

This procedure assumes the following:

  • Sites will be migrates in batches to streamline effort and allow for efficiency.
  • A common chat tool/live messaging is used to coordinate effort when sites are transitioned to the new URN
  • Representatives for the impacted aggregates and for both Test and Production SCS are available for transition.
  • URN Name transition will be planned while considering upcoming events.

Following is the procedure to be followed when the URN renaming takes place.

1. Generate GMOC Ticket

GMOC tickets must be generated capturing:

  • Date and duration of the URN change activity
  • Impacted to GENI sites. Scheduling

2. Review Affected Stitching Endpoint and coordinate start time

Before URN renaming takes place, collect Aggregate Advertisement for all Aggregates impacted by the planned update: $omni listresources -a $aggr -o

To determine which GENI sites are impacted by a switch name change, refer to the GENI Sites section above. Note the output advertisements are used for comparisons after the upgrade to ensure that the expected changes are made and that no information is added or deleted unexpectedly.

Schedule details for chat participation, identify participants and define details for expected stitching details.

3. Update Advertisement

Once the switch name change takes place and captured in ticket activity, the aggregate teams can proceed to make required changes:

  1. AL2S Aggregate changes Stitching definition in Advertisement using the new switch name and updated stitching section.
  2. Site Aggregate changes Stitching definition in Advertisement for IG, EG, or CLab site to reflect AL2S definitions.
  3. Notify team chat of completion of this step.

4. GPO Validates Advertisements

Once Advertisement updates are completed, GPO will validate:

  1. Content of Advertisement RSPec for AL2S. Verify both switch and stitching definitions.
  2. Content of Advertisement RSPec(s) for GENI site(s).
  3. Notify team chat of completion of this step

5. Stitching Computation Service Picks up changes

Once Advertisement updates are validated, the SCS owners can proceed to make the required changes:

  1. Production and/or Test SCS pick up new advertisements change for the AL2S and the GENI sites identified in ticket.
  2. As each is completed, the responsible will notify team chat of completion of this step.

6. Updates for Monitoring

Once SCS has picked for the Sites and AL2S, GPO will:

  1. Request that VLAN Delegation repository be updated to capture changes. Delegation file is used by Monitoring to identify stitching links.
  2. Notify GENI Monitoring folks to pick up updated delegation from previous step.

7. Validate URN changes and document update

Once SCS has picked for the Sites and AL2S, GPO will validate the following:

  1. Request stitching topology using updated sites from Production SCS, if applicable.
  2. Request stitching topology using updated sites from Test SCS, if applicable.
  3. Exchange traffic over stitched topology using updated devices.
  4. Request stitching OpenFlow topology and exchange traffic between endpoints.
  5. Review monitoring to verify that URN is properly captured and that metrics are available for stitching topologies in previous steps.
  6. Update wiki pages: GENI Aggregate pages, GENI Operators pages, GENI Network Stitching Sites.
  1. Notify team chat of completion of this step