From cc78c8143cc167a14f1d45755a83242fae0af1b2 Mon Sep 17 00:00:00 2001 From: Neil Lathwood Date: Thu, 15 Feb 2018 19:40:26 +0000 Subject: docs: Added model note for 3com comware (#1186) --- docs/Model-Notes/Comware.md | 10 ++++++++++ docs/Model-Notes/README.md | 1 + 2 files changed, 11 insertions(+) create mode 100644 docs/Model-Notes/Comware.md (limited to 'docs/Model-Notes') diff --git a/docs/Model-Notes/Comware.md b/docs/Model-Notes/Comware.md new file mode 100644 index 0000000..31eb002 --- /dev/null +++ b/docs/Model-Notes/Comware.md @@ -0,0 +1,10 @@ +Comware Configuration +===================== + +If you find 3Com comware devices aren't being backed up this may be due to prompt detection not matching +because a previous login message is disabled after the first prompt. You can disable this on the devices +themselves by running this command: + +`info-center source default channel 1 log state off debug state off` + +[Reference](https://github.com/ytti/oxidized/issues/1171) diff --git a/docs/Model-Notes/README.md b/docs/Model-Notes/README.md index f51ed80..6a64058 100644 --- a/docs/Model-Notes/README.md +++ b/docs/Model-Notes/README.md @@ -11,6 +11,7 @@ Use the table below for more information on the Vendor/Model caveats. Vendor | Model |Updated ----------------|-----------------|---------------- +3COM|[Comware](Comware.md)|15 Feb 2018 Huawei|[VRP](VRP-Huawei.md)|17 Nov 2017 Juniper|[MX/QFX/EX/SRX/J Series](JunOS.md)|18 Jan 2018 Xyzel|[XGS4600 Series](XGS4600-Zyxel.md)|23 Jan 2018 -- cgit v1.2.1 From 72397c4f344ab97fe3db1e381a3e5e1b1a935c62 Mon Sep 17 00:00:00 2001 From: Jason Ackley Date: Tue, 27 Feb 2018 08:58:59 -0600 Subject: model: Added support for ArbOS from Arbor Networks. (#1096) * Basic support for ArbOS from Arbor Networks. ArbOS is the generic name for Arbor Networks (https://www.arbornetworks.com/) OS that runs on some of their devices. Found and imported from https://github.com/claranet/oxidized . Credit to Claranet for the creation. Locally validated on Peakflow SP v8.2+ The module is quite simple as the command 'config show' automatically disables pagination. There is a pagination-enabled version of the command as well. * Added model notes for ArbOS --- docs/Model-Notes/ArbOS.md | 10 ++++++++++ docs/Model-Notes/README.md | 1 + 2 files changed, 11 insertions(+) create mode 100644 docs/Model-Notes/ArbOS.md (limited to 'docs/Model-Notes') diff --git a/docs/Model-Notes/ArbOS.md b/docs/Model-Notes/ArbOS.md new file mode 100644 index 0000000..0f5b628 --- /dev/null +++ b/docs/Model-Notes/ArbOS.md @@ -0,0 +1,10 @@ +Arbor Networks ArbOS notes +========================== + +If you are running ArbOS version 7 or lower then you may need to update the model to remove `exec true`: + +``` + cfg :ssh do + pre_logout 'exit' + end +``` diff --git a/docs/Model-Notes/README.md b/docs/Model-Notes/README.md index 6a64058..9d7db32 100644 --- a/docs/Model-Notes/README.md +++ b/docs/Model-Notes/README.md @@ -12,6 +12,7 @@ Use the table below for more information on the Vendor/Model caveats. Vendor | Model |Updated ----------------|-----------------|---------------- 3COM|[Comware](Comware.md)|15 Feb 2018 +Arbor Networks|[ArbOS](ArbOS.md)|27 Feb 2018 Huawei|[VRP](VRP-Huawei.md)|17 Nov 2017 Juniper|[MX/QFX/EX/SRX/J Series](JunOS.md)|18 Jan 2018 Xyzel|[XGS4600 Series](XGS4600-Zyxel.md)|23 Jan 2018 -- cgit v1.2.1 From 87600b1f5f12711afe29c408e02dbbd927e3f25d Mon Sep 17 00:00:00 2001 From: Wild Kat Date: Mon, 12 Mar 2018 00:19:20 +0100 Subject: Lint and standardize markdown documentation --- docs/Model-Notes/AireOS.md | 8 ++++---- docs/Model-Notes/ArbOS.md | 2 +- docs/Model-Notes/Comware.md | 10 ++++++---- docs/Model-Notes/JunOS.md | 14 +++++--------- docs/Model-Notes/README.md | 8 ++------ docs/Model-Notes/VRP-Huawei.md | 5 ++--- docs/Model-Notes/XGS4600-Zyxel.md | 13 +++++++------ 7 files changed, 27 insertions(+), 33 deletions(-) (limited to 'docs/Model-Notes') diff --git a/docs/Model-Notes/AireOS.md b/docs/Model-Notes/AireOS.md index 0da9b57..9962f31 100644 --- a/docs/Model-Notes/AireOS.md +++ b/docs/Model-Notes/AireOS.md @@ -1,12 +1,12 @@ -Cisco WLC Configuration -======================== +Cisco WLC Configuration +======================= Create a user with read-write privilege : -``` +```text mgmtuser add oxidized **** read-write ``` -Oxidized needs read-write privilege in order to execute 'config paging disable'. +Oxidized needs read-write privilege in order to execute 'config paging disable'. Back to [Model-Notes](README.md) diff --git a/docs/Model-Notes/ArbOS.md b/docs/Model-Notes/ArbOS.md index 0f5b628..f68467f 100644 --- a/docs/Model-Notes/ArbOS.md +++ b/docs/Model-Notes/ArbOS.md @@ -3,7 +3,7 @@ Arbor Networks ArbOS notes If you are running ArbOS version 7 or lower then you may need to update the model to remove `exec true`: -``` +```ruby cfg :ssh do pre_logout 'exit' end diff --git a/docs/Model-Notes/Comware.md b/docs/Model-Notes/Comware.md index 31eb002..0da019a 100644 --- a/docs/Model-Notes/Comware.md +++ b/docs/Model-Notes/Comware.md @@ -1,10 +1,12 @@ Comware Configuration ===================== -If you find 3Com comware devices aren't being backed up this may be due to prompt detection not matching -because a previous login message is disabled after the first prompt. You can disable this on the devices -themselves by running this command: +If you find 3Com comware devices aren't being backed up this may be due to prompt detection not matching because a previous login message is disabled after the first prompt. -`info-center source default channel 1 log state off debug state off` +You can disable this on the devices themselves by running this command: + +```text +info-center source default channel 1 log state off debug state off +``` [Reference](https://github.com/ytti/oxidized/issues/1171) diff --git a/docs/Model-Notes/JunOS.md b/docs/Model-Notes/JunOS.md index ed8dbca..8093df0 100644 --- a/docs/Model-Notes/JunOS.md +++ b/docs/Model-Notes/JunOS.md @@ -1,9 +1,9 @@ JunOS Configuration -======================== +=================== Create login class cfg-view -``` +```text set system login class cfg-view permissions view-configuration set system login class cfg-view allow-commands "(show)|(set cli screen-length)|(set cli screen-width)" set system login class cfg-view deny-commands "(clear)|(file)|(file show)|(help)|(load)|(monitor)|(op)|(request)|(save)|(set)|(start)|(test)" @@ -12,7 +12,7 @@ set system login class cfg-view deny-configuration all Create a user with cfg-view class -``` +```text set system login user oxidized class cfg-view set system login user oxidized authentication plain-text-password "verysecret" ``` @@ -25,14 +25,10 @@ The commands Oxidized executes are: 4. show version 5. show chassis hardware 6. show system license -7. show system license keys -ex22|ex33|ex4|ex8|qfx only -8. show virtual-chassis -MX960 only +7. show system license keys (ex22|ex33|ex4|ex8|qfx only) +8. show virtual-chassis (MX960 only) 9. show chassis fabric reachability - Oxidized can now retrieve your configuration! - Back to [Model-Notes](README.md) diff --git a/docs/Model-Notes/README.md b/docs/Model-Notes/README.md index 9d7db32..8dcabd3 100644 --- a/docs/Model-Notes/README.md +++ b/docs/Model-Notes/README.md @@ -1,21 +1,17 @@ - - Model Notes -======================== - +=========== This directory contains implemention notes and caveats to assist you in your oxidized deployment. Use the table below for more information on the Vendor/Model caveats. - Vendor | Model |Updated ----------------|-----------------|---------------- 3COM|[Comware](Comware.md)|15 Feb 2018 +AireOS|[AireOS](AireOS.md)|29 Nov 2017 Arbor Networks|[ArbOS](ArbOS.md)|27 Feb 2018 Huawei|[VRP](VRP-Huawei.md)|17 Nov 2017 Juniper|[MX/QFX/EX/SRX/J Series](JunOS.md)|18 Jan 2018 Xyzel|[XGS4600 Series](XGS4600-Zyxel.md)|23 Jan 2018 - If you discover additional caveats or problems please make sure to consult the [GitHub issues for oxidized](https://github.com/ytti/oxidized/issues) known issues. diff --git a/docs/Model-Notes/VRP-Huawei.md b/docs/Model-Notes/VRP-Huawei.md index d03c752..e68a959 100644 --- a/docs/Model-Notes/VRP-Huawei.md +++ b/docs/Model-Notes/VRP-Huawei.md @@ -3,7 +3,7 @@ Huawei VRP Configuration Create a user with no privileges -``` +```text system-view [~HUAWEI] aaa [~HUAWEI-aaa] local-user oxidized password irreversible-cipher verysecret @@ -21,7 +21,7 @@ The commands Oxidized executes are: Command 2 and 3 can be executed without issues, but 1 and 4 are only available for higher level users. Instead of making Oxidized a read/write user on your device, lower the priviledge-level for commands 1 and 4: -``` +```text system-view [~HUAWEI] command-privilege level 1 view global display current-configuration all [*HUAWEI] command-privilege level 1 view shell screen-length @@ -30,5 +30,4 @@ Command 2 and 3 can be executed without issues, but 1 and 4 are only available f Oxidized can now retrieve your configuration! - Back to [Model-Notes](README.md) diff --git a/docs/Model-Notes/XGS4600-Zyxel.md b/docs/Model-Notes/XGS4600-Zyxel.md index 0ff2e7d..17cb2b5 100644 --- a/docs/Model-Notes/XGS4600-Zyxel.md +++ b/docs/Model-Notes/XGS4600-Zyxel.md @@ -1,18 +1,20 @@ ZynOS Configuration -======================== +=================== ## FTP + FTP access is only possible as admin, other users can login but cannot pull the files. For the XGS4600 series the config file is _config_ and not _config-0_ -The following line in _oxidized/lib/oxidized/model/zynos.rb_ with need changing -``` - cmd 'config-0' +The following line in _oxidized/lib/oxidized/model/zynos.rb_ will need changing +```text + cmd 'config-0' ``` The inclusion of an extra ftp option is also require. Within _input_ add the following -``` + +```yaml input: ftp: passive: false @@ -20,5 +22,4 @@ input: Oxidized can now retrieve your configuration! - Back to [Model-Notes](README.md) -- cgit v1.2.1 From ce0216fde8cdf562be4cc9d39aba2cf003d3c7f6 Mon Sep 17 00:00:00 2001 From: Wild Kat Date: Fri, 16 Mar 2018 16:19:21 +0100 Subject: documentation touch-ups and issue #1218 --- docs/Model-Notes/VRP-Huawei.md | 2 ++ 1 file changed, 2 insertions(+) (limited to 'docs/Model-Notes') diff --git a/docs/Model-Notes/VRP-Huawei.md b/docs/Model-Notes/VRP-Huawei.md index e68a959..a5c0c99 100644 --- a/docs/Model-Notes/VRP-Huawei.md +++ b/docs/Model-Notes/VRP-Huawei.md @@ -30,4 +30,6 @@ Command 2 and 3 can be executed without issues, but 1 and 4 are only available f Oxidized can now retrieve your configuration! +Caveat: Some versions of VRP default to appending a timestamp prior to the output of each `display` command, which will lead to superfluous updates. The configuration statement `timestamp disable` can be used to disable this functionality. (Issue #1218) + Back to [Model-Notes](README.md) -- cgit v1.2.1 From 720facc6f80d2b977d73b944c81c63b6d95e768b Mon Sep 17 00:00:00 2001 From: Wild Kat Date: Fri, 16 Mar 2018 20:31:09 +0100 Subject: improve spelling in docs --- docs/Model-Notes/AireOS.md | 2 +- docs/Model-Notes/Comware.md | 2 +- docs/Model-Notes/README.md | 4 ++-- docs/Model-Notes/VRP-Huawei.md | 2 +- 4 files changed, 5 insertions(+), 5 deletions(-) (limited to 'docs/Model-Notes') diff --git a/docs/Model-Notes/AireOS.md b/docs/Model-Notes/AireOS.md index 9962f31..5674ae2 100644 --- a/docs/Model-Notes/AireOS.md +++ b/docs/Model-Notes/AireOS.md @@ -1,7 +1,7 @@ Cisco WLC Configuration ======================= -Create a user with read-write privilege : +Create a user with read-write privilege: ```text mgmtuser add oxidized **** read-write diff --git a/docs/Model-Notes/Comware.md b/docs/Model-Notes/Comware.md index 0da019a..e7a2198 100644 --- a/docs/Model-Notes/Comware.md +++ b/docs/Model-Notes/Comware.md @@ -1,7 +1,7 @@ Comware Configuration ===================== -If you find 3Com comware devices aren't being backed up this may be due to prompt detection not matching because a previous login message is disabled after the first prompt. +If you find 3Com Comware devices aren't being backed up this may be due to prompt detection not matching because a previous login message is disabled after the first prompt. You can disable this on the devices themselves by running this command: diff --git a/docs/Model-Notes/README.md b/docs/Model-Notes/README.md index 8dcabd3..c4b0ed1 100644 --- a/docs/Model-Notes/README.md +++ b/docs/Model-Notes/README.md @@ -1,7 +1,7 @@ Model Notes =========== -This directory contains implemention notes and caveats to assist you in your oxidized deployment. +This directory contains implementation notes and caveats to assist you in your oxidized deployment. Use the table below for more information on the Vendor/Model caveats. @@ -12,6 +12,6 @@ AireOS|[AireOS](AireOS.md)|29 Nov 2017 Arbor Networks|[ArbOS](ArbOS.md)|27 Feb 2018 Huawei|[VRP](VRP-Huawei.md)|17 Nov 2017 Juniper|[MX/QFX/EX/SRX/J Series](JunOS.md)|18 Jan 2018 -Xyzel|[XGS4600 Series](XGS4600-Zyxel.md)|23 Jan 2018 +Zyxel|[XGS4600 Series](XGS4600-Zyxel.md)|23 Jan 2018 If you discover additional caveats or problems please make sure to consult the [GitHub issues for oxidized](https://github.com/ytti/oxidized/issues) known issues. diff --git a/docs/Model-Notes/VRP-Huawei.md b/docs/Model-Notes/VRP-Huawei.md index a5c0c99..ff5426e 100644 --- a/docs/Model-Notes/VRP-Huawei.md +++ b/docs/Model-Notes/VRP-Huawei.md @@ -19,7 +19,7 @@ The commands Oxidized executes are: 3. display device 4. display current-configuration all -Command 2 and 3 can be executed without issues, but 1 and 4 are only available for higher level users. Instead of making Oxidized a read/write user on your device, lower the priviledge-level for commands 1 and 4: +Command 2 and 3 can be executed without issues, but 1 and 4 are only available for higher level users. Instead of making Oxidized a read/write user on your device, lower the privilege-level for commands 1 and 4: ```text system-view -- cgit v1.2.1