Documentation Index
Fetch the complete documentation index at: https://docs.xloud.tech/llms.txt
Use this file to discover all available pages before exploring further.
Overview
Live vCPU and RAM scaling adjusts an instance’s compute resources while it is running — no reboot required. This is distinct from the standard resize operation, which requires a reboot. Live scaling uses a combination of CPU hotplug, memory balloon, DIMM hotplug, and virtio-mem to adjust resources within the bounds defined by the instance’s flavor.Xloud-Developed — Bidirectional CPU hotplug (add AND remove vCPUs) and
combined memory scaling (balloon + DIMM + virtio-mem) are developed by Xloud and
ship with XAVS / XPCI.
Prerequisites
- An instance in
Activestatus with a hot-add-enabled flavor - The flavor must have
hw:cpu_minorhw:mem_minextra specs set - The instance must not be locked
Adjust Resources (Dashboard)
- Dashboard
- CLI
Open the Resource Adjustment dialog
Navigate to Compute > Instances. Click the More dropdown on the
instance row, then select Adjust Resources under the Configuration
Update group.
This action is only available for instances in
Active status whose
flavor has hot-add enabled (hw:cpu_min or hw:mem_min extra specs).
If the flavor does not support hot-add, this action does not appear.Adjust vCPU and memory
The dialog shows:
The vCPU slider step aligns to the CPU thread count configured in the flavor.
The memory slider uses 0.25 GiB increments.The dialog fetches the live instance status to determine current and
allowed resource ranges. Color-coded hints indicate the scaling method:
| Field | Description |
|---|---|
| Instance | Instance name (read-only) |
| Current Info | Current vCPU count and memory allocation (read-only) |
| vCPUs | Slider input — adjust between minimum and maximum vCPUs |
| Memory (GiB) | Slider input — adjust between minimum and maximum memory (0.25 GiB steps) |
| Make permanent | Checkbox — persist the configuration after a soft reboot (default: checked) |
| Color | Meaning |
|---|---|
| Green | virtio-mem — fully adjustable in both directions |
| Yellow | No balloon driver detected — limited scaling |
| Blue | DIMM hotplug information |
Configure Hot-Add Flavors
To enable live scaling, create flavors with hot-add parameters:- Dashboard
- CLI
When creating a flavor (see Flavor Management),
enable the Hot-Add toggle in the Step 1 (Params Setting) section.
Configure:
The instance boots with the minimum resources and can be scaled up to the
flavor’s maximum without rebooting.
| Field | Description |
|---|---|
| Enable Hot-Add | Set to Yes |
| Minimum CPU | Starting vCPU count at boot (can scale up to flavor’s max vCPUs) |
| Minimum Memory (GiB) | Starting memory at boot (can scale up to flavor’s max memory) |
Next Steps
Resize an Instance
Change flavors entirely (requires reboot) for capacity beyond hot-add range
Flavors
Create and manage flavors with hot-add configuration
Launch an Instance
Launch instances with hot-add enabled flavors
Troubleshooting
Resolve live scaling failures and balloon driver issues