docs/doc/source/storage/kubernetes/disk-naming-conventions.rst
Ron Stone f125a8b892 Remove spurious escapes (r8,dsR8)
This change addresses a long-standing issue in rST documentation imported from XML.
That import process added backslash escapes in front of various characters. The three
most common being '(', ')', and '_'.
These instances are removed.

Signed-off-by: Ron Stone <ronald.stone@windriver.com>
Change-Id: Id43a9337ffcd505ccbdf072d7b29afdb5d2c997e
2023-03-01 11:19:04 +00:00

2.0 KiB

Disk Naming Conventions

uses persistent disk names to simplify hardware management.

In addition to the device node identification commonly used in Linux systems (for example, /dev/sda), identifies hardware storage devices by physical location (device path). This ensures that the system can always identify a given disk based on its location, even if its device node enumeration changes because of a hardware reconfiguration. This helps to avoid the need for a system re-installation after a change to the disk complement on a host.

In the Horizon Web interface and in output, both identifications are shown. For example, the output of the system host-disk-show command includes both the device_node and the device_path.

~(keystone_admin)]$ system host-disk-show controller-0
1722b081-8421-4475-a6e8-a26808cae031

+-------------+--------------------------------------------+
| Property    | Value                                      |
+-------------+--------------------------------------------+
| device_node | /dev/sda                                   |
| device_num  | 2048                                       |
| device_type | HDD                                        |
| device_path | /dev/disk/by-path/pci-0000:00:0d.0-ata-2.0 |
| size_gib    | 120                                        |
| rpm         | Undetermined                               |
| serial_id   | VB77269fb1-ae169607                        |
| uuid        | 1722b081-8421-4475-a6e8-a26808cae031       |
| ihost_uuid  | 78c46728-4108-4b35-8081-bed1bd4cba35       |
| istor_uuid  | None                                       |
| ipv_uuid    | 2a7e7aad-6da5-4a2d-957c-058d37eace1c       |
| created_at  | 2017-05-05T07:56:02.969888+00:00           |
| updated_at  | 2017-05-08T12:27:04.437818+00:00           |
+-------------+--------------------------------------------+