netbox-agent/README.md

Netbox agent

This project aims to create hardware automatically into Netbox based on standard tools (dmidecode, lldpd, parsing /sys/, etc).

The goal is to generate an existing infrastructure on Netbox and have the ability to update it regularly by executing the agent.

Features

• Create servers, chassis and blade through standard tools (dmidecode)
• Create physical, bonding and vlan network interfaces with IPs
• Create IPMI interface if found
• Create or get existing VLAN and associate it to interfaces
• Generic ability to guess datacenters and rack location through drivers (cmd and file and custom ones)
• Update existing Device and Interface
• Handle blade moving (new slot, new chassis)
• Automatic cabling (server's interface to switch's interface) using lldp

Requirements

• Netbox >= 2.6

• Python >= 3.4

• pynetbox

• python3-netaddr

• python3-netifaces

• ethtool

• dmidecode

• ipmitool

• lldpd

Known limitations

• The project is only compatible with Linux. Since it uses ethtool and parses /sys/ directory, it's not compatible with *BSD distributions.
• Netbox >=2.6.0,<=2.6.2 has a caching problem ; if the cache lifetime is too high, the script can get stale data after modification. We advise to set CACHE_TIME to 0.

Configuration

netbox:
 url: 'http://netbox.internal.company.com'
 token: supersecrettoken

network:
  ignore_interfaces: "(dummy.*|docker.*)"
  ignore_ips: (127\.0\.0\..*)
  # enable auto-cabling
  lldp: true

datacenter_location:
 driver: "cmd:cat /etc/qualification | tr [a-z] [A-Z]"
 regex: "DATACENTER: (?P<datacenter>[A-Za-z0-9]+)"
# driver: 'cmd:lldpctl'
# regex: 'SysName: .*\.([A-Za-z0-9]+)'
#
# driver: "file:/tmp/datacenter"
# regex: "(.*)"

rack_location:
# driver: 'cmd:lldpctl'
# match SysName: sw-dist-a1.dc42
# regex: 'SysName:[ ]+[A-Za-z]+-[A-Za-z]+-([A-Za-z0-9]+)'
#
# driver: "file:/tmp/datacenter"
# regex: "(.*)"

Hardware

Tested on:

Dell Inc.

Blades

• PowerEdge M1000e (your DeviceType should have slots named Slot 01 and so on)
• PowerEdge M640
• PowerEdge M630
• PowerEdge M620
• PowerEdge M610

Pizzas

• DSS7500

HP

Blades

• HP BladeSystem c7000 Enclosure G2 / G3 (your DeviceType should have slots named Bay 1 and so on)
• HP ProLiant BL460c Gen8
• HP ProLiant BL460c Gen9
• HP ProLiant BL460c Gen10

Pizzas

• ProLiant DL380p Gen8

HPE

• HPE ProLiant XL450 Gen10

TODO

• CPU, RAID Card(s), RAM, Disks in Device's Inventory
• CustomFields support with firmware versions for Device (BIOS), RAID Cards and disks