RHDHBUGS-2140: Air-gapped install fails because oc-mirror command is missing --v2 flag (#2228)

jmagak · GitHub Actions · web-flow · commit 73762422323d · 2026-05-22T11:58:29.000+01:00
* Add --v2 flag requirement note for OCP 4.21+

* Add --v2 flag requirement notes to air-gapped procedures

* Update the install guides

---------

Co-authored-by: GitHub Actions &lt;github-actions@github.com&gt;
diff --git a/modules/extend_orchestrator-in-rhdh/proc-install-rhdh-with-orchestrator-in-a-fully-disconnected-ocp-environment-using-the-helm-chart.adoc b/modules/extend_orchestrator-in-rhdh/proc-install-rhdh-with-orchestrator-in-a-fully-disconnected-ocp-environment-using-the-helm-chart.adoc
@@ -14,7 +14,7 @@ include::snip-installing-the-orchestrator-common-prerequisites.adoc[]
 
 .Procedure
 
-. Create an `ImageSetConfiguration.yaml` file for `oc-mirror`. You must use an `ImageSetConfiguration` file to include all mirrored images required, as shown in the following example:
+. Create an `ImageSetConfiguration.yaml` file for `oc mirror`. You must use an `ImageSetConfiguration` file to include all mirrored images required, as shown in the following example:
 +
 [source,yaml,subs="+attributes,+quotes"]
 ----
@@ -76,16 +76,17 @@ unpack "registry.access.redhat.com/rhdh/plugin-catalog-index:{product-version}"
 # you can then find the `dynamic-plugins.default.yaml` under /tmp/registry.access.redhat.com/rhdh/plugin-catalog-index_{product-version}/dynamic-plugins.default.yaml
 ----
 
-. Mirror the images in the `ImageSetConfiguration.yaml` file by running the `oc-mirror` command. For example:
+. Mirror the images in the `ImageSetConfiguration.yaml` file by running the `oc mirror` command. For example:
 +
 [source,terminal,subs="+attributes,+quotes"]
 ----
-$ oc-mirror --config=ImageSetConfiguration.yaml file:///path/to/mirror-archive --authfile /path/to/authfile  --v2
+$ oc mirror --config=ImageSetConfiguration.yaml file:///path/to/mirror-archive --authfile /path/to/authfile --v2
 ----
 +
 [NOTE]
 ====
-The `oc-mirror` command pulls the charts listed in the `ImageSetConfiguration` file and makes them available as `tgz` archives under the `/path/to/mirror-archive` directory.
+. The `--v2` flag is required for {ocp-short} 4.21 and later.
+. The `oc mirror` command pulls the charts listed in the `ImageSetConfiguration` file and makes them available as `tgz` archives under the `/path/to/mirror-archive` directory.
 ====
 +
 . Apply the cluster-wide resources generated during the push step to redirect all image pulls to your local registry, as shown in the following example:
@@ -102,7 +103,7 @@ $ oc apply -f .
 +
 [source,terminal,subs="+attributes,+quotes"]
 ----
-$ oc-mirror --v2 --from <mirror-archive-file> docker://<target-registry-url:port> --workspace file://<workspace folder> --authfile /path/to/authfile
+$ oc mirror --v2 --from <mirror-archive-file> docker://<target-registry-url:port> --workspace file://<workspace folder> --authfile /path/to/authfile
 ----
 +
 where:
diff --git a/modules/extend_orchestrator-in-rhdh/proc-install-rhdh-with-orchestrator-in-a-fully-disconnected-ocp-environment-using-the-operator.adoc b/modules/extend_orchestrator-in-rhdh/proc-install-rhdh-with-orchestrator-in-a-fully-disconnected-ocp-environment-using-the-operator.adoc
@@ -18,7 +18,7 @@ include::snip-installing-the-orchestrator-common-prerequisites.adoc[]
 
 .Procedure
 
-. Create an `ImageSetConfiguration` file for `oc-mirror`. You must include the images and operators required by the Serverless Logic Operator in the `ImageSetConfiguration` file, as shown in the following example:
+. Create an `ImageSetConfiguration` file for `oc mirror`. You must include the images and operators required by the Serverless Logic Operator in the `ImageSetConfiguration` file, as shown in the following example:
 +
 [source,yaml,subs="+attributes,+quotes"]
 ----
@@ -71,16 +71,17 @@ unpack "registry.access.redhat.com/rhdh/plugin-catalog-index:{product-version)"
 # you can then find the `dynamic-plugins.default.yaml` under /tmp/registry.access.redhat.com/rhdh/plugin-catalog-index_{product-version)/dynamic-plugins.default.yaml
 ----
 
-. Mirror the images in the `ImageSetConfiguration.yaml` file by running the `oc-mirror` command. For example:
+. Mirror the images in the `ImageSetConfiguration.yaml` file by running the `oc mirror` command. For example:
 +
 [source,terminal,subs="+attributes,+quotes"]
 ----
-$ oc-mirror --config=ImageSetConfiguration.yaml file:///path/to/mirror-archive --authfile /path/to/authfile  --v2
+$ oc mirror --config=ImageSetConfiguration.yaml file:///path/to/mirror-archive --authfile /path/to/authfile --v2
 ----
 +
 [NOTE]
 ====
-The `oc-mirror` command generates a local workspace containing the mirror archive files and the required cluster manifests.
+. The `--v2` flag is required for {ocp-short} 4.21 and later.
+. The `oc mirror` command generates a local workspace containing the mirror archive files and the required cluster manifests.
 ====
 +
 . Transfer the directory specified by `/path/to/mirror-archive` to a bastion host within your disconnected environment.
@@ -89,7 +90,7 @@ The `oc-mirror` command generates a local workspace containing the mirror archiv
 +
 [source,yaml,subs="+attributes,+quotes"]
 ----
-$ oc-mirror --v2 --from <mirror-archive-file> docker://<target-registry-url:port> --workspace file://<workspace folder> --authfile /path/to/authfile
+$ oc mirror --v2 --from <mirror-archive-file> docker://<target-registry-url:port> --workspace file://<workspace folder> --authfile /path/to/authfile
 ----
 +
 where:
diff --git a/modules/extend_orchestrator-in-rhdh/proc-install-rhdh-with-orchestrator-in-a-partially-disconnected-ocp-environment-using-the-helm-chart.adoc b/modules/extend_orchestrator-in-rhdh/proc-install-rhdh-with-orchestrator-in-a-partially-disconnected-ocp-environment-using-the-helm-chart.adoc
@@ -8,15 +8,15 @@ You can install {product} ({product-very-short}) with the Orchestrator plugin in
 
 A disconnected installation prevents unauthorized access, data transfer, or communication with external sources.
 
-You can use the `oc-mirror` command to mirror resources directly to your accessible local registry and apply the generated cluster resources.
+You can use the `oc mirror` command to mirror resources directly to your accessible local registry and apply the generated cluster resources.
 
 .Prerequisites
 
 include::snip-installing-the-orchestrator-common-prerequisites.adoc[]
 
 .Procedure
 
-. Create an `ImageSetConfiguration.yaml` file for `oc-mirror`. You must use an `ImageSetConfiguration` file to include all mirrored images required, as shown in the following example:
+. Create an `ImageSetConfiguration.yaml` file for `oc mirror`. You must use an `ImageSetConfiguration` file to include all mirrored images required, as shown in the following example:
 +
 [source,yaml,subs="+attributes,+quotes"]
 ----
@@ -54,16 +54,17 @@ mirror:
           maxVersion: {rhoserverless-version}
 ----
 
-. Mirror the images in the `ImageSetConfiguration.yaml` file by running the `oc-mirror` command to pull images and charts, and push the images directly to the target registry. For example:
+. Mirror the images in the `ImageSetConfiguration.yaml` file by running the `oc mirror` command to pull images and charts, and push the images directly to the target registry. For example:
 +
 [source,terminal,subs="+attributes,+quotes"]
 ----
-$ oc-mirror --config=imagesetconfiguration.yaml docker://<registry URL:port> --workspace file://<workspace folder> --authfile /path/to/authfile  --v2
+$ oc mirror --config=imagesetconfiguration.yaml docker://<registry URL:port> --workspace file://<workspace folder> --authfile /path/to/authfile --v2
 ----
 +
 [NOTE]
 ====
-The `oc-mirror` command pulls the charts listed in the `ImageSetConfiguration` file and makes them available as `tgz` archives under the `<workspace folder>` directory.
+. The `--v2` flag is required for {ocp-short} 4.21 and later.
+. The `oc mirror` command pulls the charts listed in the `ImageSetConfiguration` file and makes them available as `tgz` archives under the `<workspace folder>` directory.
 ====
 
 . Apply the generated cluster resources to the disconnected cluster. For example:
diff --git a/modules/extend_orchestrator-in-rhdh/proc-install-rhdh-with-orchestrator-in-a-partially-disconnected-ocp-environment-using-the-operator.adoc b/modules/extend_orchestrator-in-rhdh/proc-install-rhdh-with-orchestrator-in-a-partially-disconnected-ocp-environment-using-the-operator.adoc
@@ -8,7 +8,7 @@ You can install {product} with Orchestrator plugin in a partial air-gapped envir
 
 A disconnected installation prevents unauthorized access, data transfer, or communication with external sources.
 
-You can use the `oc-mirror` command to mirror resources directly to your accessible local mirror registry and apply the generated cluster resources.
+You can use the `oc mirror` command to mirror resources directly to your accessible local mirror registry and apply the generated cluster resources.
 
 .Prerequisites
 
@@ -18,7 +18,7 @@ include::snip-installing-the-orchestrator-common-prerequisites.adoc[]
 
 .Procedure
 
-. Create an `ImageSetConfiguration` file for `oc-mirror`. You must include the images and operators required by the Serverless Logic Operator in the `ImageSetConfiguration` file, as shown in the following example:
+. Create an `ImageSetConfiguration` file for `oc mirror`. You must include the images and operators required by the Serverless Logic Operator in the `ImageSetConfiguration` file, as shown in the following example:
 +
 [source,yaml,subs="+attributes,+quotes"]
 ----
@@ -71,15 +71,20 @@ unpack "registry.access.redhat.com/rhdh/plugin-catalog-index:{product-version)"
 # you can then find the `dynamic-plugins.default.yaml` under /tmp/registry.access.redhat.com/rhdh/plugin-catalog-index_{product-version)/dynamic-plugins.default.yaml
 ----
 
-. Mirror the images in the `ImageSetConfiguration.yaml` file by running the `oc-mirror` command. For example:
+. Mirror the images in the `ImageSetConfiguration.yaml` file by running the `oc mirror` command. For example:
 +
 [source,terminal,subs="+attributes,+quotes"]
 ----
-$ oc-mirror --config=imagesetconfiguration.yaml docker://<registry URL:port> --workspace file://<workspace folder> --authfile /path/to/authfile  --v2
+$ oc mirror --config=imagesetconfiguration.yaml docker://<registry URL:port> --workspace file://<workspace folder> --authfile /path/to/authfile --v2
 $ cd <workspace folder>/working-dir/cluster-resources/
 $ oc apply -f .
 ----
 +
+[NOTE]
+====
+The `--v2` flag is required for {ocp-short} 4.21 and later.
+====
++
 . Install the OpenShift Serverless Operator and OpenShift Serverless Logic Operators using `OperatorHub`.
 
 . Create a {product-custom-resource-type} custom resource (CR).
diff --git a/modules/extend_orchestrator-in-rhdh/snip-installing-the-orchestrator-common-prerequisites.adoc b/modules/extend_orchestrator-in-rhdh/snip-installing-the-orchestrator-common-prerequisites.adoc
@@ -4,4 +4,4 @@
 
 * You have permissions to push OCI images to your internal container registry.
 
-* You have installed the {ocp-docs-link}/html-single/disconnected_environments/index#installation-oc-mirror-installing-plugin_about-installing-oc-mirror-v2[`oc-mirror`] tool, with a version corresponding to the version of your {ocp-short} cluster.
+* You have installed the {ocp-docs-link}/html-single/disconnected_environments/index#installation-oc-mirror-installing-plugin_about-installing-oc-mirror-v2[`oc mirror`] tool, with a version corresponding to the version of your {ocp-short} cluster.
diff --git a/modules/install_installing-rhdh-in-an-air-gapped-environment/proc-install-rhdh-in-a-fully-disconnected-environment-with-the-operator.adoc b/modules/install_installing-rhdh-in-an-air-gapped-environment/proc-install-rhdh-in-a-fully-disconnected-environment-with-the-operator.adoc
@@ -62,11 +62,11 @@ where:
 `_<my_pulled_image_location>_/install.sh`:: Enter the downloaded installation script and the absolute path to the directory where you stored it on your system.
 `--from-dir _<my_pulled_image_location>_`:: Enter the directory where you want to pull all of the necessary images.
 `--to-registry`:: (Optional) Enter the URL for the target mirror registry where you want to mirror the images.
-`--use-oc-mirror true`:: Recommended on {ocp-short}: Use the `oc-mirror` {ocp-short} CLI plugin to mirror images.
+`--use-oc-mirror true`:: Recommended on {ocp-short}: Use the `oc mirror` {ocp-short} CLI plugin to mirror images.
 +
 [IMPORTANT]
 ====
-If you used `oc-mirror` to mirror the images to disk, you must also use `oc-mirror` to mirror the images from disk due to the folder layout that `oc-mirror` uses.
+If you used `oc mirror` to mirror the images to disk, you must also use `oc mirror` to mirror the images from disk due to the folder layout that `oc mirror` uses.
 ====
 +
 [NOTE]
diff --git a/modules/install_installing-rhdh-in-an-air-gapped-environment/proc-install-rhdh-in-a-partially-disconnected-environment-with-the-operator.adoc b/modules/install_installing-rhdh-in-an-air-gapped-environment/proc-install-rhdh-in-a-partially-disconnected-environment-with-the-operator.adoc
@@ -34,7 +34,7 @@ For more information, see link:https://access.redhat.com/articles/RegistryAuthen
 * You have installed the `opm` CLI tool.
 For more information, see {ocp-docs-link}/html/cli_tools/opm-cli#olm-about-opm_cli-opm-install[Installing the opm CLI].
 * If you are using an {ocp-short} cluster, you have the following prerequisites:
-** Recommended: You have installed the `oc-mirror` tool, with a version corresponding to the version of your {ocp-short} cluster.
+** Recommended: You have installed the `oc mirror` tool, with a version corresponding to the version of your {ocp-short} cluster.
 * If you are using a supported Kubernetes cluster, you have the following prerequisites:
 ** You have installed the Operator Lifecycle Manager (OLM) on the disconnected cluster.
 ** You have a mirror registry that is reachable from the disconnected cluster.
@@ -61,7 +61,7 @@ $ bash prepare-restricted-environment.sh \
 ----
 where:
 `--to-registry _<my.registry.example.com>`:: Enter the URL for the target mirror registry where you want to mirror the images.
-`--use-oc-mirror true`:: Optional: Use the `oc-mirror` {ocp-short} CLI plugin to mirror images.
+`--use-oc-mirror true`:: Optional: Use the `oc mirror` {ocp-short} CLI plugin to mirror images.
 +
 [NOTE]
 ====
diff --git a/modules/install_installing-rhdh-in-an-air-gapped-environment/proc-install-rhdh-on-ocp-in-a-fully-disconnected-environment-with-the-helm-chart.adoc b/modules/install_installing-rhdh-in-an-air-gapped-environment/proc-install-rhdh-on-ocp-in-a-fully-disconnected-environment-with-the-helm-chart.adoc
@@ -42,7 +42,7 @@ mirror:
 where:
 `version: "{product-version}"`:: Enter the {product} version to mirror.
 
-. Mirror the resources specified in the `ImageSetConfiguration.yaml` file by running the `oc-mirror` command. For example:
+. Mirror the resources specified in the `ImageSetConfiguration.yaml` file by running the `oc mirror` command. For example:
 +
 [source,terminal,subs="+quotes"]
 ----
@@ -59,7 +59,8 @@ where:
 +
 [NOTE]
 ====
-Running the `oc-mirror` command generates a local workspace containing the mirror archive file, the Helm chart, `ImageDigestMirrorSet` (IDMS) and `ImageTagMirrorSet` (ITMS) manifests. The IDMS and ITMS manifests contain files that you must apply against the cluster in a later step.
+. The `--v2` flag is required for {ocp-short} 4.21 and later.
+. Running the `oc mirror` command generates a local workspace containing the mirror archive file, the Helm chart, `ImageDigestMirrorSet` (IDMS) and `ImageTagMirrorSet` (ITMS) manifests. The IDMS and ITMS manifests contain files that you must apply against the cluster in a later step.
 ====
 +
 Example output:
@@ -75,7 +76,7 @@ Creating archive /path/to/mirror-archive/mirror_seq1_000000.tar
 . The local target registry
 . The target {ocp-short} cluster
 +
-. From your air-gapped environment, mirror the resources from the archive to the target registry by running the `oc-mirror` command. For example:
+. From your air-gapped environment, mirror the resources from the archive to the target registry by running the `oc mirror` command. For example:
 +
 [source,terminal,subs="+quotes"]
 ----
diff --git a/modules/install_installing-rhdh-in-an-air-gapped-environment/proc-install-rhdh-on-ocp-in-a-partially-disconnected-environment-with-the-helm-chart.adoc b/modules/install_installing-rhdh-in-an-air-gapped-environment/proc-install-rhdh-on-ocp-in-a-partially-disconnected-environment-with-the-helm-chart.adoc
@@ -63,7 +63,8 @@ where:
 +
 [NOTE]
 ====
-Running the `oc mirror` command generates a local workspace containing the Helm chart, `ImageDigestMirrorSet` (IDMS) and `ImageTagMirrorSet` (ITMS) manifests. The IDMS and ITMS manifests contain files that you must apply against the cluster in a later step.
+. The `--v2` flag is required for {ocp-short} 4.21 and later.
+. Running the `oc mirror` command generates a local workspace containing the Helm chart, `ImageDigestMirrorSet` (IDMS) and `ImageTagMirrorSet` (ITMS) manifests. The IDMS and ITMS manifests contain files that you must apply against the cluster in a later step.
 ====
 +
 . In your workspace, locate the `ImageDigestMirrorSet` (IDMS) and `ImageTagMirrorSet` (ITMS) files by running the `ls` command. For example:

Original file line number	Diff line number	Diff line change
`@@ -14,7 +14,7 @@ include::snip-installing-the-orchestrator-common-prerequisites.adoc[]`
`14`	`14`
`15`	`15`	`.Procedure`
`16`	`16`
`17`		-. Create an `ImageSetConfiguration.yaml` file for `oc-mirror`. You must use an `ImageSetConfiguration` file to include all mirrored images required, as shown in the following example:
	`17`	+. Create an `ImageSetConfiguration.yaml` file for `oc mirror`. You must use an `ImageSetConfiguration` file to include all mirrored images required, as shown in the following example:
`18`	`18`	`+`
`19`	`19`	`[source,yaml,subs="+attributes,+quotes"]`
`20`	`20`	`----`
`@@ -76,16 +76,17 @@ unpack "registry.access.redhat.com/rhdh/plugin-catalog-index:{product-version}"`
`76`	`76`	# you can then find the `dynamic-plugins.default.yaml` under /tmp/registry.access.redhat.com/rhdh/plugin-catalog-index_{product-version}/dynamic-plugins.default.yaml
`77`	`77`	`----`
`78`	`78`
`79`		-. Mirror the images in the `ImageSetConfiguration.yaml` file by running the `oc-mirror` command. For example:
	`79`	+. Mirror the images in the `ImageSetConfiguration.yaml` file by running the `oc mirror` command. For example:
`80`	`80`	`+`
`81`	`81`	`[source,terminal,subs="+attributes,+quotes"]`
`82`	`82`	`----`
`83`		`-$ oc-mirror --config=ImageSetConfiguration.yaml file:///path/to/mirror-archive --authfile /path/to/authfile --v2`
	`83`	`+$ oc mirror --config=ImageSetConfiguration.yaml file:///path/to/mirror-archive --authfile /path/to/authfile --v2`
`84`	`84`	`----`
`85`	`85`	`+`
`86`	`86`	`[NOTE]`
`87`	`87`	`====`
`88`		-The `oc-mirror` command pulls the charts listed in the `ImageSetConfiguration` file and makes them available as `tgz` archives under the `/path/to/mirror-archive` directory.
	`88`	+. The `--v2` flag is required for {ocp-short} 4.21 and later.
	`89`	+. The `oc mirror` command pulls the charts listed in the `ImageSetConfiguration` file and makes them available as `tgz` archives under the `/path/to/mirror-archive` directory.
`89`	`90`	`====`
`90`	`91`	`+`
`91`	`92`	`. Apply the cluster-wide resources generated during the push step to redirect all image pulls to your local registry, as shown in the following example:`
`@@ -102,7 +103,7 @@ $ oc apply -f .`
`102`	`103`	`+`
`103`	`104`	`[source,terminal,subs="+attributes,+quotes"]`
`104`	`105`	`----`
`105`		`-$ oc-mirror --v2 --from <mirror-archive-file> docker://<target-registry-url:port> --workspace file://<workspace folder> --authfile /path/to/authfile`
	`106`	`+$ oc mirror --v2 --from <mirror-archive-file> docker://<target-registry-url:port> --workspace file://<workspace folder> --authfile /path/to/authfile`
`106`	`107`	`----`
`107`	`108`	`+`
`108`	`109`	`where:`
Original file line number	Diff line number	Diff line change
`@@ -18,7 +18,7 @@ include::snip-installing-the-orchestrator-common-prerequisites.adoc[]`
`18`	`18`
`19`	`19`	`.Procedure`
`20`	`20`
`21`		-. Create an `ImageSetConfiguration` file for `oc-mirror`. You must include the images and operators required by the Serverless Logic Operator in the `ImageSetConfiguration` file, as shown in the following example:
	`21`	+. Create an `ImageSetConfiguration` file for `oc mirror`. You must include the images and operators required by the Serverless Logic Operator in the `ImageSetConfiguration` file, as shown in the following example:
`22`	`22`	`+`
`23`	`23`	`[source,yaml,subs="+attributes,+quotes"]`
`24`	`24`	`----`
`@@ -71,16 +71,17 @@ unpack "registry.access.redhat.com/rhdh/plugin-catalog-index:{product-version)"`
`71`	`71`	# you can then find the `dynamic-plugins.default.yaml` under /tmp/registry.access.redhat.com/rhdh/plugin-catalog-index_{product-version)/dynamic-plugins.default.yaml
`72`	`72`	`----`
`73`	`73`
`74`		-. Mirror the images in the `ImageSetConfiguration.yaml` file by running the `oc-mirror` command. For example:
	`74`	+. Mirror the images in the `ImageSetConfiguration.yaml` file by running the `oc mirror` command. For example:
`75`	`75`	`+`
`76`	`76`	`[source,terminal,subs="+attributes,+quotes"]`
`77`	`77`	`----`
`78`		`-$ oc-mirror --config=ImageSetConfiguration.yaml file:///path/to/mirror-archive --authfile /path/to/authfile --v2`
	`78`	`+$ oc mirror --config=ImageSetConfiguration.yaml file:///path/to/mirror-archive --authfile /path/to/authfile --v2`
`79`	`79`	`----`
`80`	`80`	`+`
`81`	`81`	`[NOTE]`
`82`	`82`	`====`
`83`		-The `oc-mirror` command generates a local workspace containing the mirror archive files and the required cluster manifests.
	`83`	+. The `--v2` flag is required for {ocp-short} 4.21 and later.
	`84`	+. The `oc mirror` command generates a local workspace containing the mirror archive files and the required cluster manifests.
`84`	`85`	`====`
`85`	`86`	`+`
`86`	`87`	. Transfer the directory specified by `/path/to/mirror-archive` to a bastion host within your disconnected environment.
@@ -89,7 +90,7 @@ The `oc-mirror` command generates a local workspace containing the mirror archiv
`89`	`90`	`+`
`90`	`91`	`[source,yaml,subs="+attributes,+quotes"]`
`91`	`92`	`----`
`92`		`-$ oc-mirror --v2 --from <mirror-archive-file> docker://<target-registry-url:port> --workspace file://<workspace folder> --authfile /path/to/authfile`
	`93`	`+$ oc mirror --v2 --from <mirror-archive-file> docker://<target-registry-url:port> --workspace file://<workspace folder> --authfile /path/to/authfile`
`93`	`94`	`----`
`94`	`95`	`+`
`95`	`96`	`where:`
Original file line number	Diff line number	Diff line change
`@@ -4,4 +4,4 @@`
`4`	`4`
`5`	`5`	`* You have permissions to push OCI images to your internal container registry.`
`6`	`6`
`7`		-* You have installed the {ocp-docs-link}/html-single/disconnected_environments/index#installation-oc-mirror-installing-plugin_about-installing-oc-mirror-v2[`oc-mirror`] tool, with a version corresponding to the version of your {ocp-short} cluster.
	`7`	+* You have installed the {ocp-docs-link}/html-single/disconnected_environments/index#installation-oc-mirror-installing-plugin_about-installing-oc-mirror-v2[`oc mirror`] tool, with a version corresponding to the version of your {ocp-short} cluster.
Original file line number	Diff line number	Diff line change
`@@ -62,11 +62,11 @@ where:`
`62`	`62`	`_<my_pulled_image_location>_/install.sh`:: Enter the downloaded installation script and the absolute path to the directory where you stored it on your system.
`63`	`63`	`--from-dir _<my_pulled_image_location>_`:: Enter the directory where you want to pull all of the necessary images.
`64`	`64`	`--to-registry`:: (Optional) Enter the URL for the target mirror registry where you want to mirror the images.
`65`		-`--use-oc-mirror true`:: Recommended on {ocp-short}: Use the `oc-mirror` {ocp-short} CLI plugin to mirror images.
	`65`	+`--use-oc-mirror true`:: Recommended on {ocp-short}: Use the `oc mirror` {ocp-short} CLI plugin to mirror images.
`66`	`66`	`+`
`67`	`67`	`[IMPORTANT]`
`68`	`68`	`====`
`69`		-If you used `oc-mirror` to mirror the images to disk, you must also use `oc-mirror` to mirror the images from disk due to the folder layout that `oc-mirror` uses.
	`69`	+If you used `oc mirror` to mirror the images to disk, you must also use `oc mirror` to mirror the images from disk due to the folder layout that `oc mirror` uses.
`70`	`70`	`====`
`71`	`71`	`+`
`72`	`72`	`[NOTE]`
Original file line number	Diff line number	Diff line change
`@@ -42,7 +42,7 @@ mirror:`
`42`	`42`	`where:`
`43`	`43`	`version: "{product-version}"`:: Enter the {product} version to mirror.
`44`	`44`
`45`		-. Mirror the resources specified in the `ImageSetConfiguration.yaml` file by running the `oc-mirror` command. For example:
	`45`	+. Mirror the resources specified in the `ImageSetConfiguration.yaml` file by running the `oc mirror` command. For example:
`46`	`46`	`+`
`47`	`47`	`[source,terminal,subs="+quotes"]`
`48`	`48`	`----`
`@@ -59,7 +59,8 @@ where:`
`59`	`59`	`+`
`60`	`60`	`[NOTE]`
`61`	`61`	`====`
`62`		-Running the `oc-mirror` command generates a local workspace containing the mirror archive file, the Helm chart, `ImageDigestMirrorSet` (IDMS) and `ImageTagMirrorSet` (ITMS) manifests. The IDMS and ITMS manifests contain files that you must apply against the cluster in a later step.
	`62`	+. The `--v2` flag is required for {ocp-short} 4.21 and later.
	`63`	+. Running the `oc mirror` command generates a local workspace containing the mirror archive file, the Helm chart, `ImageDigestMirrorSet` (IDMS) and `ImageTagMirrorSet` (ITMS) manifests. The IDMS and ITMS manifests contain files that you must apply against the cluster in a later step.
`63`	`64`	`====`
`64`	`65`	`+`
`65`	`66`	`Example output:`
`@@ -75,7 +76,7 @@ Creating archive /path/to/mirror-archive/mirror_seq1_000000.tar`
`75`	`76`	`. The local target registry`
`76`	`77`	`. The target {ocp-short} cluster`
`77`	`78`	`+`
`78`		-. From your air-gapped environment, mirror the resources from the archive to the target registry by running the `oc-mirror` command. For example:
	`79`	+. From your air-gapped environment, mirror the resources from the archive to the target registry by running the `oc mirror` command. For example:
`79`	`80`	`+`
`80`	`81`	`[source,terminal,subs="+quotes"]`
`81`	`82`	`----`
Original file line number	Diff line number	Diff line change
`@@ -63,7 +63,8 @@ where:`
`63`	`63`	`+`
`64`	`64`	`[NOTE]`
`65`	`65`	`====`
`66`		-Running the `oc mirror` command generates a local workspace containing the Helm chart, `ImageDigestMirrorSet` (IDMS) and `ImageTagMirrorSet` (ITMS) manifests. The IDMS and ITMS manifests contain files that you must apply against the cluster in a later step.
	`66`	+. The `--v2` flag is required for {ocp-short} 4.21 and later.
	`67`	+. Running the `oc mirror` command generates a local workspace containing the Helm chart, `ImageDigestMirrorSet` (IDMS) and `ImageTagMirrorSet` (ITMS) manifests. The IDMS and ITMS manifests contain files that you must apply against the cluster in a later step.
`67`	`68`	`====`
`68`	`69`	`+`
`69`	`70`	. In your workspace, locate the `ImageDigestMirrorSet` (IDMS) and `ImageTagMirrorSet` (ITMS) files by running the `ls` command. For example: