> 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/devicelibrary.md).

# Device Library

| Developer | Last modified |
| --------- | ------------- |
| AIDC Team | 2026/05/08    |

## Introduction

The Device Library is the hardware model database for Infrastructure Planner. It centrally manages the complete physical and network specifications of every device type in the data center. An accurate and complete Device Library is the foundation for capacity calculations (power / weight), rack template design, and sub-node configuration.

***

## Interface Overview

![Device Library main page with device list, Asset Category filter tabs, search bar, and Device Details panel](https://pub-f334ff01208c4e6195b80133ac6e6030.r2.dev/portal/infrastructurePlanner/deviceLibrary/deviceLibrary-1.png)

The interface is divided into two main areas:

| Area                            | Description                                                                                                                               |
| ------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| **Left List**                   | Search bar, Asset Category filter tabs (ALL / SERVER / SWITCH / STORAGE / PDU / ROUTER / FIREWALL), and device model list                 |
| **Right: Device Details panel** | Displays CORE SPECS after a device is selected; shows "Select a device from the list to view its specifications" when nothing is selected |

Three action buttons are available in the top-right corner: **Import JSON**, **Export JSON**, and **+ Add Device Model**.

***

## Main Operations

### Filter and Search Devices

![Search bar with keyword input and SERVER type tab selected, showing filtered results](https://pub-f334ff01208c4e6195b80133ac6e6030.r2.dev/portal/infrastructurePlanner/deviceLibrary/deviceLibrary-7.png)

1. Click an **Asset Category** tab (ALL / SERVER / SWITCH, etc.) to filter by device type.
2. Type a device name, type, or manufacturer keyword in the search bar.
3. The list updates in real time to show matching device models.

***

### View Device Specifications

![Device selected from the list; Device Details panel on the right shows CORE SPECS including Form Factor, Asset Class, Compute Nodes, Peak Power, and Weight](https://pub-f334ff01208c4e6195b80133ac6e6030.r2.dev/portal/infrastructurePlanner/deviceLibrary/deviceLibrary-2.png)

1. Click a device model in the list.
2. The right **Device Details** panel displays:
   * Device name, manufacturer, and **ACTIVE ASSET** status badge
   * U-slot color block preview (shows the U slots and color used by the device)
   * **CORE SPECS** section: Form Factor, Asset Class, Compute Nodes, Peak Power, Weight

{% hint style="info" %}
**💡 Tip**

The edit (pencil) and delete (trash) icons are located in the top-right corner of the Device Details panel.
{% endhint %}

***

### Add a Device Model

![Add Device Model dialog opened from the top-right button, showing all input fields](https://pub-f334ff01208c4e6195b80133ac6e6030.r2.dev/portal/infrastructurePlanner/deviceLibrary/deviceLibrary-4.png)

1. Click **+ Add Device Model** in the top-right corner to open the Add Device Model dialog.

| Field                     | Description                                                | Required |
| ------------------------- | ---------------------------------------------------------- | :------: |
| **Model Name**            | Device model name (e.g., ESC8000A-E13X)                    |     ✓    |
| **Manufacturer**          | Manufacturer name (e.g., ASUS)                             |     ✓    |
| **Asset Category**        | Device type — selected via icon buttons                    |     ✓    |
| **Color**                 | Color for U-slot visualization — selected via color picker |     ✓    |
| **Height (U)**            | U height (e.g., 4 for 4U)                                  |     ✓    |
| **Nodes**                 | Node capacity (e.g., 3 means 3 independent compute units)  |     ✓    |
| **Power (W)**             | Peak power draw                                            |          |
| **PXE**                   | Number of PXE boot ports                                   |          |
| **BMC**                   | Number of BMC management ports                             |          |
| **ETH**                   | Number of Ethernet ports                                   |          |
| **IB**                    | Number of InfiniBand ports                                 |          |
| **Operating Weight (kg)** | Device weight                                              |          |
| **Admin Remark**          | Optional notes                                             |          |

2. Click **Initialize Component** to save. The device model is added to the library and is immediately available for use in rack templates.

***

### Edit a Device Model

![Pencil icon in the Device Details panel opened to the Edit Device Model dialog pre-filled with existing specs](https://pub-f334ff01208c4e6195b80133ac6e6030.r2.dev/portal/infrastructurePlanner/deviceLibrary/deviceLibrary-5.png)

1. Click the **pencil icon** in the top-right corner of the Device Details panel to open the Edit Device Model dialog.
2. Update the desired fields.
3. Click **Update** to save.

{% hint style="warning" %}
**⚠️ Note**

Updating specs such as Height, Power, or Operating Weight will trigger automatic recalculation of capacity statistics for all rack templates and layouts that reference this model.
{% endhint %}

***

### Delete a Device Model

![Trash icon in the Device Details panel; Delete Device confirmation dialog showing "This action cannot be undone"](https://pub-f334ff01208c4e6195b80133ac6e6030.r2.dev/portal/infrastructurePlanner/deviceLibrary/deviceLibrary-6.png)

1. Click the **trash icon** in the top-right corner of the Device Details panel.
2. Read the confirmation prompt ("This action cannot be undone.") and click **Delete** to confirm.

{% hint style="warning" %}
**⚠️ Warning**

If a device model is referenced by a rack template or a deployed rack, deleting it may cause device information in those configurations to display incorrectly. Confirm there are no references before proceeding.
{% endhint %}

***

### Bulk Import / Export (JSON)

![Import JSON and Export JSON buttons highlighted in the top-right of the Device Library page](https://pub-f334ff01208c4e6195b80133ac6e6030.r2.dev/portal/infrastructurePlanner/deviceLibrary/deviceLibrary-3.png)

**Import**: To add a large number of device models at once, use the JSON bulk import feature:

1. Click **Import JSON** in the top-right corner.
2. Select the prepared JSON file.
3. The system creates the device models in bulk and shows a success / failure count when done.

**Export**: Click **Export JSON** in the top-right corner. The browser automatically downloads a JSON file containing all device models, which can be used for backups or cross-environment synchronization.

**JSON format example:**

```json
[
  {
    "name": "ESC8000A-E13X",
    "manufacturer": "ASUS",
    "type": "Server",
    "uSize": 4,
    "nodeCapacity": 3,
    "power": 3200,
    "weight": 42,
    "pxe": 1,
    "bmc": 1,
    "eth": 4,
    "ib": 2,
    "color": "#00A2E0",
    "remark": "High-density GPU server"
  }
]
```

| JSON Field     | UI Field                                                             | Required |
| -------------- | -------------------------------------------------------------------- | :------: |
| `name`         | Model Name                                                           |     ✓    |
| `manufacturer` | Manufacturer                                                         |     ✓    |
| `type`         | Asset Category (Server / Switch / Storage / PDU / Router / Firewall) |     ✓    |
| `uSize`        | Height (U)                                                           |     ✓    |
| `nodeCapacity` | Nodes                                                                |     ✓    |
| `power`        | Power (W)                                                            |          |
| `weight`       | Operating Weight (kg)                                                |          |
| `pxe`          | PXE port count                                                       |          |
| `bmc`          | BMC port count                                                       |          |
| `eth`          | Ethernet port count                                                  |          |
| `ib`           | InfiniBand port count                                                |          |
| `color`        | Color (hex, e.g., #00A2E0)                                           |          |
| `remark`       | Admin Remark                                                         |          |

***

## Usage Tips

| Scenario                   | Recommendation                                                                                                             |
| -------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| **Initial setup**          | Export your existing hardware spec sheet as JSON and bulk import it to populate the library quickly                        |
| **New hardware**           | After procuring a new device model, add it to the library immediately so future plans reference accurate specs             |
| **Spec changes**           | If a vendor updates device specs (e.g., power or weight), edit the library promptly to keep capacity calculations accurate |
| **Multi-environment sync** | Export the Device Library JSON and import it in other environments to keep device data consistent across sites             |