Package: nautobot-cable-utils
Nautobot Cable UtilitiesUtilities 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.InstallationThe plugin can be found onpypi.
You should therefore be able to install it usingpip:pip install nautobot-cable-utilsMake sure to use the same version ofpipthat manages Nautobot, so if you’ve
set up a virtual environment, you will have to use<venv>/bin/pipinstead.After that, you should be able to install the plugin as described inthe
Nautobot documentation. No
change toPLUGINS_CONFIGis necessary.UsageThis plugin has two main purposes:reconnecting cablesandworking with cable templates.Automatic RouterThis 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 onAuto-Linkon 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 ExplanationWe 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 cablesIf you want to reconnect a cable, just go to its detail view. There should be a
button calledReconnectthat 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 templatesCable templates can be found underPlugins, where you will be able to add them
one by one or import them via CSV (both buttons next toCable 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 namedCommissionwill 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 functionUndo Commissioncan be used. On a previously commissioned cable which uses a valid template this button will appearBy 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 DevicesTo save time a bulk commission function can be used directly out of a selected device. If a device has planned cables an additional buttonDevice Commissionwill 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 buttonCreatethe current cable will be commissioned with the selected (cable)template. By using the buttonSkipthe current cable will be left out and the next planned cable is displayed. By pressingCancelthe 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 theCancelbutton 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 pressingCanceland freshly opened.Have fun!