# 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