Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Basic Network Management System on Web with Rails, Backbone and Bootstrap
branch: master

This branch is 101 commits behind donapieppo:master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
app
config
db
lib
log
public
script
test
vendor
.gitignore
Gemfile
README.md
Rakefile
config.ru

README.md

NMS on Rails

A basic Network Management System built with Ruby on Rails, Backbone (styled with Bootstrap).

Provides basic integration to:

and gives simple web interface to manage informations about your network ips and to connect to clients using ssh/rdp/http.

Getting started

After you have cloned and "bundle installed" everything you can load the database schema

bundle exec rake db:schema:load
bundle exec rake NmsOnRails:create_network

edit the file config/initializers/nms-on-rails.rb

and then fire rails.

Rake

 bundle exec rake -T NmsOnRails

The database can be populated with data from arpwatch and puppet. Usually with cron jobs.

Arpwatch

bundle exec rake NmsOnRails:arpwatch

reads arpwatch data (directly from arpwatch files) and updates the database. Accordingly the web interface shows how many days ago the ip was used.

Puppet

bundle exec rake NmsOnRails:facts:load

reads puppet data (facts in puppet language) and updates the database. Provides information about the hardware and operating system of the computers managed with puppet.

Bind

bundle exec rake NmsOnRails:dns:update

reads domain records with axfr query (the dns server has to allow them).

SNMP

bundle exec rake NmsOnRails:snmp:snmpwalk

updates mac-address with port on the switch (uses snmpwalk -On -v 2c -c #{community} #{clean_ip} .1.3.6.1.2.1.1.5.0)

Database structure

Ips

  • last_arp_id: is the association to the last arp address seen with the ip (usually discovered by arpwatch)
  • last_info_id: is the association to the last info (name, dns...). Some fields in infos table are seu by user.
  • conn_proto: can be ssh/rdp/http (used to connect witha click to the pc)
  • notify: boolean you set when you whant to be notified when the pc in reachable.

Ips has one_to_many relation with the arps, infos and facts tables.

Arps

The arps table collects data from arpwatch (date and ip/mac-address association)

Infos

Are the information you give to the ip. You can update or reset when the ip is associated to other informations.

Facts

Facts come from pc controlled by puppet (https://github.com/puppetlabs/puppet) and are gathered by facter (https://http://puppetlabs.com/puppet/related-projects/facter/).

Something went wrong with that request. Please try again.