diff options
Diffstat (limited to 'docs/guides/progressivevpp/interface.rst')
| -rw-r--r-- | docs/guides/progressivevpp/interface.rst | 126 |
1 files changed, 126 insertions, 0 deletions
diff --git a/docs/guides/progressivevpp/interface.rst b/docs/guides/progressivevpp/interface.rst new file mode 100644 index 00000000000..619216d5f42 --- /dev/null +++ b/docs/guides/progressivevpp/interface.rst @@ -0,0 +1,126 @@ +.. _interface: + +.. toctree:: + +Interface +========= + +VPP command learned in this exercise +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +#. `create host-interface <https://docs.fd.io/vpp/17.04/clicmd_src_vnet_devices_af_packet.html#clicmd_create_host-interface>`_ +#. `set int state <https://docs.fd.io/vpp/17.04/clicmd_src_vnet.html#clicmd_set_interface_state>`_ +#. `set int ip address <https://docs.fd.io/vpp/17.04/clicmd_src_vnet_ip.html#clicmd_set_interface_ip_address>`_ +#. `show hardware <https://docs.fd.io/vpp/17.04/clicmd_src_vnet.html#clicmd_show_hardware-interfaces>`_ +#. `show int <https://docs.fd.io/vpp/17.04/clicmd_src_vnet.html#clicmd_show_interfaces>`_ +#. `show int addr <https://docs.fd.io/vpp/17.04/clicmd_src_vnet.html#clicmd_show_interfaces>`_ +#. `trace add <https://docs.fd.io/vpp/17.04/clicmd_src_vlib.html#clicmd_trace_add>`_ +#. `clear trace <https://docs.fd.io/vpp/17.04/clicmd_src_vlib.html#clicmd_clear_trace>`_ +#. `ping <https://docs.fd.io/vpp/17.04/clicmd_src_vnet_ip.html#clicmd_ping>`_ +#. `show ip arp <https://docs.fd.io/vpp/17.04/clicmd_src_vnet_ethernet.html#clicmd_show_ip_arp>`_ +#. `show ip fib <https://docs.fd.io/vpp/17.04/clicmd_src_vnet_fib.html#clicmd_show_ip_fib>`_ + +Topology +~~~~~~~~ + +.. figure:: /_images/Create_Interface_Topology.jpg + :alt: Figure: Create Interface Topology + + Figure: Create Interface Topology + +Initial State +~~~~~~~~~~~~~ + +The initial state here is presumed to be the final state from the +exercise `VPP Basics <VPP/Progressive_VPP_Tutorial#Exercise:_vpp_basics>`__ + +Create veth interfaces on host +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +In Linux, there is a type of interface call 'veth'. Think of a 'veth' +interface as being an interface that has two ends to it (rather than +one). + +Create a veth interface with one end named **vpp1out** and the other +named **vpp1host** + +.. code-block:: console + + $ sudo ip link add name vpp1out type veth peer name vpp1host + +Turn up both ends: + +.. code-block:: console + + $ sudo ip link set dev vpp1out up + $ sudo ip link set dev vpp1host up + +Assign an IP address +~~~~~~~~~~~~~~~~~~~~ + +.. code-block:: console + + $ sudo ip addr add 10.10.1.1/24 dev vpp1host + +Display the result: + +.. code-block:: console + + $ sudo ip addr show vpp1host + 5: vpp1host@vpp1out: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc noqueue state UP group default qlen 1000 + link/ether e2:0f:1e:59:ec:f7 brd ff:ff:ff:ff:ff:ff + inet 10.10.1.1/24 scope global vpp1host + valid_lft forever preferred_lft forever + inet6 fe80::e00f:1eff:fe59:ecf7/64 scope link + valid_lft forever preferred_lft forever + +Create vpp host-interface +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Create a host interface attached to **vpp1out**. + +.. code-block:: console + + vpp# create host-interface name vpp1out + host-vpp1out + +Confirm the interface: + +.. code-block:: console + + vpp# show hardware + Name Idx Link Hardware + host-vpp1out 1 up host-vpp1out + Ethernet address 02:fe:d9:75:d5:b4 + Linux PACKET socket interface + local0 0 down local0 + local + +Turn up the interface: + +.. code-block:: console + + vpp# set int state host-vpp1out up + +Confirm the interface is up: + +.. code-block:: console + + vpp# show int + Name Idx State MTU (L3/IP4/IP6/MPLS) Counter Count + host-vpp1out 1 up 9000/0/0/0 + local0 0 down 0/0/0/0 + +Assign ip address 10.10.1.2/24 + +.. code-block:: console + + vpp# set int ip address host-vpp1out 10.10.1.2/24 + +Confirm the ip address is assigned: + +.. code-block:: console + + vpp# show int addr + host-vpp1out (up): + L3 10.10.1.2/24 + local0 (dn): |