.. _usingvppconfig.rst:

*******
Running
*******

The vpp-config utility provides the user with several different menus. This allows the
user to configure ports, some performance characteristics, the number of huge pages
and install/uninstall the released FD.io packages.

It is recommended that the menu options are executed in this order.

#. :ref:`4) List/Install/Uninstall VPP <config-command-four>`
#. :ref:`1) Show basic system information <config-command-one>`
#. :ref:`2) Dry Run <config-command-two>`
#. :ref:`3) Full Configuration <config-command-three>`

Once vpp-config is installed as a root user execute the following

.. code-block:: console

    $ sudo -H bash
    # 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)
    4) List/Install/Uninstall VPP.
    q) Quit
    
    Command:

Default Values
==============

If you do not choose to modify the default for any of the questions prompted by vpp-config,
you may press the ENTER key to select the default options:

* Questions that ask [Y/n], the capital letter Y is the default answer.
* Numbers have their default within brackets, such as in [1024], the 1024 is the default.