diff --git a/_topic_maps/_topic_map.yml b/_topic_maps/_topic_map.yml index cfd7a62dcfd3..0657b04866da 100644 --- a/_topic_maps/_topic_map.yml +++ b/_topic_maps/_topic_map.yml @@ -1525,18 +1525,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: Troubleshooting local persistent storage using LVMS - File: troubleshooting-local-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 5f1dfd8e1ef3..8e2f0d26c2a4 100644 --- a/installing/installing_sno/install-sno-installing-sno.adoc +++ b/installing/installing_sno/install-sno-installing-sno.adoc @@ -21,7 +21,8 @@ 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:../../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] // Installing single-node OpenShift with the Assisted Installer 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 20a923f9dab1..38218da05942 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 @@ -6,14 +6,15 @@ include::_attributes/common-attributes.adoc[] toc::[] + You can install the {mce-short} and deploy a hub cluster with the Agent-based {product-title} Installer. The following procedure is partially automated and requires manual steps after the initial cluster is deployed. == Prerequisites * You have read the following documentation: -** link:https://access.redhat.com/documentation/en-us/red_hat_advanced_cluster_management_for_kubernetes/2.7/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. @@ -28,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 c9055bff06b2..e28ac0d22ec3 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 @@ -84,7 +84,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 3cc021d99e26..6e1b651d169f 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/scalability_and_performance/using-rfhe.adoc b/scalability_and_performance/using-rfhe.adoc index 94b9196b2ddb..62b6feebb087 100644 --- a/scalability_and_performance/using-rfhe.adoc +++ b/scalability_and_performance/using-rfhe.adoc @@ -51,7 +51,7 @@ 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] +* xref:../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] diff --git a/storage/persistent_storage/persistent_storage_local/persistent-storage-using-lvms.adoc b/storage/persistent_storage/persistent_storage_local/persistent-storage-using-lvms.adoc deleted file mode 100644 index 4f6367e2b37b..000000000000 --- a/storage/persistent_storage/persistent_storage_local/persistent-storage-using-lvms.adoc +++ /dev/null @@ -1,125 +0,0 @@ -:_mod-docs-content-type: ASSEMBLY -[id="persistent-storage-using-lvms"] -= Persistent storage using Logical Volume Manager Storage -include::_attributes/common-attributes.adoc[] -:context: logical-volume-manager-storage - -toc::[] - -{lvms-first} uses the TopoLVM CSI driver to dynamically provision local storage on {sno} clusters. - -{lvms} creates thin-provisioned volumes using Logical Volume Manager and provides dynamic provisioning of block storage on a limited resources {sno} cluster. - -You can create volume groups, persistent volume claims (PVCs), volume snapshots, and volume clones by using {lvms}. - -//deploying/requirements with RHACM -include::modules/lvms-about-lvm-storage-installation.adoc[leveloffset=+1] - -[role="_additional-resources"] -.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] - -//deploying/requirements with web console -include::modules/lvms-installing-logical-volume-manager-operator-using-openshift-web-console.adoc[leveloffset=+2] -include::modules/lvms-uninstalling-logical-volume-manager-operator-using-openshift-web-console.adoc[leveloffset=+2] - -include::modules/lvms-installing-logical-volume-manager-operator-using-rhacm.adoc[leveloffset=+2] - -[role="_additional-resources"] -.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-uninstalling-logical-volume-manager-operator-using-rhacm.adoc[leveloffset=+2] - -[role="_additional-resources"] -.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] - -// 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] - -include::modules/lvms-creating-an-logical-volume-manager-cluster.adoc[leveloffset=+1] - -[role="_additional-resources"] -.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] - -//Provisioning -include::modules/lvms-provisioning-storage-using-logical-volume-manager-operator.adoc[leveloffset=+1] - -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"] -.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] - -[role="_additional-resources"] -.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] - -[role="_additional-resources"] -.Additional resources - -* xref:../../../storage/persistent_storage/persistent_storage_local/persistent-storage-using-lvms.html#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.html#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] - -//Upgrading -include::modules/lvms-upgrading-lvms-on-sno.adoc[leveloffset=+1] - -//Volume snapshots -include::modules/lvms-volume-snapshots-in-single-node-openshift.adoc[leveloffset=+1] - -[role="_additional-resources"] -.Additional resources - -* 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] -include::modules/lvms-deleting-volume-snapshots-in-single-node-openshift.adoc[leveloffset=+2] - -//Volume cloning -include::modules/lvms-volume-clones-in-single-node-openshift.adoc[leveloffset=+1] -include::modules/lvms-creating-volume-clones-in-single-node-openshift.adoc[leveloffset=+2] -include::modules/lvms-deleting-cloned-volumes-in-single-node-openshift.adoc[leveloffset=+2] - -//Monitoring -include::modules/lvms-monitoring-logical-volume-manager-operator.adoc[leveloffset=+1] - -//Must-gather -include::modules/lvms-download-log-files-and-diagnostics.adoc[leveloffset=+1] - -[role="_additional-resources"] -.Additional resources - -* 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] \ No newline at end of file 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_local/persistent-storage-using-lvms.adoc b/storage/persistent_storage_local/persistent-storage-using-lvms.adoc new file mode 100644 index 000000000000..516be8e0d539 --- /dev/null +++ b/storage/persistent_storage_local/persistent-storage-using-lvms.adoc @@ -0,0 +1,171 @@ +:_mod-docs-content-type: ASSEMBLY +[id="persistent-storage-using-lvms"] += Persistent storage using Logical Volume Manager Storage +include::_attributes/common-attributes.adoc[] +:context: logical-volume-manager-storage + +toc::[] + +{lvms-first} uses the TopoLVM CSI driver to dynamically provision local storage on {sno} clusters. + +{lvms} creates thin-provisioned volumes using Logical Volume Manager and provides dynamic provisioning of block storage on a limited resources {sno} cluster. + +You can create volume groups, persistent volume claims (PVCs), volume snapshots, and volume clones by using {lvms}. + +//deploying/requirements with RHACM +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] + +//deploying/requirements with web console +include::modules/lvms-installing-logical-volume-manager-operator-using-openshift-web-console.adoc[leveloffset=+2] + +[role="_additional-resources"] +[id="additional-resources-2_{context}"] +.Additional resources + +* xref:../../installing/disconnected_install/installing-mirroring-creating-registry.adoc[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 {product-title} image repository] + +* 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://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_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] + +// 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:../../installing/install_config/installing-customizing.adoc#installation-special-config-raid_installing-customizing[Configuring a RAID-enabled data volume] + +* xref:../../installing/install_config/installing-customizing.adoc#installation-special-config-encrypt-disk_installing-customizing[About disk encryption] + +* 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-5_{context}"] +.Additional resources + +[role="_additional-resources"] +[id="additional-resources-6_{context}"] +.Additional resources + +[role="_additional-resources"] +[id="additional-resources-7_{context}"] +.Additional resources + +* 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] + +[role="_additional-resources"] +[id="additional-resources-8_{context}"] +.Additional resources + +* xref:../../nodes/nodes/nodes-sno-worker-nodes.adoc[Adding worker nodes to {sno} clusters] + +[role="_additional-resources"] +[id="additional-resources-9_{context}"] +.Additional resources + +[role="_additional-resources"] +[id="additional-resources-10_{context}"] +.Additional resources + +[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] + +// Expanding PVCs +include::modules/lvms-scaling-storage-expand-pvc.adoc[leveloffset=+1] + +[role="_additional-resources"] +[id="additional-resources-12_{context}"] +.Additional resources + +* 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] + +//Volume snapshots +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] + +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] +include::modules/lvms-deleting-volume-snapshots-in-single-node-openshift.adoc[leveloffset=+2] + +//Volume cloning +include::modules/lvms-volume-clones-in-single-node-openshift.adoc[leveloffset=+1] +include::modules/lvms-creating-volume-clones-in-single-node-openshift.adoc[leveloffset=+2] +include::modules/lvms-deleting-cloned-volumes-in-single-node-openshift.adoc[leveloffset=+2] + +//Monitoring +include::modules/lvms-monitoring-logical-volume-manager-operator.adoc[leveloffset=+1] + +//Must-gather +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] + +//Troubleshooting local persistent storage using LVM Storage + +include::modules/lvms-troubleshooting-investigating-a-pvc-stuck-in-the-pending-state.adoc[leveloffset=+2] + +include::modules/lvms-troubleshooting-recovering-from-missing-lvms-or-operator-components.adoc[leveloffset=+2] + +[role="_additional-resources"] +[id="additional-resources-15_{context}"] +.Additional resources + +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_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] + +[role="_additional-resources"] +[id="additional-resources-forced-cleanup-2"] +.Additional resources + +* 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/persistent_storage_local/troubleshooting-local-persistent-storage-using-lvms.adoc b/storage/persistent_storage_local/troubleshooting-local-persistent-storage-using-lvms.adoc similarity index 100% rename from storage/persistent_storage/persistent_storage_local/troubleshooting-local-persistent-storage-using-lvms.adoc rename to storage/persistent_storage_local/troubleshooting-local-persistent-storage-using-lvms.adoc 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