starlingx/docs
Code Issues Proposed changes

Disk replacement customer suggestions (r9,dsR8MR2,MR3)

Browse Source 
Add text updates to improve customer understanding in disk replacement procedure.

Change-Id: I3b67a9b9ace65286b4ad34044c60ef7e8a1393c3
Signed-off-by: Elisamara Aoki Goncalves <elisamaraaoki.goncalves@windriver.com>
This commit is contained in:
Elisamara Aoki Goncalves 2024-06-13 17:53:41 +00:00
parent 855aaeda8f
commit a4612b34b1
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
===============================================
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. |
+--------------------------------------------------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+

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::
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

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.
#. 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.