Difference between revisions of "VPP/Configuration Tool"
From fd.io
< VPP
(→Next) |
(→Use) |
||
| Line 6: | Line 6: | ||
The installation and executing of the VPP configuration utility is simple. First install the python pip module. Using pip install, then pip install vpp-config. Then simply type vpp-config and answer the questions. If you are not sure what to answer choose the default. For yes or no questions the capital letter designates the default. For example, for a question that shows [Y/n] Y is the default. For numbers the default is within the brackets for example for a question that shows [1024]. 1024 is the default. | The installation and executing of the VPP configuration utility is simple. First install the python pip module. Using pip install, then pip install vpp-config. Then simply type vpp-config and answer the questions. If you are not sure what to answer choose the default. For yes or no questions the capital letter designates the default. For example, for a question that shows [Y/n] Y is the default. For numbers the default is within the brackets for example for a question that shows [1024]. 1024 is the default. | ||
| + | |||
| + | Ubuntu Example: | ||
| + | |||
| + | <pre> | ||
| + | $ sudo -H bash | ||
| + | # apt-get install python-pip | ||
| + | Reading package lists... Done | ||
| + | Building dependency tree | ||
| + | Reading state information... Done | ||
| + | python-pip is already the newest version (8.1.1-2ubuntu0.4). | ||
| + | </pre> | ||
| + | |||
| + | <pre> | ||
| + | # pip install vpp-config | ||
| + | Collecting 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-config | ||
| + | Successfully installed vpp-config-17.10.5 | ||
| + | </pre> | ||
| + | |||
| + | <pre> | ||
| + | # vpp-config | ||
| + | |||
| + | Welcome to the VPP system configuration utility | ||
| + | |||
| + | These are the files we will modify: | ||
| + | /etc/vpp/startup.conf | ||
| + | /etc/sysctl.d/80-vpp.conf | ||
| + | /etc/default/grub | ||
| + | |||
| + | Before we change them, we'll create working copies in /usr/local/vpp/vpp-config/dryrun | ||
| + | Please inspect them carefully before applying the actual configuration (option 3)! | ||
| + | |||
| + | What would you like to do? | ||
| + | |||
| + | 1) Show basic system information | ||
| + | 2) 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.yaml | ||
| + | 3) Full configuration (WARNING: This will change the system configuration) | ||
| + | 4) List/Install/Uninstall VPP. | ||
| + | 5) Execute some basic tests. | ||
| + | 9 or q) Quit | ||
| + | |||
| + | Command: | ||
| + | </pre> | ||
Revision as of 18:47, 1 November 2017
Summary
The purpose of the VPP configuration utility is to allow the user to configure VPP in a simple and safe manner. The utility takes input from the user and then modifies the key configuration files. The user can then examine these files to be sure they are correct and then actually apply the configuration. The utility also includes an installation utility and some basic tests. This utility is currently released with release 17.10.
Use
The installation and executing of the VPP configuration utility is simple. First install the python pip module. Using pip install, then pip install vpp-config. Then simply type vpp-config and answer the questions. If you are not sure what to answer choose the default. For yes or no questions the capital letter designates the default. For example, for a question that shows [Y/n] Y is the default. For numbers the default is within the brackets for example for a question that shows [1024]. 1024 is the default.
Ubuntu Example:
$ sudo -H bash # apt-get install python-pip Reading package lists... Done Building dependency tree Reading state information... Done python-pip is already the newest version (8.1.1-2ubuntu0.4).
# pip install vpp-config Collecting 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-config Successfully installed vpp-config-17.10.5
# vpp-config
Welcome to the VPP system configuration utility
These are the files we will modify:
/etc/vpp/startup.conf
/etc/sysctl.d/80-vpp.conf
/etc/default/grub
Before we change them, we'll create working copies in /usr/local/vpp/vpp-config/dryrun
Please inspect them carefully before applying the actual configuration (option 3)!
What would you like to do?
1) Show basic system information
2) 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.yaml
3) Full configuration (WARNING: This will change the system configuration)
4) List/Install/Uninstall VPP.
5) Execute some basic tests.
9 or q) Quit
Command:
