Skip to content

Commit

Permalink
GA for ShiftStack rootVolume etcd on local disk
Browse files Browse the repository at this point in the history
OSDOCS-9716
  • Loading branch information
maxwelldb authored and openshift-cherrypick-robot committed Sep 20, 2024
1 parent acd5f4f commit 42da15a
Show file tree
Hide file tree
Showing 2 changed files with 8 additions and 12 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -6,9 +6,6 @@ include::_attributes/common-attributes.adoc[]

toc::[]

:FeatureName: Deploying on {rh-openstack-first} with rootVolume and etcd on local disk
include::snippets/technology-preview.adoc[]

As a day 2 operation, you can resolve and prevent performance issues of your {rh-openstack-first} installation by moving etcd from a root volume (provided by OpenStack Cinder) to a dedicated ephemeral local disk.

include::modules/installation-osp-local-disk-deployment.adoc[leveloffset=+1]
Expand Down
17 changes: 8 additions & 9 deletions modules/installation-osp-local-disk-deployment.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -8,10 +8,6 @@

If you have an existing {rh-openstack} cloud, you can move etcd from that cloud to a dedicated ephemeral local disk.

[WARNING]
====
This procedure is for testing etcd on a local disk only and should not be used on production clusters. In certain cases, complete loss of the control plane can occur. For more information, see "Overview of backup and restore operation" under "Backup and restore".
====

.Prerequisites

Expand Down Expand Up @@ -71,11 +67,6 @@ $ oc wait clusteroperators --all --for=condition=Progressing=false <1>

. Create a file named `98-var-lib-etcd.yaml` by using the following YAML file:
+
[WARNING]
====
This procedure is for testing etcd on a local disk and should not be used on a production cluster. In certain cases, complete loss of the control plane can occur. For more information, see "Overview of backup and restore operation" under "Backup and restore".
====
+
[%collapsible]
====
[source,yaml]
Expand Down Expand Up @@ -152,6 +143,7 @@ spec:
After=migrate-to-local-etcd.service
Before=crio.service
Requisite=var-lib-etcd.mount
[Service]
Type=oneshot
Expand All @@ -175,6 +167,13 @@ spec:
<7> Copies and moves in separate steps to ensure atomic creation of a complete member directory.
<8> Performs a quick check of the mount point directory before performing a full recursive relabel. If restorecon in the file path `/var/lib/etcd` cannot rename the directory, the recursive rename is not performed.
====
+
[WARNING]
====
After you apply the `98-var-lib-etcd.yaml` file to the system, do not remove it. Removing this file will break etcd members and lead to system instability.
If a rollback is necessary, modify the `ControlPlaneMachineSet` object to use a flavor that does not include ephemeral disks. This change regenerates the control plane nodes without using ephemeral disks for the etcd partition, which avoids issues related to the `98-var-lib-etcd.yaml` file. It is safe to remove the `98-var-lib-etcd.yaml` file only after the update to the `ControlPlaneMachineSet` object is complete and no control plane nodes are using ephemeral disks.
====

. Create the new `MachineConfig` object by running the following command:
+
Expand Down

0 comments on commit 42da15a

Please sign in to comment.