> For the complete documentation index, see [llms.txt](https://asus-isg-aidc.gitbook.io/guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://asus-isg-aidc.gitbook.io/guide/latest/portal/infrastructureplannerintroduction/rackmanagement.md). # Rack Management | Developer | Last modified | | --------- | ------------- | | AIDC Team | 2026/05/08 | ## Introduction The Rack Management module provides a visual asset management interface organized as a tree hierarchy: Rack → Device → SubNode. Users can inspect U-slot allocations, drag and drop devices to add or rearrange them, and configure full network settings (Hostname / NIC / IP / VLAN) for each sub-node. *** ## Interface Overview ![Full Rack Management interface with left rack list, central U-slot visualization, and right Device Library panel](https://pub-f334ff01208c4e6195b80133ac6e6030.r2.dev/portal/infrastructurePlanner/rackManagement/rackManagement-1.png) The interface consists of three main areas: | Area | Description | | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | | **Left Panel** | Rack list with a search bar; expandable to show devices under each rack; includes a collapsible 3D Data Center Floor Plan mini-map at the bottom | | **Central Area** | U-slot visualization of the selected rack; displays HEIGHT / DEVICES / TOTAL NODES stats at the top | | **Right Panel** | Device Library — search for device models and drag them into the U-slot rack view | *** ## Left Panel: Rack List ### Tree Structure ![Left panel showing a rack expanded to reveal its devices, each labeled with U-slot range and node count](https://pub-f334ff01208c4e6195b80133ac6e6030.r2.dev/portal/infrastructurePlanner/rackManagement/rackManagement-8.png) The left panel displays racks and their devices in a collapsible tree: ``` Rack └── Device (ordered by U-slot, top to bottom) └── SubNode (with Hostname) ``` | Level | Displayed Information | | ----------- | ------------------------------------------- | | **Rack** | Rack name, status icon, Edit button | | **Device** | Device name, U-slot range label, node count | | **SubNode** | Hostname, edit icon | * Click the **expand arrow** to the left of a rack row to show its devices. * Click the **expand arrow** to the left of a device row to show its sub-nodes. * Click again to collapse. ### 3D Data Center Floor Plan Mini-map ![Bottom of the left panel showing the collapsible 3D Data Center Floor Plan mini-map; the selected rack is highlighted on the floor plan](https://pub-f334ff01208c4e6195b80133ac6e6030.r2.dev/portal/infrastructurePlanner/rackManagement/rackManagement-2.png) The collapsible **3D Data Center Floor Plan** mini-map at the bottom of the left panel shows a top-down view of the current layout. When a rack is selected in the list, the corresponding rack icon is highlighted on the mini-map, making it easy to confirm its physical position on the floor. *** ## Rack Stats ![Stats bar at the top of the central panel showing HEIGHT, DEVICES, and TOTAL NODES values highlighted](https://pub-f334ff01208c4e6195b80133ac6e6030.r2.dev/portal/infrastructurePlanner/rackManagement/rackManagement-5.png) After selecting a rack, three summary values are displayed above the central U-slot view: | Stat | Description | | --------------- | --------------------------------------- | | **HEIGHT** | Total rack height in U (e.g., 42U) | | **DEVICES** | Number of devices installed in the rack | | **TOTAL NODES** | Total sub-node count across all devices | *** ## Flexible Layout ![Rack Management interface with resizable dividers between panels and the 3D floor plan mini-map highlighted, annotated "Flexible layout"](https://pub-f334ff01208c4e6195b80133ac6e6030.r2.dev/portal/infrastructurePlanner/rackManagement/rackManagement-6.png) The dividers between the three panels can be dragged to adjust their width. The 3D Data Center Floor Plan mini-map area can also be resized vertically, allowing users to configure the workspace to suit their workflow. *** ## Main Operations ### Search Racks Type a keyword in the search bar at the top of the left panel to filter the rack list in real time. ![Search bar at the top of the left panel used to filter racks by name](https://pub-f334ff01208c4e6195b80133ac6e6030.r2.dev/portal/infrastructurePlanner/rackManagement/rackManagement-9.png) *** ### Edit a Rack Click the **Edit** button on a rack row to open the Add Rack dialog: ![Edit button clicked on a rack row, opening the Add Rack dialog with Rack Name and Remark fields](https://pub-f334ff01208c4e6195b80133ac6e6030.r2.dev/portal/infrastructurePlanner/rackManagement/rackManagement-7.png) | Field | Description | Required | | ------------- | ------------------------------------------------------------------------------------ | :------: | | **Template** | The rack template applied to this rack (read-only; cannot be changed after creation) | — | | **Rack Name** | Rack identifier | ✓ | | **Remark** | Optional notes for this rack | | Click **Save** to confirm. The rack is created immediately and synchronized to both the 3D Data Center scene and the tree view. *** ### Drag a Device into a U Slot (from the Device Library) ![Device card dragged from the right Device Library panel into an empty U slot in the central rack view](https://pub-f334ff01208c4e6195b80133ac6e6030.r2.dev/portal/infrastructurePlanner/rackManagement/rackManagement-4.png) 1. In the right **Device Library** panel, find the target device model (searchable by name or filterable by manufacturer). 2. Check the device card for its U height and manufacturer. 3. Drag the card into the target U slot in the central rack view. 4. The system validates whether the target U slot has enough space. 5. Once placed, the device appears in both the U-slot view and the left tree. {% hint style="info" %} **💡 Tip** Device models listed in the Device Library come from the **Device Library** module. If the required model is not listed, add it there first. {% endhint %} *** ### Reposition a Device in the U-Slot View ![Device being dragged to a new U-slot position with a red-bordered drop target and "Drag to reposition" annotation](https://pub-f334ff01208c4e6195b80133ac6e6030.r2.dev/portal/infrastructurePlanner/rackManagement/rackManagement-3.png) 1. In the central U-slot view, drag a device block up or down to an empty U slot. 2. The system validates whether the target position has sufficient space. 3. Once placed, the U-slot assignment is synced to the backend immediately. *** ### Configure Sub-Node Network Settings (feature incomplete) 1. Expand a device in the left tree to show its sub-nodes. 2. Click the **edit icon** on a sub-node row to open the node details dialog. 3. Fill in the following fields: **Hostname** | Field | Description | | ------------ | -------------------------------------------- | | **Hostname** | Node hostname (e.g., node-01, gpu-server-01) | **NIC** | Field | Description | | ------------------ | ----------------------------------------------------------- | | **Interface Name** | Network interface identifier (e.g., eth0, eth1) | | **MAC Address** | Physical address of the network card | | **Speed** | Interface speed (e.g., 25GbE, 100GbE) | | **Form Factor** | Transceiver module type (SFP+, SFP28, QSFP28, QSFP56, etc.) | **Bond / VLAN** | Field | Description | | ------------- | ---------------------------------------------------------------------- | | **Bond Name** | Bonded interface name (e.g., bond0) for link redundancy or aggregation | | **VLAN ID** | Virtual LAN identifier | **IP Configuration** | Field | Description | Example | | ------------- | ------------------------------- | --------------- | | **IP (CIDR)** | Node IP address and subnet mask | 192.168.1.10/24 | | **Gateway** | Default gateway | 192.168.1.1 | | **DNS** | DNS server address | 8.8.8.8 | 4. Click **Confirm** to save. Data is written back to the backend immediately. ***