summaryrefslogtreecommitdiff
path: root/docs/configuration-overview.rst
diff options
context:
space:
mode:
authorrunborg <runar@13xl.com>2019-06-27 21:34:16 +0200
committerKim <kim.sidney@gmail.com>2019-06-27 21:34:16 +0200
commit1a2bd0acd0671b0df55e889dc38a6a2543744402 (patch)
treeee6f404c2ef71040764986e9b12042d07ab38653 /docs/configuration-overview.rst
parent4c63a9d11d05b8ca6998de971d97182bc81f5ff0 (diff)
downloadvyos-documentation-1a2bd0acd0671b0df55e889dc38a6a2543744402.tar.gz
vyos-documentation-1a2bd0acd0671b0df55e889dc38a6a2543744402.zip
T1457: migrate Config archive, routing-policy example and two hardware devices (#70)
* T1457: Migrate Qotom Q355G4 into Running on Bare Metal * T1457: Added Configuration archive to configuration overview * T1457: Added routing-policy example to routing, from the wiki * T1457: Added Partaker i5 and Acrosser to Running on bare metal
Diffstat (limited to 'docs/configuration-overview.rst')
-rw-r--r--docs/configuration-overview.rst53
1 files changed, 53 insertions, 0 deletions
diff --git a/docs/configuration-overview.rst b/docs/configuration-overview.rst
index f7a3b078..1815bd30 100644
--- a/docs/configuration-overview.rst
+++ b/docs/configuration-overview.rst
@@ -321,3 +321,56 @@ Command completeion and syntax help with `?` and `[tab]` wil also work.
Interface IP Address S/L Description
--------- ---------- --- -----------
eth0 0.0.0.0/0 u/u
+
+
+Configuration archive
+---------------------
+
+VyOS has built-in config archiving and versionin that renders tools like rancid largely unnecessary.
+
+This feature was available in Vyatta Core since 6.3
+
+Local archive and revisions
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Revisions are stored on disk, you can view them, compare them, and rollback to previous revisions if anything goes wrong.
+To view existing revisions, use "show system commit" operational mode command.
+
+.. code-block:: sh
+ vyos@vyos-test-2# run show system commit
+ 0 2015-03-30 08:53:03 by vyos via cli
+ 1 2015-03-30 08:52:20 by vyos via cli
+ 2 2015-03-26 21:26:01 by root via boot-config-loader
+ 3 2015-03-26 20:43:18 by root via boot-config-loader
+ 4 2015-03-25 11:06:14 by root via boot-config-loader
+ 5 2015-03-25 01:04:28 by root via boot-config-loader
+ 6 2015-03-25 00:16:47 by vyos via cli
+ 7 2015-03-24 23:43:45 by root via boot-config-loader
+
+You can compare revisions with "compare X Y" command where X and Y are revision numbers.
+
+.. code-block:: sh
+ vyos@vyos-test-2# compare 0 6
+ [edit interfaces]
+ +dummy dum1 {
+ + address 10.189.0.1/31
+ +}
+ [edit interfaces ethernet eth0]
+ +vif 99 {
+ + address 10.199.0.1/31
+ +}
+ -vif 900 {
+ - address 192.0.2.4/24
+ -}
+
+You can rollback to a previous revision with "rollback X", where X is a revision number. Your system will reboot and load the config from the archive.
+
+Configuring the archive size
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+You can specify the number of revisions stored on disk with "set system config-management commit-revisions X", where X is a number between 0 and 65535. When the number of revisions exceeds that number, the oldest revision is removed.
+
+Remote archive
+~~~~~~~~~~~~~~
+VyOS can copy the config to a remote location after each commit. TFTP, FTP, and SFTP servers are supported.
+
+You can specify the location with "set system config-management commit-archive location URL" command, e.g. "set system config-management commit-archive location tftp://10.0.0.1/vyos".