[enterprise-4.13] OSDOCS-14022#Move local storage info up a level for visibility

_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

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]

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]

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

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]

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

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]

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]

storage/persistent_storage/persistent_storage_local/persistent-storage-local.adoc → 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]

storage/persistent_storage/persistent_storage_local/persistent-storage-using-lvms.adoc → 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,26 +139,21 @@ 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]
 
 [role="_additional-resources"]
 [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]