nautobot-cable-utils 0.11.2

A Nautobot plugin for working with cables

Nautobot Cable Utilities

Utilities for working with cables in Nautobot. Enables you to change cable endpoints and work with cable templates.

Please note that this plugin uses internal Nautobot components, which is explicitly discouraged by the documentation. We promise to keep the plugin up to date, but the latest version might break on unsupported Nautobot version. Your mileage may vary.

Installation

The plugin can be found on pypi. You should therefore be able to install it using pip:

pip install nautobot-cable-utils

Make sure to use the same version of pip that manages Nautobot, so if you’ve set up a virtual environment, you will have to use <venv>/bin/pip instead.

After that, you should be able to install the plugin as described in the Nautobot documentation. No change to PLUGINS_CONFIG is necessary.

Usage

This plugin has two main purposes: reconnecting cables and working with cable templates.

Automatic Router

This plugin contains an automatic router which supports automatic cable creation between two devices. It uses already pre-connected patch panels in racks to find a way between two racks. Therefore, you can click on Auto-Link on an interface to start into the auto-router.

Afterwards you can select your destination and you will see a proposed cable trace and a list of cables which will be created with Planned status afterwards.

Principle Explanation

We build a graph, where our verticies are all racks in your Netbox instance and edges are rear-port cables in rack-mounted patch panels. Afterwards, we path-find our way from source rack to destination rack and build a list of needed cables. This list gets visualized and displayed in the confirmation view and gets created with Planned status afterwards.

Reconnecting cables

If you want to reconnect a cable, just go to its detail view. There should be a button called Reconnect that will send you to a form in which you can change cable endpoints.

The form that it will send you to is fairly similar to the cable creation view, but it will not allow you to edit the cable’s properties.

Working with cable templates

Cable templates can be found under Plugins, where you will be able to add them one by one or import them via CSV (both buttons next to Cable templates). They have all the same properties as regular cables, plus a cable number.

Cable templates can be used in any planned cable. If you navigate to that cable’s detail view, an additional button named Commission will appear.

If you click on it, you will be able to select the cable template you want to use for it (by cable number). The cable takes on the properties of the template (length, color, etc.) and the template will not be selectable again for future cables.

If a cable template should be removed or changed the function Undo Commission can be used. On a previously commissioned cable which uses a valid template this button will appear

By pressing this button the commissioned cable will be removed but the cable trace will be left unaffected. A planned cable will take place which can be commissioned with another cable template if wanted.

Bulk Commission on Devices

To save time a bulk commission function can be used directly out of a selected device. If a device has planned cables an additional button Device Commission will appear:

By pressing this button all cables will can be commissioned in a loop.

The form shows you some important information while commissioning cables. On the top the amount of planned cables on the current device is shown. On the left hand side the connection details and on the right hand side the input field for a cable template are displayed.

By pressing the button Create the current cable will be commissioned with the selected (cable)template. By using the button Skip the current cable will be left out and the next planned cable is displayed. By pressing Cancel the bulk commission will stop and you will be redirected to the previously selected device. After one cable is created or skipped the next planned cable will be displayed.

Important Note! This process is session-dependent. If the form is unexpectly closed or left without pressing the Cancel button the current process of the form is paused and will be continued at the same point if re-opened until the current session has expired or another device is selected. To review skipped cables the form must be exited by pressing Cancel and freshly opened.

---

Have fun!