From 3312866be9015b407ef8ddcb115650607d9575f3 Mon Sep 17 00:00:00 2001 From: Lisa Pettyjohn Date: Tue, 5 Aug 2025 17:07:47 -0400 Subject: [PATCH] OSDOCS-14022#Move local storage info up a level for visibility --- _topic_maps/_topic_map.yml | 22 ++--- .../install-sno-installing-sno.adoc | 3 +- ...agent-based-installed-cluster-for-mce.adoc | 8 +- .../planning-migration-3-4.adoc | 2 +- .../ibmz-post-install.adoc | 4 +- release_notes/ocp-4-13-release-notes.adoc | 2 +- scalability_and_performance/using-rfhe.adoc | 5 -- .../ztp_far_edge/ztp-manual-install.adoc | 2 - .../persistent_storage_local/_attributes | 0 .../persistent_storage_local/images | 0 .../persistent_storage_local/modules | 0 .../persistent-storage-hostpath.adoc | 0 .../persistent-storage-local.adoc | 2 - .../persistent-storage-using-lvms.adoc | 82 +++++++------------ .../persistent_storage_local/snippets | 0 .../ways-to-provision-local-storage.adoc | 62 ++++++++++++++ 16 files changed, 114 insertions(+), 80 deletions(-) rename storage/{persistent_storage => }/persistent_storage_local/_attributes (100%) rename storage/{persistent_storage => }/persistent_storage_local/images (100%) rename storage/{persistent_storage => }/persistent_storage_local/modules (100%) rename storage/{persistent_storage => }/persistent_storage_local/persistent-storage-hostpath.adoc (100%) rename storage/{persistent_storage => }/persistent_storage_local/persistent-storage-local.adoc (92%) rename storage/{persistent_storage => }/persistent_storage_local/persistent-storage-using-lvms.adoc (51%) rename storage/{persistent_storage => }/persistent_storage_local/snippets (100%) create mode 100644 storage/persistent_storage_local/ways-to-provision-local-storage.adoc diff --git a/_topic_maps/_topic_map.yml b/_topic_maps/_topic_map.yml index bec5ebb5e4ca..7eea8f737c1b 100644 --- a/_topic_maps/_topic_map.yml +++ b/_topic_maps/_topic_map.yml @@ -1595,16 +1595,18 @@ Topics: File: persistent-storage-ocs - Name: Persistent storage using VMware vSphere File: persistent-storage-vsphere - - Name: Persistent storage using local storage - Dir: persistent_storage_local - Distros: openshift-enterprise,openshift-origin - Topics: - - Name: Persistent storage using local volumes - File: persistent-storage-local - - Name: Persistent storage using hostPath - File: persistent-storage-hostpath - - Name: Persistent storage using LVM Storage - File: persistent-storage-using-lvms +- Name: Persistent storage using local storage + Dir: persistent_storage_local + Distros: openshift-enterprise,openshift-origin + Topics: + - Name: Local storage overview + File: ways-to-provision-local-storage + - Name: Persistent storage using local volumes + File: persistent-storage-local + - Name: Persistent storage using hostPath + File: persistent-storage-hostpath + - Name: Persistent storage using LVM Storage + File: persistent-storage-using-lvms - Name: Using Container Storage Interface (CSI) Dir: container_storage_interface Distros: openshift-enterprise,openshift-origin diff --git a/installing/installing_sno/install-sno-installing-sno.adoc b/installing/installing_sno/install-sno-installing-sno.adoc index 0314b8f242af..4f8a294cd2e6 100644 --- a/installing/installing_sno/install-sno-installing-sno.adoc +++ b/installing/installing_sno/install-sno-installing-sno.adoc @@ -20,8 +20,7 @@ include::modules/install-sno-generating-the-discovery-iso-with-the-assisted-inst [role="_additional-resources"] .Additional resources -* xref:../../storage/persistent_storage/persistent_storage_local/persistent-storage-using-lvms.adoc#persistent-storage-using-lvms_logical-volume-manager-storage[Persistent storage using logical volume manager storage] -* xref:../../virt/about-virt.adoc#virt-what-you-can-do-with-virt_about-virt[What you can do with OpenShift Virtualization] +* xref:../../storage/persistent_storage_local/persistent-storage-using-lvms.adoc#persistent-storage-using-lvms_logical-volume-manager-storage[Persistent storage using logical volume manager storage] // Installing single-node OpenShift with the Assisted Installer include::modules/install-sno-installing-with-the-assisted-installer.adoc[leveloffset=+2] diff --git a/installing/installing_with_agent_based_installer/preparing-an-agent-based-installed-cluster-for-mce.adoc b/installing/installing_with_agent_based_installer/preparing-an-agent-based-installed-cluster-for-mce.adoc index e42d955df1a5..6184d619955d 100644 --- a/installing/installing_with_agent_based_installer/preparing-an-agent-based-installed-cluster-for-mce.adoc +++ b/installing/installing_with_agent_based_installer/preparing-an-agent-based-installed-cluster-for-mce.adoc @@ -11,9 +11,9 @@ The following procedure is partially automated and requires manual steps after t == Prerequisites * You have read the following documentation: -** link:https://access.redhat.com/documentation/en-us/red_hat_advanced_cluster_management_for_kubernetes/2.8/html/clusters/cluster_mce_overview[Cluster lifecycle with multicluster engine operator overview]. -** xref:../../storage/persistent_storage/persistent_storage_local/persistent-storage-local.adoc#persistent-storage-using-local-volume[Persistent storage using local volumes]. -** xref:../../scalability_and_performance/ztp_far_edge/ztp-deploying-far-edge-clusters-at-scale.adoc#about-ztp_ztp-deploying-far-edge-clusters-at-scale[Using ZTP to provision clusters at the network far edge]. + +** link:https://access.redhat.com/documentation/en-us/red_hat_advanced_cluster_management_for_kubernetes/2.9/html/clusters/cluster_mce_overview[Cluster lifecycle with multicluster engine operator overview]. +** xref:../../storage/persistent_storage_local/persistent-storage-local.adoc#persistent-storage-using-local-volume[Persistent storage using local volumes]. ** xref:../../installing/installing_with_agent_based_installer/preparing-to-install-with-agent-based-installer.adoc#preparing-to-install-with-agent-based-installer[Preparing to install with the Agent-based Installer]. ** xref:../../installing/disconnected_install/index.adoc#installing-mirroring-disconnected-about[About disconnected installation mirroring]. * You have access to the internet to obtain the necessary container images. @@ -29,4 +29,4 @@ include::modules/preparing-an-initial-cluster-deployment-for-mce-connected.adoc[ [role="_additional-resources"] .Additional resources -* xref:../../storage/persistent_storage/persistent_storage_local/persistent-storage-local.adoc#persistent-storage-using-local-volume[The Local Storage Operator] +* xref:../../storage/persistent_storage_local/persistent-storage-local.adoc#persistent-storage-using-local-volume[The Local Storage Operator] diff --git a/migrating_from_ocp_3_to_4/planning-migration-3-4.adoc b/migrating_from_ocp_3_to_4/planning-migration-3-4.adoc index ab9b4d88f465..3de3351a063b 100644 --- a/migrating_from_ocp_3_to_4/planning-migration-3-4.adoc +++ b/migrating_from_ocp_3_to_4/planning-migration-3-4.adoc @@ -86,7 +86,7 @@ Review the following storage changes to consider when transitioning from {produc Local storage is only supported by using the Local Storage Operator in {product-title} {product-version}. It is not supported to use the local provisioner method from {product-title} 3.11. -For more information, see xref:../storage/persistent_storage/persistent_storage_local/persistent-storage-local.adoc#persistent-storage-using-local-volume[Persistent storage using local volumes]. +For more information, see xref:../storage/persistent_storage_local/persistent-storage-local.adoc#persistent-storage-using-local-volume[Persistent storage using local volumes]. [discrete] ==== FlexVolume persistent storage diff --git a/post_installation_configuration/ibmz-post-install.adoc b/post_installation_configuration/ibmz-post-install.adoc index 64e3d9317587..d0d214280286 100644 --- a/post_installation_configuration/ibmz-post-install.adoc +++ b/post_installation_configuration/ibmz-post-install.adoc @@ -29,7 +29,7 @@ include::modules/ibmz-configure-devices-mco.adoc[leveloffset=+1] .Next steps -* xref:../storage/persistent_storage/persistent_storage_local/persistent-storage-local.adoc#persistent-storage-using-local-volume[Install and configure the Local Storage Operator] +* xref:../storage/persistent_storage_local/persistent-storage-local.adoc#persistent-storage-using-local-volume[Install and configure the Local Storage Operator] * xref:../networking/k8s_nmstate/k8s-nmstate-updating-node-network-config.adoc#k8s-nmstate-updating-node-network-config[Updating node network configuration] include::modules/ibmz-configure-devices-manually.adoc[leveloffset=+1] @@ -46,5 +46,5 @@ include::modules/ibmz-enable-multipathing-fcp-luns.adoc[leveloffset=+1] .Next steps -* xref:../storage/persistent_storage/persistent_storage_local/persistent-storage-local.adoc#persistent-storage-using-local-volume[Install and configure the Local Storage Operator] +* xref:../storage/persistent_storage_local/persistent-storage-local.adoc#persistent-storage-using-local-volume[Install and configure the Local Storage Operator] * xref:../networking/k8s_nmstate/k8s-nmstate-updating-node-network-config.adoc#k8s-nmstate-updating-node-network-config[Updating node network configuration] diff --git a/release_notes/ocp-4-13-release-notes.adoc b/release_notes/ocp-4-13-release-notes.adoc index 32a092b1962f..12317745ddf0 100644 --- a/release_notes/ocp-4-13-release-notes.adoc +++ b/release_notes/ocp-4-13-release-notes.adoc @@ -900,7 +900,7 @@ In {product-title} {product-version}, you can add and configure {lvms-first} thr [id="ocp-4-13-storage-lvms-in-disconnected-env_{context}"] ==== Support for {lvms} in disconnected environments -In {product-title} {product-version}, you can install {lvms} in disconnected environments. For more information, see xref:../storage/persistent_storage/persistent_storage_local/persistent-storage-using-lvms.adoc#lvms-installing-lvms-disconnected-env_logical-volume-manager-storage[Installing LVM Storage in a disconnected environment]. +In {product-title} {product-version}, you can install {lvms} in disconnected environments. For more information, see xref:../storage/persistent_storage_local/persistent-storage-using-lvms.adoc#lvms-installing-lvms-disconnected-env_logical-volume-manager-storage[Installing LVM Storage in a disconnected environment]. [id="ocp-4-13-storage-user-managed-encryption_{context}"] ==== User-managed encryption is generally available diff --git a/scalability_and_performance/using-rfhe.adoc b/scalability_and_performance/using-rfhe.adoc index 94b9196b2ddb..55bf017412a5 100644 --- a/scalability_and_performance/using-rfhe.adoc +++ b/scalability_and_performance/using-rfhe.adoc @@ -48,11 +48,6 @@ include::modules/nw-rfhe-quering-redfish-hardware-event-subs.adoc[leveloffset=+2 include::modules/nw-rfhe-creating-hardware-event.adoc[leveloffset=+2] -[role="_additional-resources"] -.Additional resources - -* xref:../storage/persistent_storage/persistent_storage_local/persistent-storage-local.adoc#persistent-storage-using-local-volume[Persistent storage using local volumes] - include::modules/cnf-rfhe-notifications-api-refererence.adoc[leveloffset=+1] include::modules/cnf-migrating-from-amqp-to-http-transport.adoc[leveloffset=+1] diff --git a/scalability_and_performance/ztp_far_edge/ztp-manual-install.adoc b/scalability_and_performance/ztp_far_edge/ztp-manual-install.adoc index 4be76c0eb316..9d6e7e5ff23a 100644 --- a/scalability_and_performance/ztp_far_edge/ztp-manual-install.adoc +++ b/scalability_and_performance/ztp_far_edge/ztp-manual-install.adoc @@ -42,8 +42,6 @@ include::modules/ztp-manually-install-a-single-managed-cluster.adoc[leveloffset= * xref:../../scalability_and_performance/ztp_far_edge/ztp-reference-cluster-configuration-for-vdu.adoc#ztp-managed-cluster-network-prereqs_sno-configure-for-vdu[Connectivity prerequisites for managed cluster networks] -* xref:../../storage/persistent_storage/persistent_storage_local/persistent-storage-using-lvms.adoc#lvms-preface-sno-ran_logical-volume-manager-storage[Deploying LVM Storage on single-node OpenShift clusters] - * xref:../../scalability_and_performance/ztp_far_edge/ztp-advanced-policy-config.adoc#ztp-provisioning-lvm-storage_ztp-advanced-policy-config[Configuring LVM Storage using PolicyGenTemplate CRs] include::modules/ztp-checking-the-managed-cluster-status.adoc[leveloffset=+1] diff --git a/storage/persistent_storage/persistent_storage_local/_attributes b/storage/persistent_storage_local/_attributes similarity index 100% rename from storage/persistent_storage/persistent_storage_local/_attributes rename to storage/persistent_storage_local/_attributes diff --git a/storage/persistent_storage/persistent_storage_local/images b/storage/persistent_storage_local/images similarity index 100% rename from storage/persistent_storage/persistent_storage_local/images rename to storage/persistent_storage_local/images diff --git a/storage/persistent_storage/persistent_storage_local/modules b/storage/persistent_storage_local/modules similarity index 100% rename from storage/persistent_storage/persistent_storage_local/modules rename to storage/persistent_storage_local/modules diff --git a/storage/persistent_storage/persistent_storage_local/persistent-storage-hostpath.adoc b/storage/persistent_storage_local/persistent-storage-hostpath.adoc similarity index 100% rename from storage/persistent_storage/persistent_storage_local/persistent-storage-hostpath.adoc rename to storage/persistent_storage_local/persistent-storage-hostpath.adoc diff --git a/storage/persistent_storage/persistent_storage_local/persistent-storage-local.adoc b/storage/persistent_storage_local/persistent-storage-local.adoc similarity index 92% rename from storage/persistent_storage/persistent_storage_local/persistent-storage-local.adoc rename to storage/persistent_storage_local/persistent-storage-local.adoc index 5cc3cbf228ec..ba34a0e6176e 100644 --- a/storage/persistent_storage/persistent_storage_local/persistent-storage-local.adoc +++ b/storage/persistent_storage_local/persistent-storage-local.adoc @@ -37,8 +37,6 @@ include::modules/persistent-storage-local-tolerations.adoc[leveloffset=+1] include::modules/persistent-storage-local-metrics.adoc[leveloffset=+1] -For more information about metrics, see xref:../../../observability/monitoring/managing-metrics.adoc#managing-metric[Managing metrics]. - == Deleting the Local Storage Operator resources include::modules/persistent-storage-local-removing-devices.adoc[leveloffset=+2] diff --git a/storage/persistent_storage/persistent_storage_local/persistent-storage-using-lvms.adoc b/storage/persistent_storage_local/persistent-storage-using-lvms.adoc similarity index 51% rename from storage/persistent_storage/persistent_storage_local/persistent-storage-using-lvms.adoc rename to storage/persistent_storage_local/persistent-storage-using-lvms.adoc index 346de10931aa..ac34d1f7042d 100644 --- a/storage/persistent_storage/persistent_storage_local/persistent-storage-using-lvms.adoc +++ b/storage/persistent_storage_local/persistent-storage-using-lvms.adoc @@ -16,6 +16,7 @@ You can create volume groups, persistent volume claims (PVCs), volume snapshots, include::modules/lvms-about-lvm-storage-installation.adoc[leveloffset=+1] [role="_additional-resources"] +[id="additional-resources-1_{context}"] .Additional resources * link:https://access.redhat.com/documentation/en-us/red_hat_advanced_cluster_management_for_kubernetes/2.6/html/install/installing#installing-while-connected-online[Red Hat Advanced Cluster Management for Kubernetes: Installing while connected online] @@ -31,87 +32,69 @@ include::modules/lvms-uninstalling-logical-volume-manager-operator-using-openshi include::modules/lvms-installing-logical-volume-manager-operator-disconnected-environment.adoc[leveloffset=+2] [role="_additional-resources"] +[id="additional-resources-2_{context}"] .Additional resources -* xref:../../../installing/disconnected_install/index.adoc#installing-mirroring-disconnected-about[About disconnected installation mirroring] - -* xref:../../../installing/disconnected_install/installing-mirroring-creating-registry.adoc#installing-mirroring-creating-registry[Creating a mirror registry with mirror registry for Red Hat OpenShift] - -* xref:../../../installing/disconnected_install/installing-mirroring-installation-images.adoc#installation-mirror-repository_installing-mirroring-installation-images[Mirroring the OpenShift Container Platform image repository] - -* xref:../../../installing/disconnected_install/installing-mirroring-disconnected.adoc#oc-mirror-creating-image-set-config_installing-mirroring-disconnected[Creating the image set configuration] - -* xref:../../../installing/disconnected_install/installing-mirroring-disconnected.adoc#mirroring-image-set[Mirroring an image set to a mirror registry] - -* xref:../../../openshift_images/image-configuration.adoc#images-configuration-registry-mirror_image-configuration[Configuring image registry repository mirroring] +* xref:../../openshift_images/image-configuration.adoc#images-configuration-registry-mirror_image-configuration[Configuring image registry repository mirroring] +* xref:../../openshift_images/image-streams-manage.adoc#images-imagestream-use_image-configuration[Why use imagestreams] include::modules/lvms-installing-logical-volume-manager-operator-using-rhacm.adoc[leveloffset=+2] +* link:https://access.redhat.com/documentation/en-us/red_hat_advanced_cluster_management_for_kubernetes/{rh-rhacm-version}/html/install/installing#installing-while-connected-online[Red Hat Advanced Cluster Management for Kubernetes: Installing while connected online] + [role="_additional-resources"] +[id="additional-resources-3_{context}"] .Additional resources -* link:https://access.redhat.com/documentation/en-us/red_hat_advanced_cluster_management_for_kubernetes/2.6/html/install/installing#installing-while-connected-online[Red Hat Advanced Cluster Management for Kubernetes: Installing while connected online] +* link:https://docs.redhat.com/en/documentation/red_hat_enterprise_linux/9/html-single/configuring_and_managing_logical_volumes/index#overview-of-chunk-size_creating-and-managing-thin-provisioned-volumes[Overview of chunk size] -* xref:../../../storage/persistent_storage/persistent_storage_local/persistent-storage-using-lvms.adoc#lvms-reference-file_logical-volume-manager-storage[{lvms} reference YAML file] +* xref:../../storage/persistent_storage_local/persistent-storage-using-lvms.adoc#limitations-to-configure-size-of-devices_logical-volume-manager-storage[Limitations to configure the size of the devices used in {lvms}] +* xref:../../nodes/nodes/nodes-sno-worker-nodes.adoc[Adding worker nodes to {sno} clusters] -include::modules/lvms-uninstalling-logical-volume-manager-operator-using-rhacm.adoc[leveloffset=+2] +// Limitations to configure the size of the devices to be used in LVM Storage +include::modules/lvms-limitations-to-configure-size-of-devices.adoc[leveloffset=+2] [role="_additional-resources"] +[id="additional-resources-4_{context}"] .Additional resources -* xref:../../../storage/persistent_storage/persistent_storage_local/persistent-storage-using-lvms.adoc#lvms-reference-file_logical-volume-manager-storage[{lvms} reference YAML file] +* xref:../../installing/install_config/installing-customizing.adoc#installation-special-config-raid_installing-customizing[Configuring a RAID-enabled data volume] -// Limitations to configure the size of the devices to be used in LVM Storage -include::modules/lvms-limitations-to-configure-size-of-devices.adoc[leveloffset=+1] +* xref:../../installing/install_config/installing-customizing.adoc#installation-special-config-encrypt-disk_installing-customizing[About disk encryption] -include::modules/lvms-creating-logical-volume-manager-cluster.adoc[leveloffset=+1] +* xref:../../installing/install_config/installing-customizing.adoc#installation-special-config-storage-procedure_installing-customizing[Configuring disk encryption and mirroring] [role="_additional-resources"] +[id="additional-resources-7_{context}"] .Additional resources -* xref:../../../nodes/nodes/nodes-sno-worker-nodes.adoc[Adding worker nodes to {sno} clusters] - -* xref:../../../storage/persistent_storage/persistent_storage_local/persistent-storage-using-lvms.adoc#lvms-reference-file_logical-volume-manager-storage[{lvms} reference YAML file] +* link:https://access.redhat.com/documentation/en-us/red_hat_advanced_cluster_management_for_kubernetes/{rh-rhacm-version}/html/install/installing#installing-while-connected-online[Red Hat Advanced Cluster Management for Kubernetes: Installing while connected online] //Provisioning include::modules/lvms-provisioning-storage-using-logical-volume-manager-operator.adoc[leveloffset=+1] -//Scaling -include::modules/lvms-scaling-storage-of-single-node-open-concept.adoc[leveloffset=+1] - -[role="_additional-resources"] -.Additional resources - -* xref:../../../nodes/nodes/nodes-sno-worker-nodes.adoc[Adding worker nodes to {sno} clusters] - -include::modules/lvms-scaling-storage-of-single-node-openshift-cluster.adoc[leveloffset=+2] - [role="_additional-resources"] +[id="additional-resources-8_{context}"] .Additional resources -* xref:../../../storage/persistent_storage/persistent_storage_local/persistent-storage-using-lvms.adoc#lvms-reference-file_logical-volume-manager-storage[{lvms} reference YAML file] - -include::modules/lvms-scaling-storage-of-single-node-openshift-cluster-using-rhacm.adoc[leveloffset=+2] +* xref:../../nodes/nodes/nodes-sno-worker-nodes.adoc[Adding worker nodes to {sno} clusters] [role="_additional-resources"] +[id="additional-resources-11_{context}"] .Additional resources * link:https://access.redhat.com/documentation/en-us/red_hat_advanced_cluster_management_for_kubernetes/2.6/html/install/installing#installing-while-connected-online[Red Hat Advanced Cluster Management for Kubernetes: Installing while connected online] -* xref:../../../storage/persistent_storage/persistent_storage_local/persistent-storage-using-lvms.adoc#lvms-reference-file_logical-volume-manager-storage[{lvms} reference YAML file] - -include::modules/lvms-scaling-storage-expand-pvc.adoc[leveloffset=+2] +// Expanding PVCs +include::modules/lvms-scaling-storage-expand-pvc.adoc[leveloffset=+1] [role="_additional-resources"] +[id="additional-resources-12_{context}"] .Additional resources -* xref:../../../storage/persistent_storage/persistent_storage_local/persistent-storage-using-lvms.adoc#lvms-scaling-storage-of-single-node-openshift-cluster_logical-volume-manager-storage[Scaling up storage by adding capacity to your {sno} cluster] - -* xref:../../../storage/persistent_storage/persistent_storage_local/persistent-storage-using-lvms.adoc#lvms-scaling-storage-of-single-node-openshift-cluster-using-rhacm_logical-volume-manager-storage[Scaling up storage by adding capacity to your single-node OpenShift cluster using RHACM] - -* xref:../../../storage/expanding-persistent-volumes.adoc#add-volume-expansion_expanding-persistent-volumes[Enabling volume expansion support] +* xref:../../storage/expanding-persistent-volumes.adoc#add-volume-expansion_expanding-persistent-volumes[Enabling volume expansion support] //Upgrading include::modules/lvms-upgrading-lvms-on-sno.adoc[leveloffset=+1] @@ -120,9 +103,10 @@ include::modules/lvms-upgrading-lvms-on-sno.adoc[leveloffset=+1] include::modules/lvms-volume-snapshots-in-single-node-openshift.adoc[leveloffset=+1] [role="_additional-resources"] +[id="additional-resources-13_{context}"] .Additional resources -* xref:../../../backup_and_restore/application_backup_and_restore/oadp-features-plugins.adoc#oadp-features_oadp-features-plugins[OADP features] +* xref:../../backup_and_restore/application_backup_and_restore/oadp-features-plugins.adoc#oadp-features_oadp-features-plugins[OADP features] include::modules/lvms-creating-volume-snapshots-in-single-node-openshift.adoc[leveloffset=+2] include::modules/lvms-restoring-volume-snapshots-in-single-node-openshift.adoc[leveloffset=+2] @@ -140,9 +124,10 @@ include::modules/lvms-monitoring-logical-volume-manager-operator.adoc[leveloffse include::modules/lvms-download-log-files-and-diagnostics.adoc[leveloffset=+1] [role="_additional-resources"] +[id="additional-resources-14_{context}"] .Additional resources -* xref:../../../support/gathering-cluster-data.adoc#about-must-gather_gathering-cluster-data[About the must-gather tool] +* xref:../../support/gathering-cluster-data.adoc#about-must-gather_gathering-cluster-data[About the must-gather tool] //Reference include::modules/lvms-reference-file.adoc[leveloffset=+1] @@ -154,18 +139,13 @@ include::modules/lvms-troubleshooting-investigating-a-pvc-stuck-in-the-pending-s include::modules/lvms-troubleshooting-recovering-from-missing-lvms-or-operator-components.adoc[leveloffset=+2] -[role="_additional-resources"] -.Additional resources - -* xref:../../../storage/persistent_storage/persistent_storage_local/persistent-storage-using-lvms.adoc#lvms-creating-lvms-cluster_logical-volume-manager-storage[Creating a Logical Volume Manager cluster on a {sno} worker node] - include::modules/lvms-troubleshooting-recovering-from-node-failure.adoc[leveloffset=+2] [role="_additional-resources"] [id="additional-resources-forced-cleanup-1"] .Additional resources -* xref:../../../storage/persistent_storage/persistent_storage_local/persistent-storage-using-lvms.adoc#performing-a-forced-cleanup_logical-volume-manager-storage[Performing a forced clean-up] +* xref:../../storage/persistent_storage_local/persistent-storage-using-lvms.adoc#performing-a-forced-cleanup_logical-volume-manager-storage[Performing a forced clean-up] include::modules/lvms-troubleshooting-recovering-from-disk-failure.adoc[leveloffset=+2] @@ -173,7 +153,7 @@ include::modules/lvms-troubleshooting-recovering-from-disk-failure.adoc[leveloff [id="additional-resources-forced-cleanup-2"] .Additional resources -* xref:../../../storage/persistent_storage/persistent_storage_local/persistent-storage-using-lvms.adoc#performing-a-forced-cleanup_logical-volume-manager-storage[Performing a forced clean-up] +* xref:../../storage/persistent_storage_local/persistent-storage-using-lvms.adoc#performing-a-forced-cleanup_logical-volume-manager-storage[Performing a forced clean-up] include::modules/lvms-troubleshooting-performing-a-forced-cleanup.adoc[leveloffset=+2] diff --git a/storage/persistent_storage/persistent_storage_local/snippets b/storage/persistent_storage_local/snippets similarity index 100% rename from storage/persistent_storage/persistent_storage_local/snippets rename to storage/persistent_storage_local/snippets diff --git a/storage/persistent_storage_local/ways-to-provision-local-storage.adoc b/storage/persistent_storage_local/ways-to-provision-local-storage.adoc new file mode 100644 index 000000000000..c4ab16ca40b6 --- /dev/null +++ b/storage/persistent_storage_local/ways-to-provision-local-storage.adoc @@ -0,0 +1,62 @@ +:_mod-docs-content-type: ASSEMBLY +[id="ways-to-provision-local-storage_{context}"] += Local storage overview +include::_attributes/common-attributes.adoc[] +:context: ways-to-provision-local-storage + +toc::[] + +You can use any of the following solutions to provision local storage: + +* HostPath Provisioner (HPP) +* Local Storage Operator (LSO) +* {lvms-first} + +[WARNING] +==== +These solutions support provisioning only node-local storage. The workloads are bound to the nodes that provide the storage. If the node becomes unavailable, the workload also becomes unavailable. To maintain workload availability despite node failures, you must ensure storage data replication through active or passive replication mechanisms. +==== + +[id="overview-of-hpp-functionality_{context}"] +== Overview of HostPath Provisioner functionality + +You can perform the following actions using HostPath Provisioner (HPP): + +* Map the host filesystem paths to storage classes for provisioning local storage. +* Statically create storage classes to configure filesystem paths on a node for storage consumption. +* Statically provision Persistent Volumes (PVs) based on the storage class. +* Create workloads and PersistentVolumeClaims (PVCs) while being aware of the underlying storage topology. + +[NOTE] +==== +HPP is available in upstream Kubernetes. However, it is not recommended to use HPP from upstream Kubernetes. +==== + +[id="overview-of-lso-functionality_{context}"] +== Overview of Local Storage Operator functionality + +You can perform the following actions using Local Storage Operator (LSO): + +* Assign the storage devices (disks or partitions) to the storage classes without modifying the device configuration. +* Statically provision PVs and storage classes by configuring the `LocalVolume` custom resource (CR). +* Create workloads and PVCs while being aware of the underlying storage topology. + +[NOTE] +==== +LSO is developed and delivered by Red{nbsp}Hat. +==== + +[id="overview-of-lvm-storage-functionality_{context}"] +== Overview of LVM Storage functionality + +You can perform the following actions using {lvms-first}: + +* Configure storage devices (disks or partitions) as lvm2 volume groups and expose the volume groups as storage classes. +* Create workloads and request storage by using PVCs without considering the node topology. + +{lvms} uses the TopoLVM CSI driver to dynamically allocate storage space to the nodes in the topology and provision PVs. + +[NOTE] +==== +{lvms} is developed and maintained by Red{nbsp}Hat. The CSI driver provided with {lvms} is the upstream project "topolvm". +==== \ No newline at end of file