Change Hardware Components for a Storage HostΒΆ

You can add or replace storage disks or swap a storage node while the system is running, even if the storage resources are in active use.

You can add disks to a storage node to increase capacity, and you can replace a faulty host.


The storage nodes in a StarlingX system are grouped to provide redundancy for High Availability. StarlingX recommends a balanced storage capacity in which each host has sufficient independent resources to meet the operational requirements of the system.

Depending on the type of operation, you may need to delete the host from the Host Inventory. For more information, see Configuration Changes Requiring Re-installation. If you are performing an operation that requires the host to be deleted and re-added, record the current OSD and journal disk assignments so that you can reproduce them later.


Due to a limitation in udev, the device path of a disk connected through a SAS controller changes when the disk is replaced. You must lock, delete, and re-install the node. Once this is done, avoid using storage profiles containing information about the replaced disk as it is no longer accurate.


  1. Lock the host to make changes.

    1. In the left-hand pane, select Admin > Platform > Host Inventory.

    2. Select the Hosts tab.

    3. Open the drop-down list for the host, and then select Lock Host.

    4. Wait for the host to be reported as Locked.

  2. Power down the host and make any required hardware changes.

    StarlingX does not provide controls for powering down a host. Use the BMC or other control unit.

    This can involve replacing or adding disks, or replacing the host completely.

  3. For an operation that affects the Host Inventory record, delete the host from the inventory.

    The Host Inventory contains database information associated with an existing host, such as the MAC address of the management interface NIC, or the presence of StarlingX software on the primary disk. To update this information, you must delete the host and then re-add it to the system.


    Ensure that the host is Online, so that its disk is erased when it is deleted from the inventory. This ensures that the host boots from the network when it is powered up again. If the host is not online when it is deleted from the inventory, then you may need to force a network boot when it is powered up.

  4. Reinstall the host.

  5. Power up the host.

    If the host has been deleted from the Host Inventory, the host software is reinstalled.

    Wait for the host to be reported as Locked, Disabled, and Online.

  6. If required, allocate the OSD and journal disk storage.

    If you have deleted and re-added the host, you must re-create the storage disk allocations.

  7. Unlock the host to make it available for use.

    Open the drop-down list for the host, and then select Unlock Host.

    The host is rebooted, and the progress of the unlock operation is reported in the Status field.

    When the unlock is complete, the host is shown as Unlocked, Enabled, and Available.