diff options
| -rw-r--r-- | docs/_static/images/qos1.png | bin | 0 -> 135527 bytes | |||
| -rw-r--r-- | docs/_static/images/qos10.png | bin | 0 -> 119669 bytes | |||
| -rw-r--r-- | docs/_static/images/qos2.png | bin | 0 -> 140834 bytes | |||
| -rw-r--r-- | docs/_static/images/qos3.png | bin | 0 -> 16699 bytes | |||
| -rw-r--r-- | docs/_static/images/qos4.png | bin | 0 -> 17273 bytes | |||
| -rw-r--r-- | docs/_static/images/qos5.png | bin | 0 -> 15868 bytes | |||
| -rw-r--r-- | docs/_static/images/qos6.png | bin | 0 -> 139244 bytes | |||
| -rw-r--r-- | docs/_static/images/qos7.png | bin | 0 -> 17775 bytes | |||
| -rw-r--r-- | docs/_static/images/qos8.png | bin | 0 -> 17368 bytes | |||
| -rw-r--r-- | docs/_static/images/qos9.png | bin | 0 -> 17065 bytes | |||
| -rw-r--r-- | docs/configexamples/index.rst | 1 | ||||
| -rw-r--r-- | docs/configexamples/qos.rst | 183 |
12 files changed, 184 insertions, 0 deletions
diff --git a/docs/_static/images/qos1.png b/docs/_static/images/qos1.png Binary files differnew file mode 100644 index 00000000..9c16e6a3 --- /dev/null +++ b/docs/_static/images/qos1.png diff --git a/docs/_static/images/qos10.png b/docs/_static/images/qos10.png Binary files differnew file mode 100644 index 00000000..2f90ffe7 --- /dev/null +++ b/docs/_static/images/qos10.png diff --git a/docs/_static/images/qos2.png b/docs/_static/images/qos2.png Binary files differnew file mode 100644 index 00000000..4d351344 --- /dev/null +++ b/docs/_static/images/qos2.png diff --git a/docs/_static/images/qos3.png b/docs/_static/images/qos3.png Binary files differnew file mode 100644 index 00000000..97efaeb7 --- /dev/null +++ b/docs/_static/images/qos3.png diff --git a/docs/_static/images/qos4.png b/docs/_static/images/qos4.png Binary files differnew file mode 100644 index 00000000..b87b256e --- /dev/null +++ b/docs/_static/images/qos4.png diff --git a/docs/_static/images/qos5.png b/docs/_static/images/qos5.png Binary files differnew file mode 100644 index 00000000..4a615755 --- /dev/null +++ b/docs/_static/images/qos5.png diff --git a/docs/_static/images/qos6.png b/docs/_static/images/qos6.png Binary files differnew file mode 100644 index 00000000..907d6104 --- /dev/null +++ b/docs/_static/images/qos6.png diff --git a/docs/_static/images/qos7.png b/docs/_static/images/qos7.png Binary files differnew file mode 100644 index 00000000..03ec5cd1 --- /dev/null +++ b/docs/_static/images/qos7.png diff --git a/docs/_static/images/qos8.png b/docs/_static/images/qos8.png Binary files differnew file mode 100644 index 00000000..3566ac00 --- /dev/null +++ b/docs/_static/images/qos8.png diff --git a/docs/_static/images/qos9.png b/docs/_static/images/qos9.png Binary files differnew file mode 100644 index 00000000..67d8afd2 --- /dev/null +++ b/docs/_static/images/qos9.png diff --git a/docs/configexamples/index.rst b/docs/configexamples/index.rst index c25b3ee8..7f6e56a5 100644 --- a/docs/configexamples/index.rst +++ b/docs/configexamples/index.rst @@ -19,6 +19,7 @@ This chapter contains various configuration examples: l3vpn-hub-and-spoke inter-vrf-routing-vrf-lite openvpn-ldap + qos Configuration Blueprints (autotest) diff --git a/docs/configexamples/qos.rst b/docs/configexamples/qos.rst new file mode 100644 index 00000000..c73158bd --- /dev/null +++ b/docs/configexamples/qos.rst @@ -0,0 +1,183 @@ +:lastproofread: 2023-02-18 + +.. _examples-qos: + +########### +QoS example +########### + +Configuration 'dcsp' and shaper using QoS +========================================= + +In this case, we'll try to make a simple lab using QoS and the general ability of the VyOS system. +Before we recommend you noticed the main article about QoS + +| :ref:configuration/trafficpolicy/index:qos + +Using the general schema for example: + +.. image:: /_static/images/qos1.png + :width: 80% + :align: center + :alt: Network Topology Diagram + +We have four hosts on the local network 172.17.1.0/24. All hosts are labeled CS0 by default. We need to replace labels on all hosts except vpc8. +We will replace the labels on the nearest router “VyOS3” using the IP addresses of the sources. + +* 172.17.1.2 CS0 -> CS4 +* 172.17.1.3 CS0 -> CS5 +* 172.17.1.4 CS0 -> CS6 +* 172.17.1.40 CS0 by default + +Next, we will replace only all CS4 labels on the “VyOS2” router. + +* CS4 -> CS5 + +In the end, we will configure the traffic shaper using QoS mechanisms on the “VYOS2” router. + +Configuration: +============== + +Set IP addresses on all VPCs and a default gateway 172.17.1.1. We'll use in this case only static routes. +On the VyOS3 router, we need to change the 'dscp' labels for the VPCs. To do this, we use this configuration. + +.. code-block:: none + + set interfaces ethernet eth0 address '10.1.1.100/24' + set interfaces ethernet eth0 traffic-policy out 'vyos3' + set interfaces ethernet eth1 address '172.17.1.1/24' + set protocols static route 0.0.0.0/0 next-hop 10.1.1.1 + set traffic-policy shaper vyos3 class 10 match ADDRESS10 ip source address '172.17.1.2/32' + set traffic-policy shaper vyos3 class 10 set-dscp 'CS4' + set traffic-policy shaper vyos3 class 20 match ADDRESS20 ip source address '172.17.1.3/32' + set traffic-policy shaper vyos3 class 20 set-dscp 'CS5' + set traffic-policy shaper vyos3 class 30 match ADDRESS20 ip source address '172.17.1.4/32' + set traffic-policy shaper vyos3 class 30 set-dscp 'CS6' + set traffic-policy shaper vyos3 default bandwidth '10%' + set traffic-policy shaper vyos3 default ceiling '100%' + set traffic-policy shaper vyos3 default priority '7' + set traffic-policy shaper vyos3 default queue-type 'fair-queue' + +Main rules: + +* ADDRESS10 change CS0 -> CS4 source 172.17.1.2/32 +* ADDRESS20 change CS0 -> CS5 source 172.17.1.3/32 +* ADDRESS30 change CS0 -> CS6 source 172.17.1.4/32 + + +Check the result + +.. image:: /_static/images/qos2.png + :width: 80% + :align: center + :alt: Network Topology Diagram + +Before the interface eth0 on router VyOS3 + +.. image:: /_static/images/qos3.png + :width: 80% + :align: center + :alt: Network Topology Diagram + +After the interface eth0 on router VyOS3 + +.. image:: /_static/images/qos4.png + :width: 80% + :align: center + :alt: Network Topology Diagram + +On the router, VyOS4 set all traffic as CS4. We have to configure the default class and class for changing all labels from CS0 to CS4 + +.. code-block:: none + + set interfaces ethernet eth0 address '10.2.1.100/24' + set interfaces ethernet eth0 traffic-policy out 'vyos4' + set protocols static route 0.0.0.0/0 next-hop 10.2.1.1 + set traffic-policy shaper vyos4 class 10 bandwidth '100%' + set traffic-policy shaper vyos4 class 10 burst '15k' + set traffic-policy shaper vyos4 class 10 match ALL ether protocol 'all' + set traffic-policy shaper vyos4 class 10 queue-type 'fair-queue' + set traffic-policy shaper vyos4 class 10 set-dscp 'CS4' + set traffic-policy shaper vyos4 default bandwidth '10%' + set traffic-policy shaper vyos4 default burst '15k' + set traffic-policy shaper vyos4 default ceiling '100%' + set traffic-policy shaper vyos4 default priority '7' + set traffic-policy shaper vyos4 default queue-type 'fair-queue' + +Next on the router VyOS2 we will change labels on all incoming traffic only from CS4-> CS6 + +.. image:: /_static/images/qos5.png + :width: 80% + :align: center + :alt: Network Topology Diagram + +.. code-block:: none + + set interfaces ethernet eth0 address '10.1.1.1/24' + set interfaces ethernet eth1 address '10.2.1.1/24' + set interfaces ethernet eth2 address '10.9.9.1/24' + set interfaces ethernet eth2 traffic-policy out 'vyos2' + set protocols static route 172.17.1.0/24 next-hop 10.1.1.100 + set traffic-policy shaper vyos2 class 10 bandwidth '100%' + set traffic-policy shaper vyos2 class 10 burst '15k' + set traffic-policy shaper vyos2 class 10 match VYOS2 ip dscp 'CS4' + set traffic-policy shaper vyos2 class 10 queue-type 'fair-queue' + set traffic-policy shaper vyos2 class 10 set-dscp 'CS5' + set traffic-policy shaper vyos2 default bandwidth '100%' + set traffic-policy shaper vyos2 default burst '15k' + set traffic-policy shaper vyos2 default ceiling '100%' + set traffic-policy shaper vyos2 default priority '7' + set traffic-policy shaper vyos2 default queue-type 'fair-queue' + +.. image:: /_static/images/qos6.png + :width: 80% + :align: center + :alt: Network Topology Diagram + +* 172.17.1.2/24 CS0 + +.. image:: /_static/images/qos7.png + :width: 80% + :align: center + :alt: Network Topology Diagram + +* 172.17.1.2/24 CS0 - > CS4 + +.. image:: /_static/images/qos8.png + :width: 80% + :align: center + :alt: Network Topology Diagram + +* 172.17.1.2/24 CS4 - > CS5 + +.. image:: /_static/images/qos9.png + :width: 80% + :align: center + :alt: Network Topology Diagram + +In the end, on the router “VyOS2” we will set outgoing bandwidth limits between the “VyOS3” and “VyOS1” routers. Let's set a limit for IP 10.1.1.100 = 5 Mbps(Tx). We will check the result of the work with the help of the “iPerf” utility. + +Set up bandwidth limits on the eth2 interface of the router “VyOS2”. + +.. code-block:: none + + + vyos@vyos2# show traffic-policy shaper vyos2 class 20 + bandwidth 5mbit + description "for VyOS3 eth0" + match VyOS3 { + ip { + source { + address 10.1.1.100/32 + } + } + } + +Check the result. + +.. image:: /_static/images/qos10.png + :width: 80% + :align: center + :alt: Network Topology Diagram + +As we see shaper is working and the traffic will not work over 5 Mbit/s. |
