vyos/vyos-documentation
1
0
Fork 0
mirror of https://github.com/vyos/vyos-documentation.git synced 2025-10-26 08:41:46 +01:00
Code Issues Packages Projects Releases Wiki Activity

isis: adjust to latest CLI changes

Browse Source 
The previous tagNode was replaced with a regular node.
This commit is contained in:
Christian Poessinger 2021-03-21 17:53:12 +01:00
parent a1138c5d76
commit 4f09fdd987
1 changed files with 90 additions and 85 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

175
docs/configuration/protocols/isis.rst
View File

@ -16,51 +16,54 @@ neighbors. IS-IS runs directly on the data link layer (Layer 2). IS-IS
addresses are called :abbr:`NETs (Network Entity Titles)` and can be addresses are called :abbr:`NETs (Network Entity Titles)` and can be
8 to 20 bytes long, but are generally 10 bytes long. 8 to 20 bytes long, but are generally 10 bytes long.
For example :abbr:`NET (Network Entity Title)`
.. code-block:: none
49.0001.1921.6800.1002.00
The IS-IS address consists of three parts:
:abbr:`AFI (Address family authority identifier)`
``49`` The AFI value 49 is what IS-IS uses for private addressing.
Area identifier:
``0001`` IS-IS area number (Area1)
System identifier:
``1921.6800.1002`` For system idetifier we recommend to use IP address or
MAC address of the router.
NET selector:
``00`` Must always be 00, to indicate "this system".
General Configuration
---------------------
.. cfgcmd:: set protocols isis <name> net <network-entity-title> *******
General
*******
This command enables the ISIS process by specifying the ISIS domain with Configuration
‘name’. ISIS implementation does not yet support multiple ISIS processes =============
but you must specify the name of ISIS process. This commad also sets
network entity title (NET) provided in ISO format.
.. cfgcmd:: set protocols isis <name> interface <interface> Mandatory Settings
------------------
.. cfgcmd:: set protocols isis net <network-entity-title>
This commad also sets network entity title (NET) provided in ISO format.
For example :abbr:`NET (Network Entity Title)`
.. code-block:: none
49.0001.1921.6800.1002.00
The IS-IS address consists of the following parts:
* :abbr:`AFI (Address family authority identifier)` - ``49`` The AFI value
49 is what IS-IS uses for private addressing.
* Area identifier: ``0001`` IS-IS area number (Area1)
* System identifier: ``1921.6800.1002`` - for system idetifiers we recommend
to use IP address or MAC address of the router itself.
* NET selector: ``00`` Must always be 00, to indicate "this system".
.. cfgcmd:: set protocols isis interface <interface>
This command activates ISIS adjacency on this interface. Note that the name This command activates ISIS adjacency on this interface. Note that the name
of ISIS instance must be the same as the one used to configure the ISIS of ISIS instance must be the same as the one used to configure the ISIS
process. process.
.. cfgcmd:: set protocols isis <name> dynamic-hostname .. cfgcmd:: set protocols isis dynamic-hostname
This command enables support for dynamic hostname. Dynamic hostname mapping This command enables support for dynamic hostname. Dynamic hostname mapping
determined as described in :rfc:`2763`, Dynamic Hostname Exchange Mechanism determined as described in :rfc:`2763`, Dynamic Hostname Exchange Mechanism
for IS-IS. for IS-IS.
.. cfgcmd:: set protocols isis <name> level <level-1|level-1-2|level-2> .. cfgcmd:: set protocols isis level <level-1|level-1-2|level-2>
This command defines the ISIS router behavior: This command defines the ISIS router behavior:
@ -68,12 +71,12 @@ General Configuration
**level-1-2** Act as both a station router and an area router. **level-1-2** Act as both a station router and an area router.
**level-2-only** Act as an area router only. **level-2-only** Act as an area router only.
.. cfgcmd:: set protocols isis <name> lsp-mtu <size> .. cfgcmd:: set protocols isis lsp-mtu <size>
This command configures the maximum size of generated LSPs, in bytes. The This command configures the maximum size of generated LSPs, in bytes. The
size range is 128 to 4352. size range is 128 to 4352.
.. cfgcmd:: set protocols isis <name> metric-style <narrow|transition|wide> .. cfgcmd:: set protocols isis metric-style <narrow|transition|wide>
This command sets old-style (ISO 10589) or new-style packet formats: This command sets old-style (ISO 10589) or new-style packet formats:
@ -81,19 +84,19 @@ General Configuration
**transition** Send and accept both styles of TLVs during transition. **transition** Send and accept both styles of TLVs during transition.
**wide** Use new style of TLVs to carry wider metric. **wide** Use new style of TLVs to carry wider metric.
.. cfgcmd:: set protocols isis <name> purge-originator .. cfgcmd:: set protocols isis purge-originator
This command enables :rfc:`6232` purge originator identification. Enable This command enables :rfc:`6232` purge originator identification. Enable
purge originator identification (POI) by adding the type, length and value purge originator identification (POI) by adding the type, length and value
(TLV) with the Intermediate System (IS) identification to the LSPs that do (TLV) with the Intermediate System (IS) identification to the LSPs that do
not contain POI information. If an IS generates a purge, VyOS adds this TLV not contain POI information. If an IS generates a purge, VyOS adds this TLV
with the system ID of the IS to the purge. with the system ID of the IS to the purge.
.. cfgcmd:: set protocols isis <name> set-attached-bit .. cfgcmd:: set protocols isis set-attached-bit
This command sets ATT bit to 1 in Level1 LSPs. It is described in :rfc:`3787`. This command sets ATT bit to 1 in Level1 LSPs. It is described in :rfc:`3787`.
.. cfgcmd:: set protocols isis <name> set-overload-bit .. cfgcmd:: set protocols isis set-overload-bit
This command sets overload bit to avoid any transit traffic through this This command sets overload bit to avoid any transit traffic through this
router. It is described in :rfc:`3787`. router. It is described in :rfc:`3787`.
@ -102,107 +105,108 @@ General Configuration
level-1 level-1
This command will generate a default-route in L1 database. This command will generate a default-route in L1 database.
.. cfgcmd:: set protocols isis name default-information originate <ipv4|ipv6> .. cfgcmd:: set protocols isis name default-information originate <ipv4|ipv6>
level-2 level-2
This command will generate a default-route in L2 database. This command will generate a default-route in L2 database.
Interfaces Configuration Interface Configuration
------------------------ -----------------------
.. cfgcmd:: set protocols isis <name> interface <interface> circuit-type .. cfgcmd:: set protocols isis interface <interface> circuit-type
<level-1|level-1-2|level-2-only> <level-1|level-1-2|level-2-only>
This command specifies circuit type for interface: This command specifies circuit type for interface:
**level-1** Level-1 only adjacencies are formed. * **level-1** Level-1 only adjacencies are formed.
**level-1-2** Level-1-2 adjacencies are formed * **level-1-2** Level-1-2 adjacencies are formed
**level-2-only** Level-2 only adjacencies are formed * **level-2-only** Level-2 only adjacencies are formed
.. cfgcmd:: set protocols isis <name> interface <interface> hello-interval .. cfgcmd:: set protocols isis interface <interface> hello-interval
<seconds> <seconds>
This command sets hello interval in seconds on a given interface. This command sets hello interval in seconds on a given interface.
The range is 1 to 600. The range is 1 to 600.
.. cfgcmd:: set protocols isis <name> interface <interface> hello-multiplier .. cfgcmd:: set protocols isis interface <interface> hello-multiplier
<seconds> <seconds>
This command sets multiplier for hello holding time on a given This command sets multiplier for hello holding time on a given
interface. The range is 2 to 100. interface. The range is 2 to 100.
.. cfgcmd:: set protocols isis <name> interface <interface> hello-padding .. cfgcmd:: set protocols isis interface <interface> hello-padding
This command configures padding on hello packets to accommodate asymmetrical This command configures padding on hello packets to accommodate asymmetrical
maximum transfer units (MTUs) from different hosts as described in maximum transfer units (MTUs) from different hosts as described in
:rfc:`3719`. This helps to prevent a premature adjacency Up state when one :rfc:`3719`. This helps to prevent a premature adjacency Up state when one
routing device’s MTU does not meet the requirements to establish the routing devices MTU does not meet the requirements to establish the adjacency.
adjacency.
.. cfgcmd:: set protocols isis <name> interface <interface> metric <metric> .. cfgcmd:: set protocols isis interface <interface> metric <metric>
This command set default metric for circuit. The metric range is 1 to This command set default metric for circuit.
16777215 (Max value depend if metric support narrow or wide value).
.. cfgcmd:: set protocols isis <name> interface <interface> network The metric range is 1 to 16777215 (Max value depend if metric support narrow
or wide value).
.. cfgcmd:: set protocols isis interface <interface> network
point-to-point point-to-point
This command specifies network type to ‘Point-to-Point’. The default network This command specifies network type to Point-to-Point. The default
type is broadcast. network type is broadcast.
.. cfgcmd:: set protocols isis <name> interface <interface> passive .. cfgcmd:: set protocols isis interface <interface> passive
This command configures the passive mode for this interface. This command configures the passive mode for this interface.
.. cfgcmd:: set protocols isis <name> interface <interface> password .. cfgcmd:: set protocols isis interface <interface> password
plaintext-password <text> plaintext-password <text>
This command configures the authentication password for the interface. This command configures the authentication password for the interface.
.. cfgcmd:: set protocols isis <name> interface <interface> priority <number> .. cfgcmd:: set protocols isis interface <interface> priority <number>
This command sets priority for the interface for This command sets priority for the interface for
:abbr:`DIS (Designated Intermediate System)` election. The priority :abbr:`DIS (Designated Intermediate System)` election. The priority
range is 0 to 127. range is 0 to 127.
.. cfgcmd:: set protocols isis <name> interface <interface> psnp-interval .. cfgcmd:: set protocols isis interface <interface> psnp-interval
<number> <number>
This command sets PSNP interval in seconds. The interval range is 0 This command sets PSNP interval in seconds. The interval range is 0
to 127. to 127.
.. cfgcmd:: set protocols isis <name> interface <interface> .. cfgcmd:: set protocols isis interface <interface>
no-three-way-handshake no-three-way-handshake
This command disables Three-Way Handshake for P2P adjacencies which This command disables Three-Way Handshake for P2P adjacencies which
described in :rfc:`5303`. Three-Way Handshake is enabled by default. described in :rfc:`5303`. Three-Way Handshake is enabled by default.
Redistribution Configuration Route Redistribution
---------------------------- --------------------
.. cfgcmd:: set protocols isis <name> redistribute ipv4 <route source> level-1 .. cfgcmd:: set protocols isis redistribute ipv4 <route source> level-1
This command redistributes routing information from the given route source This command redistributes routing information from the given route source
into the ISIS database as Level-1. There are six modes available for route into the ISIS database as Level-1. There are six modes available for route
source: bgp, connected, kernel, ospf, rip, static. source: bgp, connected, kernel, ospf, rip, static.
.. cfgcmd:: set protocols isis <name> redistribute ipv4 <route source> level-2 .. cfgcmd:: set protocols isis redistribute ipv4 <route source> level-2
This command redistributes routing information from the given route source This command redistributes routing information from the given route source
into the ISIS database as Level-2. There are six modes available for route into the ISIS database as Level-2. There are six modes available for route
source: bgp, connected, kernel, ospf, rip, static. source: bgp, connected, kernel, ospf, rip, static.
.. cfgcmd:: set protocols isis <name> redistribute ipv4 <route source> .. cfgcmd:: set protocols isis redistribute ipv4 <route source>
<level-1|level-2> metric <number> <level-1|level-2> metric <number>
This command specifies metric for redistributed routes from the given route This command specifies metric for redistributed routes from the given route
source. There are six modes available for route source: bgp, connected, source. There are six modes available for route source: bgp, connected,
kernel, ospf, rip, static. The metric range is 1 to 16777215. kernel, ospf, rip, static. The metric range is 1 to 16777215.
.. cfgcmd:: set protocols isis <name> redistribute ipv4 <route source> .. cfgcmd:: set protocols isis redistribute ipv4 <route source>
<level-1|level-2> route-map <name> <level-1|level-2> route-map <name>
This command allows to use route map to filter redistributed routes from This command allows to use route map to filter redistributed routes from
@ -210,15 +214,15 @@ Redistribution Configuration
bgp, connected, kernel, ospf, rip, static. bgp, connected, kernel, ospf, rip, static.
Timers Configuration Timers
-------------------- ------
.. cfgcmd:: set protocols isis <name> lsp-gen-interval <seconds> .. cfgcmd:: set protocols isis lsp-gen-interval <seconds>
This command sets minimum interval in seconds between regenerating same This command sets minimum interval in seconds between regenerating same
LSP. The interval range is 1 to 120. LSP. The interval range is 1 to 120.
.. cfgcmd:: set protocols isis <name> lsp-refresh-interval <seconds> .. cfgcmd:: set protocols isis lsp-refresh-interval <seconds>
This command sets LSP refresh interval in seconds. IS-IS generates LSPs This command sets LSP refresh interval in seconds. IS-IS generates LSPs
when the state of a link changes. However, to ensure that routing when the state of a link changes. However, to ensure that routing
@ -227,32 +231,32 @@ Timers Configuration
the state of the links. The interval range is 1 to 65235. The default the state of the links. The interval range is 1 to 65235. The default
value is 900 seconds. value is 900 seconds.
.. cfgcmd:: set protocols isis <name> max-lsp-lifetime <seconds> .. cfgcmd:: set protocols isis max-lsp-lifetime <seconds>
This command sets LSP maximum LSP lifetime in seconds. The interval range This command sets LSP maximum LSP lifetime in seconds. The interval range
is 350 to 65535. LSPs remain in a database for 1200 seconds by default. is 350 to 65535. LSPs remain in a database for 1200 seconds by default.
If they are not refreshed by that time, they are deleted. You can change If they are not refreshed by that time, they are deleted. You can change
the LSP refresh interval or the LSP lifetime. The LSP refresh interval the LSP refresh interval or the LSP lifetime. The LSP refresh interval
should be less than the LSP lifetime or else LSPs will time out before should be less than the LSP lifetime or else LSPs will time out before
they are refreshed. they are refreshed.
.. cfgcmd:: set protocols isis <name> spf-interval <seconds> .. cfgcmd:: set protocols isis spf-interval <seconds>
This command sets minimum interval between consecutive SPF calculations in This command sets minimum interval between consecutive SPF calculations in
seconds.The interval range is 1 to 120. seconds.The interval range is 1 to 120.
.. cfgcmd:: set protocols isis <name> spf-delay-ietf holddown <milliseconds> .. cfgcmd:: set protocols isis spf-delay-ietf holddown <milliseconds>
.. cfgcmd:: set protocols isis <name> spf-delay-ietf init-delay .. cfgcmd:: set protocols isis spf-delay-ietf init-delay
<milliseconds> <milliseconds>
.. cfgcmd:: set protocols isis <name> spf-delay-ietf long-delay .. cfgcmd:: set protocols isis spf-delay-ietf long-delay
<milliseconds> <milliseconds>
.. cfgcmd:: set protocols isis <name> spf-delay-ietf short-delay .. cfgcmd:: set protocols isis spf-delay-ietf short-delay
<milliseconds> <milliseconds>
.. cfgcmd:: set protocols isis <name> spf-delay-ietf time-to-learn .. cfgcmd:: set protocols isis spf-delay-ietf time-to-learn
<milliseconds> <milliseconds>
This commands specifies the Finite State Machine (FSM) intended to This commands specifies the Finite State Machine (FSM) intended to
@ -260,8 +264,9 @@ Timers Configuration
to IGP events. The process described in :rfc:`8405`. to IGP events. The process described in :rfc:`8405`.
Configuration Example *******
--------------------- Example
*******
Simple IS-IS configuration using 2 nodes and redistributing connected Simple IS-IS configuration using 2 nodes and redistributing connected
interfaces. interfaces.
@ -295,7 +300,7 @@ Show ip routes on Node2:
.. code-block:: none .. code-block:: none
vyos@r2:~$ show ip route isis vyos@r2:~$ show ip route isis
Codes: K - kernel route, C - connected, S - static, R - RIP, Codes: K - kernel route, C - connected, S - static, R - RIP,
O - OSPF, I - IS-IS, B - BGP, E - EIGRP, N - NHRP, O - OSPF, I - IS-IS, B - BGP, E - EIGRP, N - NHRP,
T - Table, v - VNC, V - VNC-Direct, A - Babel, D - SHARP, T - Table, v - VNC, V - VNC-Direct, A - Babel, D - SHARP,