Devices
The Devices section under Inventory provides a centralized view to manage all physical infrastructure resources, such as GPU servers and bare metal nodes. This inventory enables efficient tracking, allocation, and planning of hardware resources across the system.
Each device entry represents a real physical node in the cloud partner’s infrastructure. These entries serve as the source of truth for provisioning compute resources to customers through isolated virtual machines and assigned GPUs.
Keeping device entries updated ensures full visibility and control over infrastructure assets, helping administrators prepare resources for provisioning and usage across environments.
Why use Devices?¶
- Maintain a complete inventory of physical compute resources
- Track details such as serial numbers, resource configurations, and tags
- Allocate and deallocate resources as needed
- Plan capacity and monitor utilization
- Gain insight into GPU and VM usage per device
- Serve as the backing source for compute provisioning workflows
Devices List View¶
From the Devices page, users can:
- View all devices in a tabular layout
- Expand each device to view:
- VM Details
- BMC Details
- GPU Details
- Interfaces
- View key attributes including:
- Name
- Device Type
- Tags
- Allocation Status
- GPU Count (Allocated and Unallocated)
- VM Count
- Add new devices or upload in bulk via CSV
- Edit or delete existing devices
Tip: Use filters to narrow down devices based on status, allocation status, or types.
Adding or Editing a Device¶
Click Add Device or the edit icon next to an existing device to modify its information. Device information is categorized under multiple tabs for easier input and management.
Properties¶
Basic Information¶
| Field | Description | Example |
|---|---|---|
| Name | Unique device name | gpu-server-1 |
| Organization Name | Name of the associated organization | ABC Corp |
| Model | Hardware model of the device | PowerEdge R750 |
| Manufacturer | Device manufacturer (e.g., NVIDIA) | Dell |
| Serial Number | Unique hardware serial number | SN1234567890 |
| Device Type | Type of physical device (e.g., SERVER) | SERVER |
| Allocation Status | AVAILABLE or ALLOCATED | AVAILABLE |
Authentication¶
| Field | Description | Example |
|---|---|---|
| Username | Login username | admin |
| Password | Login password | ******** |
Power Management¶
| Field | Description | Example |
|---|---|---|
| BMC IP | BMC management IP | 192.168.1.10 |
| BMC Username | BMC login username | root |
| BMC Password | BMC login password | ******** |
Resource Configuration¶
| Field | Description | Example |
|---|---|---|
| Total CPU | Total number of CPU cores | 64 |
| Total Memory (MB) | RAM available in megabytes | 262144 |
| Total Storage (GB) | Local disk capacity in GB | 2048 |
Tags¶
The Tags tab allows users to apply metadata to a device to help categorize and filter devices effectively.
There are two types of tags:
- System Tags: These are managed internally by the platform and cannot be edited by the user.
Example: priority: qe
- Tags: These are user-defined key-value pairs. Users must provide both the key and value to add a tag.
Click Add Tags to enter the following:
| Field | Description | Example |
|---|---|---|
| Key | The tag name or identifier | env |
| Value | The value associated with the key | prod |
Note: Both the key and value fields are mandatory. An error is shown if either field is left blank.
Interfaces¶
The Interfaces tab lists network interface details. Click Add Interface, fill in the required fields, and then click Add to save the entry.
| Field | Description | Example |
|---|---|---|
| Interface Name | Name of the network interface | eth0 |
| MAC Address | MAC address of the interface | 00:1A:2B:3C:4D:5E |
| IP Address | Assigned IP address | 10.0.0.5 |
| Label | Custom label (optional) | Primary NIC |
| Connecting Switch | Name of the connected switch | core-switch-01 |
| Switch Port | Port used on the switch | Gig1/0/24 |
GPU(s)¶
The GPU(s) tab allows you to add or view GPU assignments for the device. One or more GPUs can be attached to a single device.
Click Add GPU to input:
| Field | Description | Example |
|---|---|---|
| Model No | GPU model number | A100 |
| PCIe ID | PCIe identifier of the GPU | 0000:36:00.0 |
| Vendor Code | Identifier for the GPU vendor | 10de |
| UUID | Unique identifier for the GPU | GPU-f3f716ed |
| Type | Assignment type: - PASSTHROUGH (full GPU to one VM), - MIG (split GPU into instances), - VGPU (shared GPU across VMs) |
PASSTHROUGH |
| VM Reference | ID of the VM if the GPU is currently attached to a virtual machine | 0xa8789 |
At the top of the GPU tab, users can track the allocated and unallocated GPU count in real time.
VM(s)¶
The VM(s) tab displays the virtual machines associated with the selected device. One or more VMs can be associated with a single device.
❗ Important: VM creation is only supported via API. The UI allows viewing details of VMs already associated with the device.
Below is an example of a VM already linked to a device:
| Field | Description | Example |
|---|---|---|
| VM Name | Name of the virtual machine | paas-hello-vm |
| IP Address | IP assigned to the VM | 192.168.1.110 |
| Instance ID | VM instance ID | i-abcxyz |
| CPU Cores | CPU cores allocated | 4 |
| Memory (MB) | RAM allocated to the VM | 8192 |
| Storage (GB) | Storage allocated | 50 |
| Workspace ID | Associated workspace | 4qkolkn |
| Organization ID | Owning organization | 4qkolkn |
| Project ID | Project under which the VM runs | 4qkolkn |
| Partner ID | Partner reference | rx280ml |
Allocated and unallocated VM counts for the device are shown at the top of the tab.
Once all the configuration tabs are completed, click Update Device to save the changes.
Bulk Upload Using CSV¶
To onboard multiple devices efficiently, use the Download Template and Upload CSV options available on the Devices page.
Procedure¶
- Click Download Template to get a pre-formatted CSV file with all the required columns.
- Open the CSV file and enter device details such as:
- Name
- Model
- IP Address
- MAC Address
- Device Type
- Resource configuration, etc.
- Save the file with a
.csvextension. - Return to the Devices page and click Upload CSV.
- Select the updated file and confirm the upload.
This flow streamlines bulk onboarding of devices and is especially helpful during environment scale-outs, hardware migrations, or initial setup.
Best Practices¶
- Keep device records up-to-date
- Use tags and system tags consistently
- Regularly audit inventory for unused or outdated devices
- Remove decommissioned devices from the inventory