前言
- VPP提供了一个配置工具，让用户可以简单快捷地配置VPP。用户可以通过一些简单的命令配置VPP，功能包括安装及一些基本配置和测试用例。
使用
- 先安装一个python的pip模块，使用pip安装VPP的配置工具。
- 如果不确定要如何配置，可以选择默认值：y ，而对于数字，如果问题中有形如[1024]的样子，则1024就是默认值。
在Ubuntu系统下安装运行
- 安装pyhton的pip
$ sudo -H bash# apt-get install python-pipReading package lists... DoneBuilding dependency tree Reading state information... Donepython-pip is already the newest version (8.1.1-2ubuntu0.4).
- 安装VPP-config
# pip install vpp-configCollecting vpp-config Downloading vpp_config-17.10.5-py2.py3-none-any.whl (52kB)Requirement already satisfied: pyyaml in /usr/local/lib/python2.7/dist-packages (from vpp-config)Requirement already satisfied: netaddr in /usr/local/lib/python2.7/dist-packages (from vpp-config)Installing collected packages: vpp-configSuccessfully installed vpp-config-17.10.5
- 然后启动配置工具
# vpp-configWelcome to the VPP system configuration utilityThese are the files we will modify: /etc/vpp/startup.conf /etc/sysctl.d/80-vpp.conf /etc/default/grubBefore we change them, we'll create working copies in /usr/local/vpp/vpp-config/dryrunPlease inspect them carefully before applying the actual configuration (option 3)!What would you like to do?1) Show basic system information2) Dry Run (Will save the configuration files in /usr/local/vpp/vpp-config/dryrun for inspection) and user input in /usr/local/vpp/vpp-config/configs/auto-config.yaml3) Full configuration (WARNING: This will change the system configuration)4) List/Install/Uninstall VPP.5) Execute some basic tests.9 or q) QuitCommand:
对于Developers
修改代码很简单。编辑并调试根目录中的代码。为了做到这一点，我们需要一个脚本，将文件复制或数据到适当的地方。这是他们最终与点安装。对于Ubuntu，这是/ usr / local / vpp / vpp-config。对于Centos / usr / vpp / vpp-config。我提供了一个能够正确复制相关文件的脚本（./scripts/cp-data.sh）。我还提供了一个清理环境的脚本。这使开发人员可以从头开始。这些是在此环境中运行实用程序的步骤。这些脚本旨在从根目录运行。 ./scripts/clean.sh ./scripts/cp-data.sh ./vpp_config.py当该实用程序使用pip安装时，wrapper scripts / vpp-config被写入/ usr / local / bin。但是，在本地调试此脚本的起点是./vpp_config.py。通过从根目录执行./vpp_config.py来运行该实用程序。代码中的起点位于vpp_config.py中。大部分工作都在./vpplib中的文件中完成
上传到Pypi
$ sudo -H bash # cd vpp_config # python setup.py sdist bdist_wheel # twine upload dist/*
示例
# vpp-configWelcome to the VPP system configuration utilityThese are the files we will modify: /etc/vpp/startup.conf /etc/sysctl.d/80-vpp.conf /etc/default/grubBefore we change them, we'll create working copies in /usr/local/vpp/vpp-config/dryrunPlease inspect them carefully before applying the actual configuration (option 3)!
What would you like to do?1) Show basic system information2) Dry Run (Will save the configuration files in /usr/local/vpp/vpp-config/dryrun for inspection) and user input in /usr/local/vpp/vpp-config/configs/auto-config.yaml3) Full configuration (WARNING: This will change the system configuration)4) List/Install/Uninstall VPP.5) Execute some basic tests.9 or q) QuitCommand: 1==============================NODE: DUT1CPU: Model name: Intel(R) Xeon(R) CPU E5-2667 v3 @ 3.20GHz CPU(s): 32 Thread(s) per core: 2 Core(s) per socket: 8 Socket(s): 2 NUMA node0 CPU(s): 0-7,16-23 NUMA node1 CPU(s): 8-15,24-31 CPU max MHz: 3600.0000 CPU min MHz: 1200.0000 SMT: EnabledVPP Threads: (Name: Cpu Number)Grub Command Line: Current: BOOT_IMAGE=/boot/vmlinuz-4.4.0-97-generic root=UUID=d760b82f-f37b-47e2-9815-db8d479a3557 ro Configured: GRUB_CMDLINE_LINUX_DEFAULT=""Huge Pages: Total System Memory : 65863484 kB Total Free Memory : 56862700 kB Actual Huge Page Total : 1024 Configured Huge Page Total : 1024 Huge Pages Free : 1024 Huge Page Size : 2048 kBDevices:Devices with link up (can not be used with VPP):0000:08:00.0 enp8s0f0 I350 Gigabit Network Connection Devices bound to kernel drivers:0000:90:00.0 enp144s0 VIC Ethernet NIC 0000:8f:00.0 enp143s0 VIC Ethernet NIC 0000:84:00.0 enp132s0f0,enp132s0f0d1 Ethernet Controller XL710 for 40GbE QSFP+ 0000:84:00.1 enp132s0f1,enp132s0f1d1 Ethernet Controller XL710 for 40GbE QSFP+ 0000:08:00.1 enp8s0f1 I350 Gigabit Network Connection 0000:02:00.0 enp2s0f0 82599ES 10-Gigabit SFI/SFP+ Network Connection 0000:02:00.1 enp2s0f1 82599ES 10-Gigabit SFI/SFP+ Network Connection No devices bound to DPDK driversVPP Service Status: Not Installed==============================
安装VPP
-显示并未安装
VPP Service Status: Not Installed==============================
- 现在可以安装VPP
What would you like to do?1) Show basic system information2) Dry Run (Will save the configuration files in /usr/local/vpp/vpp-config/dryrun for inspection) and user input in /usr/local/vpp/vpp-config/configs/auto-config.yaml3) Full configuration (WARNING: This will change the system configuration)4) List/Install/Uninstall VPP.5) Execute some basic tests.9 or q) QuitCommand: 4There are no VPP packages on node localhost.Do you want to install VPP [Y/n]? yINFO:root: Local Command: ls /etc/apt/sources.list.d/99fd.io.list.origINFO:root: /etc/apt/sources.list.d/99fd.io.list.origINFO:root: Local Command: rm /etc/apt/sources.list.d/99fd.io.listINFO:root: Local Command: echo "deb [trusted=yes] https://nexus.fd.io/content/repositories/fd.io.ubuntu.xenial.main/ ./" | sudo tee /etc/apt/sources.list.d/99fd.io.listINFO:root: deb [trusted=yes] https://nexus.fd.io/content/repositories/fd.io.ubuntu.xenial.main/ ./.......
演练
- 安装完VPP后我们可以进行演练。会创造一个配置文件并放入dryrun目录中，这些文件应该被检查以确保在真正应用前有效。
What would you like to do?1) Show basic system information2) Dry Run (Will save the configuration files in /usr/local/vpp/vpp-config/dryrun for inspection) and user input in /usr/local/vpp/vpp-config/configs/auto-config.yaml3) Full configuration (WARNING: This will change the system configuration)4) List/Install/Uninstall VPP.5) Execute some basic tests.9 or q) QuitCommand: 2These device(s) are currently NOT being used by VPP or the OS.PCI ID Description ----------------------------------------------------------------0000:86:00.0 82599ES 10-Gigabit SFI/SFP+ Network Connection 0000:86:00.1 82599ES 10-Gigabit SFI/SFP+ Network Connection Would you like to give any of these devices back to the OS [Y/n]? yWould you like to use device 0000:86:00.0 for the OS [y/N]? yWould you like to use device 0000:86:00.1 for the OS [y/N]? yThese devices have kernel interfaces, but appear to be safe to use with VPP.PCI ID Kernel Interface(s) Description ------------------------------------------------------------------------------------------0000:90:00.0 enp144s0 VIC Ethernet NIC 0000:8f:00.0 enp143s0 VIC Ethernet NIC 0000:84:00.0 enp132s0f0,enp132s0f0d1 Ethernet Controller XL710 for 40GbE QSFP+ 0000:84:00.1 enp132s0f1,enp132s0f1d1 Ethernet Controller XL710 for 40GbE QSFP+ 0000:08:00.1 enp8s0f1 I350 Gigabit Network Connection 0000:02:00.0 enp2s0f0 82599ES 10-Gigabit SFI/SFP+ Network Connection 0000:02:00.1 enp2s0f1 82599ES 10-Gigabit SFI/SFP+ Network Connection 0000:86:00.0 enp134s0f0 82599ES 10-Gigabit SFI/SFP+ Network Connection 0000:86:00.1 enp134s0f1 82599ES 10-Gigabit SFI/SFP+ Network Connection Would you like to use any of these device(s) for VPP [y/N]? yWould you like to use device 0000:90:00.0 for VPP [y/N]? Would you like to use device 0000:8f:00.0 for VPP [y/N]? Would you like to use device 0000:84:00.0 for VPP [y/N]? Would you like to use device 0000:84:00.1 for VPP [y/N]? Would you like to use device 0000:08:00.1 for VPP [y/N]? Would you like to use device 0000:02:00.0 for VPP [y/N]? Would you like to use device 0000:02:00.1 for VPP [y/N]? Would you like to use device 0000:86:00.0 for VPP [y/N]? yWould you like to use device 0000:86:00.1 for VPP [y/N]? yThese device(s) will be used by VPP.PCI ID Description ----------------------------------------------------------------0000:86:00.0 82599ES 10-Gigabit SFI/SFP+ Network Connection 0000:86:00.1 82599ES 10-Gigabit SFI/SFP+ Network Connection Would you like to remove any of these device(s) [y/N]? These device(s) will be used by VPP, please rerun this option if this is incorrect.PCI ID Description ----------------------------------------------------------------0000:86:00.0 82599ES 10-Gigabit SFI/SFP+ Network Connection 0000:86:00.1 82599ES 10-Gigabit SFI/SFP+ Network Connection Your system has 32 core(s) and 2 Numa Nodes.To begin, we suggest not reserving any cores for VPP or other processes.Then to improve performance try reserving cores as needed. How many core(s) do you want to reserve for processes other than VPP? [0-16][0]? How many core(s) shall we reserve for VPP workers[0-4][0]? 2Should we reserve 1 core for the VPP Main thread? [y/N]? yHow many active-open / tcp client sessions are expected [0-10000000][0]? How many passive-open / tcp server sessions are expected [0-10000000][0]? There currently 1024 2048 kB huge pages free.Do you want to reconfigure the number of huge pages [y/N]? yThere currently a total of 1024 huge pages.How many huge pages do you want [1024 - 19414][1024]? 8192
应用配置
- 配置文件检查完毕后，我们可以用option3来应用。缺省值并不会改变这个指令，如果选择更改grub这个命令行选项，则需要重启。
What would you like to do?1) Show basic system information2) Dry Run (Will save the configuration files in /usr/local/vpp/vpp-config/dryrun for inspection) and user input in /usr/local/vpp/vpp-config/configs/auto-config.yaml3) Full configuration (WARNING: This will change the system configuration)4) List/Install/Uninstall VPP.5) Execute some basic tests.9 or q) QuitCommand: 3We are now going to configure your system(s).Are you sure you want to do this [Y/n]? yThese are the changes we will apply tothe huge page file (/etc/sysctl.d/80-vpp.conf).1,2d0< vm.nr_hugepages=10244,7c2,3< vm.max_map_count=3096---> vm.nr_hugepages=8192> vm.max_map_count=174088a5> kernel.shmmax=1717986918410,15d6< kernel.shmmax=2147483648Are you sure you want to apply these changes [Y/n]? These are the changes we will apply tothe VPP startup file (/etc/vpp/startup.conf).---> > main-core 8> corelist-workers 9-10> > scheduler-policy fifo> scheduler-priority 50> 67,68c56,66< # dpdk {---> dpdk {> > dev 0000:86:00.0 { > num-rx-queues 2> }> dev 0000:86:00.1 { > num-rx-queues 2> }> num-mbufs 25600> 124c122< # }---> }Are you sure you want to apply these changes [Y/n]? The configured grub cmdline looks like this:GRUB_CMDLINE_LINUX_DEFAULT="isolcpus=8,9-10 nohz_full=8,9-10 rcu_nocbs=8,9-10"The current boot cmdline looks like this:BOOT_IMAGE=/boot/vmlinuz-4.4.0-97-generic root=UUID=d760b82f-f37b-47e2-9815-db8d479a3557 roDo you want to keep the current boot cmdline [Y/n]? Show System (after the configuration)When we show the system information after the system is configured notice that the VPP workers and the VPP main core is on the correct Numa Node. Notice also that VPP is running and the interfaces are shown.What would you like to do?1) Show basic system information2) Dry Run (Will save the configuration files in /usr/local/vpp/vpp-config/dryrun for inspection) and user input in /usr/local/vpp/vpp-config/configs/auto-config.yaml3) Full configuration (WARNING: This will change the system configuration)4) List/Install/Uninstall VPP.5) Execute some basic tests.9 or q) QuitCommand: 1==============================NODE: DUT1CPU: Model name: Intel(R) Xeon(R) CPU E5-2667 v3 @ 3.20GHz CPU(s): 32 Thread(s) per core: 2 Core(s) per socket: 8 Socket(s): 2 NUMA node0 CPU(s): 0-7,16-23 NUMA node1 CPU(s): 8-15,24-31 CPU max MHz: 3600.0000 CPU min MHz: 1200.0000 SMT: EnabledVPP Threads: (Name: Cpu Number) vpp_main : 8 vpp_wk_1 : 10 vpp_wk_0 : 9 vpp_stats : 0 Grub Command Line: Current: BOOT_IMAGE=/boot/vmlinuz-4.4.0-97-generic root=UUID=d760b82f-f37b-47e2-9815-db8d479a3557 ro Configured: GRUB_CMDLINE_LINUX_DEFAULT="isolcpus=8,9-10 nohz_full=8,9-10 rcu_nocbs=8,9-10"Huge Pages: Total System Memory : 65863484 kB Total Free Memory : 42048632 kB Actual Huge Page Total : 8192 Configured Huge Page Total : 8192 Huge Pages Free : 7936 Huge Page Size : 2048 kBDevices:Total Number of Buffers: 25600Devices with link up (can not be used with VPP):0000:08:00.0 enp8s0f0 I350 Gigabit Network Connection Devices bound to kernel drivers:0000:90:00.0 enp144s0 VIC Ethernet NIC 0000:8f:00.0 enp143s0 VIC Ethernet NIC 0000:84:00.0 enp132s0f0,enp132s0f0d1 Ethernet Controller XL710 for 40GbE QSFP+ 0000:84:00.1 enp132s0f1,enp132s0f1d1 Ethernet Controller XL710 for 40GbE QSFP+ 0000:08:00.1 enp8s0f1 I350 Gigabit Network Connection 0000:02:00.0 enp2s0f0 82599ES 10-Gigabit SFI/SFP+ Network Connection 0000:02:00.1 enp2s0f1 82599ES 10-Gigabit SFI/SFP+ Network Connection Devices bound to DPDK drivers:0000:86:00.0 82599ES 10-Gigabit SFI/SFP+ Network Connection 0000:86:00.1 82599ES 10-Gigabit SFI/SFP+ Network Connection Devices in use by VPP:Name Socket RXQs RXDescs TXQs TXDescsTenGigabitEthernet86/0/0 1 2 1024 3 1024TenGigabitEthernet86/0/1 1 2 1024 3 1024VPP Service Status: active (running)============================== 测试用例
设置IP地址
- vpp配置好后我们可以把ip地址加入到这些已经配置好的接口上。一旦完成，你可以试着ping一下，然后一个运行脚本会创建： /usr/local/vpp/vpp-config/scripts/set_int_ipv4_and_up for Ubuntu and /usr/vpp/vpp-config/scripts/set_int_ipv4_and_up for Centos。 用这个脚本以后可以用来配置IP地址。
What would you like to do?1) Show basic system information2) Dry Run (Will save the configuration files in /usr/local/vpp/vpp-config/dryrun for inspection) and user input in /usr/local/vpp/vpp-config/configs/auto-config.yaml3) Full configuration (WARNING: This will change the system configuration)4) List/Install/Uninstall VPP.5) Execute some basic tests.9 or q) QuitCommand: 5What would you like to do?1) List/Create Simple IPv4 Setup9 or q) Back to main menu.Command: 1These are the current interfaces with IP addresses:TenGigabitEthernet86/0/0 Not Set dn TenGigabitEthernet86/0/1 Not Set dn Would you like to keep this configuration [Y/n]? nWould you like add address to interface TenGigabitEthernet86/0/0 [Y/n]? Please enter the IPv4 Address [n.n.n.n/n]: 30.0.0.2/24Would you like add address to interface TenGigabitEthernet86/0/1 [Y/n]? yPlease enter the IPv4 Address [n.n.n.n/n]: 40.0.0.2/24A script as been created at /usr/local/vpp/vpp-config/scripts/set_int_ipv4_and_upThis script can be run using the following:vppctl exec /usr/local/vpp/vpp-config/scripts/set_int_ipv4_and_upWhat would you like to do?1) List/Create Simple IPv4 Setup9 or q) Back to main menu.Command: 1These are the current interfaces with IP addresses:TenGigabitEthernet86/0/0 30.0.0.2/24 up TenGigabitEthernet86/0/1 40.0.0.2/24 up Would you like to keep this configuration [Y/n]?