Sweetcomb ======================== ## Introduction Sweetcomb is a management agent that runs on the same host as a VPP instance, and exposes yang models via NETCONF or RESTCONF or gRPC to allow the management of that VPP instance from out-of-box. For more information on VPP and its features please visit the [Sweetcomb website](https://wiki.fd.io/view/Sweetcomb) ## Changes Details of the changes leading up to this version of Sweetcomb can be found under @ref release notes. ## Directory layout | Directory name | Description | | ---------------------- | ------------------------------------------- | | build-root | Build output directory | | @ref src/plugins | Sweetcomb bundled plugins directory | | @ref src/scvpp | Sweetcomb to VPP communication | ## Getting started Make sure you have added FD.io repository using https://packagecloud.io/fdio/release/ installation script. You should have a sight on the release package, the package name may be defferent in rpm and deb on defferent version (such vpp-plugins.deb in 19.01 and vpp-plugin-core.deb and vpp-plugin-dpdk.deb in 19.04) Firstly, please follow below steps to install dependencies and build code: cd $/sweetcomb/ make install-dep make install-dep-extra make install-vpp make build-scvpp make build-plugins Then, please start each daemon one by one: start vpp (for example on Ubuntu: systemctl start vpp) sysrepod sysrepo-plugind netopeer2-server netopeer2-cli Now you can utilize Sweetcomb. ## Manual Test For example, if you want to configure ipv4 address on HW interface TenGigabitEthernet5/0/0, You can follow below steps to verify if Sweetcomb is working well. Firstly, set interface up: vppctl set interface state TenGigabitEthernet5/0/0 up Then, starting netopeer2-cli on any host: netopeer2-cli > connect --host --login > edit-config --target running --config ## Press Enter and then past below XML example into the editor and quit TenGigabitEthernet5/0/0 eth0 ianaift:ethernetCsmacd true 1514
192.168.50.72 24
true
Finally, check the configuration result. vppctl show interface address If you configure above successfully, you will get ip address set up on interface TenGigabitEthernet5/0/0.