Skip to content

Commit 7330ee8

Browse files
authored
Merge pull request #461 from ritza-co/19.06.11
Docs 19.06.11 release (Week 29, 2025)
2 parents 270b167 + 53913aa commit 7330ee8

File tree

242 files changed

+1539
-879
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

242 files changed

+1539
-879
lines changed

.gitignore

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,7 @@
1616
.env.production.local
1717
*.swp
1818
.vscode/
19+
CLAUDE.md
1920

2021
npm-debug.log*
2122
yarn-debug.log*

docs/infrastructure-management/buildings-rooms-and-racks/impact-charts.mdx

Lines changed: 262 additions & 129 deletions
Large diffs are not rendered by default.

docs/infrastructure-management/connectivity/cables.mdx

Lines changed: 31 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -3,28 +3,49 @@ title: "Cables"
33
sidebar_position: 1
44
---
55

6+
import ThemedImage from '@theme/ThemedImage'
7+
import useBaseUrl from '@docusaurus/useBaseUrl'
8+
69
### Cabling Overview
710

811
The Device42 cables module can track the origin, end connection(s), length, and path for each of your cables.
912

10-
The origin and end point types can be a patch panel port, a switch port, a device, a circuit, or another cable. A given cable endpoint can also be an origin for multiple other cables.
13+
The origin and endpoint types can be patch panel ports, switch ports, devices, circuits, or other cables. A given cable endpoint can also be an origin for multiple other cables.
1114

12-
Find the "Add A Cable" screen under _DATACENTER --> Cables_
15+
Find the Add Cable screen under **Hardware > Cables**.
1316

14-
![Add A Cable](/assets/images/201802add-cables.png)
17+
<ThemedImage
18+
alt="Add A Cable"
19+
sources={{
20+
light: useBaseUrl('/assets/images/cables/201802add-cables-light.png'),
21+
dark: useBaseUrl('/assets/images/cables/201802add-cables-dark.png'),
22+
}}
23+
/>
1524

16-
Cables also have their own unique properties (see "Add Cable" screen in the above image). Aside from length, connector type, and location, cables support [custom fields](../../administration/custom-key-value-pairs-explained.mdx), as well.
25+
Cables also have their own unique properties. In addition to length, connector type, and location, cables support [custom fields](../../administration/custom-key-value-pairs-explained.mdx).
1726

18-
### Drag and Drop Cabling from the Rack View
27+
### Drag-and-Drop Cabling From the Rack View
1928

20-
From the rack view, you can create, move, edit, and trace cables visually via drag and drop, in addition to the above method.
29+
From the rack view under **Data Center > Racks > Your Rack > View Rack Layout**, you can create, move, edit, and trace cables visually via the drag-and-drop functionality, in addition to the above method.
2130

22-
From the "Rack View" (DATACENTER --> Racks --> YourRack --> View Rack Layout), you can view or easily add a cable connection by clicking "Physical Connections" under "Rack Details" on the left, and enabling "Edit Mode":
31+
You can also view or add a cable connection by clicking **Physical Connections** under **Rack Details** on the left and enabling edit mode:
2332

24-
![Visually Add a Cable](/assets/images/2018002-add_cable_visually.png)
33+
<ThemedImage
34+
alt="Visually Add a Cable"
35+
sources={{
36+
light: useBaseUrl('/assets/images/cables/2018002-add_cable_visually-light.png'),
37+
dark: useBaseUrl('/assets/images/cables/2018002-add_cable_visually-dark.png'),
38+
}}
39+
/>
2540

2641
### View Cables on Impact Charts
2742

28-
If your network Device has cables connected to it (A Load balancer, for example), you'll be able to view those connections in the device's impact chart. See the following image:
43+
If your network device has cables connected to it (a load balancer, for example), you can view those connections in the device's impact chart.
2944

30-
View cables on Impact Charts: ![Trace Cables in impact view](/assets/images/Cable-Impact-Chart-Local-View.png)
45+
<ThemedImage
46+
alt="Trace Cables in impact view"
47+
sources={{
48+
light: useBaseUrl('/assets/images/cables/Cable-Impact-Chart-Local-View-light.png'),
49+
dark: useBaseUrl('/assets/images/cables/Cable-Impact-Chart-Local-View-dark.png'),
50+
}}
51+
/>

docs/infrastructure-management/connectivity/circuits.mdx

Lines changed: 39 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -3,14 +3,47 @@ title: "Circuits"
33
sidebar_position: 2
44
---
55

6-
The Device42 Circuits modules enable management of circuit IDs, vendors and the customers who own the circuits.
6+
import ThemedImage from '@theme/ThemedImage';
7+
import useBaseUrl from '@docusaurus/useBaseUrl'
78

8-
![](/assets/images/WEB-599_telco-circuits-1.png)
9+
The Device42 circuits module enables you to manage and tack the **Circuit ID**, **Vendor**, **Customer** who owns the circuit, and more.
910

10-
![](/assets/images/WEB-599_telco-circuits-2.png)
11+
The circuits module tracks both **Origin** and **End Point** connections. The **Origin Type** and **Endpoint Type** includes panel ports, switch ports, devices, or other circuits.
1112

12-
The Circuits module tracks both origin and end connections. The origin and end point types can be a patch panel port, switch port, a device, or another circuit.
13+
Navigate to **Infrastructure > Hardware > Circuits** and click the **Create** button.
1314

14-
The module also tracks order date, provision date, turn on date and contract start/end dates.
15+
<ThemedImage
16+
alt="Telco circuits overview"
17+
sources={{
18+
light: useBaseUrl('/assets/images/circuits/WEB-599_telco-circuits-1-light.png'),
19+
dark: useBaseUrl('/assets/images/circuits/WEB-599_telco-circuits-1-dark.png'),
20+
}}
21+
/>
1522

16-
File attachments, custom fields and purchase/support info are also available on this screen.
23+
<ThemedImage
24+
alt="Telco circuits overview"
25+
sources={{
26+
light: useBaseUrl('/assets/images/circuits/WEB-599_telco-circuits-2-light.png'),
27+
dark: useBaseUrl('/assets/images/circuits/WEB-599_telco-circuits-2-dark.png'),
28+
}}
29+
/>
30+
31+
<ThemedImage
32+
alt="Telco circuits overview"
33+
sources={{
34+
light: useBaseUrl('/assets/images/circuits/WEB-599_telco-circuits-3-light.png'),
35+
dark: useBaseUrl('/assets/images/circuits/WEB-599_telco-circuits-3-dark.png'),
36+
}}
37+
/>
38+
39+
<ThemedImage
40+
alt="Telco circuits overview"
41+
sources={{
42+
light: useBaseUrl('/assets/images/circuits/WEB-599_telco-circuits-4-light.png'),
43+
dark: useBaseUrl('/assets/images/circuits/WEB-599_telco-circuits-4-dark.png'),
44+
}}
45+
/>
46+
47+
The module also tracks the **Order Date**, **Provision Date**, **Turn on Date**, and **Expiration Date** on contracts.
48+
49+
Fields to upload **File Attachments**, enter **Custom Fields** and **Purchase/Support** details are also available on this screen.

docs/infrastructure-management/connectivity/creating-wall-jacks.mdx

Lines changed: 31 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -3,22 +3,43 @@ title: "Creating Wall Jacks"
33
sidebar_position: 3
44
---
55

6-
A method you can use to document these connections and the patch from patch panel > wall jack > switch > devices will be to create a Patch Panel Model for wall jacks. You can first create this via Devices > Assets > Patch Panel Models, you will want to create a model with the type of port and number of desired ports contained on the panel of the wall jack.
6+
import ThemedImage from '@theme/ThemedImage';
7+
import useBaseUrl from '@docusaurus/useBaseUrl'
78

8-
![Wall Jack Patch Panel](/assets/images/wall-jack-01.png)
9+
One method for documenting the connections and the patch from a patch panel to a wall jack, to a switch, to devices is to create a **patch panel model** for wall jacks.
910

10-
Once the model is created you can then create specific assets for the wall jacks via Devices > Assets > Add Assets. When creating the asset select type Patch Panel then select the wall jack model for the Patch Panel Model. Also, select the Back Connection Type, this can either be Patch Panel or Switch and can go to the Patch Panel or the unmanaged switch you are documenting.
11+
Navigate to **Resources > Assets > Patch Panel Models** and create a model with the appropriate **Port Type** and desired **Number of ports** on the panel of the wall jack.
1112

12-
You will then want to create an unmanaged switch. Do this by going to Tools > Templates & Bulk Operations > Switch Templates then create a template that reflects the switches that are part of this connectivity by selecting switch type and adding a ports switch template with desired ports prefix and a template that includes type/# of ports.
13+
<ThemedImage
14+
alt="Wall Jack Patch Panel"
15+
sources={{
16+
light: useBaseUrl('/assets/images/wall-jacks/wall-jack-01-light.png'),
17+
dark: useBaseUrl('/assets/images/wall-jacks/wall-jack-01-dark.png'),
18+
}}
19+
style={{ width: '80%' }}
20+
/>
1321

14-
Once the Switch Template is created select the template and click Create/Edit switches in the top right from the details page of the template. Here you can add the desired amount of unmanaged switches needed.
22+
Once you've created the model, make specific assets for the wall jacks via **Resources > All Assets > Create**. When creating the asset, select the type **Patch Panel**, then select the wall jack model for the patch panel model and the **Back connection** type, which can be either **Patch Panel** or **Switch**, and can go to the patch panel or the unmanaged switch you are documenting.
1523

16-
Once you have assets created for the wall jacks and switches created from the template you can start creating the connections.
24+
You will then want to create an unmanaged switch:
1725

18-
Go to the desired wall jack asset you want to work with and open the edit details page of the asset.
26+
- Do this by going to **Tools > Templates & Bulk Operations > Switch Templates**, then create a template that reflects the switches that are part of this connectivity by selecting a switch type and adding a ports switch template with the desired ports prefix and a template that includes the type and number of ports.
1927

20-
There will be a section for Patch Panel Ports in this details page and a line for each port contained on the wall jack panel defined by previously created patch panel model. First will be to define the front connection either the Patch Panel or the Switch whichever desired. Define the connection type then enter the object id or search for and select the switch port or patch panel port of this connection, you can also enter a label for this that corresponds with the wall jack label in the room (if they are labeled). Then define the back connection this can also be Patch Panel Port or Switch Port, whichever you did not use for the front connection.
28+
- Once you've created the switch template, select the template and click the **Create/Edit** option under the **Ellipsis menu** in the top right corner of the template's details page. Here, you can add the desired amount of unmanaged switches needed.
2129

22-
![Wall Jack connection details](/assets/images/wall-jack-02.png)
30+
Once you've created assets for the wall jacks and created switches from the template, you can start creating the connections:
2331

24-
This should complete the connection path of patch panel > wall jack > switch, you can then locate the unmanaged switch by searching for it by the given name. Select switch port at the top right from the details page of the switch and you can select each switch port and edit add the connections of any relevant devices.
32+
- Go to the desired wall jack asset you want to work with and open the edit details page of the asset. There will be a section for patch panel ports on this details page, with a line for each port contained on the wall jack panel (defined by the previously created patch panel model).
33+
- First, define the front connection as either the patch panel or the switch, whichever is desired.
34+
- Define the **Connection Type**, then enter the **Object** ID or search for and select the switch port or the patch panel port for the connection.
35+
- You can also enter a **Label** for the connection that corresponds with the wall jack label in the room (if it is labeled). Then, define the **Back connection**, which can also be the patch panel port or the switch port (whichever you did not use for the front connection).
36+
37+
<ThemedImage
38+
alt="Wall Jack connection details"
39+
sources={{
40+
light: useBaseUrl('/assets/images/wall-jacks/wall-jack-02-light.png'),
41+
dark: useBaseUrl('/assets/images/wall-jacks/wall-jack-02-dark.png'),
42+
}}
43+
/>
44+
45+
This should complete the connection path from the patch panel to the wall jack to the switch. Next, you can locate the unmanaged switch by searching for it by its given name. Select the switch port in the top right corner of the switch's details page. You can select each switch port and edit or add the connections of any relevant devices.

0 commit comments

Comments
 (0)