{"id":2304,"date":"2019-03-01T00:03:06","date_gmt":"2019-03-01T00:03:06","guid":{"rendered":"http:\/\/www.incredigeek.com\/home\/?p=2304"},"modified":"2023-02-08T15:36:27","modified_gmt":"2023-02-08T21:36:27","slug":"install-oxidized-on-librenms","status":"publish","type":"post","link":"https:\/\/www.incredigeek.com\/home\/install-oxidized-on-librenms\/","title":{"rendered":"Install Oxidized on LibreNMS"},"content":{"rendered":"\n

Install Oxidized<\/strong><\/p>\n\n\n\n

Install Instructions from here<\/a><\/p>\n\n\n\n

Install prerequisites <\/strong><\/p>\n\n\n\n

For CentOS, RockyLinux, and Alma Linux.<\/p>\n\n\n\n

sudo yum -y install make cmake which sqlite-devel openssl-devel libssh2-devel ruby gcc ruby-devel libicu-devel gcc-c++<\/pre>\n\n\n\n
<\/p>\n\n\n\n
Install Ruby Gems<\/strong><\/p>\n\n\n\n
If you run into issues with installing the oxidized-web gem because of a ruby version, try installing ruby 2.6.1 via rvm<\/a> the docs say install 2.1.2, but was having issues with it.  2.6.1 seems fine.<\/p>\n\n\n\n
Install Oxidized<\/strong><\/p>\n\n\n\n
Note: If you run into issues with oxidized not being able to ssh into devices, and showing “OpenSSL::PKey::PKeyError with msg “dh#set_pqg= is incompatible with OpenSSL 3.0″” in the log, try installing from git<\/a>.<\/p>\n\n\n\n
gem install oxidized \ngem install oxidized-script\ngem install oxidized-web <\/pre>\n\n\n\n
Run Oxidized twice to generate the config<\/p>\n\n\n\n
oxidized<\/pre>\n\n\n\n
If you have issues running oxidized due to an invalid or self signed ssl cert, you can either fix the cert or ignore it in the oxidized config. https:\/\/github.com\/ytti\/oxidized\/pull\/618\/files<\/a><\/p>\n\n\n\n
Modify the Oxidized config file in “\/root\/.config\/oxidized\/config” to look like this.<\/p>\n\n\n\n
Modify the http portion of the config file to look like the following.<\/p>\n\n\n\n
http:
\n    url: https:\/\/localhost\/api\/v0\/oxidized
\n    scheme: https
\n    secure: false<\/pre>\n\n\n\n
Setup Config<\/strong><\/p>\n\n\n\n
Put the config file in the users home directory.<\/p>\n\n\n\n
vi .config\/oxidized\/config<\/pre>\n\n\n\n
Setup the config, Basic config below, edit as needed<\/p>\n\n\n\n
---
username: admin
password: password
model: airos
resolve_dns: true
interval: 3600
use_syslog: false
debug: false
threads: 30
timeout: 20
retries: 3
prompt: !ruby\/regexp \/^([\\w.@-]+[#>]\\s?)$\/
rest: 127.0.0.1:8888
next_adds_job: false
vars: {}
groups:
   airos:
     username: ubnt
     password: ubnt
   routeros:
     username: admin
     password: 
     vars:
       ssh_port: 2222
 models: {}
 pid: \/home\/incredigeek\/.config\/oxidized\/pid
 crash:
   directory: \/home\/incredigeek\/.config\/oxidized\/crashes
   hostnames: false
 stats:
   history_size: 10
 input:
   default: ssh, telnet
   debug: false
   ssh:
     secure: false
   ftp:
     passive: true
   utf8_encoded: true
 output:
   default: file
   file:
     directory: \/home\/incredigeek\/.config\/oxidized\/configs
 source:
   default: http
   debug: false
   http:
     secure: false
     scheme: https
     url: https:\/\/localhost\/api\/v0\/oxidized
     map:
       name: hostname
       model: os
       group: group
     headers:
       X-Auth-Token: '3wq2b87fj4e6fb5987b5812t6ej9709g'
 model_map:
   cisco: ios
   juniper: junos
   mikrotik: routeros<\/pre>\n\n\n\n
Setup as system service<\/strong><\/p>\n\n\n\n
Find the “oxidized.service” file, should be in <\/p>\n\n\n\n
  \/usr\/local\/rvm\/gems\/ruby-2.6.1\/gems\/oxidized-0.25.1\/extra\/oxidized.service<\/pre>\n\n\n\n
or <\/p>\n\n\n\n
\/usr\/local\/share\/gems\/gems\/oxidized-0.28.0\/extra\/oxidized.service<\/pre>\n\n\n\n
and copy it to <\/p>\n\n\n\n
  \/usr\/lib\/systemd\/system\/<\/pre>\n\n\n\n
Edit it and change the user and try to launch it<\/p>\n\n\n\n
systemctl start oxidized<\/pre>\n\n\n\n
If it fails, you may need to substitute the ExecStart= variable to the following more info<\/a><\/p>\n\n\n\n
ExecStart=\/usr\/local\/rvm\/gems\/ruby-2.6.1\/wrappers\/oxidize<\/p>\n\n\n\n
Change the ruby number if yours is different.<\/em><\/p>\n\n\n\n
Enable the service on system boot up and start<\/p>\n\n\n\n
systemctl enable --now oxidized<\/pre>\n\n\n\n
Check that oxidized is running<\/p>\n\n\n\n
systemctl status oxidized<\/pre>\n\n\n\n
LibreNMS config<\/strong><\/p>\n\n\n\n
Add the following to your \/opt\/librenms\/config.php config file.<\/p>\n\n\n\n
# Oxidized configuration\n $config['oxidized']['enabled']                  = TRUE;\n $config['oxidized']['url']                      = 'http:\/\/127.0.0.1:8888';\n $config['oxidized']['features']['versioning']   = true;\n $config['oxidized']['group_support']            = true;\n $config['oxidized']['default_group']            = 'default';\n $config['oxidized']['reload_nodes']             = true;\n $config['oxidized']['ignore_os'] = array('linux','windows');\n $config['oxidized']['ignore_types'] = array('server','power');<\/pre>\n\n\n\n
LibreNMS should now feed Oxidized the devices.  <\/p>\n\n\n\n
You can check in the LibreNMS interface to see if it is getting the configs.  https:\/\/librenms\/oxidized<\/p>\n\n\n\n
Where librenms is your LibreNMS servers ip\/hostname.
<\/p>\n","protected":false},"excerpt":{"rendered":"
Install Oxidized Install Instructions from here Install prerequisites For CentOS, RockyLinux, and Alma Linux. sudo yum -y install make cmake which sqlite-devel openssl-devel libssh2-devel ruby gcc ruby-devel libicu-devel gcc-c++ Install Ruby Gems If you run into issues with installing the … Continue reading →<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[352],"tags":[75,353,134,389,585],"class_list":["post-2304","post","type-post","status-publish","format-standard","hentry","category-librenms","tag-backup","tag-librenms","tag-monitoring","tag-nms","tag-oxidized"],"_links":{"self":[{"href":"https:\/\/www.incredigeek.com\/home\/wp-json\/wp\/v2\/posts\/2304","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.incredigeek.com\/home\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.incredigeek.com\/home\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.incredigeek.com\/home\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.incredigeek.com\/home\/wp-json\/wp\/v2\/comments?post=2304"}],"version-history":[{"count":16,"href":"https:\/\/www.incredigeek.com\/home\/wp-json\/wp\/v2\/posts\/2304\/revisions"}],"predecessor-version":[{"id":4828,"href":"https:\/\/www.incredigeek.com\/home\/wp-json\/wp\/v2\/posts\/2304\/revisions\/4828"}],"wp:attachment":[{"href":"https:\/\/www.incredigeek.com\/home\/wp-json\/wp\/v2\/media?parent=2304"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.incredigeek.com\/home\/wp-json\/wp\/v2\/categories?post=2304"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.incredigeek.com\/home\/wp-json\/wp\/v2\/tags?post=2304"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}