OpenFabric

OpenFabric, specified in draft-white-openfabric-06.txt, is a routing protocol derived from IS-IS, providing link-state routing with efficient flooding for topologies like spine-leaf networks.

FRR implements OpenFabric in a daemon called fabricd

Configuring fabricd

There are no fabricd specific options. Common options can be specified (Common Invocation Options) to fabricd. fabricd needs to acquire interface information from zebra in order to function. Therefore zebra must be running before invoking fabricd. Also, if zebra is restarted then fabricd must be too.

Like other daemons, fabricd configuration is done in an OpenFabric specific configuration file fabricd.conf.

OpenFabric router

To enable the OpenFabric routing protocol, an OpenFabric router needs to be created in the configuration:

router openfabric WORD

Enable or disable the OpenFabric process by specifying the OpenFabric domain with 'WORD'.

net XX.XXXX. ... .XXX.XX

Set/Unset network entity title (NET) provided in ISO format.

domain-password [clear | md5] <password>

Configure the authentication password for a domain, as clear text or md5 one.

attached-bit [receive ignore | send]

Set attached bit for inter-area traffic:

  • receive If LSP received with attached bit set, create default route to neighbor
  • send If L1|L2 router, set attached bit in LSP sent to L1 router
log-adjacency-changes

Log changes in adjacency state.

set-overload-bit

Set overload bit to avoid any transit traffic.

purge-originator

Enable or disable RFC 6232 purge originator identification.

fabric-tier (0-14)

Configure a static tier number to advertise as location in the fabric

OpenFabric Timer

lsp-gen-interval (1-120)

Set minimum interval in seconds between regenerating same LSP.

lsp-refresh-interval (1-65235)

Set LSP refresh interval in seconds.

max-lsp-lifetime (360-65535)

Set LSP maximum LSP lifetime in seconds.

spf-interval (1-120)

Set minimum interval between consecutive SPF calculations in seconds.

OpenFabric interface

ip router openfabric WORD
Activate OpenFabric on this interface. Note that the name of OpenFabric instance must be the same as the one used to configure the routing process (see command router openfabric WORD).
openfabric csnp-interval (1-600)

Set CSNP interval in seconds.

openfabric hello-interval (1-600)

Set Hello interval in seconds.

openfabric hello-multiplier (2-100)

Set multiplier for Hello holding time.

openfabric metric (0-16777215)

Set interface metric value.

openfabric passive

Configure the passive mode for this interface.

openfabric password [clear | md5] <password>

Configure the authentication password (clear or encoded text) for the interface.

openfabric psnp-interval (1-120)

Set PSNP interval in seconds.

Showing OpenFabric information

show openfabric summary

Show summary information about OpenFabric.

show openfabric hostname

Show which hostnames are associated with which OpenFabric system ids.

show openfabric interface
show openfabric interface detail
show openfabric interface <interface name>

Show state and configuration of specified OpenFabric interface, or all interfaces if no interface is given with or without details.

show openfabric neighbor
show openfabric neighbor <System Id>
show openfabric neighbor detail

Show state and information of specified OpenFabric neighbor, or all neighbors if no system id is given with or without details.

show openfabric database
show openfabric database [detail]
show openfabric database <LSP id> [detail]
show openfabric database detail <LSP id>

Show the OpenFabric database globally, for a specific LSP id without or with details.

show openfabric topology

Show calculated OpenFabric paths and associated topology information.

Debugging OpenFabric

debug openfabric adj-packets

OpenFabric Adjacency related packets.

debug openfabric checksum-errors

OpenFabric LSP checksum errors.

debug openfabric events

OpenFabric Events.

debug openfabric local-updates

OpenFabric local update packets.

debug openfabric lsp-gen

Generation of own LSPs.

debug openfabric lsp-sched

Debug scheduling of generation of own LSPs.

debug openfabric packet-dump

OpenFabric packet dump.

debug openfabric protocol-errors

OpenFabric LSP protocol errors.

debug openfabric route-events

OpenFabric Route related events.

debug openfabric snp-packets

OpenFabric CSNP/PSNP packets.

debug openfabric spf-events
debug openfabric spf-statistics
debug openfabric spf-triggers

OpenFabric Shortest Path First Events, Timing and Statistic Data and triggering events.

debug openfabric update-packets

Update-related packets.

show debugging openfabric

Print which OpenFabric debug levels are active.

Sample configuration

A simple example:

!
interface lo
 ip address 192.0.2.1/32
 ip router openfabric 1
 ipv6 address 2001:db8::1/128
 ipv6 router openfabric 1
!
interface eth0
 ip router openfabric 1
 ipv6 router openfabric 1
!
interface eth1
 ip router openfabric 1
 ipv6 router openfabric 1
!
router openfabric 1
 net 49.0000.0000.0001.00

Alternative example:

hostname fabricd

router openfabric DEAD
  net 47.0023.0000.0003.0300.0100.0102.0304.0506.00
  lsp-lifetime 65535

  hostname isisd-router
  domain-password foobar

interface eth0
 ip router openfabric DEAD
 openfabric hello-interval 5
 openfabric lsp-interval 1000

! -- optional
openfabric retransmit-interval 10
openfabric retransmit-throttle-interval