diff options
author | Christian Poessinger <christian@poessinger.com> | 2019-11-28 21:41:53 +0100 |
---|---|---|
committer | Christian Poessinger <christian@poessinger.com> | 2019-11-28 21:41:53 +0100 |
commit | de3b09d6ac10405b72dfefdfe750a92d8eea30f6 (patch) | |
tree | fc493ef372dbe11ca9fea91d8a070b7e76a5ad25 /docs/interfaces | |
parent | 8d843d4a17ff0c249256a4be902607f3e83f16ab (diff) | |
download | vyos-documentation-de3b09d6ac10405b72dfefdfe750a92d8eea30f6.tar.gz vyos-documentation-de3b09d6ac10405b72dfefdfe750a92d8eea30f6.zip |
Refactor "code-block:: console" to "code-block:: none"
Diffstat (limited to 'docs/interfaces')
-rw-r--r-- | docs/interfaces/addresses.rst | 22 | ||||
-rw-r--r-- | docs/interfaces/bonding.rst | 14 | ||||
-rw-r--r-- | docs/interfaces/bridging.rst | 14 | ||||
-rw-r--r-- | docs/interfaces/dummy.rst | 2 | ||||
-rw-r--r-- | docs/interfaces/ethernet.rst | 6 | ||||
-rw-r--r-- | docs/interfaces/index.rst | 4 | ||||
-rw-r--r-- | docs/interfaces/l2tpv3.rst | 10 | ||||
-rw-r--r-- | docs/interfaces/pppoe.rst | 12 | ||||
-rw-r--r-- | docs/interfaces/qinq.rst | 4 | ||||
-rw-r--r-- | docs/interfaces/tunnel.rst | 22 | ||||
-rw-r--r-- | docs/interfaces/vlan.rst | 6 | ||||
-rw-r--r-- | docs/interfaces/vxlan.rst | 28 | ||||
-rw-r--r-- | docs/interfaces/wireless.rst | 6 |
13 files changed, 75 insertions, 75 deletions
diff --git a/docs/interfaces/addresses.rst b/docs/interfaces/addresses.rst index 188d1c00..6799b027 100644 --- a/docs/interfaces/addresses.rst +++ b/docs/interfaces/addresses.rst @@ -13,7 +13,7 @@ addresses might be: An interface description is assigned using the following command: -.. code-block:: console +.. code-block:: none set interfaces ethernet eth0 description 'OUTSIDE' @@ -29,7 +29,7 @@ PPP. The command is `set interfaces $type $name address $address`. Examples: -.. code-block:: console +.. code-block:: none set interfaces ethernet eth0 address 192.0.2.1/24 set interfaces tunnel tun0 address 10.0.0.1/30 @@ -45,7 +45,7 @@ pseudo-ethernet, wireless). The command is `set interfaces $type $name address dhcp`. Examples: -.. code-block:: console +.. code-block:: none set interfaces ethernet eth0 vif 90 address dhcp set interfaces bridge br0 address dhcp @@ -63,7 +63,7 @@ except :ref:`interfaces-tunnel`. The command is `set interfaces $type $name address $address`. Examples: -.. code-block:: console +.. code-block:: none set interfaces ethernet eth0 address 2001:db8:100::ffff/64 set interfaces tunnel tun0 address 2001:db8::1/64 @@ -79,7 +79,7 @@ pseudo-ethernet, wireless). The command is `set interfaces $type $name address dhcpv6`. Examples: -.. code-block:: console +.. code-block:: none set interfaces bonding bond1 address dhcpv6 set interfaces bridge br0 vif 56 address dhcpv6 @@ -93,7 +93,7 @@ interfaces, and those that are directly connected to a physical interface The command is `set interfaces $type $name ipv6 address autoconf`. Examples: -.. code-block:: console +.. code-block:: none set interfaces ethernet eth0 vif 90 ipv6 address autoconf set interfaces bridge br0 ipv6 address autoconf @@ -111,7 +111,7 @@ MAC address, if you specify the prefix. The command is `set interfaces $type $name ipv6 address eui64 $prefix`. Examples: -.. code-block:: console +.. code-block:: none set interfaces bridge br0 ipv6 address eui64 2001:db8:beef::/64 set interfaces pseudo-ethernet peth0 ipv6 address eui64 2001:db8:aa::/64 @@ -124,14 +124,14 @@ Router advertisements are described in `RFC4861 section 4.2`_. They are part of To enable or disable, use: -.. code-block:: console +.. code-block:: none set interfaces <interface> ipv6 router-advert send-advert <true or false> To set the options described in "Router Advertisement Message Format": -.. code-block:: console +.. code-block:: none vyos@vyos# set interfaces <interface> ipv6 router-advert Possible completions: @@ -154,7 +154,7 @@ To set the options described in "Router Advertisement Message Format": Prefix information is described in `RFC4861 section 4.6.2`_ -.. code-block:: console +.. code-block:: none vyos@vyos# set interfaces <interface> ipv6 router-advert prefix <h:h:h:h:h:h:h:h/x> Possible completions: @@ -167,7 +167,7 @@ Prefix information is described in `RFC4861 section 4.6.2`_ To receive and accept RAs on an interface, you need to enable it with the following configuration command -.. code-block:: console +.. code-block:: none vyos@vyos# set system sysctl custom net.ipv6.conf.<interface name>.accept_ra value 2 diff --git a/docs/interfaces/bonding.rst b/docs/interfaces/bonding.rst index 19d78e4e..76c8714a 100644 --- a/docs/interfaces/bonding.rst +++ b/docs/interfaces/bonding.rst @@ -6,13 +6,13 @@ logical one. It's called bonding, or LAG, or ether-channel, or port-channel. Create interface bondX, where X is just a number: -.. code-block:: console +.. code-block:: none set interfaces bonding bond0 description 'my-sw1 int 23 and 24' You are able to choose a hash policy: -.. code-block:: console +.. code-block:: none vyos@vyos# set interfaces bonding bond0 hash-policy Possible completions: @@ -22,20 +22,20 @@ You are able to choose a hash policy: For example: -.. code-block:: console +.. code-block:: none set interfaces bonding bond0 hash-policy 'layer2' You may want to set IEEE 802.3ad Dynamic link aggregation (802.3ad) AKA LACP (don't forget to setup it on the other end of these links): -.. code-block:: console +.. code-block:: none set interfaces bonding bond0 mode '802.3ad' or some other modes: -.. code-block:: console +.. code-block:: none vyos@vyos# set interfaces bonding bond0 mode Possible completions: @@ -52,7 +52,7 @@ or some other modes: Now bond some physical interfaces into bond0: -.. code-block:: console +.. code-block:: none set interfaces ethernet eth0 bond-group 'bond0' set interfaces ethernet eth0 description 'member of bond0' @@ -64,7 +64,7 @@ change its` duplex, for example) and assign IPs or VIFs on it. You may check the result: -.. code-block:: console +.. code-block:: none vyos@vyos# run sh interfaces bonding Codes: S - State, L - Link, u - Up, D - Down, A - Admin Down diff --git a/docs/interfaces/bridging.rst b/docs/interfaces/bridging.rst index 3c11a64b..8d9c905e 100644 --- a/docs/interfaces/bridging.rst +++ b/docs/interfaces/bridging.rst @@ -7,7 +7,7 @@ Layer-2 traffic. A bridge is created when a bridge interface is defined. In the example below we will be creating a bridge for VLAN 100 and assigning a VIF to the bridge. -.. code-block:: console +.. code-block:: none set interfaces bridge 'br100' ~~set interfaces ethernet eth1 vif 100 bridge-group bridge br100~~ @@ -17,14 +17,14 @@ Interfaces assigned to a bridge-group do not have address configuration. An IP address can be assigned to the bridge interface itself, however, like any normal interface. -.. code-block:: console +.. code-block:: none set interfaces bridge br100 address '192.168.100.1/24' set interfaces bridge br100 address '2001:db8:100::1/64' Example Result: -.. code-block:: console +.. code-block:: none bridge br100 { address 192.168.100.1/24 @@ -49,7 +49,7 @@ Spanning-Tree Protocol. STP is disabled by default. To enable spanning-tree use the `set interfaces bridge <name> stp true` command: -.. code-block:: console +.. code-block:: none set interfaces bridge br100 stp true @@ -63,7 +63,7 @@ configured. The `show bridge` operational command can be used to display configured bridges: -.. code-block:: console +.. code-block:: none vyos@vyos:~$ show bridge bridge name bridge id STP enabled interfaces @@ -72,7 +72,7 @@ bridges: If spanning-tree is enabled, the `show bridge <name> spanning-tree` command can be used to show STP configuration: -.. code-block:: console +.. code-block:: none vyos@vyos:~$ show bridge br100 spanning-tree br100 @@ -98,7 +98,7 @@ can be used to show STP configuration: The MAC address-table for a bridge can be displayed using the `show bridge <name> macs` command: -.. code-block:: console +.. code-block:: none vyos@vyos:~$ show bridge br100 macs port no mac addr is local? ageing timer diff --git a/docs/interfaces/dummy.rst b/docs/interfaces/dummy.rst index 0479cf5e..dea4c387 100644 --- a/docs/interfaces/dummy.rst +++ b/docs/interfaces/dummy.rst @@ -8,7 +8,7 @@ Dummy interfaces can be used as interfaces that always stay up (in the same fash Configuration commands: -.. code-block:: console +.. code-block:: none interfaces dummy <dum[0-999]> diff --git a/docs/interfaces/ethernet.rst b/docs/interfaces/ethernet.rst index 34260fc2..c7744b6c 100644 --- a/docs/interfaces/ethernet.rst +++ b/docs/interfaces/ethernet.rst @@ -6,7 +6,7 @@ Ethernet Interfaces Ethernet interfaces allow for the configuration of speed, duplex, and hw-id (MAC address). Below is an example configuration: -.. code-block:: console +.. code-block:: none set interfaces ethernet eth1 address '192.168.0.1/24' set interfaces ethernet eth1 address '2001:db8:1::ffff/64' @@ -16,7 +16,7 @@ Ethernet interfaces allow for the configuration of speed, duplex, and hw-id Resulting in: -.. code-block:: console +.. code-block:: none ethernet eth1 { address 192.168.0.1/24 @@ -35,7 +35,7 @@ In addition, Ethernet interfaces provide the extended operational commands: Statistics available are driver dependent. -.. code-block:: console +.. code-block:: none vyos@vyos:~$ show interfaces ethernet eth0 physical Settings for eth0: diff --git a/docs/interfaces/index.rst b/docs/interfaces/index.rst index 5d7caf1c..aa8d264e 100644 --- a/docs/interfaces/index.rst +++ b/docs/interfaces/index.rst @@ -6,7 +6,7 @@ Network Interfaces Configured interfaces on a VyOS system can be displayed using the `show interfaces` command. -.. code-block:: console +.. code-block:: none vyos@vyos:~$ show interfaces Codes: S - State, L - Link, u - Up, D - Down, A - Admin Down @@ -21,7 +21,7 @@ Configured interfaces on a VyOS system can be displayed using the A specific interface can be shown using the `show interfaces <type> <name>` command. -.. code-block:: console +.. code-block:: none vyos@vyos:~$ show interfaces ethernet eth0 eth0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc pfifo_fast state UP qlen 1000 diff --git a/docs/interfaces/l2tpv3.rst b/docs/interfaces/l2tpv3.rst index a3fe3cd8..4514412d 100644 --- a/docs/interfaces/l2tpv3.rst +++ b/docs/interfaces/l2tpv3.rst @@ -11,7 +11,7 @@ L2TPv3 can transport any traffic including ethernet frames. L2TPv2 is limited to L2TPv3 over IP ^^^^^^^^^^^^^^ -.. code-block:: console +.. code-block:: none # show interfaces l2tpv3 l2tpv3 l2tpeth10 { @@ -35,7 +35,7 @@ UDP mode works better with NAT: * Set local-ip to your local IP (LAN). * Add a forwarding rule matching UDP port on your internet router. -.. code-block:: console +.. code-block:: none # show interfaces l2tpv3 l2tpv3 l2tpeth10 { @@ -61,7 +61,7 @@ This is the LAN extension use case. The eth0 port of the distant VPN peers will IPSec: -.. code-block:: console +.. code-block:: none set vpn ipsec ipsec-interfaces <VPN-interface> set vpn ipsec esp-group test-ESP-1 compression 'disable' @@ -89,7 +89,7 @@ IPSec: Bridge: -.. code-block:: console +.. code-block:: none set interfaces bridge br0 description 'L2 VPN Bridge' # remote side in this example: @@ -100,7 +100,7 @@ Bridge: L2TPv3: -.. code-block:: console +.. code-block:: none set interfaces l2tpv3 l2tpeth0 bridge-group bridge 'br0' set interfaces l2tpv3 l2tpeth0 description 'L2 VPN Tunnel' diff --git a/docs/interfaces/pppoe.rst b/docs/interfaces/pppoe.rst index 803b43fb..d8625722 100644 --- a/docs/interfaces/pppoe.rst +++ b/docs/interfaces/pppoe.rst @@ -22,7 +22,7 @@ Once you have an Ethernet device connected, i.e. eth0, then you can configure it **Here is an example configuration:** -.. code-block:: console +.. code-block:: none set interface ethernet eth0 description "DSL Modem" set interface ethernet eth0 duplex auto @@ -37,7 +37,7 @@ Once you have an Ethernet device connected, i.e. eth0, then you can configure it * You should add a firewall to your configuration above as well by assigning it to the pppoe0 itself as shown here: -.. code-block:: console +.. code-block:: none set interface ethernet eth0 pppoe 0 firewall in name NET-IN set interface ethernet eth0 pppoe 0 firewall local name NET-LOCAL @@ -52,7 +52,7 @@ Handling and troubleshooting You can test connecting and disconnecting with the below commands: -.. code-block:: console +.. code-block:: none disconnect interface 0 connect interface 0 @@ -62,20 +62,20 @@ You can check the PPPoE connection logs with the following: This command shows the current statistics, status and some of the settings (i.e. MTU) for the current connection on pppoe0. -.. code-block:: console +.. code-block:: none show interfaces pppoe 0 This command shows the entire log for the PPPoE connection starting with the oldest data. Scroll down with the <space> key to reach the end where the current data is. -.. code-block:: console +.. code-block:: none show interfaces pppoe 0 log This command shows the same log as without the 'tail' option but only starts with the last few lines and continues to show added lines until you exit with ``Ctrl + x`` -.. code-block:: console +.. code-block:: none show interfaces pppoe 0 log tail diff --git a/docs/interfaces/qinq.rst b/docs/interfaces/qinq.rst index f94ccda4..2049f511 100644 --- a/docs/interfaces/qinq.rst +++ b/docs/interfaces/qinq.rst @@ -14,7 +14,7 @@ The outer tag is the one closer/closest to the Ethernet header; its name is S-TA Configuration commands: -.. code-block:: console +.. code-block:: none interfaces ethernet <eth[0-999]> @@ -48,7 +48,7 @@ Configuration commands: Example: -.. code-block:: console +.. code-block:: none set interfaces ethernet eth0 vif-s 333 set interfaces ethernet eth0 vif-s 333 address 192.0.2.10/32 diff --git a/docs/interfaces/tunnel.rst b/docs/interfaces/tunnel.rst index 2f884270..da452a8b 100644 --- a/docs/interfaces/tunnel.rst +++ b/docs/interfaces/tunnel.rst @@ -18,7 +18,7 @@ It takes an IPv4 packet and sends it as a payload of another IPv4 packet. For th An example: -.. code-block:: console +.. code-block:: none set interfaces tunnel tun0 encapsulation ipip set interfaces tunnel tun0 local-ip 192.0.2.10 @@ -34,7 +34,7 @@ It's not likely that anyone will need it any time soon, but it does exist. An example: -.. code-block:: console +.. code-block:: none set interfaces tunnel tun0 encapsulation ipip set interfaces tunnel tun0 local-ip 2001:db8:aa::1/64 @@ -50,7 +50,7 @@ As the name implies, it's IPv4 encapsulated in IPv6, as simple as that. An example: -.. code-block:: console +.. code-block:: none set interfaces tunnel tun0 encapsulation ipip6 set interfaces tunnel tun0 local-ip 2001:db8:aa::1/64 @@ -68,7 +68,7 @@ The encapsulation overhead is the size of the IPv4 header of 20 bytes, therefore An example: -.. code-block:: console +.. code-block:: none set interfaces tunnel tun0 encapsulation sit set interfaces tunnel tun0 local-ip 192.0.2.10 @@ -96,7 +96,7 @@ The Cisco router defaults to 'gre ip' otherwise it would have to be configured a **VyOS Router:** -.. code-block:: console +.. code-block:: none set interfaces tunnel tun100 address '10.0.0.1/30' set interfaces tunnel tun100 encapsulation 'gre' @@ -105,7 +105,7 @@ The Cisco router defaults to 'gre ip' otherwise it would have to be configured a **Cisco IOS Router:** -.. code-block:: console +.. code-block:: none interface Tunnel100 ip address 10.0.0.2 255.255.255.252 @@ -122,7 +122,7 @@ configurations that are discarding IP protocol 47 or blocking your source/desint **1. Confirm IP connectivity between tunnel local-ip and remote-ip:** -.. code-block:: console +.. code-block:: none vyos@vyos:~$ ping 203.0.113.10 interface 198.51.100.2 count 4 PING 203.0.113.10 (203.0.113.10) from 198.51.100.2 : 56(84) bytes of data. @@ -137,7 +137,7 @@ configurations that are discarding IP protocol 47 or blocking your source/desint **2. Confirm the link type has been set to GRE:** -.. code-block:: console +.. code-block:: none vyos@vyos:~$ show interfaces tunnel tun100 tun100@NONE: <POINTOPOINT,NOARP,UP,LOWER_UP> mtu 1476 qdisc noqueue state UNKNOWN group default qlen 1000 @@ -154,7 +154,7 @@ configurations that are discarding IP protocol 47 or blocking your source/desint **3. Confirm IP connectivity across the tunnel:** -.. code-block:: console +.. code-block:: none vyos@vyos:~$ ping 10.0.0.2 interface 10.0.0.1 count 4 PING 10.0.0.2 (10.0.0.2) from 10.0.0.1 : 56(84) bytes of data. @@ -172,14 +172,14 @@ Virtual Tunnel Interface (VTI) Set Virtual Tunnel Interface -.. code-block:: console +.. code-block:: none set interfaces vti vti0 address 192.168.2.249/30 set interfaces vti vti0 address 2001:db8:2::249/64 Results in: -.. code-block:: console +.. code-block:: none vyos@vyos# show interfaces vti vti vti0 { diff --git a/docs/interfaces/vlan.rst b/docs/interfaces/vlan.rst index cbab0a80..b2f67108 100644 --- a/docs/interfaces/vlan.rst +++ b/docs/interfaces/vlan.rst @@ -7,7 +7,7 @@ term used for this is `vif`. Configuration of a tagged sub-interface is accomplished using the configuration command `set interfaces ethernet <name> vif <vlan-id>`. -.. code-block:: console +.. code-block:: none set interfaces ethernet eth1 vif 100 description 'VLAN 100' set interfaces ethernet eth1 vif 100 address '192.168.100.1/24' @@ -15,7 +15,7 @@ accomplished using the configuration command Resulting in: -.. code-block:: console +.. code-block:: none ethernet eth1 { address 192.168.100.1/24 @@ -33,7 +33,7 @@ Resulting in: VLAN interfaces are shown as `<name>.<vlan-id>`, e.g. `eth1.100`: -.. code-block:: console +.. code-block:: none vyos@vyos:~$ show interfaces Codes: S - State, L - Link, u - Up, D - Down, A - Admin Down diff --git a/docs/interfaces/vxlan.rst b/docs/interfaces/vxlan.rst index a4de5766..e3eb5c43 100644 --- a/docs/interfaces/vxlan.rst +++ b/docs/interfaces/vxlan.rst @@ -44,7 +44,7 @@ support this. Configuration commands ^^^^^^^^^^^^^^^^^^^^^^ -.. code-block:: console +.. code-block:: none interfaces vxlan <vxlan[0-16777215]> @@ -74,7 +74,7 @@ This topology was built using GNS3. Topology: -.. code-block:: console +.. code-block:: none Spine1: fa0/2 towards Leaf2, IP-address: 10.1.2.1/24 @@ -90,7 +90,7 @@ Topology: Spine1 Configuration: -.. code-block:: console +.. code-block:: none conf t ip multicast-routing @@ -113,7 +113,7 @@ from. Leaf2 configuration: -.. code-block:: console +.. code-block:: none set interfaces ethernet eth0 address '10.1.2.2/24' set protocols ospf area 0 network '10.0.0.0/8' @@ -136,7 +136,7 @@ Leaf2 configuration: Leaf3 configuration: -.. code-block:: console +.. code-block:: none set interfaces ethernet eth0 address '10.1.3.3/24' set protocols ospf area 0 network '10.0.0.0/8' @@ -161,7 +161,7 @@ As you can see, Leaf2 and Leaf3 configuration is almost identical. There are lots of commands above, I'll try to into more detail below, command descriptions are placed under the command boxes: -.. code-block:: console +.. code-block:: none set interfaces bridge br241 address '172.16.241.1/24' @@ -173,7 +173,7 @@ so that the Spine will learn how to reach it. To do this you need to change the OSPF network from '10.0.0.0/8' to '0.0.0.0/0' to allow 172.16/12-networks to be advertised. -.. code-block:: console +.. code-block:: none set interfaces ethernet eth1 vif 241 bridge-group bridge 'br241' set interfaces vxlan vxlan241 bridge-group bridge 'br241' @@ -181,28 +181,28 @@ advertised. Binds eth1 vif 241 and vxlan241 to each other by putting them in the same bridge-group. Internal VyOS requirement. -.. code-block:: console +.. code-block:: none set interfaces vxlan vxlan241 group '239.0.0.241' The multicast-group used by all Leafs for this vlan extension. Has to be the same on all Leafs that has this interface. -.. code-block:: console +.. code-block:: none set interfaces vxlan vxlan241 link 'eth0' Sets the interface to listen for multicast packets on. Could be a loopback, not yet tested. -.. code-block:: console +.. code-block:: none set interfaces vxlan vxlan241 vni '241' Sets the unique id for this vxlan-interface. Not sure how it correlates with multicast-address. -.. code-block:: console +.. code-block:: none set interfaces vxlan vxlan241 remote-port 12345 @@ -217,7 +217,7 @@ Older Examples Example for bridging normal L2 segment and vxlan overlay network, and using a vxlan interface as routing interface. -.. code-block:: console +.. code-block:: none interfaces { bridge br0 { @@ -248,7 +248,7 @@ router has a VLAN interface (26) facing the client devices and a VLAN interface can flow between both routers' VLAN 26, but can't escape since there is no L3 gateway. You can add an IP to a bridge-group to create a gateway. -.. code-block:: console +.. code-block:: none interfaces { bridge br0 { @@ -284,7 +284,7 @@ Alternative to multicast, the remote IPv4 address of the VXLAN tunnel can set di Let's change the Multicast example from above: -.. code-block:: console +.. code-block:: none # leaf2 and leaf3 delete interfaces vxlan vxlan241 group '239.0.0.241' diff --git a/docs/interfaces/wireless.rst b/docs/interfaces/wireless.rst index 8bc5d434..a7e796e9 100644 --- a/docs/interfaces/wireless.rst +++ b/docs/interfaces/wireless.rst @@ -9,13 +9,13 @@ If your device is configurable it will appear as `wlan` in `show interfaces`. To be able to use the wireless interfaces you will first need to set a regulatory domain with the country code of your locaion. -.. code-block:: console +.. code-block:: none set system wifi-regulatory-domain SE An example on how to set it up as an access point: -.. code-block:: console +.. code-block:: none set interfaces wireless wlan0 address '192.168.99.1/24' set interfaces wireless wlan0 type access-point @@ -27,7 +27,7 @@ An example on how to set it up as an access point: Resulting in -.. code-block:: console +.. code-block:: none interfaces { [...] |