Segment Routing Group Handling:

SR GroupKey data model

Segment Routing application interacts with the Group subsystem using the below SR specific GroupKey. So SR application associate a SRDefaultGroupKey or SRPolicyGroupKey for every group it creates. The SRGroupKey consists of collection of <PortNumber + Label Stack to be pushed on that port> where leftmost label representing the outermost label and rightmost label representing innermost label to be pushed.

For e.g. a ECMP group with two buckets pushing label L1 and output to two ports P1 and P2 respectively can be represented with a SRDefaultGroupKey {{P1, L1}, {P2, L1}}. 

Default Group Handling

For every new device detected where the current controller instance is a MASTER (Either first time device connected or MASTER-SHIP changes), the SR application would initiate default group handling procedures for that device.

• @Activation
  
  • Get the Segment IDs of all devices in the network from Network Config service
  • Get "isEdgeRouter" attribute for this device from Network Config service
  • Create Neighbor <-> Port mapping database based on current topology
  • Create Port <-> Neighbor mapping database based on current topology
  • If AUDIT is in progress at Group subsystem for this device
    • Start a timer and perform the Sanity check
  • Sanity Check
    • Compute power set of all Neighbors
    • Pair them with all applicable Segment IDs if the current device is a edge router
    • Determine the SRDefaultGroupKeys for each pair and create groups using Group service API if there is no group existing with this Key
• @LINK_UP involving one of device ports
  • Find the Neighbor Device ID
  • If (Neighbor is already present in the database for this device)
    • That means this new link is part of group of links to that Neighbor (e.g. LAG)
    • Determine all SRDefaultGroupKeys that are impacted due to this new link from the information of Port <-> Neighbor & Neighbor <-> Port databases and Segment IDs
    • Invoke "addBucketsToGroup()" API of the GroupService with a new SRDefaultGroupKey for all the impacted Groups
    • Update Neighbor <-> Port mapping database
    • Update Port <-> Neighbor mapping database
  • Else
    
    • That means this new link discovers a new neighbor
    • Update Neighbor <-> Port mapping database
    • Update Port <-> Neighbor mapping database
    • Recompute neighbor power sets with updated neighbor database and determine the delta entries and pair them up with applicable segment IDs
    • Determine the SRDefaultGroupKeys for each pair and create groups using Group service API if there is no group existing with this Key.
• @PORT_UP
  
  • No Action
• @PORT_DOWN
  
  • Determine all SRDefaultGroupKeys that are impacted due to this PORT_DOWN event from the information of Port <-> Neighbor & Neighbor <-> Port databases and Segment IDs
  • Invoke "removeBucketsFromGroup()" API of the GroupService with a new SRDefaultGroupKey for all the impacted Groups
  • Update Neighbor <-> Port mapping database
  • Update Port <-> Neighbor mapping database
  • 
    

Policy Group Handler & Recovery

While creating the tunnel, ensure all the stitched groups are created before creating the Group chain in the ingress router

Similarly, while deleting the tunnel, ensure the group is deleted at ingress router before deleting any stitched groups

Group Event Handling