scaleway/netbox-netprod-importer

scaleway/netbox-netprod-importer

Description: Poll data from network devices in production and import it into netbox

Language: Roff

License: GPL-3.0

Stars: 109

Forks: 33

Open issues: 27

Created: 2018-12-17T19:10:20Z

Pushed: 2024-08-09T23:44:46Z

Default branch: master

Fork: no

Archived: no

README: ================================== Netbox network production importer ==================================

.. image:: https://travis-ci.org/scaleway/netbox-netprod-importer.svg?branch=master :target: https://travis-ci.org/scaleway/netbox-netprod-importer

netbox-netprod-importer is a tool dedicated to help moving your current knowledge base to Netbox _ as an IPAM/DCIM, independently of your current information system. It connects to a given list of network devices, parse their status and configuration to import them into Netbox like they are currently configured.

It is thought to be generic and infrastructure agnostic. It means that imported data will probably need to be adapted by some custom scripts, like the specification of roles, tennant and other properties on objects.

Used by Scaleway _ on more than 5000 network devices.

Documentation -------------

Documentation is available here _.

Features --------

Device's data:

• Fetch interfaces (physical & virtual):

• Try to guess the interface form factor (more info in the documentation)
• MTU
• MAC Address
• Description
• Parent LAG
• Enabled/Disabled
• IPv4/IPv6

• Serial number
• Main IPv4/IPv6

Devices interconnections:

• Build an interconnection graph by using LLDP to add (and optionally clean)

interconnections between devices in Netbox

Compatibility -------------

Tested on:

• Cisco IOS (catalyst, 2960)
• Cisco Nexus 9000
• Cisco ASR (but no specific parser written, some features are not available)
• Juniper

Installation ------------

Run::

pip3 install netbox-netprod-importer

netbox-netprod-importer requires at least Python 3.6. It is tested on Python 3.6 to 3.8.

Contributors ------------

Tool initially developed by Scaleway _ .

• Anthony Ruhier

License -------

Tool under the GPLv3 license. Do not hesitate to report bugs, ask me some questions or do some pull request if you want to!