Add rib-has-route condition to openconfig-routing-policy

[niallmasterson]

Add rib-has-route condition to openconfig-routing-policy

Change Scope

• Add support for the "rib-has-route" route-policy condition which will check if a route exists in the routing-table. Multiple vendors support this capability which is used for conditional route-advertisements, i.e. the route-policy condition checks if a certain prefix A exists in the routing table, and if so then advertises another prefix B or a default-route.

Platform Implementations

• Cisco IOS-XR - rib-has-route

https://www.cisco.com/c/en/us/td/docs/iosxr/cisco8000/routing/cumulative/command/reference/b-routing-cr-cisco8000/m-rpl-commands-1.html#wp4036312080

prefix-set PREFIX-TO-TRACK                                                                                                    
  10.10.10.0/24                                                                                                               
end-set                                                                                                                       
! 
route-policy CONDITIONAL-ADVERTISEMENT
  if rib-has-route in PREFIX-TO-TRACK then
    done
  endif
  drop
end-policy

• Arista EOS - dynamic prefix-lists
  https://www.arista.com/en/support/toi/eos-4-21-0f/14072-bgp-conditional-route-inject-routing-protocol-mode-rib

dynamic prefix-list DPL
  match-map PREFIX-TO-CHECK
  prefix-list ipv4 ADV-THIS-PREFIX
!
route-map PREFIX-TO-CHECK permit 10
  match ip address prefix-list PREFIX-TO-TRACK
!
ip prefix-list PREFIX-TO-TRACK seq 10 permit 10.10.10.0/24

ip prefix-list ADV-THIS-PREFIX seq 10 permit 10.20.20.0/24
!
route-map OUTBOUND-POLICY permit 10
  match ip address dynamic prefix-list DPL

• Juniper JUNOS - if-route-exists
  https://www.juniper.net/documentation/us/en/software/junos/routing-policy/bgp/topics/example/conditional-prefix-installing-configuring.html

policy-options {
    prefix-list ADV-THIS-PREFIX {
        10.20.20.0/24;
    }
    policy-statement OUTBOUND-POLICY {
        term CONDITIONAL-ADVERTISE {
            from {
                prefix-list ADV-THIS-PREFIX;
                condition CHECK-TRACK-ROUTE;
            }                           
            then accept;
        }
    }
    condition CHECK-TRACK-ROUTE {
        if-route-exists {
            10.10.10.0/24;
            table inet.0;
        }
    }
}

Tree View

 module: openconfig-routing-policy
               +--rw statement* [name]
                  +--rw name          -> ../config/name
                  +--rw config
                  |  +--rw name?   string
                  +--ro state
                  |  +--ro name?   string
                  +--rw conditions
                  |  +--rw config
                  |  |  +--rw call-policy?           -> ../../../../../../../policy-definitions/policy-definition/name
                  |  |  +--rw install-protocol-eq?   identityref
                  |  +--ro state
                  |  |  +--ro call-policy?           -> ../../../../../../../policy-definitions/policy-definition/name
                  |  |  +--ro install-protocol-eq?   identityref
                  |  +--rw match-interface
                  |  |  +--rw config
                  |  |  +--ro state
                  |  +--rw match-prefix-set
                  |  |  +--rw config
                  |  |  |  +--rw prefix-set?          -> ../../../../../../../../defined-sets/prefix-sets/prefix-set/config/name
                  |  |  |  +--rw match-set-options?   oc-pol-types:match-set-options-restricted-type
                  |  |  +--ro state
                  |  |     +--ro prefix-set?          -> ../../../../../../../../defined-sets/prefix-sets/prefix-set/config/name
                  |  |     +--ro match-set-options?   oc-pol-types:match-set-options-restricted-type
+                 |  +--rw match-rib-has-route
+                 |  |  +--rw config
+                 |  |  |  +--rw prefix-set?          -> ../../../../../../../../defined-sets/prefix-sets/prefix-set/config/name
+                 |  |  |  +--rw match-set-options?   oc-pol-types:match-set-options-restricted-type
+                 |  |  +--ro state
+                 |  |     +--ro prefix-set?          -> ../../../../../../../../defined-sets/prefix-sets/prefix-set/config/name
+                 |  |     +--ro match-set-options?   oc-pol-types:match-set-options-restricted-type
                  |  +--rw match-neighbor-set
                  |  |  +--rw config
                  |  |  |  +--rw neighbor-set?        -> ../../../../../../../../defined-sets/neighbor-sets/neighbor-set/name
                  |  |  |  +--rw match-set-options?   oc-pol-types:match-set-options-restricted-type
                  |  |  +--ro state
                  |  |     +--ro neighbor-set?        -> ../../../../../../../../defined-sets/neighbor-sets/neighbor-set/name
                  |  |     +--ro match-set-options?   oc-pol-types:match-set-options-restricted-type
                  |  +--rw match-tag-set
                  |     +--rw config
                  |     |  +--rw tag-set?             -> ../../../../../../../../defined-sets/tag-sets/tag-set/name
                  |     |  +--rw match-set-options?   oc-pol-types:match-set-options-restricted-type
                  |     +--ro state
                  |        +--ro tag-set?             -> ../../../../../../../../defined-sets/tag-sets/tag-set/name
                  |        +--ro match-set-options?   oc-pol-types:match-set-options-restricted-type
                  +--rw actions
                     +--rw config
                     |  +--rw policy-result?   policy-result-type
                     +--ro state
                     |  +--ro policy-result?   policy-result-type
                     +--rw set-tag
                        +--rw config

[jhaas-pfrc]

Note: At least one implementation has a limitation that the "prefix-set" has exactly one entry. The documentation for one of the other implementations similarly seems to indicate the same restriction.

[niallmasterson]

Note: At least one implementation has a limitation that the "prefix-set" has exactly one entry. The documentation for one of the other implementations similarly seems to indicate the same restriction.

In the case where the vendor can only support a prefix-set with one entry, they could potentially create multiple conditions to implement the OC intent. i.e. for each entry in the prefix-set create a condition/term. Juniper for example doesn't actually use a prefix-set for the prefix to track. Instead a single prefix is specified under the condition config. So if you wanted to track multiple prefixes with a "match-any", you could create multiple conditions and terms. e.g.

prefix-list ADV-THIS-PREFIX {
    10.20.20.0/24;
}
policy-statement OUTBOUND-POLICY {
    term CONDITIONAL-ADVERTISE {
        from {
            prefix-list ADV-THIS-PREFIX;
            condition CHECK-TRACK-ROUTE;
        }
        then accept;
    }
    term CONDITIONAL-ADVERTISE-1 {
        from {
            prefix-list ADV-THIS-PREFIX;
            condition CHECK-TRACK-ROUTE-1;
        }
        then accept;
    }
}
condition CHECK-TRACK-ROUTE {
    if-route-exists {
        10.10.10.0/24;
        table inet.0;
    }
}
condition CHECK-TRACK-ROUTE-1 {
    if-route-exists {
        20.20.20.0/24;
        table inet.0;
    }
}

[akalluru1]

@niallmasterson match-rib-has-route container represents the list or set of prefixes present in routing table, is that correct? which container in the policy-definitions represents the list or set of prefixes that should be advertised?

Taking the Arista EOS example from the PR description:

dynamic prefix-list DPL
  match-map PREFIX-TO-CHECK
  prefix-list ipv4 ADV-THIS-PREFIX
!
route-map PREFIX-TO-CHECK permit 10
  match ip address prefix-list PREFIX-TO-TRACK
!
ip prefix-list PREFIX-TO-TRACK seq 10 permit 10.10.10.0/24

ip prefix-list ADV-THIS-PREFIX seq 10 permit 10.20.20.0/24
!
route-map OUTBOUND-POLICY permit 10
  match ip address dynamic prefix-list DPL

what would be the value of prefix-set leaf in match-rib-has-route container for the above example? PREFIX-TO-TRACK? If so, which leaf represents prefix-list ipv4 ADV-THIS-PREFIX & dynamic prefix-list DPL?