diff options
| -rw-r--r-- | docs/commandscripting.rst | 21 | ||||
| -rw-r--r-- | docs/interfaces/addresses.rst | 2 | ||||
| -rw-r--r-- | docs/interfaces/index.rst | 2 | ||||
| -rw-r--r-- | docs/troubleshooting.rst | 39 |
4 files changed, 60 insertions, 4 deletions
diff --git a/docs/commandscripting.rst b/docs/commandscripting.rst index cfdbae44..15977b30 100644 --- a/docs/commandscripting.rst +++ b/docs/commandscripting.rst @@ -104,4 +104,23 @@ To make sure that a script is not accidentally called without the ``vyattacfg`` if [ "$(id -g -n)" != 'vyattacfg' ] ; then exec sg vyattacfg -c "/bin/vbash $(readlink -f $0) $@" - fi
\ No newline at end of file + fi + +Postconfig on boot +------------------ + +The ``/config/scripts/vyos-postconfig-bootup.script`` script is called on boot after the VyOS configuration is fully applied. + +Any modifications done to work around unfixed bugs and implement enhancements which are not complete in the VyOS system can be placed here. + +The default file looks like this: + +.. code-block:: sh + + #!/bin/sh + # This script is executed at boot time after VyOS configuration is fully applied. + # Any modifications required to work around unfixed bugs + # or use services not available through the VyOS CLI system can be placed here. + +.. hint:: + For configuration/upgrade management issues, modification of this script should be the last option. Always try to find solutions based on CLI commands first.
\ No newline at end of file diff --git a/docs/interfaces/addresses.rst b/docs/interfaces/addresses.rst index 4c3ca7f6..97781c09 100644 --- a/docs/interfaces/addresses.rst +++ b/docs/interfaces/addresses.rst @@ -59,7 +59,7 @@ Static Address This method is supported on all interfaces, apart from OpenVPN that uses different syntax and wireless modems that are always autoconfigured through PPP. Static IPv6 addresses are supported on all interfaces -except :ref:`interfaces-vti`. +except :ref:`interfaces-tunnel`. The command is `set interfaces $type $name address $address`. Examples: diff --git a/docs/interfaces/index.rst b/docs/interfaces/index.rst index 756269c4..cd6cca6c 100644 --- a/docs/interfaces/index.rst +++ b/docs/interfaces/index.rst @@ -55,7 +55,7 @@ respective sections. wireless bridging bonding - vti + tunnel vlan qinq vxlan diff --git a/docs/troubleshooting.rst b/docs/troubleshooting.rst index 04cb9d80..80a46932 100644 --- a/docs/troubleshooting.rst +++ b/docs/troubleshooting.rst @@ -297,8 +297,45 @@ to clear counters on firewall rulesets or single rules vyos@vyos:~$ clear firewall ipv6-name <ipv6 ruleset name> counters vyos@vyos:~$ clear firewall ipv6-name <ipv6 ruleset name> rule <rule#> counters - +Basic System Information +------------------------ + +Boot steps +^^^^^^^^^^ + +VyOS 1.2.0+ uses `Debian Jessie`_ as the base Linux operating system. +Jessie was the first version of Debian that uses `systemd`_ as the default init system. + +These are the boot steps for VyOS 1.2.0+ + +1. The BIOS loads Grub (or isolinux for the Live CD) +2. Grub then starts the Linux boot and loads the Linux Kernel ``/boot/vmlinuz`` +3. Kernel Launches Systemd ``/lib/systemd/systemd`` +4. Systemd loads the VyOS service file ``/lib/systemd/system/vyos-router.service`` +5. The service file launches the VyOS router init script ``/usr/libexec/vyos/init/vyos-router`` - this is part of the `vyatta-cfg`_ Debian package + + 1. Starts FRR_ - successor to `GNU Zebra`_ and `Quagga`_ + + 2. Initialises the boot configuration file - copies over ``config.boot.default`` if there is no configuration + 3. Runs the configuration migration, if the configuration is for an older version of VyOS + 4. Runs The pre-config script, if there is one ``/config/scripts/vyos-preconfig-bootup.script`` + 5. If the config file was upgraded, runs any post upgrade scripts ``/config/scripts/post-upgrade.d`` + 6. Starts **rl-system** and **firewall** + 7. Mounts the ``/boot`` partition + 8. The boot configuration file is then applied by ``/opt/vyatta/sbin/vyatta-boot-config-loader /opt/vyatta/etc/config/config.boot`` + + 1. The config loader script writes log entries to ``/var/log/vyatta-config-loader.log`` + + 10. Runs ``telinit q`` to tell the init system to reload ``/etc/inittab`` + 11. Finally it runs the post-config script ``/config/scripts/vyos-postconfig-bootup.script`` + +.. _Quagga: http://www.quagga.net/ +.. _`GNU Zebra`: https://www.gnu.org/software/zebra/ +.. _FRR: https://frrouting.org/ +.. _vyatta-cfg: https://github.com/vyos/vyatta-cfg +.. _systemd: _https://freedesktop.org/wiki/Software/systemd/ +.. _`Debian Jessie`: https://www.debian.org/releases/jessie/ .. _mtr: http://www.bitwizard.nl/mtr/ .. _tshark: https://www.wireshark.org/docs/man-pages/tshark.html .. _`PCAP filter expressions`: http://www.tcpdump.org/manpages/pcap-filter.7.html |