diff --git a/doc/source/node_management/kubernetes/host_hardware_management/configuration-changes-requiring-re-installation.rst b/doc/source/node_management/kubernetes/host_hardware_management/configuration-changes-requiring-re-installation.rst index af89685f0..967944b10 100644 --- a/doc/source/node_management/kubernetes/host_hardware_management/configuration-changes-requiring-re-installation.rst +++ b/doc/source/node_management/kubernetes/host_hardware_management/configuration-changes-requiring-re-installation.rst @@ -6,7 +6,7 @@ Configuration Changes Requiring Re-installation =============================================== -Some configuration changes require a system or host re-installation. +Some configuration changes require a system or host re-add. .. _configuration-changes-requiring-re-installation-table-d2t-yjs-kfb: @@ -18,15 +18,15 @@ Some configuration changes require a system or host re-installation. +==============================================================+=================+====================================================================================================================================================================================================================================================================================================================================+ | Product type change | System | To change between Standard and All-in-one, you must perform a system reinstallation. | +--------------------------------------------------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | PXE boot network addition or removal | System | | + | PXE boot network addition or removal | System | You must perform a system reinstallation. | +--------------------------------------------------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Management network subnet or range changes | System | | + | Management network subnet or range changes | System | You must perform a system reinstallation. | +--------------------------------------------------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Cluster-host subnet or range changes | System | | + | Cluster-host subnet or range changes | System | You must perform a system reinstallation. | +--------------------------------------------------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Legacy BIOS to UEFI change | System | | + | Legacy BIOS to UEFI change | System | You must perform a system reinstallation. | +--------------------------------------------------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Security profile change | System | | + | Security profile change | System | You must perform a system reinstallation. | +--------------------------------------------------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | Controller filesystem size decrease | System | To decrease the controller filesystem size, you must perform a system reinstallation. | +--------------------------------------------------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ @@ -37,7 +37,7 @@ Some configuration changes require a system or host re-installation. +--------------------------------------------------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | Replacement of storage disk on SAS controller | Host (re-add) | 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, it is advisable to replace any storage profiles associated with the host, since the old storage profile is no longer accurate. | +--------------------------------------------------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Aborted upgrade after controller-1 and controller-0 upgraded | System | | + | Aborted upgrade after controller-1 and controller-0 upgraded | System | You must perform a system reinstallation. | +--------------------------------------------------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | Subcloud delete and re-add | System | The subcloud system must be reinstalled. | +--------------------------------------------------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ diff --git a/doc/source/storage/kubernetes/replace-osds-and-journal-disks.rst b/doc/source/storage/kubernetes/replace-osds-and-journal-disks.rst index 7e5ee57eb..2c08067c1 100644 --- a/doc/source/storage/kubernetes/replace-osds-and-journal-disks.rst +++ b/doc/source/storage/kubernetes/replace-osds-and-journal-disks.rst @@ -15,9 +15,10 @@ the same peer group. Do not substitute a smaller disk than the original. .. note:: Due to a limitation in **udev**, the device path of a disk connected through - a SAS controller changes when the disk is replaced. Therefore, in the - general procedure below, you must lock, delete, and re-install the node. - However, for standard, |AIO-SX|, and |AIO-DX| systems, use the following + a |SAS| controller changes when the disk is replaced. Therefore, the + general procedure below works for controller and storage nodes. + + For standard, |AIO-SX|, and |AIO-DX| systems, use the following alternative procedures to replace |OSDs| without reinstalling the host: - :ref:`Replace OSDs on a Standard System diff --git a/doc/source/storage/kubernetes/replace-osds-on-an-aio-sx-single-disk-system-without-backup-951eefebd1f2.rst b/doc/source/storage/kubernetes/replace-osds-on-an-aio-sx-single-disk-system-without-backup-951eefebd1f2.rst index 1c9bf0528..b56cbdb3c 100644 --- a/doc/source/storage/kubernetes/replace-osds-on-an-aio-sx-single-disk-system-without-backup-951eefebd1f2.rst +++ b/doc/source/storage/kubernetes/replace-osds-on-an-aio-sx-single-disk-system-without-backup-951eefebd1f2.rst @@ -31,7 +31,7 @@ Replace OSDs on an AIO-SX Single Disk System without Backup Keep the names of the removed applications as they will be used in step 11. -#. Make a backup of /etc/pmon.d/ceph.conf to a safe location and remove the +#. Make a backup of /etc/pmon.d/ceph.conf to a safe location and remove the ceph.conf file from the /etc/pmon.d folder. #. Stop ``ceph-mds``. @@ -51,21 +51,26 @@ Replace OSDs on an AIO-SX Single Disk System without Backup .. code-block:: none - ~(keystone_admin)$ ceph tell mon.\* injectargs + ~(keystone_admin)$ ceph tell mon.\* injectargs '--mon-allow-pool-delete=true' #. Remove all the pools. .. code-block:: none - ~(keystone_admin)$ ceph osd pool ls | xargs -i ceph osd pool delete {} + ~(keystone_admin)$ ceph osd pool ls | xargs -i ceph osd pool delete {} {} --yes-i-really-really-mean-it #. Shutdown machine, replace disk, turn it on and wait for boot to finish. -#. Move the backed up ceph.conf from step 4 to /etc/pmon.d and unlock the +#. Move the backed up ceph.conf from step 4 to /etc/pmon.d and unlock the controller. #. Add the applications that were removed in step 3. #. Verify that all pools and settings listed in step 1 are recreated. + +.. warning:: + + This procedure does not include a backup, so it might cause the loss of + |OSD| data. \ No newline at end of file