Adding items

Each kind of item is added in the view that owns it:

Item	Where	How
Rack	Any view (Rack Elevation shows it)	Add Rack or 0
Server, switch, PDU	Rack Elevation, Port Mapping, Power Budget	1, 3, 4, then click
NIC / port group / load bank	Port Mapping, or the side panel	5, then click a device
Port	Side panel	+ Port on a NIC
Network cable	Port Mapping	C, then click two ports
Power inlet	Power Budget, or the side panel	5, then click a device
Power cord	Power Budget	C, then click an outlet and an inlet
Bond	Side panel, on a port	Bond → + New bond
Label (tag)	Side panel, on a device or cable	Labels box
Template (model)	Materials, or the catalog bar's +	See Materials editor

Anything can also be added as text in the DSL editor.

Racks

Click Add Rack in the Rack Elevation toolbar, or press 0. The new rack is Rack N, 36U, in row 1; select it to change its label, height and row in the side panel.

Copy a whole rack

If a rack is selected when you add one, the new rack copies it: same height and row, the next label, and a copy of every device in it (with their NICs, ports and bonds, but not their cables). It is the fastest way to build ten identical racks.

Servers, switches and PDUs

1. Pick the tool: Server (1), Switch (3) or PDU (4).
2. Optionally pick a template in the catalog bar at the bottom. With no template, the device gets a default layout:
   • server: NIC eth0 with 2 × 25G SFP28 ports, and two power inlets;
   • switch: port group data with 32 × 100G QSFP28, mgmt with one RJ45, and two inlets;
   • PDU: banks bank1 and bank2, each 8 × C13 outlets behind a 20 A breaker.
3. Click where it goes:
   • Rack Elevation — move over a rack. The preview is green where the device fits and red (No space) where it doesn't. Click to place it. Clicks outside a rack do nothing.
   • Port Mapping / Power Budget — click anywhere on the canvas. The device is unracked until you give it a rack (see Editing items).
4. The tool stays on, so you can keep clicking. Press Esc or V when done.

Several servers at once. With the Server tool, press + / − to place N servers per click. In a rack they stack downward from where you click (the preview shows N × NU); on the canvas they stack vertically.

Clone mode. If a device of the same kind is selected when you click, the new device is a copy of it — same template, NICs, ports, bonds and labels, with the label's number counted up (node-07 → node-08). The cursor turns multicoloured to show it. Clear the selection (Esc) to place from the catalog instead.

NICs, port groups and load banks

• On the canvas (Port Mapping): press 5 and click a server. It gets a new NIC with two ports, or one built from the NIC template selected in the catalog bar. Clicking a PDU adds a load bank. The tool then returns to Select.
• In the side panel: select the device, open Edit device, and click + NIC (+ Port Group on a switch, + Bank on a PDU).

Devices placed from a template get their NICs from the template; change the template in Materials instead.

Ports

Select a NIC (click its label on the canvas), or open Edit device in the device's panel and expand the NIC's row. Click + Port (+ Outlet on a PDU bank). Set each port's speed and connector in its chip.

Network cables

1. Open Port Mapping and press C (Cable). Optionally pick a cable template in the catalog bar — the new cable will use it.
2. Click a free port; it turns yellow and a line follows the pointer.
3. Click the port at the other end. The cable is created.

Click on empty canvas or press Esc to cancel a cable halfway. A port that already has a cable, or that cannot take this one, shows a not-allowed cursor.

Several cables at once. Press + to draw N cables per click (shown as ×N next to the line). Click a start port and an end port: the app connects N consecutive free ports of each NIC, in order. It refuses if either side doesn't have N free ports in a row.

Breakout cables. To cable the lanes of a split switch port, first split it: select the port and set Breakout to 2× or 4×. The port is drawn as lanes. With the Cable tool, click a lane to use it, or the port to take its first free lane.

Power inlets and power cords

1. Open Power Budget. Network cables are hidden here by default; power cords are shown.
2. Press 5 (Power inlet) and click a device to give it an inlet (PSU1, PSU2…). Or add inlets in the side panel with + Inlet, or in the device's template.
3. Press C (Power cord). Click a PDU outlet, then a device inlet. Both ends must be power connectors, and one must be a PDU outlet.

The legend updates as you go: outlets in use per PDU, the load against the PDU's capacity, and how many inlets are still unfed.

Bonds

Select one of the member ports. In its panel, set Bond to + New bond. Name the bond and choose its mode (lacp, static or active-backup). Then select each other member port and choose the bond from its Bond list. Bonded ports have a purple outline.

A bond can only join ports of the same device, and breakout ports can't be members.

Labels

Select one or more devices (or cables). In the panel's Labels box, type a label and press Enter, or pick an existing one. See Filtering by label.