Merge pull request #58494 from amolnar-rh/TELCODOCS-1186

Author: adellape

modules/lvms-installing-logical-volume-manager-operator-disconnected-environment.adoc

@@ -0,0 +1,25 @@
+// Module included in the following assemblies:
+//
+// storage/persistent_storage/persistent_storage_local/persistent-storage-using-lvms.adoc
+
+:_content-type: PROCEDURE
+[id="lvms-installing-lvms-disconnected-env_{context}"]
+= Installing {lvms} in a disconnected environment
+
+You can install {lvms} on {product-title} {product-version} in a disconnected environment. All sections referenced in this procedure are linked in _Additional resources_.
+
+.Prerequisites
+
+* You read the _About disconnected installation mirroring_ section.
+* You have access to the {product-title} image repository.
+* You created a mirror registry.
+
+.Procedure
+
+. Follow the steps in the _Creating the image set configuration_ procedure. To create an `ImageSetConfiguration` resource for {lvms}, you can use the following example YAML file:
++
+include::snippets/lvms-disconnected-ImageSetConfig.adoc[]
+
+. Follow the procedure in the _Mirroring an image set to a mirror registry_ section.
+
+. Follow the procedure in the _Configuring image registry repository mirroring_ section.

snippets/lvms-disconnected-ImageSetConfig.adoc

@@ -0,0 +1,36 @@
+:_content-type: SNIPPET
+.Example ImageSetConfiguration file for {lvms}
+[source,yaml,subs="attributes+"]
+----
+kind: ImageSetConfiguration
+apiVersion: mirror.openshift.io/v1alpha2
+archiveSize: 4 <1>
+storageConfig: <2>
+  registry:
+    imageURL: example.com/mirror/oc-mirror-metadata <3>
+    skipTLS: false
+mirror:
+  platform:
+    channels:
+    - name: stable-{product-version} <4>
+      type: ocp
+    graph: true <5>
+  operators:
+  - catalog: registry.redhat.io/redhat/redhat-operator-index:v{product-version} <6>
+    packages:
+    - name: lvms-operator <7>
+      channels:
+      - name: stable <8>
+  additionalImages:
+  - name: registry.redhat.io/ubi8/ubi:latest <9>
+  helm: {}
+----
+<1> Add `archiveSize` to set the maximum size, in GiB, of each file within the image set.
+<2> Set the back-end location to save the image set metadata to. This location can be a registry or local directory. It is required to specify `storageConfig` values, unless you are using the Technology Preview OCI feature.
+<3> Set the registry URL for the storage backend.
+<4> Set the channel to retrieve the {product-title} images from.
+<5> Add `graph: true` to generate the OpenShift Update Service (OSUS) graph image to allow for an improved cluster update experience when using the web console. For more information, see _About the OpenShift Update Service_.
+<6> Set the Operator catalog to retrieve the {product-title} images from.
+<7> Specify only certain Operator packages to include in the image set. Remove this field to retrieve all packages in the catalog.
+<8> Specify only certain channels of the Operator packages to include in the image set. You must always include the default channel for the Operator package even if you do not use the bundles in that channel. You can find the default channel by running the following command: `oc mirror list operators --catalog=<catalog_name> --package=<package_name>`.
+<9> Specify any additional images to include in image set.

storage/persistent_storage/persistent_storage_local/persistent-storage-using-lvms.adoc

@@ -24,6 +24,24 @@ include::modules/lvms-installing-logical-volume-manager-operator-using-openshift
 
 include::modules/lvms-uninstalling-logical-volume-manager-operator-using-openshift-web-console.adoc[leveloffset=+2]
 
+include::modules/lvms-installing-logical-volume-manager-operator-disconnected-environment.adoc[leveloffset=+2]
+
+[role="_additional-resources"]
+.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]
+
+
 include::modules/lvms-installing-logical-volume-manager-operator-using-rhacm.adoc[leveloffset=+2]
 
 [role="_additional-resources"]
@@ -92,9 +110,9 @@ 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.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.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/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]