From 4f09fdd987db7717822f5e3ac5a59752ed1137fd Mon Sep 17 00:00:00 2001 From: Christian Poessinger Date: Sun, 21 Mar 2021 17:53:12 +0100 Subject: isis: adjust to latest CLI changes The previous tagNode was replaced with a regular node. --- docs/configuration/protocols/isis.rst | 161 ++++++++++++++++++---------------- 1 file changed, 83 insertions(+), 78 deletions(-) (limited to 'docs/configuration') diff --git a/docs/configuration/protocols/isis.rst b/docs/configuration/protocols/isis.rst index 05a851f1..ecc5ced7 100644 --- a/docs/configuration/protocols/isis.rst +++ b/docs/configuration/protocols/isis.rst @@ -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 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: +******* +General +******* + +Configuration +============= + +Mandatory Settings +------------------ + +.. cfgcmd:: set protocols isis net - :abbr:`AFI (Address family authority identifier)` - ``49`` The AFI value 49 is what IS-IS uses for private addressing. + This commad also sets network entity title (NET) provided in ISO format. - Area identifier: - ``0001`` IS-IS area number (Area1) + For example :abbr:`NET (Network Entity Title)` - System identifier: - ``1921.6800.1002`` For system idetifier we recommend to use IP address or - MAC address of the router. + .. code-block:: none - NET selector: - ``00`` Must always be 00, to indicate "this system". + 49.0001.1921.6800.1002.00 + The IS-IS address consists of the following parts: -General Configuration ---------------------- + * :abbr:`AFI (Address family authority identifier)` - ``49`` The AFI value + 49 is what IS-IS uses for private addressing. -.. cfgcmd:: set protocols isis net + * Area identifier: ``0001`` IS-IS area number (Area1) - This command enables the ISIS process by specifying the ISIS domain with - ‘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. + * System identifier: ``1921.6800.1002`` - for system idetifiers we recommend + to use IP address or MAC address of the router itself. -.. cfgcmd:: set protocols isis interface + * NET selector: ``00`` Must always be 00, to indicate "this system". + +.. cfgcmd:: set protocols isis interface 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 process. - -.. cfgcmd:: set protocols isis dynamic-hostname + +.. cfgcmd:: set protocols isis dynamic-hostname This command enables support for dynamic hostname. Dynamic hostname mapping determined as described in :rfc:`2763`, Dynamic Hostname Exchange Mechanism for IS-IS. -.. cfgcmd:: set protocols isis level +.. cfgcmd:: set protocols isis level 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-2-only** Act as an area router only. -.. cfgcmd:: set protocols isis lsp-mtu +.. cfgcmd:: set protocols isis lsp-mtu This command configures the maximum size of generated LSPs, in bytes. The size range is 128 to 4352. -.. cfgcmd:: set protocols isis metric-style +.. cfgcmd:: set protocols isis metric-style 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. **wide** Use new style of TLVs to carry wider metric. -.. cfgcmd:: set protocols isis purge-originator +.. cfgcmd:: set protocols isis purge-originator This command enables :rfc:`6232` purge originator identification. Enable purge originator identification (POI) by adding the type, length and value (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 - with the system ID of the IS to the purge. + with the system ID of the IS to the purge. -.. cfgcmd:: set protocols isis 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`. -.. cfgcmd:: set protocols isis set-overload-bit +.. cfgcmd:: set protocols isis set-overload-bit This command sets overload bit to avoid any transit traffic through this router. It is described in :rfc:`3787`. @@ -102,107 +105,108 @@ General Configuration level-1 This command will generate a default-route in L1 database. - + .. cfgcmd:: set protocols isis name default-information originate level-2 This command will generate a default-route in L2 database. -Interfaces Configuration ------------------------- +Interface Configuration +----------------------- -.. cfgcmd:: set protocols isis interface circuit-type +.. cfgcmd:: set protocols isis interface circuit-type This command specifies 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 + * **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 -.. cfgcmd:: set protocols isis interface hello-interval +.. cfgcmd:: set protocols isis interface hello-interval This command sets hello interval in seconds on a given interface. The range is 1 to 600. -.. cfgcmd:: set protocols isis interface hello-multiplier +.. cfgcmd:: set protocols isis interface hello-multiplier - 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. -.. cfgcmd:: set protocols isis interface hello-padding +.. cfgcmd:: set protocols isis interface hello-padding This command configures padding on hello packets to accommodate asymmetrical maximum transfer units (MTUs) from different hosts as described in :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 - adjacency. + routing devices MTU does not meet the requirements to establish the adjacency. -.. cfgcmd:: set protocols isis interface metric +.. cfgcmd:: set protocols isis interface metric - This command set default metric for circuit. The metric range is 1 to - 16777215 (Max value depend if metric support narrow or wide value). + This command set default metric for circuit. -.. cfgcmd:: set protocols isis interface network + The metric range is 1 to 16777215 (Max value depend if metric support narrow + or wide value). + +.. cfgcmd:: set protocols isis interface network point-to-point - This command specifies network type to ‘Point-to-Point’. The default network - type is broadcast. + This command specifies network type to Point-to-Point. The default + network type is broadcast. -.. cfgcmd:: set protocols isis interface passive +.. cfgcmd:: set protocols isis interface passive This command configures the passive mode for this interface. -.. cfgcmd:: set protocols isis interface password +.. cfgcmd:: set protocols isis interface password plaintext-password This command configures the authentication password for the interface. -.. cfgcmd:: set protocols isis interface priority +.. cfgcmd:: set protocols isis interface priority This command sets priority for the interface for :abbr:`DIS (Designated Intermediate System)` election. The priority range is 0 to 127. -.. cfgcmd:: set protocols isis interface psnp-interval +.. cfgcmd:: set protocols isis interface psnp-interval This command sets PSNP interval in seconds. The interval range is 0 to 127. -.. cfgcmd:: set protocols isis interface +.. cfgcmd:: set protocols isis interface no-three-way-handshake This command disables Three-Way Handshake for P2P adjacencies which described in :rfc:`5303`. Three-Way Handshake is enabled by default. -Redistribution Configuration ----------------------------- +Route Redistribution +-------------------- -.. cfgcmd:: set protocols isis redistribute ipv4 level-1 +.. cfgcmd:: set protocols isis redistribute ipv4 level-1 This command redistributes routing information from the given route source into the ISIS database as Level-1. There are six modes available for route source: bgp, connected, kernel, ospf, rip, static. -.. cfgcmd:: set protocols isis redistribute ipv4 level-2 +.. cfgcmd:: set protocols isis redistribute ipv4 level-2 This command redistributes routing information from the given route source into the ISIS database as Level-2. There are six modes available for route source: bgp, connected, kernel, ospf, rip, static. - -.. cfgcmd:: set protocols isis redistribute ipv4 + +.. cfgcmd:: set protocols isis redistribute ipv4 metric This command specifies metric for redistributed routes from the given route source. There are six modes available for route source: bgp, connected, kernel, ospf, rip, static. The metric range is 1 to 16777215. -.. cfgcmd:: set protocols isis redistribute ipv4 +.. cfgcmd:: set protocols isis redistribute ipv4 route-map This command allows to use route map to filter redistributed routes from @@ -210,15 +214,15 @@ Redistribution Configuration bgp, connected, kernel, ospf, rip, static. -Timers Configuration --------------------- +Timers +------ -.. cfgcmd:: set protocols isis lsp-gen-interval +.. cfgcmd:: set protocols isis lsp-gen-interval This command sets minimum interval in seconds between regenerating same LSP. The interval range is 1 to 120. - -.. cfgcmd:: set protocols isis lsp-refresh-interval + +.. cfgcmd:: set protocols isis lsp-refresh-interval This command sets LSP refresh interval in seconds. IS-IS generates LSPs 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 value is 900 seconds. -.. cfgcmd:: set protocols isis max-lsp-lifetime +.. cfgcmd:: set protocols isis max-lsp-lifetime 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. 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 should be less than the LSP lifetime or else LSPs will time out before - they are refreshed. - -.. cfgcmd:: set protocols isis spf-interval + they are refreshed. + +.. cfgcmd:: set protocols isis spf-interval This command sets minimum interval between consecutive SPF calculations in seconds.The interval range is 1 to 120. -.. cfgcmd:: set protocols isis spf-delay-ietf holddown +.. cfgcmd:: set protocols isis spf-delay-ietf holddown -.. cfgcmd:: set protocols isis spf-delay-ietf init-delay +.. cfgcmd:: set protocols isis spf-delay-ietf init-delay -.. cfgcmd:: set protocols isis spf-delay-ietf long-delay +.. cfgcmd:: set protocols isis spf-delay-ietf long-delay -.. cfgcmd:: set protocols isis spf-delay-ietf short-delay +.. cfgcmd:: set protocols isis spf-delay-ietf short-delay -.. cfgcmd:: set protocols isis spf-delay-ietf time-to-learn +.. cfgcmd:: set protocols isis spf-delay-ietf time-to-learn 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`. -Configuration Example ---------------------- +******* +Example +******* Simple IS-IS configuration using 2 nodes and redistributing connected interfaces. @@ -295,7 +300,7 @@ Show ip routes on Node2: .. 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, O - OSPF, I - IS-IS, B - BGP, E - EIGRP, N - NHRP, T - Table, v - VNC, V - VNC-Direct, A - Babel, D - SHARP, -- cgit v1.2.3