.. _isis:
****
ISIS
****
:abbr:`ISIS (Intermediate System to Intermediate System)` is a routing protocol
which is described in :t:`ISO10589`, :rfc:`1195`, :rfc:`5308`. ISIS is an
:abbr:`IGP (Interior Gateway Protocol)`. Compared with :abbr:`RIP`,
:abbr:`ISIS` can provide scalable network support and faster convergence times
like :abbr:`OSPF`. ISIS is widely used in large networks such as :abbr:`ISP
(Internet Service Provider)` and carrier backbone networks.
.. _configuring-isisd:
Configuring isisd
=================
There are no *isisd* specific options. Common options can be specified
(:ref:`common-invocation-options`) to *isisd*. *isisd* needs to acquire
interface information from *zebra* in order to function. Therefore *zebra* must
be running before invoking *isisd*. Also, if *zebra* is restarted then *isisd*
must be too.
Like other daemons, *isisd* configuration is done in :abbr:`ISIS` specific
configuration file :file:`isisd.conf`.
.. _isis-router:
ISIS router
===========
To start the ISIS process you have to specify the ISIS router. As of this
writing, *isisd* does not support multiple ISIS processes.
.. index:: [no] router isis WORD
.. clicmd:: [no] router isis WORD
Enable or disable the ISIS process by specifying the ISIS domain with
'WORD'. *isisd* does not yet support multiple ISIS processes but you must
specify the name of ISIS process. The ISIS process name 'WORD' is then used
for interface (see command :clicmd:`ip router isis WORD`).
.. index:: net XX.XXXX. ... .XXX.XX
.. clicmd:: net XX.XXXX. ... .XXX.XX
.. index:: no net XX.XXXX. ... .XXX.XX
.. clicmd:: no net XX.XXXX. ... .XXX.XX
Set/Unset network entity title (NET) provided in ISO format.
.. index:: hostname dynamic
.. clicmd:: hostname dynamic
.. index:: no hostname dynamic
.. clicmd:: no hostname dynamic
Enable support for dynamic hostname.
.. index:: area-password [clear | md5] <password>
.. clicmd:: area-password [clear | md5] <password>
.. index:: domain-password [clear | md5] <password>
.. clicmd:: domain-password [clear | md5] <password>
.. index:: no area-password
.. clicmd:: no area-password
.. index:: no domain-password
.. clicmd:: no domain-password
Configure the authentication password for an area, respectively a domain, as
clear text or md5 one.
.. index:: log-adjacency-changes
.. clicmd:: log-adjacency-changes
.. index:: no log-adjacency-changes
.. clicmd:: no log-adjacency-changes
Log changes in adjacency state.
.. index:: metric-style [narrow | transition | wide]
.. clicmd:: metric-style [narrow | transition | wide]
.. index:: no metric-style
.. clicmd:: no metric-style
Set old-style (ISO 10589) or new-style packet formats:
- narrow
Use old style of TLVs with narrow metric
- transition
Send and accept both styles of TLVs during transition
- wide
Use new style of TLVs to carry wider metric
.. index:: set-overload-bit
.. clicmd:: set-overload-bit
.. index:: no set-overload-bit
.. clicmd:: no set-overload-bit
Set overload bit to avoid any transit traffic.
.. index:: purge-originator
.. clicmd:: purge-originator
.. index:: no purge-originator
.. clicmd:: no purge-originator
Enable or disable :rfc:`6232` purge originator identification.
.. _isis-timer:
ISIS Timer
==========
.. index:: lsp-gen-interval (1-120)
.. clicmd:: lsp-gen-interval (1-120)
.. index:: lsp-gen-interval [level-1 | level-2] (1-120)
.. clicmd:: lsp-gen-interval [level-1 | level-2] (1-120)
.. index:: no lsp-gen-interval
.. clicmd:: no lsp-gen-interval
.. index:: no lsp-gen-interval [level-1 | level-2]
.. clicmd:: no lsp-gen-interval [level-1 | level-2]
Set minimum interval in seconds between regenerating same LSP,
globally, for an area (level-1) or a domain (level-2).
.. index:: lsp-refresh-interval [level-1 | level-2] (1-65235)
.. clicmd:: lsp-refresh-interval [level-1 | level-2] (1-65235)
.. index:: no lsp-refresh-interval [level-1 | level-2]
.. clicmd:: no lsp-refresh-interval [level-1 | level-2]
Set LSP refresh interval in seconds, globally, for an area (level-1) or a
domain (level-2).
.. index:: max-lsp-lifetime (360-65535)
.. clicmd:: max-lsp-lifetime (360-65535)
.. index:: max-lsp-lifetime [level-1 | level-2] (360-65535)
.. clicmd:: max-lsp-lifetime [level-1 | level-2] (360-65535)
.. index:: no max-lsp-lifetime
.. clicmd:: no max-lsp-lifetime
.. index:: no max-lsp-lifetime [level-1 | level-2]
.. clicmd:: no max-lsp-lifetime [level-1 | level-2]
Set LSP maximum LSP lifetime in seconds, globally, for an area (level-1) or
a domain (level-2).
.. index:: spf-interval (1-120)
.. clicmd:: spf-interval (1-120)
.. index:: spf-interval [level-1 | level-2] (1-120)
.. clicmd:: spf-interval [level-1 | level-2] (1-120)
.. index:: no spf-interval
.. clicmd:: no spf-interval
.. index:: no spf-interval [level-1 | level-2]
.. clicmd:: no spf-interval [level-1 | level-2]
Set minimum interval between consecutive SPF calculations in seconds.
.. _isis-region:
ISIS region
===========
.. index:: is-type [level-1 | level-1-2 | level-2-only]
.. clicmd:: is-type [level-1 | level-1-2 | level-2-only]
.. index:: no is-type
.. clicmd:: no is-type
Define the ISIS router behavior:
- level-1
Act as a station router only
- level-1-2
Act as both a station router and an area router
- level-2-only
Act as an area router only
.. _isis-interface:
ISIS interface
==============
.. _ip-router-isis-word:
.. index:: [no] <ip|ipv6> router isis WORD
.. clicmd:: [no] <ip|ipv6> router isis WORD
Activate ISIS adjacency on this interface. Note that the name of ISIS
instance must be the same as the one used to configure the ISIS process (see
command :clicmd:`router isis WORD`). To enable IPv4, issue ``ip router isis
WORD``; to enable IPv6, issue ``ipv6 router isis WORD``.
.. index:: isis circuit-type [level-1 | level-1-2 | level-2]
.. clicmd:: isis circuit-type [level-1 | level-1-2 | level-2]
.. index:: no isis circuit-type
.. clicmd:: no isis circuit-type
Configure circuit type for interface:
- level-1
Level-1 only adjacencies are formed
- level-1-2
Level-1-2 adjacencies are formed
- level-2-only
Level-2 only adjacencies are formed
.. index:: isis csnp-interval (1-600)
.. clicmd:: isis csnp-interval (1-600)
.. index:: isis csnp-interval (1-600) [level-1 | level-2]
.. clicmd:: isis csnp-interval (1-600) [level-1 | level-2]
.. index:: no isis csnp-interval
.. clicmd:: no isis csnp-interval
.. index:: no isis csnp-interval [level-1 | level-2]
.. clicmd:: no isis csnp-interval [level-1 | level-2]
Set CSNP interval in seconds globally, for an area (level-1) or a domain
(level-2).
.. index:: isis hello padding
.. clicmd:: isis hello padding
Add padding to IS-IS hello packets.
.. index:: isis hello-interval (1-600)
.. clicmd:: isis hello-interval (1-600)
.. index:: isis hello-interval (1-600) [level-1 | level-2]
.. clicmd:: isis hello-interval (1-600) [level-1 | level-2]
.. index:: no isis hello-interval
.. clicmd:: no isis hello-interval
.. index:: no isis hello-interval [level-1 | level-2]
.. clicmd:: no isis hello-interval [level-1 | level-2]
Set Hello interval in seconds globally, for an area (level-1) or a domain
(level-2).
.. index:: isis hello-multiplier (2-100)
.. clicmd:: isis hello-multiplier (2-100)
.. index:: isis hello-multiplier (2-100) [level-1 | level-2]
.. clicmd:: isis hello-multiplier (2-100) [level-1 | level-2]
.. index:: no isis hello-multiplier
.. clicmd:: no isis hello-multiplier
.. index:: no isis hello-multiplier [level-1 | level-2]
.. clicmd:: no isis hello-multiplier [level-1 | level-2]
Set multiplier for Hello holding time globally, for an area (level-1) or a
domain (level-2).
.. index:: isis metric [(0-255) | (0-16777215)]
.. clicmd:: isis metric [(0-255) | (0-16777215)]
.. index:: isis metric [(0-255) | (0-16777215)] [level-1 | level-2]
.. clicmd:: isis metric [(0-255) | (0-16777215)] [level-1 | level-2]
.. index:: no isis metric
.. clicmd:: no isis metric
.. index:: no isis metric [level-1 | level-2]
.. clicmd:: no isis metric [level-1 | level-2]
Set default metric value globally, for an area (level-1) or a domain
(level-2). Max value depend if metric support narrow or wide value (see
command :clicmd:`metric-style [narrow | transition | wide]`).
.. index:: isis network point-to-point
.. clicmd:: isis network point-to-point
.. index:: no isis network point-to-point
.. clicmd:: no isis network point-to-point
Set network type to 'Point-to-Point' (broadcast by default).
.. index:: isis passive
.. clicmd:: isis passive
.. index:: no isis passive
.. clicmd:: no isis passive
Configure the passive mode for this interface.
.. index:: isis password [clear | md5] <password>
.. clicmd:: isis password [clear | md5] <password>
.. index:: no isis password
.. clicmd:: no isis password
Configure the authentication password (clear or encoded text) for the
interface.
.. index:: isis priority (0-127)
.. clicmd:: isis priority (0-127)
.. index:: isis priority (0-127) [level-1 | level-2]
.. clicmd:: isis priority (0-127) [level-1 | level-2]
.. index:: no isis priority
.. clicmd:: no isis priority
.. index:: no isis priority [level-1 | level-2]
.. clicmd:: no isis priority [level-1 | level-2]
Set priority for Designated Router election, globally, for the area
(level-1) or the domain (level-2).
.. index:: isis psnp-interval (1-120)
.. clicmd:: isis psnp-interval (1-120)
.. index:: isis psnp-interval (1-120) [level-1 | level-2]
.. clicmd:: isis psnp-interval (1-120) [level-1 | level-2]
.. index:: no isis psnp-interval
.. clicmd:: no isis psnp-interval
.. index:: no isis psnp-interval [level-1 | level-2]
.. clicmd:: no isis psnp-interval [level-1 | level-2]
Set PSNP interval in seconds globally, for an area (level-1) or a domain
(level-2).
.. index:: isis three-way-handshake
.. clicmd:: isis three-way-handshake
.. index:: no isis three-way-handshake
.. clicmd:: no isis three-way-handshake
Enable or disable :rfc:`5303` Three-Way Handshake for P2P adjacencies.
Three-Way Handshake is enabled by default.
.. _showing-isis-information:
Showing ISIS information
========================
.. index:: show isis summary
.. clicmd:: show isis summary
Show summary information about ISIS.
.. index:: show isis hostname
.. clicmd:: show isis hostname
Show information about ISIS node.
.. index:: show isis interface
.. clicmd:: show isis interface
.. index:: show isis interface detail
.. clicmd:: show isis interface detail
.. index:: show isis interface <interface name>
.. clicmd:: show isis interface <interface name>
Show state and configuration of ISIS specified interface, or all interfaces
if no interface is given with or without details.
.. index:: show isis neighbor
.. clicmd:: show isis neighbor
.. index:: show isis neighbor <System Id>
.. clicmd:: show isis neighbor <System Id>
.. index:: show isis neighbor detail
.. clicmd:: show isis neighbor detail
Show state and information of ISIS specified neighbor, or all neighbors if
no system id is given with or without details.
.. index:: show isis database
.. clicmd:: show isis database
.. index:: show isis database [detail]
.. clicmd:: show isis database [detail]
.. index:: show isis database <LSP id> [detail]
.. clicmd:: show isis database <LSP id> [detail]
.. index:: show isis database detail <LSP id>
.. clicmd:: show isis database detail <LSP id>
Show the ISIS database globally, for a specific LSP id without or with
details.
.. index:: show isis topology
.. clicmd:: show isis topology
.. index:: show isis topology [level-1|level-2]
.. clicmd:: show isis topology [level-1|level-2]
Show topology IS-IS paths to Intermediate Systems, globally, in area
(level-1) or domain (level-2).
.. index:: show ip route isis
.. clicmd:: show ip route isis
Show the ISIS routing table, as determined by the most recent SPF
calculation.
.. _isis-traffic-engineering:
Traffic Engineering
===================
.. index:: mpls-te on
.. clicmd:: mpls-te on
.. index:: no mpls-te
.. clicmd:: no mpls-te
Enable Traffic Engineering LSP flooding.
.. index:: mpls-te router-address <A.B.C.D>
.. clicmd:: mpls-te router-address <A.B.C.D>
.. index:: no mpls-te router-address
.. clicmd:: no mpls-te router-address
Configure stable IP address for MPLS-TE.
.. index:: show isis mpls-te interface
.. clicmd:: show isis mpls-te interface
.. index:: show isis mpls-te interface INTERFACE
.. clicmd:: show isis mpls-te interface INTERFACE
Show MPLS Traffic Engineering parameters for all or specified interface.
.. index:: show isis mpls-te router
.. clicmd:: show isis mpls-te router
Show Traffic Engineering router parameters.
.. seealso::
:ref:`ospf-traffic-engineering`
.. _debugging-isis:
Debugging ISIS
==============
.. index:: debug isis adj-packets
.. clicmd:: debug isis adj-packets
.. index:: no debug isis adj-packets
.. clicmd:: no debug isis adj-packets
IS-IS Adjacency related packets.
.. index:: debug isis checksum-errors
.. clicmd:: debug isis checksum-errors
.. index:: no debug isis checksum-errors
.. clicmd:: no debug isis checksum-errors
IS-IS LSP checksum errors.
.. index:: debug isis events
.. clicmd:: debug isis events
.. index:: no debug isis events
.. clicmd:: no debug isis events
IS-IS Events.
.. index:: debug isis local-updates
.. clicmd:: debug isis local-updates
.. index:: no debug isis local-updates
.. clicmd:: no debug isis local-updates
IS-IS local update packets.
.. index:: debug isis packet-dump
.. clicmd:: debug isis packet-dump
.. index:: no debug isis packet-dump
.. clicmd:: no debug isis packet-dump
IS-IS packet dump.
.. index:: debug isis protocol-errors
.. clicmd:: debug isis protocol-errors
.. index:: no debug isis protocol-errors
.. clicmd:: no debug isis protocol-errors
IS-IS LSP protocol errors.
.. index:: debug isis route-events
.. clicmd:: debug isis route-events
.. index:: no debug isis route-events
.. clicmd:: no debug isis route-events
IS-IS Route related events.
.. index:: debug isis snp-packets
.. clicmd:: debug isis snp-packets
.. index:: no debug isis snp-packets
.. clicmd:: no debug isis snp-packets
IS-IS CSNP/PSNP packets.
.. index:: debug isis spf-events
.. clicmd:: debug isis spf-events
.. index:: debug isis spf-statistics
.. clicmd:: debug isis spf-statistics
.. index:: debug isis spf-triggers
.. clicmd:: debug isis spf-triggers
.. index:: no debug isis spf-events
.. clicmd:: no debug isis spf-events
.. index:: no debug isis spf-statistics
.. clicmd:: no debug isis spf-statistics
.. index:: no debug isis spf-triggers
.. clicmd:: no debug isis spf-triggers
IS-IS Shortest Path First Events, Timing and Statistic Data and triggering
events.
.. index:: debug isis update-packets
.. clicmd:: debug isis update-packets
.. index:: no debug isis update-packets
.. clicmd:: no debug isis update-packets
Update related packets.
.. index:: show debugging isis
.. clicmd:: show debugging isis
Print which ISIS debug level is activate.
ISIS Configuration Examples
===========================
A simple example, with MD5 authentication enabled:
.. code-block:: frr
!
interface eth0
ip router isis FOO
isis network point-to-point
isis circuit-type level-2-only
!
router isis FOO
net 47.0023.0000.0000.0000.0000.0000.0000.1900.0004.00
metric-style wide
is-type level-2-only
A Traffic Engineering configuration, with Inter-ASv2 support.
First, the :file:`zebra.conf` part:
.. code-block:: frr
hostname HOSTNAME
password PASSWORD
log file /var/log/zebra.log
!
interface eth0
ip address 10.2.2.2/24
link-params
max-bw 1.25e+07
max-rsv-bw 1.25e+06
unrsv-bw 0 1.25e+06
unrsv-bw 1 1.25e+06
unrsv-bw 2 1.25e+06
unrsv-bw 3 1.25e+06
unrsv-bw 4 1.25e+06
unrsv-bw 5 1.25e+06
unrsv-bw 6 1.25e+06
unrsv-bw 7 1.25e+06
admin-grp 0xab
!
interface eth1
ip address 10.1.1.1/24
link-params
enable
metric 100
max-bw 1.25e+07
max-rsv-bw 1.25e+06
unrsv-bw 0 1.25e+06
unrsv-bw 1 1.25e+06
unrsv-bw 2 1.25e+06
unrsv-bw 3 1.25e+06
unrsv-bw 4 1.25e+06
unrsv-bw 5 1.25e+06
unrsv-bw 6 1.25e+06
unrsv-bw 7 1.25e+06
neighbor 10.1.1.2 as 65000
Then the :file:`isisd.conf` itself:
.. code-block:: frr
hostname HOSTNAME
password PASSWORD
log file /var/log/isisd.log
!
!
interface eth0
ip router isis FOO
!
interface eth1
ip router isis FOO
!
!
router isis FOO
isis net 47.0023.0000.0000.0000.0000.0000.0000.1900.0004.00
mpls-te on
mpls-te router-address 10.1.1.1
!
line vty