starlingx/docs
Code Issues Proposed changes
docs/doc/source/node_management/kubernetes/node_interfaces/nic-replacement-with-the-same-vendor-and-device-id-32942b7b05e5.rst
Ron Stone d964b0e628 nic-replacement-without-host-reinstall editorial updates 
Some minor corrections to files related to this feature.
Patchset 1 review updates

Signed-off-by: Ron Stone <ronald.stone@windriver.com>
Change-Id: I5a41b1a6653e7c72547b95ead75ce50f1c672dfc
Signed-off-by: Ron Stone <ronald.stone@windriver.com>
2021-11-01 12:19:11 -04:00

1.7 KiB
Raw Blame History

Replace a NIC with the same vendor and device-id

The following procedure allows the replacement of a NIC on a host, without requiring a host or system (in case of ) re-install and re-configuration, in the case of the replaced NIC having the same vendor or device ID information.

The normal approach to doing such a change would be to do a system host-delete, a system host-add (re-install) and a re-configure of the host. In the case of an deployment, with only one host, this would result in a full system re-install and full system re-configuration.

Since this procedure reuses same vendor and device ID information and capabilities, the interface's new will be updated internally and no reconfiguration is required. Assuming that the replacement will occur on the same slot of the previous card, the procedure can be executed for all types of NIC classes (pci-sriov, data, pci-passthrough, and platform).

  1. Lock the host.

    ~(keystone_admin)]$ system host-lock <hostname>
    1. Wait for the host to be reported as locked.

  2. Power down the host manually and make the NIC card replacement.

  3. Power up the host.

  4. Unlock the host.

    ~(keystone_admin)]$ system host-unlock <hostname>

The host is rebooted, and its Availability State is reported as In-Test. After a few minutes, it is reported as Unlocked, Enabled, and Available.