starlingx/docs
Code Issues Proposed changes

Merge "Disk replacement customer suggestions (r9,dsR8MR2,MR3)"

Browse Source
This commit is contained in:
Zuul 2024-06-18 14:01:02 +00:00 committed by Gerrit Code Review
commit 684643bf49
3 changed files with 20 additions and 14 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

14
doc/source/node_management/kubernetes/host_hardware_management/configuration-changes-requiring-re-installation.rst
View File

@ -6,7 +6,7 @@
Configuration Changes Requiring Re-installation 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: .. _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. | | 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. | | 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. | | 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. | | Subcloud delete and re-add | System | The subcloud system must be reinstalled. |
+--------------------------------------------------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +--------------------------------------------------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+

7
doc/source/storage/kubernetes/replace-osds-and-journal-disks.rst
View File

@ -15,9 +15,10 @@ the same peer group. Do not substitute a smaller disk than the original.
.. note:: .. note::
Due to a limitation in **udev**, the device path of a disk connected through 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 a |SAS| controller changes when the disk is replaced. Therefore, the
general procedure below, you must lock, delete, and re-install the node. general procedure below works for controller and storage nodes.
However, for standard, |AIO-SX|, and |AIO-DX| systems, use the following
For standard, |AIO-SX|, and |AIO-DX| systems, use the following
alternative procedures to replace |OSDs| without reinstalling the host: alternative procedures to replace |OSDs| without reinstalling the host:
- :ref:`Replace OSDs on a Standard System - :ref:`Replace OSDs on a Standard System

13
doc/source/storage/kubernetes/replace-osds-on-an-aio-sx-single-disk-system-without-backup-951eefebd1f2.rst
View File

@ -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. 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. ceph.conf file from the /etc/pmon.d folder.
#. Stop ``ceph-mds``. #. Stop ``ceph-mds``.
@ -51,21 +51,26 @@ Replace OSDs on an AIO-SX Single Disk System without Backup
.. code-block:: none .. code-block:: none
~(keystone_admin)$ ceph tell mon.\* injectargs ~(keystone_admin)$ ceph tell mon.\* injectargs
'--mon-allow-pool-delete=true' '--mon-allow-pool-delete=true'
#. Remove all the pools. #. Remove all the pools.
.. code-block:: none .. 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 {} --yes-i-really-really-mean-it
#. Shutdown machine, replace disk, turn it on and wait for boot to finish. #. 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. controller.
#. Add the applications that were removed in step 3. #. Add the applications that were removed in step 3.
#. Verify that all pools and settings listed in step 1 are recreated. #. 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.