Repository navigation
Release Notes
The git and gitcrypt outputs no longer provide the :date field in the node versions, as it was only used by oxidized-web <= 0.16.0. You need oxidized-web >= 0.17.0, older versions will fail to display node versions and diffs.
Oxidized no longer patches Puma's signal handling (needed for Puma 8). With oxidized-web < 0.17.0, Puma takes over the INT, TERM and HUP signals again. Oxidized logs a warning at startup if it finds such a version.
When loading a single node (oxs <host> in oxidized-script, /reload?node=<host> in oxidized-web), the node name must now match exactly. Previously, a node also matched when its name was contained in the requested name, so oxs router10 could run on router1.
net-ssh >= 8.0 requires Diffie-Hellman group exchange groups of at least 2048 bits (previously 1024). Old devices offering only 1024-bit groups fail to connect; set the variable ssh_minimum_dh_bits: 1024 for them.
net-ssh >= 8.0 parses the OpenSSH configuration files (~/.ssh/config, /etc/ssh/ssh_config) more strictly, including KexAlgorithms, PubkeyAcceptedAlgorithms and - algorithm lists. This may change the algorithm negotiation; see OpenSSH configuration files.
net-ssh >= 8.1 changed how RSA keys are offered, which may break public key authentication on some devices; see SSH public key algorithms.
Added
- device2yaml: add port option (@systeembeheerder)
- itmgos: new model for Lantronix IT Management Gateway OS (SLC 8000, SLC 9000, EMG, SLB console servers), with simulation data and unit tests (@ryanhoggpm)
- vrp: add simulation data for Huawei YunShan OS with VRP model (@systeembeheerder)
- iosxr: add show vesion (@Mascherus, @systeembeheerder)
- cnos: remove transceiver DDM data (@freddy36)
- cnos: add show license output (@freddy36)
- cnos: add FS-S5850 simulation data (@freddy36)
- eatonnetwork: model unit test (@thanegill)
- source/sql: support defining port in configuration. Closes #3853 (@ytti)
- vsololt: new model for VSOL GPON OLT (@Vantomas)
- tplink: add simulation data and unit tests for the TP-Link DeltaStream DS-P7001-08 GPON OLT (@Vantomas)
- device2yaml: add
-n/--newlineoption to set the command line terminator (e.g.-n "\r\n") for devices that submit a command only on a carriage return; the terminator is recorded as acommand_newlinekey in the generated YAML (@Vantomas) - ftd: new model for Cisco FTD via HTTP; requires the optional rubyzip gem (@mgrocock-cwcs, @robertcheramy)
- AGENTS.md: add guidance for AI coding agents, and document the AI contribution policy in CONTRIBUTING.md (@robertcheramy)
- refinements: add
String#rstrip_linesto strip trailing whitespace from each line (@thanegill) - ssh: add the
ssh_pubkey_algorithmsvariable to choose the public key signature algorithms, for devices that disconnect onrsa-sha2-*such as Huawei SmartAX. Closes #2875 (@fmcglinn) - ssh: add the
ssh_minimum_dh_bitsvariable to accept Diffie-Hellman groups smaller than 2048 bits on old devices (@robertcheramy)
Changed
- vyos: add commit info (@systeembeheerder)
- vrp: ignore
!Last configuration was updated/saved atlines whenoutput_store_modeison_significant. Closes #3958 (@robertcheramy) - docker: set LANG=C.UTF-8. Fixes #3690 (@ytti)
- routeros: remove intermittent POE
voltage_on_poe-incomment (@hendrikbl) - tplink: use
\r\nas the line terminator in pre_logout, required for the model unit tests to work (@Vantomas) - ssh: change max_window_size from 138k to 2MB to avoid triggering Mikrotik bug. Closes #3867 (@ytti)
- CI: run Ruby 3.0 and 3.1 on ubuntu-24.04, as ubuntu-26.04 (ubuntu-latest) only provides Ruby >= 3.2 (@robertcheramy)
- README: document libgpg-error-dev as a dependency on Debian and Ubuntu, and libjitterentropy3-dev as a dependency on Ubuntu 26.04 (Ubuntu bug #2158026) (@robertcheramy)
- core: log a warning at startup when the loaded oxidized-web is older than 0.17.0 (@robertcheramy)
- ssh: require net-ssh ~> 8.1 and net-scp ~> 4.2, newer than the Debian 13 packages; the Docker image installs them as gems (@robertcheramy)
- ssh: drop the ed25519 gem dependency and the x25519 gem in the Docker image, as net-ssh 8 uses OpenSSL for Ed25519 and Curve25519 (@robertcheramy)
- ssh, scp: log a warning instead of creating a crashfile on a host key mismatch (
secure: true) and on an unsupported key type (@robertcheramy) - ingate: redact secrets (private keys, passwords, secrets, passphrases, pre-shared keys, tokens and the SNMP community) when remove_secret is set (@thanegill)
- http: support overriding port (@mgrocock-cwcs)
- http: support DELETE method (@mgrocock-cwcs)
- tmos: strip volatile object metadata (checksum, revision, size, create/update time and author) from
tmsh -q listand the partition configs (@dahlmo) - panos_api: back up the running configuration with
show config runninginstead of the candidate configuration export. A custom admin role now needs the XML APIOperational Requestspermission; setpanos_api_candidate: trueto keep the previous behaviour. Fixes #2759 (@macmandr197) - gemspec: add nokogiri as a development dependency for the panos_api unit tests (@macmandr197)
- gemspec: document which component needs each optional dependency (@robertcheramy)
- output/git: skip walking the git logs in the version cache when HEAD did not change, speeding up node lists in oxidized-web. Closes #3895 (@zaits07)
- output/git: reduce the memory footprint of the version cache by deduplicating author and message strings (@robertcheramy)
- output/git, output/gitcrypt: remove the
:datefield from node versions, use:timeinstead. Requires oxidized-web >= 0.17.0 (@robertcheramy) - garderos: replace
show system version&show system serialwithshow system informationandshow hardware allto get more hardware details (@robertcheramy) - docs: document in Docker.md how to extend the official image with additional gems or packages, as the image no longer ships build tools or
/sbin/my_initsince the move to debian:trixie-slim. Closes #3897 (@joewaltman) - ATOMS tests: fail instead of skip when test data cannot be loaded (@robertcheramy)
- procurve: rstrip trailing whitespace from commented command sections (@thanegill)
- adtran, aosw, c4cmts, coriantgroove, dlink, dlinknextgen, enterasys, hpebladesystem, junos, mtrlrfs, procurve, routeros, xos, zhoneolt: use the
cut_*andrstrip_linesrefinements instead of custom code (@thanegill) - arbos, aricentiss, asa, asternos, bdcom, comnetms, dellx, dnos, eciapollo, edgeos, fiberdriver, firelinuxos, ftos, ibos, kornfeldos, masteros, mlnxos, ndms, necix, netgear, netscaler, ocnos, onefinity, openbsd, os10, os6, panos, screenos, sgos, siklu, sonicos, tdre, telco, tplink, viptela, voltaire, vyatta: use the
cut_head,cut_tailandcut_bothrefinements instead of slicing line arrays (@robertcheramy) - acsw, aireos, br6910, ironware, slxos, sonicos, tplink: use endless ranges (
[n..]) instead of[n..-1](@robertcheramy) - audiocodesmp, ciscosmb, ibos, kornfeldos, oneos: remove no-op
[0..-1]slicing that only copied the configuration (@robertcheramy) - rubocop: enable
Style/SlicingWithRangeand fix the offenses in hooks, telnet input, refinements and extra/syslog.rb (@robertcheramy) - procurve: remove ANSI escape codes with
clean :escape_codesand simplify the prompt regexp (@thanegill) - procurve: redact the additional credentials exposed by
include-credentials/encrypt-credentials, with unit tests (@thanegill)
Fixed
- extra/oxidized.service: remove
KillSignal=SIGKILL, Oxidized exits on SIGTERM since #3059 (@robertcheramy) - signals: remove the
Puma::Signalmonkey patch, which broke Puma 8 (undefined method 'list' for class Puma::Signal) when Oxidized was loaded before Puma. The patch is no longer needed since oxidized-web 0.17.0 (ytti/oxidized-web#357) startsPuma::Serverdirectly instead of using the Puma launcher. With oxidized-web < 0.17.0, Puma traps INT, TERM and HUP again (@robertcheramy) - output/git:
get_diffonly returns the diff of the requested node when a commit contains several nodes (@robertcheramy) - output/gitcrypt:
get_diffonly returns the diff of the requested node when a commit contains several nodes, and works with groups in a single repository (@robertcheramy) - output/gitcrypt: reference the
gitgem as::Git, asGitresolved toOxidized::Output::Gitwhen the git output was loaded too (@robertcheramy) - input/cli: raise an error when a requested login credential is missing. Fixes #3700 (@robertcheramy)
- eos: hide the community string / v3 user in snmp-server host lines. Fixes #3882 (@FusionBrah)
- aoscx: mask the community string in snmp-server host lines instead of the token after the host address. Fixes #3881 (@FusionBrah)
- fortigate: answer the
Do you want to continue? (y/n)prompt fromdiagnose hardware deviceinfo psu. Fixes #3940 (@suryakant-source) - fastiron: answer the pager prompt with a space and strip ANSI escape sequences, as
skip-page-displayis not available to users without enable rights. Fixes #3819 (@FusionBrah) - junos: redact cleartext passwords embedded in archive-site URLs. Fixes #3640 (@KalebFenley, @robertcheramy)
- nxos: hide the auth key of snmp-server users without priv (@robertcheramy)
- siklu: allow parenthesis in prompt. Fixes #3841 (@ytti)
- fortios: allow parenthesis in prompt. Fixes #3846 (@ytti)
- os6: hide snmp-server community strings in the secret filter (@Jurgen1994)
- fortigate: prompt can contain HA cluster status. Fixes #3846 (@robertcheramy)
- aoscx: hide power consumption on rows where PSU output is N/A. Fixes #3864 (@FusionBrah)
- aoscx: hide input voltage readings in "show environment power-supply input-voltage". Fixes #3864 (@FusionBrah)
- source: return the decrypted contents of a
gpg-encrypted source as an IO object, so JSONFile (and any source reading via#read) loads it instead of crashing with aNoMethodError. Fixes #3879 (@youdie006) - output/git: fix the version cache losing commits made within the same second or during a cache update. Log an error and rebuild the cache if the git history has been rewritten while Oxidized is running (@robertcheramy)
- output/git: rebuild the git index from HEAD before each commit, so that changes merged by the githubrepo hook or pushed to the repository are no longer reverted by the next commit, and read configurations from HEAD instead of the index. Fixes #3887 (@robertcheramy)
- scp: rescue the
ArgumentErrornet-scp raises when a device answers with an error message missing the\2prefix, so the node fails instead of crashing Oxidized. Fixes #3900 (@SAY-5) - nodes: match the node name exactly when loading a single node, instead of matching the node name as a regexp against the requested name, which could select the wrong node (e.g.
router1forrouter10) (@robertcheramy) - core: expand
~incrash.directorybefore writing crash dumps. Fixes #3945. (@wleeaf, @robertcheramy) - junos: remove syntax error when there is no virtual chassis. Fixes #3922. (@dalejos, @robertcheramy)
- ssh: reject an
ssh_proxythat is not[user@]host(RFC 1123 hostname, IPv4 or IPv6 address) and anssh_proxy_portthat is not an integer, so values from the source cannot inject shell commands or ssh options. Invalid ssh variables make the node fail with a warning (@robertcheramy) - docs: Supported-OS-Types lists the F5OS, Grandstream HT8xx and Uplink EP4440 models under their model names (
f5os,grandstreamht8xx,uplinkolt) instead oftmos,grandstreamandEP4440(@rawsun007) - awplus: remove stray BEL (0x07) character left from pager. Fixes #3919. (@cojumbo, @robertcheramy)
- procurve: hide the SNMP community on
snmp-server host <ip> community "<name>"lines (@thanegill) - procurve: hide local user password hashes (
password ... sha1 "<hash>") when remove_secret is true (@thanegill) - debug logs no longer contain the node password, sensitive vars (e.g.
enable) and the HTTP Authorization header (basic auth credentials, API tokens). The newOxidized::Redactmodule hides them, using the same patterns asoxidized --support(@robertcheramy)
New Contributors
- @hendrikbl made their first contribution in #3863
- @FusionBrah made their first contribution in #3866
- @KalebFenley made their first contribution in #3868
- @youdie006 made their first contribution in #3880
- @Jurgen1994 made their first contribution in #3870
- @mgrocock-cwcs made their first contribution in #3908
- @dahlmo made their first contribution in #3896
- @fmcglinn made their first contribution in #3928
- @Skorvol made their first contribution in #3903
- @mpikzink made their first contribution in #3901
- @suryakant-source made their first contribution in #3941
- @macmandr197 made their first contribution in #3934
- @SAY-5 made their first contribution in #3935
- @rawsun007 made their first contribution in #3955
- @ryanhoggpm made their first contribution in #3953
- @joewaltman made their first contribution in #3957
Full Changelog: 0.37.0...0.38.0