From 31c156f792eb7acb08fc2816339ed31e70afc74c Mon Sep 17 00:00:00 2001 From: Jeremy Stretch Date: Tue, 28 Jul 2020 09:48:55 -0400 Subject: [PATCH] Updated cable documentation --- docs/media/models/dcim_cable_trace.png | Bin 0 -> 14950 bytes docs/models/dcim/cable.md | 41 +++++++++++++++++-------- 2 files changed, 28 insertions(+), 13 deletions(-) create mode 100644 docs/media/models/dcim_cable_trace.png diff --git a/docs/media/models/dcim_cable_trace.png b/docs/media/models/dcim_cable_trace.png new file mode 100644 index 0000000000000000000000000000000000000000..9597c88286aa86fe2f308b9fce5cefa33beceb82 GIT binary patch literal 14950 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 literal 0 HcmV?d00001 diff --git a/docs/models/dcim/cable.md b/docs/models/dcim/cable.md index 8b00a999d..753ab6f7f 100644 --- a/docs/models/dcim/cable.md +++ b/docs/models/dcim/cable.md @@ -1,19 +1,34 @@ # Cables -A cable represents a physical connection between two termination points, such as between a console port and a patch panel port, or between two network interfaces. Cables can be traced through pass-through ports to form a complete path between two endpoints. In the example below, three individual cables comprise a path between the two connected endpoints. +All connections between device components in NetBox are represented using cables. A cable represents a direct physical connection between two termination points, such as between a console port and a patch panel port, or between two network interfaces. -``` -|<------------------------------------------ Cable Path ------------------------------------------->| +Each cable must have two endpoints defined. These endpoints are sometimes referenced as A and B for clarity, however cables are direction-agnostic and the order in which terminations are made has no meaning. Cables may be connected to the following objects: - Device A Patch Panel A Patch Panel B Device B -+-----------+ +-------------+ +-------------+ +-----------+ -| Interface | --- Cable --- | Front Port | | Front Port | --- Cable --- | Interface | -+-----------+ +-------------+ +-------------+ +-----------+ - +-------------+ +-------------+ - | Rear Port | --- Cable --- | Rear Port | - +-------------+ +-------------+ -``` +* Circuit terminations +* Console ports +* Console server ports +* Interfaces +* Pass-through ports (front and rear) +* Power feeds +* Power outlets +* Power ports -All connections between device components in NetBox are represented using cables. However, defining the actual cable plant is optional: Components can be be directly connected using cables with no type or other attributes assigned. +Each cable may be assigned a type, label, length, and color. Each cable is also assigned one of three operational statuses: -Cables are also used to associated ports and interfaces with circuit terminations. To do this, first create the circuit termination, then navigate the desired component and connect a cable between the two. +* Active (default) +* Planned +* Decommissioning + +## Tracing Cables + +A cable may be traced from either of its endpoints by clicking the "trace" button. (A REST API endpoint also provides this functionality.) NetBox will follow the path of connected cables from this termination across the directly connected cable to the far-end termination. If the cable connects to a pass-through port, and the peer port has another cable connected, NetBox will continue following the cable path until it encounters a non-pass-through or unconnected termination point. The entire path will be displayed to the user. + +In the example below, three individual cables comprise a path between devices A and D: + +![Cable path](../../media/models/dcim_cable_trace.png) + +Traced from Interface 1 on Device A, NetBox will show the following path: + +* Cable 1: Interface 1 to Front Port 1 +* Cable 2: Rear Port 1 to Rear Port 2 +* Cable 3: Front Port 2 to Interface 2