proxmox-mirrors/mirror_frr
1
0
Fork 0
mirror of https://git.proxmox.com/git/mirror_frr synced 2025-04-30 15:02:54 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

doc: add docs for frr-reload.py options

Browse Source 
Signed-off-by: Emanuele Di Pascale <emanuele@voltanet.io>
This commit is contained in:
Emanuele Di Pascale 2020-05-20 10:20:30 +02:00 committed by David Lamparter
parent fa18c6bbda
commit c01f5f2145
1 changed files with 31 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

33
doc/user/frr-reload.rst
View File

@ -4,9 +4,38 @@
The frr-reload.py script The frr-reload.py script
======================== ========================
The ``frr-reload.py`` script attempts to update the configuration of running
daemons. It takes as argument the path of the configuration file that we want
to apply. The script will attempt to retrieve the running configuration from
daemons, calculate the delta between that config and the intended one, and
execute the required sequence of vtysh commands to enforce the changes.
Options Options
------- -------
There are several options that control the behavior of ``frr-reload``. There are several options that control the behavior of ``frr-reload``:
* ``--input INPUT``: uses the specified input file as the running configuration
instead of retrieving it from a ``show running-config`` in vtysh
* ``--reload``: applies the configuration delta to the daemons. Either this or
``--test`` MUST be specified.
* ``--test``: only outputs the configuration delta, without enforcing it.
Either this or ``--reload`` MUST be specified.
* ``--debug``: enable debug messages
* ``--stdout``: print output to stdout
* ``--bindir BINDIR``: path to the vtysh executable
* ``--confdir CONFDIR``: path to the existing daemon config files
* ``--rundir RUNDIR``: path to a folder to be used to write the temporary files
needed by the script to do its job. The script should have write access to it
* ``--daemon DAEMON``: by default ``frr-reload.py`` assumes that we are using
integrated config and attempting to update the configuration for all daemons.
If this is not the case, e.g. each daemon has its individual config file,
then the delta can only be computed on a per-daemon basis. This option allows
the user to specify the daemon for which the config is intended. DAEMON
should be one of the keywords allowed in vtysh as an option for ``show
running-config``.
* ``--vty_socket VTY_SOCKET``: the socket to be used by vtysh to connect to the
running daemons.
* ``--overwrite``: overwrite the existing daemon config file with the new
config after the delta has been applied. The file name will be ``frr.conf``
for integrate config, or ``DAEMON.conf`` when using per-daemon config files.