Gå till innehållet

Oxidized är ett backup tool för nätverk devices. Alltså en ersättare till Rancid. Oxidized bygger också på perl men är lite mer modernare än Rancid. Oxidized har ett eget webinterface med REST API stöd för att kunna söka, diffa och visa config. Medans Rancid enbart kan använda en csv fil som source vad den ska backupa kan Oxidized även använda samma sorts fil, en SQL databas eller en websida med JSON tex LibreNMS API.

Supportade OS

  • A0 Networks
    • ACOS
  • Alcatel-Lucent
    • AOS
    • AOS7
    • ISAM
    • TiMOS
    • Wireless
  • Arista
    • EOS
  • Arris
    • C4CMTS
  • Aruba
    • AOSW
  • Brocade
    • FabricOS
    • Ironware
    • NOS (Network Operating System)
    • Vyatta
  • Ciena
    • SOAS
  • Cisco
    • AireOS
    • ASA
    • IOS
    • IOSXR
    • NXOS
    • SMB (Nikola series)
  • Citrix
    • NetScaler (Virtual Applicance)
  • Cumulus
    • Linux
  • DataCom
    • DmSwitch 3000
  • DELL
    • PowerConnect
    • AOSW
  • Ericsson/Redback
    • IPOS (former SEOS)
  • Extreme Networks
    • XOS
    • WM
  • F5
    • TMOS
  • Force0
    • DNOS
    • FTOS
  • FortiGate
    • FortiOS
  • HP
    • Comware (HP A-series, H3C, 3Com)
    • Procurve
  • Huawei
    • VRP
  • Juniper
    • JunOS
    • ScreenOS (Netscreen)
  • Mikrotik
    • RouterOS
  • Motorola
    • RFS
  • MRV
    • MasterOS
  • Netonix
    • WISP Switch (As Netonix)
  • Opengear
    • Opengear
  • Palo Alto
    • PANOS
  • Supermicro
    • Supermicro
  • Ubiquiti
    • AirOS
    • Edgeos
    • EdgeSwitch
  • Zyxel
    • ZyNOS

Installation

requires Ruby version >= 2.0

  • #tab1|CentOS 7
  • #tab2|Ubuntu 16.04
Skapa Oxidized användaren `useradd -d /opt/oxidized oxidized` Installera EPEL och SCL `yum install epel-release centos-release-scl-rh centos-release-scl` Installera Ruby samt extra paket för att kompilera Oxidized. `yum install make cmake which sqlite-devel openssl-devel libssh2-devel gcc libicu-devel gcc-c++ rh-ruby26-ruby-devel rh-ruby26-ruby git` Installera Oxidized `scl enable rh-ruby26 bash` `gem install oxidized` `gem install oxidized-script oxidized-web` Skapa en systemd fil åt Oxidized.
#For debian 8 put it in /lib/systemd/system/ #To set OXIDIZED_HOME instead of the default: # ~${oxidized_user}/.config/oxidized in debian 8, then uncomment #(and modify as required) the "Environment" variable below so #systemd sets the correct environment. Tested only on Debian 8.8. #YMMV otherwise. # #For RHEL / CentOS 7 put it in /etc/systemd/system/ #and call it with systemctl start oxidized.service [Unit] Description=Oxidized - Network Device Configuration Backup Tool After=network-online.target multi-user.target Wants=network-online.target [Service] ExecStart=/bin/scl enable rh-ruby26 /opt/rh/rh-ruby26/root/usr/local/bin/oxidized User=oxidized KillSignal=SIGKILL Restart=always RestartSec=20 #Environment="OXIDIZED_HOME=/etc/oxidized" [Install] WantedBy=multi-user.target
`sudo add-apt-repository universe` `sudo apt-get -y install ruby ruby-dev libsqlite3-dev libssl-dev pkg-config cmake libssh2-1-dev libicu-dev zlib1g-dev g++` `sudo gem install oxidized` `sudo gem install oxidized-script oxidized-web`

Konfiguration

Konfigurationen är på YAML-format. Default-konf finns i: /etc/oxidized/config och sedan används\~/.config/oxidized/config

För att initiera oxidized i ditt home directory kör:

mkdir -p ~/.config/oxidized oxidized nano ~/.config/oxidized/config

Man kan ändra var man vill att oxidized ska lägga sig genom att ändra environment variable

OXIDIZED_HOME=/etc/oxidized

Logging

log: "/home/$USER/.config/oxidized/oxidized.log"

Input

Input hämtar konfiguration från enheterna.

input: default: ssh, telnet debug: false ssh: secure: false

Source

Source läser vilka enheter som ska konfigbackas. Oxidized har stöd för CSV, SQLite, MySQL och HTTP som source backends.

CSV

CSV backend läser vilka enheter som det ska tas backup på från en rancid-kompatibel fil.

 source:
   default: csv
   csv:
     file: "/home/$USER/.config/oxidized/router.db"
     delimiter: !ruby/regexp /:/
     map:
       name: 0
       model: 1
       username: 2
       password: 3
     vars_map:
       enable: 4

router.db Format: 0:1:2:3:4

router01.example.com:ios:user:pw:enablepw 172.20.0.1:ios:user:pw:enablepw

HTTP

HTTP backend behöver läsa en JSON hemsida.

source:
  default: http
  debug: false
  http:
    url: https://url
    scheme: https
    map:
      name: hostname
      model: os

Exempel på JSON formatet om Oxidized behöver.

]
  {
    "group": "default",
    "hostname": "switch1",
    "ip": "192.168.1.11",
    "os": "junos"
  },
  {
    "group": "default",
    "hostname": "switch2",
    "ip": "192.168.1.12",
    "os": "xos"
  }
]

Output

Output lagrar konfigurationen. Man måste köra git för att få versionshantering på konfig-filerna.

output: default: file file: directory: "/home/$USER/.config/oxidized/configs"

GIT

output: default: git git: user: Oxidized email: oxidized@example.com repo: "/home/$USER/.config/oxidized/oxidized.git"

Exceptions Man kan lägga in egna undantag för rader som ej borde vara med i konfigen, t.ex. rader med tidsstämplar som ändras ofta.

Exempel IOS, edit /var/lib/gems/2.3.0/gems/oxidized-0.21.0/lib/oxidized/model/ios.rb

  cmd 'show running-config' do |cfg|
    cfg = cfg.each_line.to_a[3..-1]
    cfg = cfg.reject { |line| line.match /^ntp clock-period / }.join
    cfg.gsub! /^Current configuration : [^\n]*\n/, ''
    cfg.gsub! /^! Last configuration change at [^\n]*\n/, ''
    cfg.gsub! /^! NVRAM config last updated at [^\n]*\n/, ''
    cfg.gsub! /^\ tunnel\ mpls\ traffic-eng\ bandwidth[^\n]*\n*(
                  (?:\ [^\n]*\n*)*
                  tunnel\ mpls\ traffic-eng\ auto-bw)/mx, '\1'
    cfg
  end

Hooks

Hooks kan användas för att kalla på script, skicka mail eller pusha mot git när något specifikt har hänt. Mer info om Hooks samt fler exempel finns på deras hemsida

Events

  • node_success: triggas när en lyckad backup har tagits och precis före configen sparas i oxidized.
  • node_fail: triggas efter en node har failat.
  • post_store: triggas efter en node config har sparats. Körs endast om configen har ändrats.
  • nodes_done: triggas efter oxidized gått igenom alla nodes.

Push to GIT

För att pusha till git måste man skapa en hook för det. Där man anger vilket repo samt en ssh key.

hooks:
  push_to_remote:
    type: githubrepo
    events: [post_store]
    remote_repo: ssh://oxidized@github.com/hackernet-oxidized.git
    publickey: /opt/oxidized/.ssh/id_rsa.pub
    privatekey: /opt/oxidized/.ssh/id_rsa

Maila om en node failar

Om en node skulle faila med backupen skicka då ett mail.

  email_output:
    type: exec
    events: [node_fail]
    cmd: '/opt/oxidized/.config/oxidized/extra/oxidized-report-git-commits | mail -s "Oxidized updates for ${OX_NODE_NAME}" hackernet@hackernet.se'
    async: true
    timeout: 120

Execute

För att starta oxidized och ta en första backup

oxidized

RESTful web API

rest::8888

Service

Skapa en service med hjälp av Systemd. Om du installera Oxidized enligt denna guiden för CentOS använd isåfall systemd filen som angetts där.

sudo cat <<'__EOF__'>> /lib/systemd/system/oxidized.service [Unit] Description=Oxidized - Network Device Configuration Backup Tool

[Service] ExecStart=/usr/local/bin/oxidized User=oxidized

[Install] WantedBy=multi-user.target __EOF__

sudo systemctl enable oxidized sudo systemctl start oxidized sudo systemctl status oxidized

Category:Guider