diff --git a/_topic_maps/_topic_map.yml b/_topic_maps/_topic_map.yml index 0626a98881a1..20b8448c9649 100644 --- a/_topic_maps/_topic_map.yml +++ b/_topic_maps/_topic_map.yml @@ -124,22 +124,18 @@ Topics: File: about - Name: Converting a connected cluster to a disconnected cluster File: connected-to-disconnected -- Name: Mirroring in disconnected environments - Dir: mirroring - Distros: openshift-origin,openshift-enterprise - Topics: - - Name: About disconnected installation mirroring - File: index - - Name: Creating a mirror registry with mirror registry for Red Hat OpenShift - File: installing-mirroring-creating-registry - - Name: Mirroring images for a disconnected installation using oc-mirror plugin v2 - File: about-installing-oc-mirror-v2 - - Name: Migrating from oc-mirror plugin v1 to v2 - File: oc-mirror-migration-v1-to-v2 - - Name: Mirroring images for a disconnected installation using the oc-mirror plugin v1 - File: installing-mirroring-disconnected - - Name: Mirroring images for a disconnected installation by using the oc adm command - File: installing-mirroring-installation-images +- Name: About disconnected installation mirroring + File: index +- Name: Creating a mirror registry with mirror registry for Red Hat OpenShift + File: installing-mirroring-creating-registry +- Name: Mirroring images for a disconnected installation using oc-mirror plugin v2 + File: about-installing-oc-mirror-v2 +- Name: Migrating from oc-mirror plugin v1 to v2 + File: oc-mirror-migration-v1-to-v2 +- Name: Mirroring images for a disconnected installation using the oc-mirror plugin v1 + File: installing-mirroring-disconnected +- Name: Mirroring images for a disconnected installation by using the oc adm command + File: installing-mirroring-installation-images - Name: Installing a cluster in a disconnected environment File: installing - Name: Using OLM in disconnected environments diff --git a/cicd/pipelines/creating-applications-with-cicd-pipelines.adoc b/cicd/pipelines/creating-applications-with-cicd-pipelines.adoc index e3624f23b49d..f1262326b98c 100644 --- a/cicd/pipelines/creating-applications-with-cicd-pipelines.adoc +++ b/cicd/pipelines/creating-applications-with-cicd-pipelines.adoc @@ -51,7 +51,7 @@ include::modules/op-mirroring-images-to-run-pipelines-in-restricted-environment. * xref:../../openshift_images/configuring-samples-operator.adoc#samples-operator-restricted-network-install[Configuring Samples Operator for a restricted cluster] -* xref:../../disconnected/mirroring/installing-mirroring-installation-images.adoc#installation-about-mirror-registry_installing-mirroring-installation-images[Creating a cluster with a mirrored registry] +* xref:../../disconnected/installing-mirroring-installation-images.adoc#installation-about-mirror-registry_installing-mirroring-installation-images[Creating a cluster with a mirrored registry] include::modules/op-running-a-pipeline.adoc[leveloffset=+1] diff --git a/cicd/pipelines/installing-pipelines.adoc b/cicd/pipelines/installing-pipelines.adoc index dc9955b6c15a..a37f2e453074 100644 --- a/cicd/pipelines/installing-pipelines.adoc +++ b/cicd/pipelines/installing-pipelines.adoc @@ -54,5 +54,5 @@ include::modules/op-performance-tuning-using-tektonconfig-cr.adoc[leveloffset=+1 ** xref:../../openshift_images/configuring-samples-operator.adoc#samples-operator-restricted-network-install[Configuring Samples Operator for a restricted cluster] -** xref:../../disconnected/mirroring/installing-mirroring-installation-images.adoc#installation-about-mirror-registry_installing-mirroring-installation-images[Creating a cluster with a mirrored registry] +** xref:../../disconnected/installing-mirroring-installation-images.adoc#installation-about-mirror-registry_installing-mirroring-installation-images[Creating a cluster with a mirrored registry] diff --git a/cli_reference/opm/cli-opm-ref.adoc b/cli_reference/opm/cli-opm-ref.adoc index 4c6bb6e96a9e..9576bfeb983b 100644 --- a/cli_reference/opm/cli-opm-ref.adoc +++ b/cli_reference/opm/cli-opm-ref.adoc @@ -44,7 +44,7 @@ ifndef::openshift-rosa,openshift-rosa-hcp,openshift-dedicated[] * xref:../../operators/understanding/olm-packaging-format.adoc#olm-file-based-catalogs_olm-packaging-format[Operator Framework packaging format] * xref:../../operators/admin/olm-managing-custom-catalogs.adoc#olm-managing-custom-catalogs-fb[Managing custom catalogs] -* xref:../../disconnected/mirroring/installing-mirroring-disconnected.adoc#installing-mirroring-disconnected[Mirroring images for a disconnected installation using the oc-mirror plugin] +* xref:../../disconnected/installing-mirroring-disconnected.adoc#installing-mirroring-disconnected[Mirroring images for a disconnected installation using the oc-mirror plugin] endif::openshift-rosa,openshift-rosa-hcp,openshift-dedicated[] include::modules/opm-cli-ref-init.adoc[leveloffset=+1] diff --git a/disconnected/mirroring/about-installing-oc-mirror-v2.adoc b/disconnected/about-installing-oc-mirror-v2.adoc similarity index 73% rename from disconnected/mirroring/about-installing-oc-mirror-v2.adoc rename to disconnected/about-installing-oc-mirror-v2.adoc index f8b325be5f2a..003ce0d91e06 100644 --- a/disconnected/mirroring/about-installing-oc-mirror-v2.adoc +++ b/disconnected/about-installing-oc-mirror-v2.adoc @@ -50,7 +50,7 @@ include::modules/oc-mirror-building-image-set-config-v2.adoc[leveloffset=+2] [role="_additional-resources"] .Additional resources -* xref:../../updating/understanding_updates/intro-to-updates.adoc#update-service-about_understanding-openshift-updates[About the OpenShift Update Service] +* xref:../updating/understanding_updates/intro-to-updates.adoc#update-service-about_understanding-openshift-updates[About the OpenShift Update Service] //Mirroring an image set in a partially disconnected environment include::modules/oc-mirror-workflows-partially-disconnected-v2.adoc[leveloffset=+2] @@ -66,13 +66,13 @@ include::modules/oc-mirror-IDMS-ITMS-about.adoc[leveloffset=+1] [role="_additional-resources"] .Additional resources -* xref:../../rest_api/operatorhub_apis/catalogsource-operators-coreos-com-v1alpha1.html[CatalogSource] +* xref:../rest_api/operatorhub_apis/catalogsource-operators-coreos-com-v1alpha1.html[CatalogSource] -* xref:../../rest_api/config_apis/imagedigestmirrorset-config-openshift-io-v1.adoc#imagedigestmirrorset-config-openshift-io-v1[ImageDigestMirrorSet] +* xref:../rest_api/config_apis/imagedigestmirrorset-config-openshift-io-v1.adoc#imagedigestmirrorset-config-openshift-io-v1[ImageDigestMirrorSet] -* xref:../../rest_api/config_apis/imagetagmirrorset-config-openshift-io-v1.adoc#imagetagmirrorset-config-openshift-io-v1[ImageTagMirrorSet] +* xref:../rest_api/config_apis/imagetagmirrorset-config-openshift-io-v1.adoc#imagetagmirrorset-config-openshift-io-v1[ImageTagMirrorSet] -* xref:../../extensions/catalogs/managing-catalogs.adoc#olmv1-about-catalogs_managing-catalogs[About catalogs in {olmv1}] +* xref:../extensions/catalogs/managing-catalogs.adoc#olmv1-about-catalogs_managing-catalogs[About catalogs in {olmv1}] // Restrictions on modifying oc-mirror-generated resources include::modules/oc-mirror-restricted-fields.adoc[leveloffset=+2] @@ -80,19 +80,19 @@ include::modules/oc-mirror-restricted-fields.adoc[leveloffset=+2] // Configuring your cluster to use the resources generated by oc-mirror include::modules/oc-mirror-updating-cluster-manifests-v2.adoc[leveloffset=+2] -After your cluster is configured to use the resources generated by oc-mirror plugin v2, see xref:../../disconnected/mirroring/about-installing-oc-mirror-v2.adoc#next-steps_about-installing-oc-mirror-v2[Next steps] for information about tasks that you can perform using your mirrored images. +After your cluster is configured to use the resources generated by oc-mirror plugin v2, see xref:../disconnected/about-installing-oc-mirror-v2.adoc#next-steps_about-installing-oc-mirror-v2[Next steps] for information about tasks that you can perform using your mirrored images. [role="_additional-resources"] .Additional resources -* xref:../../extensions/catalogs/disconnected-catalogs.adoc#disconnected-catalogs[Disconnected environment support in {olmv1}] +* xref:../extensions/catalogs/disconnected-catalogs.adoc#disconnected-catalogs[Disconnected environment support in {olmv1}] // Deletion of images from your disconnected environment include::modules/oc-mirror-workflows-delete-v2.adoc[leveloffset=+1] [role="_additional-resources"] .Additional resources -* xref:../../disconnected/mirroring/about-installing-oc-mirror-v2.adoc#oc-mirror-v2-procedure-garbage-collector_about-installing-oc-mirror-v2[Resolving storage cleanup issues in the distribution registry] +* xref:../disconnected/about-installing-oc-mirror-v2.adoc#oc-mirror-v2-procedure-garbage-collector_about-installing-oc-mirror-v2[Resolving storage cleanup issues in the distribution registry] include::modules/oc-mirror-v2-procedure-garbage-collector.adoc[leveloffset=+2] @@ -119,8 +119,8 @@ include::modules/oc-mirror-proxy-support.adoc[leveloffset=+1] [role="_additional-resources"] .Additional resources -* xref:../../disconnected/updating/disconnected-update-osus.adoc#updating-disconnected-cluster-osus[Updating a cluster in a disconnected environment using the OpenShift Update Service] -* xref:../../disconnected/mirroring/about-installing-oc-mirror-v2.adoc#oc-mirror-v2-procedure-garbage-collector_about-installing-oc-mirror-v2[Resolving storage cleanup issues in the distribution registry] +* xref:../disconnected/updating/disconnected-update-osus.adoc#updating-disconnected-cluster-osus[Updating a cluster in a disconnected environment using the OpenShift Update Service] +* xref:../disconnected/about-installing-oc-mirror-v2.adoc#oc-mirror-v2-procedure-garbage-collector_about-installing-oc-mirror-v2[Resolving storage cleanup issues in the distribution registry] //signature mirroring include::modules/oc-mirror-signature-mirroring.adoc[leveloffset=+1] @@ -140,15 +140,15 @@ include::modules/oc-mirror-about-cache-and-workspace-dirs.adoc[leveloffset=+2] [role="_additional-resources"] .Additional resources -* xref:../../disconnected/mirroring/about-installing-oc-mirror-v2.adoc#oc-mirror-updating-cluster-manifests-v2_about-installing-oc-mirror-v2[Configuring your cluster to use the resources generated by oc-mirror] +* xref:../disconnected/about-installing-oc-mirror-v2.adoc#oc-mirror-updating-cluster-manifests-v2_about-installing-oc-mirror-v2[Configuring your cluster to use the resources generated by oc-mirror] [id="next-steps_{context}"] == Next steps After you mirror images to your disconnected environment using oc-mirror plugin v2, you can perform any of the following actions: -* xref:../../disconnected/installing.adoc#installing-disconnected-environments[Installing a cluster in a disconnected environment] -* xref:../../disconnected/using-olm.adoc#olm-restricted-networks[Using Operator Lifecycle Manager in disconnected environments] -* xref:../../disconnected/updating/disconnected-update-osus.adoc#updating-disconnected-cluster-osus[Updating a cluster in a disconnected environment using the OpenShift Update Service] +* xref:../disconnected/installing.adoc#installing-disconnected-environments[Installing a cluster in a disconnected environment] +* xref:../disconnected/using-olm.adoc#olm-restricted-networks[Using Operator Lifecycle Manager in disconnected environments] +* xref:../disconnected/updating/disconnected-update-osus.adoc#updating-disconnected-cluster-osus[Updating a cluster in a disconnected environment using the OpenShift Update Service] // Intentionally linking to the OSUS update procedure since we probably want to steer users to do that workflow as much as possible. But I can change to the index of the update section if I shouldn't be as prescriptive. diff --git a/disconnected/about.adoc b/disconnected/about.adoc index 733428a8892a..9fc8abe1e85a 100644 --- a/disconnected/about.adoc +++ b/disconnected/about.adoc @@ -54,7 +54,7 @@ However, some options provide a simpler and more convenient user experience for Unless your organizational needs require you to choose another option, use the following methods for mirroring images, installing your cluster, and updating your cluster: -* Mirror your images using the xref:../disconnected/mirroring/about-installing-oc-mirror-v2.adoc#about-installing-oc-mirror-v2[oc-mirror plugin v2]. +* Mirror your images using the xref:../disconnected/about-installing-oc-mirror-v2.adoc#about-installing-oc-mirror-v2[oc-mirror plugin v2]. * Install your cluster using the xref:../installing/installing_with_agent_based_installer/installing-with-agent-based-installer.adoc#installing-with-agent-based-installer[Agent-based Installer]. diff --git a/disconnected/mirroring/index.adoc b/disconnected/index.adoc similarity index 100% rename from disconnected/mirroring/index.adoc rename to disconnected/index.adoc diff --git a/disconnected/mirroring/installing-mirroring-creating-registry.adoc b/disconnected/installing-mirroring-creating-registry.adoc similarity index 84% rename from disconnected/mirroring/installing-mirroring-creating-registry.adoc rename to disconnected/installing-mirroring-creating-registry.adoc index f7172efe4d95..b92f229b58f2 100644 --- a/disconnected/mirroring/installing-mirroring-creating-registry.adoc +++ b/disconnected/installing-mirroring-creating-registry.adoc @@ -8,7 +8,7 @@ toc::[] The _mirror registry for Red{nbsp}Hat OpenShift_ is a small and streamlined container registry that you can use as a target for mirroring the required container images of {product-title} for disconnected installations. -If you already have a container image registry, such as link:https://www.redhat.com/en/technologies/cloud-computing/quay[{quay}], you can skip this section and go straight to xref:../../disconnected/mirroring/installing-mirroring-installation-images.adoc#installation-mirror-repository_installing-mirroring-installation-images[Mirroring the {product-title} image repository]. +If you already have a container image registry, such as link:https://www.redhat.com/en/technologies/cloud-computing/quay[{quay}], you can skip this section and go straight to xref:../disconnected/installing-mirroring-installation-images.adoc#installation-mirror-repository_installing-mirroring-installation-images[Mirroring the {product-title} image repository]. [IMPORTANT] ==== @@ -57,6 +57,6 @@ include::modules/mirror-registry-troubleshooting.adoc[leveloffset=+1] * link:https://docs.redhat.com/en/documentation/red_hat_quay/3/html-single/securing_red_hat_quay/index#configuring-system-trust-ca[Configuring the system to trust the certificate authority] -* xref:../../disconnected/mirroring/installing-mirroring-installation-images.adoc#installation-mirror-repository_installing-mirroring-installation-images[Mirroring the {product-title} image repository] +* xref:../disconnected/installing-mirroring-installation-images.adoc#installation-mirror-repository_installing-mirroring-installation-images[Mirroring the {product-title} image repository] -* xref:../../disconnected/mirroring/installing-mirroring-installation-images.adoc#olm-mirror-catalog_installing-mirroring-installation-images[Mirroring Operator catalogs for use with disconnected clusters] +* xref:../disconnected/installing-mirroring-installation-images.adoc#olm-mirror-catalog_installing-mirroring-installation-images[Mirroring Operator catalogs for use with disconnected clusters] diff --git a/disconnected/mirroring/installing-mirroring-disconnected.adoc b/disconnected/installing-mirroring-disconnected.adoc similarity index 58% rename from disconnected/mirroring/installing-mirroring-disconnected.adoc rename to disconnected/installing-mirroring-disconnected.adoc index 17a0e0abe524..5e899e163dd7 100644 --- a/disconnected/mirroring/installing-mirroring-disconnected.adoc +++ b/disconnected/installing-mirroring-disconnected.adoc @@ -6,13 +6,13 @@ include::_attributes/common-attributes.adoc[] toc::[] -Running your cluster in a restricted network without direct internet connectivity is possible by installing the cluster from a mirrored set of {product-title} container images in a private registry. This registry must be running at all times as long as the cluster is running. See the xref:../../disconnected/mirroring/installing-mirroring-disconnected.adoc#prerequisites_installing-mirroring-disconnected[Prerequisites] section for more information. +Running your cluster in a restricted network without direct internet connectivity is possible by installing the cluster from a mirrored set of {product-title} container images in a private registry. This registry must be running at all times as long as the cluster is running. See the xref:../disconnected/installing-mirroring-disconnected.adoc#prerequisites_installing-mirroring-disconnected[Prerequisites] section for more information. You can use the oc-mirror OpenShift CLI (`oc`) plugin to mirror images to a mirror registry in your fully or partially disconnected environments. You must run oc-mirror from a system with internet connectivity in order to download the required images from the official Red Hat registries. [IMPORTANT] ==== -The oc-mirror v1 plugin is deprecated. To prevent failures in a future release, specify the `--v1` flag to continue using the v1 plugin, or migrate to the supported v2 plugin and use the `--v2` flag. Transition to the xref:../../disconnected/mirroring/about-installing-oc-mirror-v2.adoc#installation-oc-mirror-v2-about_about-installing-oc-mirror-v2[oc-mirror v2 plugin] for continued support and improvements. +The oc-mirror v1 plugin is deprecated. To prevent failures in a future release, specify the `--v1` flag to continue using the v1 plugin, or migrate to the supported v2 plugin and use the `--v2` flag. Transition to the xref:../disconnected/about-installing-oc-mirror-v2.adoc#installation-oc-mirror-v2-about_about-installing-oc-mirror-v2[oc-mirror v2 plugin] for continued support and improvements. ==== // About the oc-mirror plugin @@ -24,7 +24,7 @@ include::modules/oc-mirror-support.adoc[leveloffset=+1] [role="_additional-resources"] .Additional resources -* For information on updating oc-mirror, see xref:../../installing/validation_and_troubleshooting/validating-an-installation.adoc#viewing-the-image-pull-source_validating-an-installation[Viewing the image pull source]. +* For information on updating oc-mirror, see xref:../installing/validation_and_troubleshooting/validating-an-installation.adoc#viewing-the-image-pull-source_validating-an-installation[Viewing the image pull source]. // About the mirror registry include::modules/installation-about-mirror-registry.adoc[leveloffset=+1] @@ -32,7 +32,7 @@ include::modules/installation-about-mirror-registry.adoc[leveloffset=+1] [role="_additional-resources"] .Additional resources -* For information about viewing the CRI-O logs to view the image source, see xref:../../installing/validation_and_troubleshooting/validating-an-installation.adoc#viewing-the-image-pull-source_validating-an-installation[Viewing the image pull source]. +* xref:../installing/validation_and_troubleshooting/validating-an-installation.adoc#viewing-the-image-pull-source_validating-an-installation[Viewing the image pull source]. [id="prerequisites_installing-mirroring-disconnected"] == Prerequisites @@ -44,7 +44,7 @@ include::modules/installation-about-mirror-registry.adoc[leveloffset=+1] If you use {quay}, you must use version 3.6 or later with the oc-mirror plugin. If you have an entitlement to {quay}, see the documentation on deploying {quay} link:https://docs.redhat.com/en/documentation/red_hat_quay/3/html/proof_of_concept_-_deploying_red_hat_quay/index[for proof-of-concept purposes] or link:https://access.redhat.com/documentation/en-us/red_hat_quay/3/html/deploying_the_red_hat_quay_operator_on_openshift_container_platform/index[by using the {quay} Operator]. If you need additional assistance selecting and installing a registry, contact your sales representative or Red Hat Support. ==== + -If you do not already have an existing solution for a container image registry, subscribers of {product-title} are provided a xref:../../disconnected/mirroring/installing-mirroring-creating-registry.adoc#installing-mirroring-creating-registry[mirror registry for Red Hat OpenShift]. The _mirror registry for Red{nbsp}Hat OpenShift_ is included with your subscription and is a small-scale container registry that can be used to mirror the required container images of {product-title} in disconnected installations. +If you do not already have an existing solution for a container image registry, subscribers of {product-title} are provided a xref:../disconnected/installing-mirroring-creating-registry.adoc#installing-mirroring-creating-registry[mirror registry for Red Hat OpenShift]. The _mirror registry for Red{nbsp}Hat OpenShift_ is included with your subscription and is a small-scale container registry that can be used to mirror the required container images of {product-title} in disconnected installations. [id="mirroring-preparing-your-hosts"] == Preparing your mirror hosts @@ -57,7 +57,7 @@ include::modules/oc-mirror-installing-plugin.adoc[leveloffset=+2] [role="_additional-resources"] .Additional resources -* xref:../../cli_reference/openshift_cli/extending-cli-plugins.adoc#cli-installing-plugins_cli-extend-plugins[Installing and using CLI plugins] +* xref:../cli_reference/openshift_cli/extending-cli-plugins.adoc#cli-installing-plugins_cli-extend-plugins[Installing and using CLI plugins] // Configuring credentials that allow images to be mirrored include::modules/installation-adding-registry-pull-secret.adoc[leveloffset=+2] @@ -68,14 +68,14 @@ include::modules/oc-mirror-creating-image-set-config.adoc[leveloffset=+1] [role="_additional-resources"] .Additional resources -* xref:../../disconnected/mirroring/installing-mirroring-disconnected.adoc#oc-mirror-imageset-config-params_installing-mirroring-disconnected[Image set configuration parameters] -* xref:../../disconnected/mirroring/installing-mirroring-disconnected.adoc#oc-mirror-image-set-examples_installing-mirroring-disconnected[Image set configuration examples] -* xref:../../disconnected/updating/disconnected-update-osus.adoc#updating-disconnected-cluster-osus[Using the OpenShift Update Service in a disconnected environment] +* xref:../disconnected/installing-mirroring-disconnected.adoc#oc-mirror-imageset-config-params_installing-mirroring-disconnected[Image set configuration parameters] +* xref:../disconnected/installing-mirroring-disconnected.adoc#oc-mirror-image-set-examples_installing-mirroring-disconnected[Image set configuration examples] +* xref:../disconnected/updating/disconnected-update-osus.adoc#updating-disconnected-cluster-osus[Using the OpenShift Update Service in a disconnected environment] [id="mirroring-image-set"] == Mirroring an image set to a mirror registry -You can use the oc-mirror CLI plugin to mirror images to a mirror registry in a xref:../../disconnected/mirroring/installing-mirroring-disconnected.adoc#mirroring-image-set-partial[partially disconnected environment] or in a xref:../../disconnected/mirroring/installing-mirroring-disconnected.adoc#mirroring-image-set-full[fully disconnected environment]. +You can use the oc-mirror CLI plugin to mirror images to a mirror registry in a xref:../disconnected/installing-mirroring-disconnected.adoc#mirroring-image-set-partial[partially disconnected environment] or in a xref:../disconnected/installing-mirroring-disconnected.adoc#mirroring-image-set-full[fully disconnected environment]. These procedures assume that you already have your mirror registry set up. @@ -90,7 +90,7 @@ include::modules/oc-mirror-mirror-to-mirror.adoc[leveloffset=+3] [id="mirroring-image-set-full"] === Mirroring an image set in a fully disconnected environment -To mirror an image set in a fully disconnected environment, you must first xref:../../disconnected/mirroring/installing-mirroring-disconnected.adoc#oc-mirror-mirror-to-disk_installing-mirroring-disconnected[mirror the image set to disk], then xref:../../disconnected/mirroring/installing-mirroring-disconnected.adoc#oc-mirror-disk-to-mirror_installing-mirroring-disconnected[mirror the image set file on disk to a mirror]. +To mirror an image set in a fully disconnected environment, you must first xref:../disconnected/installing-mirroring-disconnected.adoc#oc-mirror-mirror-to-disk_installing-mirroring-disconnected[mirror the image set to disk], then xref:../disconnected/installing-mirroring-disconnected.adoc#oc-mirror-disk-to-mirror_installing-mirroring-disconnected[mirror the image set file on disk to a mirror]. // Mirroring from mirror to disk include::modules/oc-mirror-mirror-to-disk.adoc[leveloffset=+3] @@ -104,7 +104,7 @@ include::modules/oc-mirror-updating-cluster-manifests.adoc[leveloffset=+1] [role="_additional-resources"] .Additional resources -* xref:../../extensions/catalogs/managing-catalogs.adoc#olmv1-adding-a-catalog-to-a-cluster_managing-catalogs[Adding a catalog to a cluster] in "Extensions" +* xref:../extensions/catalogs/managing-catalogs.adoc#olmv1-adding-a-catalog-to-a-cluster_managing-catalogs[Adding a catalog to a cluster] in "Extensions" // About updating your mirror registry content include::modules/oc-mirror-updating-registry-about.adoc[leveloffset=+1] @@ -114,10 +114,10 @@ include::modules/oc-mirror-updating-use-cases.adoc[leveloffset=+2] [role="_additional-resources"] .Additional resources -* xref:../../disconnected/mirroring/installing-mirroring-disconnected.adoc#oc-mirror-image-set-examples_installing-mirroring-disconnected[Image set configuration examples] -* xref:../../disconnected/mirroring/installing-mirroring-disconnected.adoc#mirroring-image-set-partial[Mirroring an image set in a partially disconnected environment] -* xref:../../disconnected/mirroring/installing-mirroring-disconnected.adoc#mirroring-image-set-full[Mirroring an image set in a fully disconnected environment] -* xref:../../disconnected/mirroring/installing-mirroring-disconnected.adoc#oc-mirror-updating-cluster-manifests_installing-mirroring-disconnected[Configuring your cluster to use the resources generated by oc-mirror] +* xref:../disconnected/installing-mirroring-disconnected.adoc#oc-mirror-image-set-examples_installing-mirroring-disconnected[Image set configuration examples] +* xref:../disconnected/installing-mirroring-disconnected.adoc#mirroring-image-set-partial[Mirroring an image set in a partially disconnected environment] +* xref:../disconnected/installing-mirroring-disconnected.adoc#mirroring-image-set-full[Mirroring an image set in a fully disconnected environment] +* xref:../disconnected/installing-mirroring-disconnected.adoc#oc-mirror-updating-cluster-manifests_installing-mirroring-disconnected[Configuring your cluster to use the resources generated by oc-mirror] // Performing a dry run include::modules/oc-mirror-dry-run.adoc[leveloffset=+1] @@ -129,7 +129,7 @@ include::modules/oc-mirror-oci-format.adoc[leveloffset=+1] .Additional resources // TODO: This title might need to update per sebastian's PR -* xref:../../disconnected/mirroring/installing-mirroring-disconnected.adoc#oc-mirror-updating-cluster-manifests_installing-mirroring-disconnected[Configuring your cluster to use the resources generated by oc-mirror] +* xref:../disconnected/installing-mirroring-disconnected.adoc#oc-mirror-updating-cluster-manifests_installing-mirroring-disconnected[Configuring your cluster to use the resources generated by oc-mirror] // Image set configuration parameters include::modules/oc-mirror-imageset-config-params.adoc[leveloffset=+1] @@ -144,4 +144,4 @@ include::modules/oc-mirror-command-reference.adoc[leveloffset=+1] [id="additional-resources_installing-mirroring-disconnected"] == Additional resources -* xref:../../disconnected/updating/index.adoc#about-disconnected-updates[About cluster updates in a disconnected environment] +* xref:../disconnected/updating/index.adoc#about-disconnected-updates[About cluster updates in a disconnected environment] diff --git a/disconnected/mirroring/installing-mirroring-installation-images.adoc b/disconnected/installing-mirroring-installation-images.adoc similarity index 74% rename from disconnected/mirroring/installing-mirroring-installation-images.adoc rename to disconnected/installing-mirroring-installation-images.adoc index 66e5b44a86a9..7e779b426f39 100644 --- a/disconnected/mirroring/installing-mirroring-installation-images.adoc +++ b/disconnected/installing-mirroring-installation-images.adoc @@ -17,7 +17,7 @@ You can ensure your clusters only use container images that satisfy your organiz You must have access to the internet to obtain the necessary container images. In this procedure, you place your mirror registry on a mirror host that has access to both your network and the internet. If you do not have access -to a mirror host, use the xref:../../disconnected/mirroring/installing-mirroring-installation-images.adoc#olm-mirror-catalog_installing-mirroring-installation-images[Mirroring Operator catalogs for use with disconnected clusters] procedure to copy images to a device you can move across network boundaries with. +to a mirror host, use the xref:../disconnected/installing-mirroring-installation-images.adoc#olm-mirror-catalog_installing-mirroring-installation-images[Mirroring Operator catalogs for use with disconnected clusters] procedure to copy images to a device you can move across network boundaries with. ==== [id="prerequisites_installing-mirroring-installation-images"] @@ -34,13 +34,13 @@ to a mirror host, use the xref:../../disconnected/mirroring/installing-mirroring + If you have an entitlement to {quay}, see the documentation on deploying {quay} link:https://docs.redhat.com/en/documentation/red_hat_quay/3.9/html/deploy_red_hat_quay_for_proof-of-concept_non-production_purposes/index[for proof-of-concept purposes] or link:https://access.redhat.com/documentation/en-us/red_hat_quay/3/html/deploying_the_red_hat_quay_operator_on_openshift_container_platform/index[by using the {quay} Operator]. If you need additional assistance selecting and installing a registry, contact your sales representative or Red Hat Support. -* If you do not already have an existing solution for a container image registry, subscribers of {product-title} are provided a xref:../../disconnected/mirroring/installing-mirroring-creating-registry.adoc#installing-mirroring-creating-registry[mirror registry for Red Hat OpenShift]. The _mirror registry for Red{nbsp}Hat OpenShift_ is included with your subscription and is a small-scale container registry that can be used to mirror the required container images of {product-title} in disconnected installations. +* If you do not already have an existing solution for a container image registry, subscribers of {product-title} are provided a xref:../disconnected/installing-mirroring-creating-registry.adoc#installing-mirroring-creating-registry[mirror registry for Red Hat OpenShift]. The _mirror registry for Red{nbsp}Hat OpenShift_ is included with your subscription and is a small-scale container registry that can be used to mirror the required container images of {product-title} in disconnected installations. include::modules/installation-about-mirror-registry.adoc[leveloffset=+1] .Additional information -For information about viewing the CRI-O logs to view the image source, see xref:../../installing/validation_and_troubleshooting/validating-an-installation.adoc#viewing-the-image-pull-source_validating-an-installation[Viewing the image pull source]. +For information about viewing the CRI-O logs to view the image source, see xref:../installing/validation_and_troubleshooting/validating-an-installation.adoc#viewing-the-image-pull-source_validating-an-installation[Viewing the image pull source]. [id="installing-preparing-mirror"] == Preparing your mirror host @@ -85,7 +85,7 @@ include::modules/olm-mirroring-catalog.adoc[leveloffset=+1] [role="_additional-resources"] .Additional resources -* xref:../../disconnected/using-olm.adoc#olm-restricted-networks[Using Operator Lifecycle Manager in disconnected environments] +* xref:../disconnected/using-olm.adoc#olm-restricted-networks[Using Operator Lifecycle Manager in disconnected environments] [id="olm-mirror-catalog-prerequisites_installing-mirroring-installation-images"] === Prerequisites @@ -95,8 +95,8 @@ Mirroring Operator catalogs for use with disconnected clusters has the following * Workstation with unrestricted network access. * `podman` version 1.9.3 or later. * If you want to filter, or _prune_, an existing catalog and selectively mirror only a subset of Operators, see the following sections: -** xref:../../cli_reference/opm/cli-opm-install.adoc#cli-opm-install[Installing the opm CLI] -** xref:../../operators/admin/olm-managing-custom-catalogs.adoc#olm-filtering-fbc_olm-managing-custom-catalogs[Updating or filtering a file-based catalog image] +** xref:../cli_reference/opm/cli-opm-install.adoc#cli-opm-install[Installing the opm CLI] +** xref:../operators/admin/olm-managing-custom-catalogs.adoc#olm-filtering-fbc_olm-managing-custom-catalogs[Updating or filtering a file-based catalog image] ifndef::openshift-origin[] * If you want to mirror a Red Hat-provided catalog, run the following command on your workstation with unrestricted network access to authenticate with `registry.redhat.io`: + @@ -127,8 +127,8 @@ include::modules/olm-mirroring-catalog-post.adoc[leveloffset=+2] [role="_additional-resources"] .Additional resources -* xref:../../post_installation_configuration/preparing-for-users.adoc#post-install-mirrored-catalogs[Populating the software catalog from mirrored Operator catalogs] -* xref:../../operators/admin/olm-managing-custom-catalogs.adoc#olm-filtering-fbc_olm-managing-custom-catalogs[Updating or filtering a file-based catalog image] +* xref:../post_installation_configuration/preparing-for-users.adoc#post-install-mirrored-catalogs[Populating the software catalog from mirrored Operator catalogs] +* xref:../operators/admin/olm-managing-custom-catalogs.adoc#olm-filtering-fbc_olm-managing-custom-catalogs[Updating or filtering a file-based catalog image] [id="next-steps_installing-mirroring-installation-images"] == Next steps @@ -136,11 +136,11 @@ include::modules/olm-mirroring-catalog-post.adoc[leveloffset=+2] //* TODO need to add the registry secret to the machines, which is different * Install a cluster on infrastructure that you provision in your restricted network, such as on -xref:../../installing/installing_vsphere/upi/installing-restricted-networks-vsphere.adoc#installing-restricted-networks-vsphere[VMware vSphere], -xref:../../installing/installing_bare_metal/upi/installing-restricted-networks-bare-metal.adoc#installing-restricted-networks-bare-metal[bare metal], or xref:../../installing/installing_aws/upi/installing-restricted-networks-aws.adoc#installing-restricted-networks-aws[Amazon Web Services]. +xref:../installing/installing_vsphere/upi/installing-restricted-networks-vsphere.adoc#installing-restricted-networks-vsphere[VMware vSphere], +xref:../installing/installing_bare_metal/upi/installing-restricted-networks-bare-metal.adoc#installing-restricted-networks-bare-metal[bare metal], or xref:../installing/installing_aws/upi/installing-restricted-networks-aws.adoc#installing-restricted-networks-aws[Amazon Web Services]. [role="_additional-resources"] [id="restricted-networks-additional-resources"] == Additional resources -* See xref:../../support/gathering-cluster-data.adoc#gathering-data-specific-features_gathering-cluster-data[Gathering data about specific features] for more information about using must-gather. +* See xref:../support/gathering-cluster-data.adoc#gathering-data-specific-features_gathering-cluster-data[Gathering data about specific features] for more information about using must-gather. diff --git a/disconnected/mirroring/_attributes b/disconnected/mirroring/_attributes deleted file mode 120000 index 20cc1dcb77bf..000000000000 --- a/disconnected/mirroring/_attributes +++ /dev/null @@ -1 +0,0 @@ -../../_attributes/ \ No newline at end of file diff --git a/disconnected/mirroring/images b/disconnected/mirroring/images deleted file mode 120000 index 847b03ed0541..000000000000 --- a/disconnected/mirroring/images +++ /dev/null @@ -1 +0,0 @@ -../../images/ \ No newline at end of file diff --git a/disconnected/mirroring/modules b/disconnected/mirroring/modules deleted file mode 120000 index 36719b9de743..000000000000 --- a/disconnected/mirroring/modules +++ /dev/null @@ -1 +0,0 @@ -../../modules/ \ No newline at end of file diff --git a/disconnected/mirroring/snippets b/disconnected/mirroring/snippets deleted file mode 120000 index 5a3f5add140e..000000000000 --- a/disconnected/mirroring/snippets +++ /dev/null @@ -1 +0,0 @@ -../../snippets/ \ No newline at end of file diff --git a/disconnected/mirroring/oc-mirror-migration-v1-to-v2.adoc b/disconnected/oc-mirror-migration-v1-to-v2.adoc similarity index 52% rename from disconnected/mirroring/oc-mirror-migration-v1-to-v2.adoc rename to disconnected/oc-mirror-migration-v1-to-v2.adoc index c0c5e9b6e7fd..a2d5092f2926 100644 --- a/disconnected/mirroring/oc-mirror-migration-v1-to-v2.adoc +++ b/disconnected/oc-mirror-migration-v1-to-v2.adoc @@ -23,7 +23,7 @@ include::modules/oc-mirror-migration-process.adoc[leveloffset=+1] [id="additional-resources_{context}"] == Additional resources -* xref:../../disconnected/mirroring/about-installing-oc-mirror-v2#oc-mirror-workflows-partially-disconnected-v2_about-installing-oc-mirror-v2[Mirroring an image set in a partially disconnected environment] -* xref:../../disconnected/mirroring/about-installing-oc-mirror-v2#oc-mirror-workflows-fully-disconnected-v2_about-installing-oc-mirror-v2[Mirroring an image set in a fully disconnected environment] -* For details regarding configuration changes, see xref:../../disconnected/mirroring/oc-mirror-migration-v1-to-v2#oc-mirror-migration-differences_oc-mirror-migration-v1-to-v2[Changes from oc-mirror plugin v1 to v2]. -* For more information about deleting images, see xref:../../disconnected/mirroring/about-installing-oc-mirror-v2#oc-mirror-procedure-delete-v2_about-installing-oc-mirror-v2[Deletion of images from your disconnected environment]. +* xref:../disconnected/about-installing-oc-mirror-v2#oc-mirror-workflows-partially-disconnected-v2_about-installing-oc-mirror-v2[Mirroring an image set in a partially disconnected environment] +* xref:../disconnected/about-installing-oc-mirror-v2#oc-mirror-workflows-fully-disconnected-v2_about-installing-oc-mirror-v2[Mirroring an image set in a fully disconnected environment] +* For details regarding configuration changes, see xref:../disconnected/oc-mirror-migration-v1-to-v2#oc-mirror-migration-differences_oc-mirror-migration-v1-to-v2[Changes from oc-mirror plugin v1 to v2]. +* For more information about deleting images, see xref:../disconnected/about-installing-oc-mirror-v2#oc-mirror-procedure-delete-v2_about-installing-oc-mirror-v2[Deletion of images from your disconnected environment]. diff --git a/disconnected/updating/mirroring-image-repository.adoc b/disconnected/updating/mirroring-image-repository.adoc index 6b8cbeec5ee5..8f2a26ba3277 100644 --- a/disconnected/updating/mirroring-image-repository.adoc +++ b/disconnected/updating/mirroring-image-repository.adoc @@ -52,7 +52,7 @@ Compared to using the `oc adm release mirror` command, the oc-mirror plugin has You can use the oc-mirror OpenShift CLI (`oc`) plugin to mirror images to a mirror registry in your fully or partially disconnected environments. You must run oc-mirror from a system with internet connectivity to download the required images from the official Red{nbsp}Hat registries. -See xref:../../disconnected/mirroring/about-installing-oc-mirror-v2.adoc#about-installing-oc-mirror-v2[Mirroring images for a disconnected installation by using the oc-mirror plugin v2] for additional details. +See xref:../../disconnected/about-installing-oc-mirror-v2.adoc#about-installing-oc-mirror-v2[Mirroring images for a disconnected installation by using the oc-mirror plugin v2] for additional details. [id="update-mirror-repository-adm-release-mirror_{context}"] == Mirroring images using the oc adm release mirror command @@ -69,7 +69,7 @@ You can use the `oc adm release mirror` command to mirror images to your mirror If you use {quay}, you must use version 3.6 or later with the oc-mirror plugin. If you have an entitlement to {quay}, see the documentation on deploying {quay} link:https://docs.redhat.com/en/documentation/red_hat_quay/3/html/proof_of_concept_-_deploying_red_hat_quay/index[for proof-of-concept purposes] or link:https://access.redhat.com/documentation/en-us/red_hat_quay/3/html/deploying_the_red_hat_quay_operator_on_openshift_container_platform/index[by using the Quay Operator]. If you need additional assistance selecting and installing a registry, contact your sales representative or Red Hat Support. ==== + -If you do not have an existing solution for a container image registry, the xref:../../disconnected/mirroring/installing-mirroring-creating-registry.adoc#installing-mirroring-creating-registry[mirror registry for Red Hat OpenShift] is included in {product-title} subscriptions. The _mirror registry for Red{nbsp}Hat OpenShift_ is a small-scale container registry that you can use to mirror {product-title} container images in disconnected installations and updates. +If you do not have an existing solution for a container image registry, the xref:../../disconnected/installing-mirroring-creating-registry.adoc#installing-mirroring-creating-registry[mirror registry for Red Hat OpenShift] is included in {product-title} subscriptions. The _mirror registry for Red{nbsp}Hat OpenShift_ is a small-scale container registry that you can use to mirror {product-title} container images in disconnected installations and updates. [id="updating-disconnected-mirror-host_{context}"] === Preparing your mirror host diff --git a/disconnected/using-olm.adoc b/disconnected/using-olm.adoc index ce406839fd3a..d662520048a3 100644 --- a/disconnected/using-olm.adoc +++ b/disconnected/using-olm.adoc @@ -52,7 +52,7 @@ include::modules/olm-restricted-networks-configuring-operatorhub.adoc[leveloffse [id="olm-mirror-catalog_olm-restricted-networks"] == Mirroring an Operator catalog -For instructions about mirroring Operator catalogs for use with disconnected clusters, see xref:../disconnected/mirroring/installing-mirroring-installation-images.adoc#olm-mirror-catalog_installing-mirroring-installation-images[Mirroring Operator catalogs for use with disconnected clusters]. +For instructions about mirroring Operator catalogs for use with disconnected clusters, see xref:../disconnected/installing-mirroring-installation-images.adoc#olm-mirror-catalog_installing-mirroring-installation-images[Mirroring Operator catalogs for use with disconnected clusters]. [IMPORTANT] ==== @@ -60,7 +60,7 @@ As of {product-title} 4.11, the default Red{nbsp}Hat-provided Operator catalog r The `opm` subcommands, flags, and functionality related to the SQLite database format are also deprecated and will be removed in a future release. The features are still supported and must be used for catalogs that use the deprecated SQLite database format. -Many of the `opm` subcommands and flags for working with the SQLite database format, such as `opm index prune`, do not work with the file-based catalog format. For more information about working with file-based catalogs, see xref:../operators/understanding/olm-packaging-format.adoc#olm-file-based-catalogs_olm-packaging-format[Operator Framework packaging format], xref:../operators/admin/olm-managing-custom-catalogs.adoc#olm-managing-custom-catalogs-fb[Managing custom catalogs], and xref:../disconnected/mirroring/about-installing-oc-mirror-v2.adoc#about-installing-oc-mirror-v2[Mirroring images for a disconnected installation by using the oc-mirror plugin v2]. +Many of the `opm` subcommands and flags for working with the SQLite database format, such as `opm index prune`, do not work with the file-based catalog format. For more information about working with file-based catalogs, see xref:../operators/understanding/olm-packaging-format.adoc#olm-file-based-catalogs_olm-packaging-format[Operator Framework packaging format], xref:../operators/admin/olm-managing-custom-catalogs.adoc#olm-managing-custom-catalogs-fb[Managing custom catalogs], and xref:../disconnected/about-installing-oc-mirror-v2.adoc#about-installing-oc-mirror-v2[Mirroring images for a disconnected installation by using the oc-mirror plugin v2]. ==== include::modules/olm-creating-catalog-from-index.adoc[leveloffset=+1] diff --git a/edge_computing/day_2_core_cnf_clusters/updating/telco-update-ocp-update-prep.adoc b/edge_computing/day_2_core_cnf_clusters/updating/telco-update-ocp-update-prep.adoc index 0d6eaa11b7d8..f793bf02dedf 100644 --- a/edge_computing/day_2_core_cnf_clusters/updating/telco-update-ocp-update-prep.adoc +++ b/edge_computing/day_2_core_cnf_clusters/updating/telco-update-ocp-update-prep.adoc @@ -48,7 +48,7 @@ To update clusters in these environments, you must update your offline image rep * xref:../../../rest_api/overview/understanding-compatibility-guidelines.adoc#api-compatibility-guidelines_compatibility-guidelines[API compatibility guidelines] -* xref:../../../disconnected/mirroring/about-installing-oc-mirror-v2.adoc#about-installing-oc-mirror-v2[Mirroring images for a disconnected installation by using the oc-mirror plugin v2] +* xref:../../../disconnected/about-installing-oc-mirror-v2.adoc#about-installing-oc-mirror-v2[Mirroring images for a disconnected installation by using the oc-mirror plugin v2] include::modules/telco-update-preparing-the-platform-for-update.adoc[leveloffset=+1] diff --git a/edge_computing/image_based_upgrade/cnf-understanding-image-based-upgrade.adoc b/edge_computing/image_based_upgrade/cnf-understanding-image-based-upgrade.adoc index 1f45ad0fcb34..7c6e21a4d03c 100644 --- a/edge_computing/image_based_upgrade/cnf-understanding-image-based-upgrade.adoc +++ b/edge_computing/image_based_upgrade/cnf-understanding-image-based-upgrade.adoc @@ -83,7 +83,7 @@ include::modules/cnf-image-based-upgrade-guidelines.adoc[leveloffset=+1] [role="_additional-resources"] .Additional resources -* xref:../../disconnected/mirroring/installing-mirroring-installation-images.adoc#installing-mirroring-installation-images[Mirroring images for a disconnected installation] +* xref:../../disconnected/installing-mirroring-installation-images.adoc#installing-mirroring-installation-images[Mirroring images for a disconnected installation] include::modules/cnf-image-based-upgrade-cluster-validated-software.adoc[leveloffset=+2] diff --git a/edge_computing/policygenerator_for_ztp/ztp-talm-updating-managed-policies-pg.adoc b/edge_computing/policygenerator_for_ztp/ztp-talm-updating-managed-policies-pg.adoc index 5ee6dd114419..6b503597779e 100644 --- a/edge_computing/policygenerator_for_ztp/ztp-talm-updating-managed-policies-pg.adoc +++ b/edge_computing/policygenerator_for_ztp/ztp-talm-updating-managed-policies-pg.adoc @@ -26,9 +26,9 @@ include::modules/cnf-topology-aware-lifecycle-manager-preparing-for-updates.adoc * For more information about how to update {ztp-first}, see xref:../../edge_computing/ztp-updating-gitops.adoc#ztp-updating-gitops[Upgrading {ztp}]. -* For more information about how to mirror an {product-title} image repository, see xref:../../disconnected/mirroring/installing-mirroring-installation-images.adoc#installation-mirror-repository_installing-mirroring-installation-images[Mirroring the {product-title} image repository]. +* For more information about how to mirror an {product-title} image repository, see xref:../../disconnected/installing-mirroring-installation-images.adoc#installation-mirror-repository_installing-mirroring-installation-images[Mirroring the {product-title} image repository]. -* For more information about how to mirror Operator catalogs for disconnected clusters, see xref:../../disconnected/mirroring/installing-mirroring-installation-images.adoc#olm-mirror-catalog_installing-mirroring-installation-images[Mirroring Operator catalogs for use with disconnected clusters]. +* For more information about how to mirror Operator catalogs for disconnected clusters, see xref:../../disconnected/installing-mirroring-installation-images.adoc#olm-mirror-catalog_installing-mirroring-installation-images[Mirroring Operator catalogs for use with disconnected clusters]. * For more information about how to prepare the disconnected environment and mirroring the desired image repository, see xref:../../edge_computing/ztp-preparing-the-hub-cluster.adoc#ztp-preparing-the-hub-cluster[Preparing the disconnected environment]. diff --git a/edge_computing/policygentemplate_for_ztp/ztp-talm-updating-managed-policies.adoc b/edge_computing/policygentemplate_for_ztp/ztp-talm-updating-managed-policies.adoc index e921223bd6f3..39c9393dc82b 100644 --- a/edge_computing/policygentemplate_for_ztp/ztp-talm-updating-managed-policies.adoc +++ b/edge_computing/policygentemplate_for_ztp/ztp-talm-updating-managed-policies.adoc @@ -30,9 +30,9 @@ include::modules/cnf-topology-aware-lifecycle-manager-preparing-for-updates.adoc * xref:../../edge_computing/ztp-updating-gitops.adoc#ztp-updating-gitops[Upgrading {ztp}] -* xref:../../disconnected/mirroring/installing-mirroring-installation-images.adoc#installation-mirror-repository_installing-mirroring-installation-images[Mirroring the {product-title} image repository] +* xref:../../disconnected/installing-mirroring-installation-images.adoc#installation-mirror-repository_installing-mirroring-installation-images[Mirroring the {product-title} image repository] -* xref:../../disconnected/mirroring/installing-mirroring-installation-images.adoc#olm-mirror-catalog_installing-mirroring-installation-images[Mirroring Operator catalogs for use with disconnected clusters] +* xref:../../disconnected/installing-mirroring-installation-images.adoc#olm-mirror-catalog_installing-mirroring-installation-images[Mirroring Operator catalogs for use with disconnected clusters] * xref:../../edge_computing/ztp-preparing-the-hub-cluster.adoc#ztp-preparing-the-hub-cluster[Preparing the disconnected environment] diff --git a/edge_computing/ztp-preparing-the-hub-cluster.adoc b/edge_computing/ztp-preparing-the-hub-cluster.adoc index a013a46633ba..a82631df79fa 100644 --- a/edge_computing/ztp-preparing-the-hub-cluster.adoc +++ b/edge_computing/ztp-preparing-the-hub-cluster.adoc @@ -33,9 +33,9 @@ include::modules/ztp-acm-adding-images-to-mirror-registry.adoc[leveloffset=+1] [role="_additional-resources"] .Additional resources -* xref:../disconnected/mirroring/installing-mirroring-creating-registry.adoc#installing-mirroring-creating-registry[Creating a mirror registry] +* xref:../disconnected/installing-mirroring-creating-registry.adoc#installing-mirroring-creating-registry[Creating a mirror registry] -* xref:../disconnected/mirroring/installing-mirroring-installation-images.adoc#installing-mirroring-installation-images[Mirroring images for a disconnected installation] +* xref:../disconnected/installing-mirroring-installation-images.adoc#installing-mirroring-installation-images[Mirroring images for a disconnected installation] include::modules/ztp-enabling-assisted-installer-service-on-bare-metal.adoc[leveloffset=+1] @@ -44,7 +44,7 @@ include::modules/ztp-configuring-the-cluster-for-a-disconnected-environment.adoc [role="_additional-resources"] .Additional resources -* xref:../disconnected/mirroring/installing-mirroring-installation-images.adoc#installation-mirror-repository_installing-mirroring-installation-images[Mirroring the {product-title} repository] +* xref:../disconnected/installing-mirroring-installation-images.adoc#installation-mirror-repository_installing-mirroring-installation-images[Mirroring the {product-title} repository] include::modules/ztp-configuring-the-hub-cluster-to-use-unauthenticated-registries.adoc[leveloffset=+1] diff --git a/extensions/catalogs/creating-catalogs.adoc b/extensions/catalogs/creating-catalogs.adoc index 14a3e83a3078..9838ddb66999 100644 --- a/extensions/catalogs/creating-catalogs.adoc +++ b/extensions/catalogs/creating-catalogs.adoc @@ -22,7 +22,7 @@ ifndef::openshift-dedicated,openshift-rosa,openshift-rosa-hcp[] .Additional resources * xref:../../operators/understanding/olm-packaging-format.adoc#olm-deprecations-schema_olm-packaging-format[Packaging format -> Schemas -> olm.deprecations schema] -* xref:../../disconnected/mirroring/installing-mirroring-disconnected.adoc#updating-mirror-registry-content[Mirroring images for a disconnected installation using the oc-mirror plugin -> Keeping your mirror registry content updated] +* xref:../../disconnected/installing-mirroring-disconnected.adoc#updating-mirror-registry-content[Mirroring images for a disconnected installation using the oc-mirror plugin -> Keeping your mirror registry content updated] * xref:../../disconnected/using-olm.adoc#olm-creating-catalog-from-index_olm-restricted-networks[Adding a catalog source to a cluster] endif::openshift-dedicated,openshift-rosa,openshift-rosa-hcp[] diff --git a/extensions/catalogs/disconnected-catalogs.adoc b/extensions/catalogs/disconnected-catalogs.adoc index d1ae48d488fb..1e448ec0def9 100644 --- a/extensions/catalogs/disconnected-catalogs.adoc +++ b/extensions/catalogs/disconnected-catalogs.adoc @@ -12,5 +12,5 @@ include::modules/olmv1-about-disconnected.adoc[leveloffset=+1] [role="_additional-resources"] .Additional resources -* xref:../../disconnected/mirroring/installing-mirroring-disconnected.adoc#installing-mirroring-disconnected[Mirroring images for a disconnected installation using the oc-mirror plugin v1] -* xref:../../disconnected/mirroring/about-installing-oc-mirror-v2.adoc#about-installing-oc-mirror-v2[Mirroring images for a disconnected installation using the oc-mirror plugin v2] \ No newline at end of file +* xref:../../disconnected/installing-mirroring-disconnected.adoc#installing-mirroring-disconnected[Mirroring images for a disconnected installation using the oc-mirror plugin v1] +* xref:../../disconnected/about-installing-oc-mirror-v2.adoc#about-installing-oc-mirror-v2[Mirroring images for a disconnected installation using the oc-mirror plugin v2] \ No newline at end of file diff --git a/hosted_control_planes/hcp-disconnected/disconnected-install-ibmz-hcp.adoc b/hosted_control_planes/hcp-disconnected/disconnected-install-ibmz-hcp.adoc index db6b273ade45..47dd315f3c01 100644 --- a/hosted_control_planes/hcp-disconnected/disconnected-install-ibmz-hcp.adoc +++ b/hosted_control_planes/hcp-disconnected/disconnected-install-ibmz-hcp.adoc @@ -23,8 +23,8 @@ include::modules/hcp-ibm-z-dc-prereqs.adoc[leveloffset=+1] [role="_additional-resources"] .Additional resources -* xref:../../disconnected/mirroring/installing-mirroring-creating-registry.adoc#mirror-registry-introduction_installing-mirroring-creating-registry[Creating a mirror registry with mirror registry for Red Hat OpenShift] -* xref:../../disconnected/mirroring/about-installing-oc-mirror-v2.adoc#about-installing-oc-mirror-v2[Mirroring images for a disconnected installation by using the oc-mirror plugin v2] +* xref:../../disconnected/installing-mirroring-creating-registry.adoc#mirror-registry-introduction_installing-mirroring-creating-registry[Creating a mirror registry with mirror registry for Red Hat OpenShift] +* xref:../../disconnected/about-installing-oc-mirror-v2.adoc#about-installing-oc-mirror-v2[Mirroring images for a disconnected installation by using the oc-mirror plugin v2] include::modules/hcp-ibm-z-adding-credentials-registry.adoc[leveloffset=+1] diff --git a/hosted_control_planes/hcp-disconnected/hcp-deploy-dc-bm.adoc b/hosted_control_planes/hcp-disconnected/hcp-deploy-dc-bm.adoc index 150f9019df29..493670b9ee5e 100644 --- a/hosted_control_planes/hcp-disconnected/hcp-deploy-dc-bm.adoc +++ b/hosted_control_planes/hcp-disconnected/hcp-deploy-dc-bm.adoc @@ -26,14 +26,14 @@ include::modules/hcp-dc-image-mirror.adoc[leveloffset=+1] [role="_additional-resources"] .Additional resources -* xref:../../disconnected/mirroring/about-installing-oc-mirror-v2.adoc#oc-mirror-workflows-partially-disconnected-v2_about-installing-oc-mirror-v2[Mirroring an image set in a partially disconnected environment] -* xref:../../disconnected/mirroring/about-installing-oc-mirror-v2.adoc#oc-mirror-workflows-fully-disconnected-v2_about-installing-oc-mirror-v2[Mirroring an image set in a fully disconnected environment] +* xref:../../disconnected/about-installing-oc-mirror-v2.adoc#oc-mirror-workflows-partially-disconnected-v2_about-installing-oc-mirror-v2[Mirroring an image set in a partially disconnected environment] +* xref:../../disconnected/about-installing-oc-mirror-v2.adoc#oc-mirror-workflows-fully-disconnected-v2_about-installing-oc-mirror-v2[Mirroring an image set in a fully disconnected environment] include::modules/hcp-dc-apply-objects.adoc[leveloffset=+1] [role="_additional-resources"] .Additional resources -* xref:../../disconnected/mirroring/about-installing-oc-mirror-v2.adoc#about-installing-oc-mirror-v2[Mirroring images for a disconnected installation by using the oc-mirror plugin v2] +* xref:../../disconnected/about-installing-oc-mirror-v2.adoc#about-installing-oc-mirror-v2[Mirroring images for a disconnected installation by using the oc-mirror plugin v2] include::modules/hcp-agentserviceconfig.adoc[leveloffset=+1] diff --git a/hosted_control_planes/hcp-disconnected/hcp-deploy-dc-virt.adoc b/hosted_control_planes/hcp-disconnected/hcp-deploy-dc-virt.adoc index e8ed75a1a71a..6d5ffca7aefd 100644 --- a/hosted_control_planes/hcp-disconnected/hcp-deploy-dc-virt.adoc +++ b/hosted_control_planes/hcp-disconnected/hcp-deploy-dc-virt.adoc @@ -12,20 +12,20 @@ When you deploy {hcp} in a disconnected environment, some of the steps differ de == Prerequisites * You have a disconnected {product-title} environment serving as your management cluster. -* You have an internal registry to mirror images on. For more information, see xref:../../disconnected/mirroring/index.adoc#installing-mirroring-disconnected-about[About disconnected installation mirroring]. +* You have an internal registry to mirror images on. For more information, see xref:../../disconnected/index.adoc#installing-mirroring-disconnected-about[About disconnected installation mirroring]. include::modules/hcp-dc-image-mirror.adoc[leveloffset=+1] [role="_additional-resources"] .Additional resources -* xref:../../disconnected/mirroring/about-installing-oc-mirror-v2.adoc#oc-mirror-workflows-partially-disconnected-v2_about-installing-oc-mirror-v2[Mirroring an image set in a partially disconnected environment] -* xref:../../disconnected/mirroring/about-installing-oc-mirror-v2.adoc#oc-mirror-workflows-fully-disconnected-v2_about-installing-oc-mirror-v2[Mirroring an image set in a fully disconnected environment] +* xref:../../disconnected/about-installing-oc-mirror-v2.adoc#oc-mirror-workflows-partially-disconnected-v2_about-installing-oc-mirror-v2[Mirroring an image set in a partially disconnected environment] +* xref:../../disconnected/about-installing-oc-mirror-v2.adoc#oc-mirror-workflows-fully-disconnected-v2_about-installing-oc-mirror-v2[Mirroring an image set in a fully disconnected environment] include::modules/hcp-dc-apply-objects.adoc[leveloffset=+1] [role="_additional-resources"] .Additional resources -* xref:../../disconnected/mirroring/about-installing-oc-mirror-v2.adoc#about-installing-oc-mirror-v2[Mirroring images for a disconnected installation by using the oc-mirror plugin v2] +* xref:../../disconnected/about-installing-oc-mirror-v2.adoc#about-installing-oc-mirror-v2[Mirroring images for a disconnected installation by using the oc-mirror plugin v2] [id="hcp-dc-mce-virt"] == Deploying {mce-short} for a disconnected installation of {hcp} diff --git a/installing/installing_aws/ipi/installing-restricted-networks-aws-installer-provisioned.adoc b/installing/installing_aws/ipi/installing-restricted-networks-aws-installer-provisioned.adoc index 888a9acff559..885eacd1d7e5 100644 --- a/installing/installing_aws/ipi/installing-restricted-networks-aws-installer-provisioned.adoc +++ b/installing/installing_aws/ipi/installing-restricted-networks-aws-installer-provisioned.adoc @@ -13,7 +13,7 @@ In {product-title} version {product-version}, you can install a cluster on Amazo * You reviewed details about the xref:../../../architecture/architecture-installation.adoc#architecture-installation[{product-title} installation and update] processes. * You read the documentation on xref:../../../installing/overview/installing-preparing.adoc#installing-preparing[selecting a cluster installation method and preparing it for users]. -* You xref:../../../disconnected/mirroring/installing-mirroring-installation-images.adoc#installation-about-mirror-registry_installing-mirroring-installation-images[mirrored the images for a disconnected installation] to your registry and obtained the `imageContentSources` data for your version of {product-title}. +* You xref:../../../disconnected/installing-mirroring-installation-images.adoc#installation-about-mirror-registry_installing-mirroring-installation-images[mirrored the images for a disconnected installation] to your registry and obtained the `imageContentSources` data for your version of {product-title}. + [IMPORTANT] ==== diff --git a/installing/installing_aws/ipi/ipi-aws-preparing-to-install.adoc b/installing/installing_aws/ipi/ipi-aws-preparing-to-install.adoc index b93ee6a56c63..64288954a85e 100644 --- a/installing/installing_aws/ipi/ipi-aws-preparing-to-install.adoc +++ b/installing/installing_aws/ipi/ipi-aws-preparing-to-install.adoc @@ -16,7 +16,7 @@ You prepare to install an {product-title} cluster on AWS by completing the follo + [NOTE] ==== -If you are installing in a disconnected environment, you extract the installation program from the mirrored content. For more information, see xref:../../../disconnected/mirroring/installing-mirroring-installation-images.adoc#installing-mirroring-installation-images[Mirroring images for a disconnected installation]. +If you are installing in a disconnected environment, you extract the installation program from the mirrored content. For more information, see xref:../../../disconnected/installing-mirroring-installation-images.adoc#installing-mirroring-installation-images[Mirroring images for a disconnected installation]. ==== * Installing the {oc-first}. + diff --git a/installing/installing_aws/upi/installing-restricted-networks-aws.adoc b/installing/installing_aws/upi/installing-restricted-networks-aws.adoc index a2eb0fbbe517..d91964092d54 100644 --- a/installing/installing_aws/upi/installing-restricted-networks-aws.adoc +++ b/installing/installing_aws/upi/installing-restricted-networks-aws.adoc @@ -30,7 +30,7 @@ The steps for performing a user-provisioned infrastructure installation are prov * You reviewed details about the xref:../../../architecture/architecture-installation.adoc#architecture-installation[{product-title} installation and update] processes. * You read the documentation on xref:../../../installing/overview/installing-preparing.adoc#installing-preparing[selecting a cluster installation method and preparing it for users]. -* You xref:../../../disconnected/mirroring/installing-mirroring-installation-images.adoc#installing-mirroring-installation-images[created a mirror registry on your mirror host] and obtained the `imageContentSources` data for your version of {product-title}. +* You xref:../../../disconnected/installing-mirroring-installation-images.adoc#installing-mirroring-installation-images[created a mirror registry on your mirror host] and obtained the `imageContentSources` data for your version of {product-title}. + [IMPORTANT] ==== diff --git a/installing/installing_aws/upi/upi-aws-preparing-to-install.adoc b/installing/installing_aws/upi/upi-aws-preparing-to-install.adoc index 3d1b0fdfb1c3..b375373e2986 100644 --- a/installing/installing_aws/upi/upi-aws-preparing-to-install.adoc +++ b/installing/installing_aws/upi/upi-aws-preparing-to-install.adoc @@ -16,7 +16,7 @@ You prepare to install an {product-title} cluster on AWS by completing the follo + [NOTE] ==== -If you are installing in a disconnected environment, you extract the installation program from the mirrored content. For more information, see xref:../../../disconnected/mirroring/installing-mirroring-installation-images.adoc#installing-mirroring-installation-images[Mirroring images for a disconnected installation]. +If you are installing in a disconnected environment, you extract the installation program from the mirrored content. For more information, see xref:../../../disconnected/installing-mirroring-installation-images.adoc#installing-mirroring-installation-images[Mirroring images for a disconnected installation]. ==== * Installing the {oc-first}. + diff --git a/installing/installing_azure/ipi/installing-restricted-networks-azure-installer-provisioned.adoc b/installing/installing_azure/ipi/installing-restricted-networks-azure-installer-provisioned.adoc index 604dc5e27479..8f129d2053ec 100644 --- a/installing/installing_azure/ipi/installing-restricted-networks-azure-installer-provisioned.adoc +++ b/installing/installing_azure/ipi/installing-restricted-networks-azure-installer-provisioned.adoc @@ -16,7 +16,7 @@ You can install an {product-title} cluster by using mirrored installation releas [id="prerequisites_installing-restricted-networks-azure-installer-provisioned"] == Prerequisites -* You xref:../../../disconnected/mirroring/installing-mirroring-installation-images.adoc#installation-about-mirror-registry_installing-mirroring-installation-images[mirrored the images for a disconnected installation] to your registry and obtained the `imageContentSources` data for your version of {product-title}. +* You xref:../../../disconnected/installing-mirroring-installation-images.adoc#installation-about-mirror-registry_installing-mirroring-installation-images[mirrored the images for a disconnected installation] to your registry and obtained the `imageContentSources` data for your version of {product-title}. + [IMPORTANT] ==== diff --git a/installing/installing_azure/upi/installing-restricted-networks-azure-user-provisioned.adoc b/installing/installing_azure/upi/installing-restricted-networks-azure-user-provisioned.adoc index 5a19296ea39d..2fffa9793fd7 100644 --- a/installing/installing_azure/upi/installing-restricted-networks-azure-user-provisioned.adoc +++ b/installing/installing_azure/upi/installing-restricted-networks-azure-user-provisioned.adoc @@ -20,7 +20,7 @@ The steps for performing a user-provisioned infrastructure installation are prov * You reviewed details about the xref:../../../architecture/architecture-installation.adoc#architecture-installation[{product-title} installation and update] processes. * You read the documentation on xref:../../../installing/overview/installing-preparing.adoc#installing-preparing[selecting a cluster installation method and preparing it for users]. * You xref:../../../installing/installing_azure/installing-azure-account.adoc#installing-azure-account[configured an Azure account] to host the cluster and determined the tested and validated region to deploy the cluster to. -* You xref:../../../disconnected/mirroring/installing-mirroring-installation-images.adoc#installation-about-mirror-registry_installing-mirroring-installation-images[mirrored the images for a disconnected installation] to your registry and obtained the `imageContentSources` data for your version of {product-title}. +* You xref:../../../disconnected/installing-mirroring-installation-images.adoc#installation-about-mirror-registry_installing-mirroring-installation-images[mirrored the images for a disconnected installation] to your registry and obtained the `imageContentSources` data for your version of {product-title}. + [IMPORTANT] ==== diff --git a/installing/installing_bare_metal/ipi/ipi-install-installation-workflow.adoc b/installing/installing_bare_metal/ipi/ipi-install-installation-workflow.adoc index 8fb81d7bd901..cca9f9ec8511 100644 --- a/installing/installing_bare_metal/ipi/ipi-install-installation-workflow.adoc +++ b/installing/installing_bare_metal/ipi/ipi-install-installation-workflow.adoc @@ -192,7 +192,7 @@ include::modules/ipi-install-creating-a-disconnected-registry.adoc[leveloffset=+ [id="prerequisites_ipi-disconnected-registry"] === Prerequisites -* If you have already prepared a mirror registry for xref:../../../disconnected/mirroring/installing-mirroring-installation-images.adoc#prerequisites_installing-mirroring-installation-images[Mirroring images for a disconnected installation], you can skip directly to xref:../../../installing/installing_bare_metal/ipi/ipi-install-installation-workflow.adoc#ipi-modify-install-config-for-a-disconnected-registry_ipi-install-installation-workflow[Modify the install-config.yaml file to use the disconnected registry]. +* If you have already prepared a mirror registry for xref:../../../disconnected/installing-mirroring-installation-images.adoc#prerequisites_installing-mirroring-installation-images[Mirroring images for a disconnected installation], you can skip directly to xref:../../../installing/installing_bare_metal/ipi/ipi-install-installation-workflow.adoc#ipi-modify-install-config-for-a-disconnected-registry_ipi-install-installation-workflow[Modify the install-config.yaml file to use the disconnected registry]. // Preparing the registry node to host the mirrored registry include::modules/ipi-install-preparing-a-disconnected-registry.adoc[leveloffset=+2] diff --git a/installing/installing_bare_metal/upi/installing-restricted-networks-bare-metal.adoc b/installing/installing_bare_metal/upi/installing-restricted-networks-bare-metal.adoc index 0815e3fb5d18..a121cb919d8e 100644 --- a/installing/installing_bare_metal/upi/installing-restricted-networks-bare-metal.adoc +++ b/installing/installing_bare_metal/upi/installing-restricted-networks-bare-metal.adoc @@ -22,7 +22,7 @@ before you attempt to install an {product-title} cluster in such an environment. * You reviewed details about the xref:../../../architecture/architecture-installation.adoc#architecture-installation[{product-title} installation and update] processes. * You read the documentation on xref:../../../installing/overview/installing-preparing.adoc#installing-preparing[selecting a cluster installation method and preparing it for users]. -* You xref:../../../disconnected/mirroring/installing-mirroring-installation-images.adoc#installing-mirroring-installation-images[created a registry on your mirror host] and obtained the `imageContentSources` data for your version of {product-title}. +* You xref:../../../disconnected/installing-mirroring-installation-images.adoc#installing-mirroring-installation-images[created a registry on your mirror host] and obtained the `imageContentSources` data for your version of {product-title}. + [IMPORTANT] ==== diff --git a/installing/installing_gcp/installing-restricted-networks-gcp-installer-provisioned.adoc b/installing/installing_gcp/installing-restricted-networks-gcp-installer-provisioned.adoc index 341a15c00f39..8719e4047dcc 100644 --- a/installing/installing_gcp/installing-restricted-networks-gcp-installer-provisioned.adoc +++ b/installing/installing_gcp/installing-restricted-networks-gcp-installer-provisioned.adoc @@ -19,7 +19,7 @@ You can install an {product-title} cluster by using mirrored installation releas * You reviewed details about the xref:../../architecture/architecture-installation.adoc#architecture-installation[{product-title} installation and update] processes. * You read the documentation on xref:../../installing/overview/installing-preparing.adoc#installing-preparing[selecting a cluster installation method and preparing it for users]. * You xref:../../installing/installing_gcp/installing-gcp-account.adoc#installing-gcp-account[configured a GCP project] to host the cluster. -* You xref:../../disconnected/mirroring/installing-mirroring-installation-images.adoc#installation-about-mirror-registry_installing-mirroring-installation-images[mirrored the images for a disconnected installation] to your registry and obtained the `imageContentSources` data for your version of {product-title}. +* You xref:../../disconnected/installing-mirroring-installation-images.adoc#installation-about-mirror-registry_installing-mirroring-installation-images[mirrored the images for a disconnected installation] to your registry and obtained the `imageContentSources` data for your version of {product-title}. + [IMPORTANT] ==== diff --git a/installing/installing_gcp/installing-restricted-networks-gcp.adoc b/installing/installing_gcp/installing-restricted-networks-gcp.adoc index 38f82c60174a..d256e1ed58d9 100644 --- a/installing/installing_gcp/installing-restricted-networks-gcp.adoc +++ b/installing/installing_gcp/installing-restricted-networks-gcp.adoc @@ -25,7 +25,7 @@ The steps for performing a user-provisioned infrastructure installation are prov * You reviewed details about the xref:../../architecture/architecture-installation.adoc#architecture-installation[{product-title} installation and update] processes. * You read the documentation on xref:../../installing/overview/installing-preparing.adoc#installing-preparing[selecting a cluster installation method and preparing it for users]. -* You xref:../../disconnected/mirroring/installing-mirroring-installation-images.adoc#installing-mirroring-installation-images[created a registry on your mirror host] and obtained the `imageContentSources` data for your version of {product-title}. +* You xref:../../disconnected/installing-mirroring-installation-images.adoc#installing-mirroring-installation-images[created a registry on your mirror host] and obtained the `imageContentSources` data for your version of {product-title}. + [IMPORTANT] ==== diff --git a/installing/installing_ibm_cloud/installing-ibm-cloud-restricted.adoc b/installing/installing_ibm_cloud/installing-ibm-cloud-restricted.adoc index 5c9574774578..12dffb5c8246 100644 --- a/installing/installing_ibm_cloud/installing-ibm-cloud-restricted.adoc +++ b/installing/installing_ibm_cloud/installing-ibm-cloud-restricted.adoc @@ -13,7 +13,7 @@ In {product-title} {product-version}, you can install a cluster in a restricted * You reviewed details about the xref:../../architecture/architecture-installation.adoc#architecture-installation[{product-title} installation and update] processes. * You xref:../../installing/installing_ibm_cloud/installing-ibm-cloud-account.adoc#installing-ibm-cloud-account[configured an {ibm-cloud-title} account] to host the cluster. -* You have a container image registry that is accessible to the internet and your restricted network. The container image registry should mirror the contents of the {product-registry} and contain the installation media. For more information, see xref:../../disconnected/mirroring/about-installing-oc-mirror-v2.adoc#about-installing-oc-mirror-v2[Mirroring images for a disconnected installation by using the oc-mirror plugin v2]. +* You have a container image registry that is accessible to the internet and your restricted network. The container image registry should mirror the contents of the {product-registry} and contain the installation media. For more information, see xref:../../disconnected/about-installing-oc-mirror-v2.adoc#about-installing-oc-mirror-v2[Mirroring images for a disconnected installation by using the oc-mirror plugin v2]. * You have an existing VPC on {ibm-cloud-name} that meets the following requirements: ** The VPC contains the mirror registry or has firewall rules or a peering connection to access the mirror registry that is hosted elsewhere. ** The VPC can access {ibm-cloud-name} service endpoints using a public endpoint. If network restrictions limit access to public service endpoints, evaluate those services for alternate endpoints that might be available. For more information see xref:../../installing/installing_ibm_cloud/installing-ibm-cloud-restricted.adoc#access-to-ibm-service-endpoints_installing-ibm-cloud-restricted[Access to IBM service endpoints]. @@ -30,7 +30,7 @@ include::modules/installation-about-restricted-network.adoc[leveloffset=+1] [role="_additional-resources"] .Additional resources -* xref:../../disconnected/mirroring/about-installing-oc-mirror-v2.adoc#about-installing-oc-mirror-v2[Mirroring images for a disconnected installation by using the oc-mirror plugin v2] +* xref:../../disconnected/about-installing-oc-mirror-v2.adoc#about-installing-oc-mirror-v2[Mirroring images for a disconnected installation by using the oc-mirror plugin v2] * xref:../../installing/installing_ibm_cloud/installation-config-parameters-ibm-cloud-vpc.adoc#installation-configuration-parameters-additional-ibm-cloud_installation-config-parameters-ibm-cloud-vpc[Additional {ibm-cloud-title} configuration parameters] include::modules/installation-custom-ibm-cloud-vpc.adoc[leveloffset=+1] diff --git a/installing/installing_ibm_power/installing-restricted-networks-ibm-power.adoc b/installing/installing_ibm_power/installing-restricted-networks-ibm-power.adoc index 067ad8f6e379..b5c0b8974445 100644 --- a/installing/installing_ibm_power/installing-restricted-networks-ibm-power.adoc +++ b/installing/installing_ibm_power/installing-restricted-networks-ibm-power.adoc @@ -19,7 +19,7 @@ link:https://access.redhat.com/articles/4207611[guidelines for deploying {produc * You reviewed details about the xref:../../architecture/architecture-installation.adoc#architecture-installation[{product-title} installation and update] processes. * You read the documentation on xref:../../installing/overview/installing-preparing.adoc#installing-preparing[selecting a cluster installation method and preparing it for users]. -* You xref:../../disconnected/mirroring/installing-mirroring-installation-images.adoc#installing-mirroring-installation-images[created a mirror registry for installation in a restricted network] and obtained the `imageContentSources` data for your version of {product-title}. +* You xref:../../disconnected/installing-mirroring-installation-images.adoc#installing-mirroring-installation-images[created a mirror registry for installation in a restricted network] and obtained the `imageContentSources` data for your version of {product-title}. * Before you begin the installation process, you must move or remove any existing installation files. This ensures that the required installation files are created and updated during the installation process. + [IMPORTANT] diff --git a/installing/installing_ibm_powervs/installing-restricted-networks-ibm-power-vs.adoc b/installing/installing_ibm_powervs/installing-restricted-networks-ibm-power-vs.adoc index 1c56348bebea..4a4a80e9edad 100644 --- a/installing/installing_ibm_powervs/installing-restricted-networks-ibm-power-vs.adoc +++ b/installing/installing_ibm_powervs/installing-restricted-networks-ibm-power-vs.adoc @@ -14,7 +14,7 @@ In {product-title} {product-version}, you can install a cluster on {ibm-cloud-na * You reviewed details about the xref:../../architecture/architecture-installation.adoc#architecture-installation[{product-title} installation and update] processes. * You read the documentation on xref:../../installing/overview/installing-preparing.adoc#installing-preparing[selecting a cluster installation method and preparing it for users]. * You xref:../../installing/installing_ibm_powervs/installing-ibm-cloud-account-power-vs.adoc#installing-ibm-cloud-account-power-vs[configured an {ibm-cloud-name} account] to host the cluster. -* You xref:../../disconnected/mirroring/installing-mirroring-installation-images.adoc#installation-about-mirror-registry_installing-mirroring-installation-images[mirrored the images for a disconnected installation] to your registry and obtained the `imageContentSources` data for your version of {product-title}. +* You xref:../../disconnected/installing-mirroring-installation-images.adoc#installation-about-mirror-registry_installing-mirroring-installation-images[mirrored the images for a disconnected installation] to your registry and obtained the `imageContentSources` data for your version of {product-title}. + [IMPORTANT] ==== diff --git a/installing/installing_ibm_z/upi/installing-restricted-networks-ibm-z-kvm.adoc b/installing/installing_ibm_z/upi/installing-restricted-networks-ibm-z-kvm.adoc index 6d82aafd3d7b..f76df58691a6 100644 --- a/installing/installing_ibm_z/upi/installing-restricted-networks-ibm-z-kvm.adoc +++ b/installing/installing_ibm_z/upi/installing-restricted-networks-ibm-z-kvm.adoc @@ -21,7 +21,7 @@ While this document refers to only {ibm-z-name}, all information in it also appl * You have completed the tasks in xref:../../../installing/installing_ibm_z/upi/upi-ibm-z-preparing-to-install.adoc#upi-ibm-z-preparing-to-install[Preparing to install a cluster on {ibm-z-title} using user-provisioned infrastructure]. * You reviewed details about the xref:../../../architecture/architecture-installation.adoc#architecture-installation[{product-title} installation and update] processes. * You read the documentation on xref:../../../installing/overview/installing-preparing.adoc#installing-preparing[selecting a cluster installation method and preparing it for users]. -* You xref:../../../disconnected/mirroring/installing-mirroring-installation-images.adoc#installing-mirroring-installation-images[mirrored the images for a disconnected installation] to your registry and obtained the `imageContentSources` data for your version of {product-title}. +* You xref:../../../disconnected/installing-mirroring-installation-images.adoc#installing-mirroring-installation-images[mirrored the images for a disconnected installation] to your registry and obtained the `imageContentSources` data for your version of {product-title}. * You must move or remove any existing installation files, before you begin the installation process. This ensures that the required installation files are created and updated during the installation process. + [IMPORTANT] diff --git a/installing/installing_ibm_z/upi/installing-restricted-networks-ibm-z-lpar.adoc b/installing/installing_ibm_z/upi/installing-restricted-networks-ibm-z-lpar.adoc index 6d665df9f97b..6a2dccb08c59 100644 --- a/installing/installing_ibm_z/upi/installing-restricted-networks-ibm-z-lpar.adoc +++ b/installing/installing_ibm_z/upi/installing-restricted-networks-ibm-z-lpar.adoc @@ -20,7 +20,7 @@ While this document refers to only {ibm-z-name}, all information in it also appl * You have completed the tasks in xref:../../../installing/installing_ibm_z/upi/upi-ibm-z-preparing-to-install.adoc#upi-ibm-z-preparing-to-install[Preparing to install a cluster on {ibm-z-title} using user-provisioned infrastructure]. * You reviewed details about the xref:../../../architecture/architecture-installation.adoc#architecture-installation[{product-title} installation and update] processes. * You read the documentation on xref:../../../installing/overview/installing-preparing.adoc#installing-preparing[selecting a cluster installation method and preparing it for users]. -* You xref:../../../disconnected/mirroring/installing-mirroring-installation-images.adoc#installing-mirroring-installation-images[mirrored the images for a disconnected installation] to your registry and obtained the `imageContentSources` data for your version of {product-title}. +* You xref:../../../disconnected/installing-mirroring-installation-images.adoc#installing-mirroring-installation-images[mirrored the images for a disconnected installation] to your registry and obtained the `imageContentSources` data for your version of {product-title}. * Before you begin the installation process, you must move or remove any existing installation files. This ensures that the required installation files are created and updated during the installation process. + [IMPORTANT] diff --git a/installing/installing_ibm_z/upi/installing-restricted-networks-ibm-z.adoc b/installing/installing_ibm_z/upi/installing-restricted-networks-ibm-z.adoc index e2a3ce98179e..1e34af2505ef 100644 --- a/installing/installing_ibm_z/upi/installing-restricted-networks-ibm-z.adoc +++ b/installing/installing_ibm_z/upi/installing-restricted-networks-ibm-z.adoc @@ -21,7 +21,7 @@ While this document refers to only {ibm-z-name}, all information in it also appl * You have completed the tasks in xref:../../../installing/installing_ibm_z/upi/upi-ibm-z-preparing-to-install.adoc#upi-ibm-z-preparing-to-install[Preparing to install a cluster on {ibm-z-title} using user-provisioned infrastructure]. * You reviewed details about the xref:../../../architecture/architecture-installation.adoc#architecture-installation[{product-title} installation and update] processes. * You read the documentation on xref:../../../installing/overview/installing-preparing.adoc#installing-preparing[selecting a cluster installation method and preparing it for users]. -* You xref:../../../disconnected/mirroring/installing-mirroring-installation-images.adoc#installing-mirroring-installation-images[mirrored the images for a disconnected installation] to your registry and obtained the `imageContentSources` data for your version of {product-title}. +* You xref:../../../disconnected/installing-mirroring-installation-images.adoc#installing-mirroring-installation-images[mirrored the images for a disconnected installation] to your registry and obtained the `imageContentSources` data for your version of {product-title}. * Before you begin the installation process, you must move or remove any existing installation files. This ensures that the required installation files are created and updated during the installation process. + [IMPORTANT] diff --git a/installing/installing_ibm_z/upi/upi-ibm-z-preparing-to-install.adoc b/installing/installing_ibm_z/upi/upi-ibm-z-preparing-to-install.adoc index 57a20e186e2b..f82b4dcb16f8 100644 --- a/installing/installing_ibm_z/upi/upi-ibm-z-preparing-to-install.adoc +++ b/installing/installing_ibm_z/upi/upi-ibm-z-preparing-to-install.adoc @@ -14,7 +14,7 @@ You prepare to install an {product-title} cluster on {ibm-z-name} and {ibm-linux + [NOTE] ==== -If you are installing in a disconnected environment, you extract the installation program from the mirrored content. For more information, see xref:../../../disconnected/mirroring/installing-mirroring-installation-images.adoc#installing-mirroring-installation-images[Mirroring images for a disconnected installation]. +If you are installing in a disconnected environment, you extract the installation program from the mirrored content. For more information, see xref:../../../disconnected/installing-mirroring-installation-images.adoc#installing-mirroring-installation-images[Mirroring images for a disconnected installation]. ==== * Installing the {oc-first}. diff --git a/installing/installing_nutanix/installing-restricted-networks-nutanix-installer-provisioned.adoc b/installing/installing_nutanix/installing-restricted-networks-nutanix-installer-provisioned.adoc index e774bf6beca0..c6bbb02af3f2 100644 --- a/installing/installing_nutanix/installing-restricted-networks-nutanix-installer-provisioned.adoc +++ b/installing/installing_nutanix/installing-restricted-networks-nutanix-installer-provisioned.adoc @@ -23,8 +23,8 @@ If your Nutanix environment uses an internal CA to issue certificates, you must ==== Use 2048-bit certificates. The installation fails if you use 4096-bit certificates with Prism Central 2022.x. ==== -* You have a container image registry, such as {quay}. If you do not already have a registry, you can create a mirror registry using xref:../../disconnected/mirroring/installing-mirroring-creating-registry.adoc#installing-mirroring-creating-registry[_mirror registry for Red{nbsp}Hat OpenShift_]. -* You have used the xref:../../disconnected/mirroring/about-installing-oc-mirror-v2.adoc#about-installing-oc-mirror-v2[oc-mirror OpenShift CLI (oc) plugin] to mirror all of the required {product-title} content and other images, including the Nutanix CSI Operator, to your mirror registry. +* You have a container image registry, such as {quay}. If you do not already have a registry, you can create a mirror registry using xref:../../disconnected/installing-mirroring-creating-registry.adoc#installing-mirroring-creating-registry[_mirror registry for Red{nbsp}Hat OpenShift_]. +* You have used the xref:../../disconnected/about-installing-oc-mirror-v2.adoc#about-installing-oc-mirror-v2[oc-mirror OpenShift CLI (oc) plugin] to mirror all of the required {product-title} content and other images, including the Nutanix CSI Operator, to your mirror registry. + [IMPORTANT] ==== diff --git a/installing/installing_oci/installing-c3-agent-based-installer.adoc b/installing/installing_oci/installing-c3-agent-based-installer.adoc index efb3c423a6bf..4b13fe3c589a 100644 --- a/installing/installing_oci/installing-c3-agent-based-installer.adoc +++ b/installing/installing_oci/installing-c3-agent-based-installer.adoc @@ -42,8 +42,8 @@ include::modules/creating-config-files-cluster-install-oci.adoc[leveloffset=+1] * xref:../../installing/overview/installing-preparing.adoc#installing-preparing-selecting-cluster-type[Selecting a cluster installation type] * 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/installing_with_agent_based_installer/installing-with-agent-based-installer.adoc#installing-ocp-agent-retrieve_installing-with-agent-based-installer[Downloading the Agent-based Installer] -* xref:../../disconnected/mirroring/installing-mirroring-creating-registry.adoc#installing-mirroring-creating-registry[Creating a mirror registry with mirror registry for Red{nbsp}Hat OpenShift] -* xref:../../disconnected/mirroring/installing-mirroring-installation-images.adoc#installation-mirror-repository_installing-mirroring-installation-images[Mirroring the {product-title} image repository] +* xref:../../disconnected/installing-mirroring-creating-registry.adoc#installing-mirroring-creating-registry[Creating a mirror registry with mirror registry for Red{nbsp}Hat OpenShift] +* xref:../../disconnected/installing-mirroring-installation-images.adoc#installation-mirror-repository_installing-mirroring-installation-images[Mirroring the {product-title} image repository] * xref:../../installing/installing_with_agent_based_installer/installing-with-agent-based-installer.adoc#installing-ocp-agent-ztp_installing-with-agent-based-installer[Optional: Using ZTP manifests] // Configuring your firewall diff --git a/installing/installing_oci/installing-oci-agent-based-installer.adoc b/installing/installing_oci/installing-oci-agent-based-installer.adoc index fa0a6bf8b0b8..7ff219386450 100644 --- a/installing/installing_oci/installing-oci-agent-based-installer.adoc +++ b/installing/installing_oci/installing-oci-agent-based-installer.adoc @@ -62,8 +62,8 @@ include::modules/creating-config-files-cluster-install-oci.adoc[leveloffset=+1] * xref:../../installing/overview/installing-preparing.adoc#installing-preparing-selecting-cluster-type[Selecting a cluster installation type] * 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/installing_with_agent_based_installer/installing-with-agent-based-installer.adoc#installing-ocp-agent-retrieve_installing-with-agent-based-installer[Downloading the Agent-based Installer] -* xref:../../disconnected/mirroring/installing-mirroring-creating-registry.adoc#installing-mirroring-creating-registry[Creating a mirror registry with mirror registry for Red{nbsp}Hat OpenShift] -* xref:../../disconnected/mirroring/installing-mirroring-installation-images.adoc#installation-mirror-repository_installing-mirroring-installation-images[Mirroring the {product-title} image repository] +* xref:../../disconnected/installing-mirroring-creating-registry.adoc#installing-mirroring-creating-registry[Creating a mirror registry with mirror registry for Red{nbsp}Hat OpenShift] +* xref:../../disconnected/installing-mirroring-installation-images.adoc#installation-mirror-repository_installing-mirroring-installation-images[Mirroring the {product-title} image repository] * xref:../../installing/installing_with_agent_based_installer/installing-with-agent-based-installer.adoc#installing-ocp-agent-ztp_installing-with-agent-based-installer[Optional: Using ZTP manifests] // Configuring your firewall diff --git a/installing/installing_oci/installing-pca-agent-based-installer.adoc b/installing/installing_oci/installing-pca-agent-based-installer.adoc index 88c12afe8c3b..96db0f5810ab 100644 --- a/installing/installing_oci/installing-pca-agent-based-installer.adoc +++ b/installing/installing_oci/installing-pca-agent-based-installer.adoc @@ -42,8 +42,8 @@ include::modules/creating-config-files-cluster-install-oci.adoc[leveloffset=+1] * xref:../../installing/overview/installing-preparing.adoc#installing-preparing-selecting-cluster-type[Selecting a cluster installation type] * 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/installing_with_agent_based_installer/installing-with-agent-based-installer.adoc#installing-ocp-agent-retrieve_installing-with-agent-based-installer[Downloading the Agent-based Installer] -* xref:../../disconnected/mirroring/installing-mirroring-creating-registry.adoc#installing-mirroring-creating-registry[Creating a mirror registry with mirror registry for Red{nbsp}Hat OpenShift] -* xref:../../disconnected/mirroring/installing-mirroring-installation-images.adoc#installation-mirror-repository_installing-mirroring-installation-images[Mirroring the {product-title} image repository] +* xref:../../disconnected/installing-mirroring-creating-registry.adoc#installing-mirroring-creating-registry[Creating a mirror registry with mirror registry for Red{nbsp}Hat OpenShift] +* xref:../../disconnected/installing-mirroring-installation-images.adoc#installation-mirror-repository_installing-mirroring-installation-images[Mirroring the {product-title} image repository] * xref:../../installing/installing_with_agent_based_installer/installing-with-agent-based-installer.adoc#installing-ocp-agent-ztp_installing-with-agent-based-installer[Optional: Using ZTP manifests] // Configuring your firewall diff --git a/installing/installing_openstack/installing-openstack-installer-custom.adoc b/installing/installing_openstack/installing-openstack-installer-custom.adoc index 9bf6ddb82587..6621b6f030d4 100644 --- a/installing/installing_openstack/installing-openstack-installer-custom.adoc +++ b/installing/installing_openstack/installing-openstack-installer-custom.adoc @@ -59,7 +59,7 @@ include::modules/installation-configuring-shiftstack-single-ipv6.adoc[leveloffse [role="_additional-resources"] .Additional resources -* See xref:../../disconnected/mirroring/installing-mirroring-creating-registry.adoc#installing-mirroring-creating-registry[Creating a mirror registry with mirror registry for Red Hat OpenShift] +* See xref:../../disconnected/installing-mirroring-creating-registry.adoc#installing-mirroring-creating-registry[Creating a mirror registry with mirror registry for Red Hat OpenShift] include::modules/installation-osp-external-lb-config.adoc[leveloffset=+2] // include::modules/installation-osp-setting-worker-affinity.adoc[leveloffset=+1] diff --git a/installing/installing_openstack/installing-openstack-installer-restricted.adoc b/installing/installing_openstack/installing-openstack-installer-restricted.adoc index 4c548d27ff5f..fe352e51bf7d 100644 --- a/installing/installing_openstack/installing-openstack-installer-restricted.adoc +++ b/installing/installing_openstack/installing-openstack-installer-restricted.adoc @@ -14,7 +14,7 @@ In {product-title} {product-version}, you can install a cluster on * You reviewed details about the xref:../../architecture/architecture-installation.adoc#architecture-installation[{product-title} installation and update] processes. * You read the documentation on xref:../../installing/overview/installing-preparing.adoc#installing-preparing[selecting a cluster installation method and preparing it for users]. * You verified that {product-title} {product-version} is compatible with your {rh-openstack} version by using the xref:../../architecture/architecture-installation.adoc#supported-platforms-for-openshift-clusters_architecture-installation[Supported platforms for OpenShift clusters] section. You can also compare platform support across different versions by viewing the link:https://access.redhat.com/articles/4679401[{product-title} on {rh-openstack} support matrix]. -* You xref:../../disconnected/mirroring/installing-mirroring-installation-images.adoc#installing-mirroring-installation-images[created a registry on your mirror host] and obtained the `imageContentSources` data for your version of {product-title}. +* You xref:../../disconnected/installing-mirroring-installation-images.adoc#installing-mirroring-installation-images[created a registry on your mirror host] and obtained the `imageContentSources` data for your version of {product-title}. + [IMPORTANT] ==== diff --git a/installing/installing_vsphere/ipi/installing-restricted-networks-installer-provisioned-vsphere.adoc b/installing/installing_vsphere/ipi/installing-restricted-networks-installer-provisioned-vsphere.adoc index a369fdb31112..8be733bcbb77 100644 --- a/installing/installing_vsphere/ipi/installing-restricted-networks-installer-provisioned-vsphere.adoc +++ b/installing/installing_vsphere/ipi/installing-restricted-networks-installer-provisioned-vsphere.adoc @@ -15,7 +15,7 @@ In {product-title} {product-version}, you can install a cluster on VMware vSpher * You reviewed your VMware platform licenses. Red{nbsp}Hat does not place any restrictions on your VMware licenses, but some VMware infrastructure components require licensing. * You reviewed details about the xref:../../../architecture/architecture-installation.adoc#architecture-installation[{product-title} installation and update] processes. * You read the documentation on xref:../../../installing/overview/installing-preparing.adoc#installing-preparing[selecting a cluster installation method and preparing it for users]. -* You xref:../../../disconnected/mirroring/installing-mirroring-installation-images.adoc#installing-mirroring-installation-images[created a registry on your mirror host] and obtained the `imageContentSources` data for your version of {product-title}. +* You xref:../../../disconnected/installing-mirroring-installation-images.adoc#installing-mirroring-installation-images[created a registry on your mirror host] and obtained the `imageContentSources` data for your version of {product-title}. + [IMPORTANT] ==== diff --git a/installing/installing_vsphere/ipi/ipi-vsphere-preparing-to-install.adoc b/installing/installing_vsphere/ipi/ipi-vsphere-preparing-to-install.adoc index cc1bab8b1f7a..fc688c797930 100644 --- a/installing/installing_vsphere/ipi/ipi-vsphere-preparing-to-install.adoc +++ b/installing/installing_vsphere/ipi/ipi-vsphere-preparing-to-install.adoc @@ -12,7 +12,7 @@ You prepare to install an {product-title} cluster on vSphere by completing the f + [NOTE] ==== -If you are installing in a disconnected environment, you extract the installation program from the mirrored content. For more information, see xref:../../../disconnected/mirroring/installing-mirroring-installation-images.adoc#installing-mirroring-installation-images[Mirroring images for a disconnected installation]. +If you are installing in a disconnected environment, you extract the installation program from the mirrored content. For more information, see xref:../../../disconnected/installing-mirroring-installation-images.adoc#installing-mirroring-installation-images[Mirroring images for a disconnected installation]. ==== * Installing the {oc-first}. + diff --git a/installing/installing_vsphere/upi/installing-restricted-networks-vsphere.adoc b/installing/installing_vsphere/upi/installing-restricted-networks-vsphere.adoc index 80e291d56893..cec2b5fa62f9 100644 --- a/installing/installing_vsphere/upi/installing-restricted-networks-vsphere.adoc +++ b/installing/installing_vsphere/upi/installing-restricted-networks-vsphere.adoc @@ -21,7 +21,7 @@ The steps for performing a user-provisioned infrastructure installation are prov * You reviewed your VMware platform licenses. Red{nbsp}Hat does not place any restrictions on your VMware licenses, but some VMware infrastructure components require licensing. * You reviewed details about the xref:../../../architecture/architecture-installation.adoc#architecture-installation[{product-title} installation and update] processes. * You read the documentation on xref:../../../installing/overview/installing-preparing.adoc#installing-preparing[selecting a cluster installation method and preparing it for users]. -* You xref:../../../disconnected/mirroring/installing-mirroring-installation-images.adoc#installing-mirroring-installation-images[created a registry on your mirror host] and obtained the `imageContentSources` data for your version of {product-title}. +* You xref:../../../disconnected/installing-mirroring-installation-images.adoc#installing-mirroring-installation-images[created a registry on your mirror host] and obtained the `imageContentSources` data for your version of {product-title}. + [IMPORTANT] ==== diff --git a/installing/installing_vsphere/upi/upi-vsphere-preparing-to-install.adoc b/installing/installing_vsphere/upi/upi-vsphere-preparing-to-install.adoc index 19f878f31316..9832fedcc053 100644 --- a/installing/installing_vsphere/upi/upi-vsphere-preparing-to-install.adoc +++ b/installing/installing_vsphere/upi/upi-vsphere-preparing-to-install.adoc @@ -12,7 +12,7 @@ You prepare to install an {product-title} cluster on vSphere by completing the f + [NOTE] ==== -If you are installing in a disconnected environment, you extract the installation program from the mirrored content. For more information, see xref:../../../disconnected/mirroring/installing-mirroring-installation-images.adoc#installing-mirroring-installation-images[Mirroring images for a disconnected installation]. +If you are installing in a disconnected environment, you extract the installation program from the mirrored content. For more information, see xref:../../../disconnected/installing-mirroring-installation-images.adoc#installing-mirroring-installation-images[Mirroring images for a disconnected installation]. ==== * Installing the {oc-first}. + 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 e0b3897dfa10..560855b62f49 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 @@ -16,7 +16,7 @@ The following procedure is partially automated and requires manual steps after t ** xref:../../storage/persistent_storage_local/persistent-storage-local.adoc#persistent-storage-using-local-volume[Persistent storage using local volumes]. ** xref:../../edge_computing/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]. ** 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:../../disconnected/mirroring/index.adoc#installing-mirroring-disconnected-about[About disconnected installation mirroring]. +** xref:../../disconnected/index.adoc#installing-mirroring-disconnected-about[About disconnected installation mirroring]. * You have access to the internet to obtain the necessary container images. * You have installed the OpenShift CLI (`oc`). * If you are installing in a disconnected environment, you must have a configured local mirror registry for disconnected installation mirroring. diff --git a/installing/installing_with_agent_based_installer/understanding-disconnected-installation-mirroring.adoc b/installing/installing_with_agent_based_installer/understanding-disconnected-installation-mirroring.adoc index 907df1a39b7d..1c0e79f9879a 100644 --- a/installing/installing_with_agent_based_installer/understanding-disconnected-installation-mirroring.adoc +++ b/installing/installing_with_agent_based_installer/understanding-disconnected-installation-mirroring.adoc @@ -14,8 +14,8 @@ You can use a mirror registry for disconnected installations and to ensure that You can use one of the following procedures to mirror your {product-title} image repository to your mirror registry: -* xref:../../disconnected/mirroring/installing-mirroring-installation-images.adoc#installing-mirroring-installation-images[Mirroring images for a disconnected installation] -* xref:../../disconnected/mirroring/about-installing-oc-mirror-v2.adoc#about-installing-oc-mirror-v2[Mirroring images for a disconnected installation by using the oc-mirror plugin v2] +* xref:../../disconnected/installing-mirroring-installation-images.adoc#installing-mirroring-installation-images[Mirroring images for a disconnected installation] +* xref:../../disconnected/about-installing-oc-mirror-v2.adoc#about-installing-oc-mirror-v2[Mirroring images for a disconnected installation by using the oc-mirror plugin v2] include::modules/agent-install-about-mirroring-for-disconnected-registry.adoc[leveloffset=+1] diff --git a/installing/overview/installing-preparing.adoc b/installing/overview/installing-preparing.adoc index b6a98578a5e7..2cb524d06229 100644 --- a/installing/overview/installing-preparing.adoc +++ b/installing/overview/installing-preparing.adoc @@ -77,7 +77,7 @@ If you use a user-provisioned installation method, you can configure a proxy for If you want to prevent your cluster on a public cloud from exposing endpoints externally, you can deploy a private cluster with installer-provisioned infrastructure on xref:../../installing/installing_aws/ipi/installing-aws-private.adoc#installing-aws-private[AWS], xref:../../installing/installing_azure/ipi/installing-azure-private.adoc#installing-azure-private[Azure], or xref:../../installing/installing_gcp/installing-gcp-private.adoc#installing-gcp-private[GCP]. -If you need to install your cluster that has limited access to the internet, such as a disconnected or restricted network cluster, you can xref:../../disconnected/mirroring/installing-mirroring-installation-images.adoc#installing-mirroring-installation-images[mirror the installation packages] and install the cluster from them. Follow detailed instructions for user-provisioned infrastructure installations into restricted networks for xref:../../installing/installing_aws/upi/installing-restricted-networks-aws.adoc#installing-restricted-networks-aws[AWS], xref:../../installing/installing_gcp/installing-restricted-networks-gcp.adoc#installing-restricted-networks-gcp[GCP], xref:../../installing/installing_ibm_z/upi/installing-restricted-networks-ibm-z.adoc#installing-restricted-networks-ibm-z[{ibm-z-name} or {ibm-linuxone-name}], xref:../../installing/installing_ibm_z/upi/installing-restricted-networks-ibm-z-kvm.adoc#installing-restricted-networks-ibm-z-kvm[{ibm-z-name} or {ibm-linuxone-name} with {op-system-base} KVM], xref:../../installing/installing_ibm_z/upi/installing-restricted-networks-ibm-z-lpar.adoc#installing-restricted-networks-ibm-z-lpar[{ibm-z-name} or {ibm-linuxone-name} in an LPAR], xref:../../installing/installing_ibm_power/installing-restricted-networks-ibm-power.adoc#installing-restricted-networks-ibm-power[{ibm-power-name}], xref:../../installing/installing_vsphere/upi/installing-restricted-networks-vsphere.adoc#installing-restricted-networks-vsphere[vSphere], or xref:../../installing/installing_bare_metal/upi/installing-restricted-networks-bare-metal.adoc#installing-restricted-networks-bare-metal[bare metal]. You can also install a cluster into a restricted network using installer-provisioned infrastructure by following detailed instructions for xref:../../installing/installing_aws/ipi/installing-restricted-networks-aws-installer-provisioned.adoc#installing-restricted-networks-aws-installer-provisioned[AWS], xref:../../installing/installing_gcp/installing-restricted-networks-gcp-installer-provisioned.adoc#installing-restricted-networks-gcp-installer-provisioned[GCP], xref:../../installing/installing_ibm_cloud/installing-ibm-cloud-restricted.adoc#installing-ibm-cloud-restricted[{ibm-cloud-name}], xref:../../installing/installing_nutanix/installing-restricted-networks-nutanix-installer-provisioned.adoc#installing-restricted-networks-nutanix-installer-provisioned[Nutanix], xref:../../installing/installing_openstack/installing-openstack-installer-restricted.adoc#installing-openstack-installer-restricted[{rh-openstack}], and xref:../../installing/installing_vsphere/ipi/installing-restricted-networks-installer-provisioned-vsphere.adoc#installing-restricted-networks-installer-provisioned-vsphere[vSphere]. +If you need to install your cluster that has limited access to the internet, such as a disconnected or restricted network cluster, you can xref:../../disconnected/installing-mirroring-installation-images.adoc#installing-mirroring-installation-images[mirror the installation packages] and install the cluster from them. Follow detailed instructions for user-provisioned infrastructure installations into restricted networks for xref:../../installing/installing_aws/upi/installing-restricted-networks-aws.adoc#installing-restricted-networks-aws[AWS], xref:../../installing/installing_gcp/installing-restricted-networks-gcp.adoc#installing-restricted-networks-gcp[GCP], xref:../../installing/installing_ibm_z/upi/installing-restricted-networks-ibm-z.adoc#installing-restricted-networks-ibm-z[{ibm-z-name} or {ibm-linuxone-name}], xref:../../installing/installing_ibm_z/upi/installing-restricted-networks-ibm-z-kvm.adoc#installing-restricted-networks-ibm-z-kvm[{ibm-z-name} or {ibm-linuxone-name} with {op-system-base} KVM], xref:../../installing/installing_ibm_z/upi/installing-restricted-networks-ibm-z-lpar.adoc#installing-restricted-networks-ibm-z-lpar[{ibm-z-name} or {ibm-linuxone-name} in an LPAR], xref:../../installing/installing_ibm_power/installing-restricted-networks-ibm-power.adoc#installing-restricted-networks-ibm-power[{ibm-power-name}], xref:../../installing/installing_vsphere/upi/installing-restricted-networks-vsphere.adoc#installing-restricted-networks-vsphere[vSphere], or xref:../../installing/installing_bare_metal/upi/installing-restricted-networks-bare-metal.adoc#installing-restricted-networks-bare-metal[bare metal]. You can also install a cluster into a restricted network using installer-provisioned infrastructure by following detailed instructions for xref:../../installing/installing_aws/ipi/installing-restricted-networks-aws-installer-provisioned.adoc#installing-restricted-networks-aws-installer-provisioned[AWS], xref:../../installing/installing_gcp/installing-restricted-networks-gcp-installer-provisioned.adoc#installing-restricted-networks-gcp-installer-provisioned[GCP], xref:../../installing/installing_ibm_cloud/installing-ibm-cloud-restricted.adoc#installing-ibm-cloud-restricted[{ibm-cloud-name}], xref:../../installing/installing_nutanix/installing-restricted-networks-nutanix-installer-provisioned.adoc#installing-restricted-networks-nutanix-installer-provisioned[Nutanix], xref:../../installing/installing_openstack/installing-openstack-installer-restricted.adoc#installing-openstack-installer-restricted[{rh-openstack}], and xref:../../installing/installing_vsphere/ipi/installing-restricted-networks-installer-provisioned-vsphere.adoc#installing-restricted-networks-installer-provisioned-vsphere[vSphere]. If you need to deploy your cluster to an xref:../../installing/installing_aws/ipi/installing-aws-specialized-region.adoc#installing-aws-specialized-region[AWS GovCloud region], xref:../../installing/installing_aws/ipi/installing-aws-specialized-region.adoc#installing-aws-specialized-region[AWS China region], or xref:../../installing/installing_azure/ipi/installing-azure-government-region.adoc#installing-azure-government-region[Azure government region], you can configure those custom regions during an installer-provisioned infrastructure installation. diff --git a/operators/admin/olm-managing-custom-catalogs.adoc b/operators/admin/olm-managing-custom-catalogs.adoc index e6194c00c4f7..6a30119aa012 100644 --- a/operators/admin/olm-managing-custom-catalogs.adoc +++ b/operators/admin/olm-managing-custom-catalogs.adoc @@ -45,7 +45,7 @@ The `opm` subcommands, flags, and functionality related to the SQLite database f Many of the `opm` subcommands and flags for working with the SQLite database format, such as `opm index prune`, do not work with the file-based catalog format. ifndef::openshift-dedicated,openshift-rosa,openshift-rosa-hcp[] -For more information about working with file-based catalogs, see xref:../../operators/understanding/olm-packaging-format.adoc#olm-file-based-catalogs_olm-packaging-format[Operator Framework packaging format] and xref:../../disconnected/mirroring/installing-mirroring-disconnected.adoc#installing-mirroring-disconnected[Mirroring images for a disconnected installation using the oc-mirror plugin]. +For more information about working with file-based catalogs, see xref:../../operators/understanding/olm-packaging-format.adoc#olm-file-based-catalogs_olm-packaging-format[Operator Framework packaging format] and xref:../../disconnected/installing-mirroring-disconnected.adoc#installing-mirroring-disconnected[Mirroring images for a disconnected installation using the oc-mirror plugin]. endif::openshift-dedicated,openshift-rosa,openshift-rosa-hcp[] ifdef::openshift-dedicated,openshift-rosa,openshift-rosa-hcp[] For more information about working with file-based catalogs, see xref:../../operators/understanding/olm-packaging-format.adoc#olm-file-based-catalogs_olm-packaging-format[Operator Framework packaging format]. @@ -67,7 +67,7 @@ ifndef::openshift-dedicated,openshift-rosa,openshift-rosa-hcp[] .Additional resources * xref:../../operators/understanding/olm-packaging-format.adoc#olm-deprecations-schema_olm-packaging-format[Packaging format -> Schemas -> olm.deprecations schema] -* xref:../../disconnected/mirroring/installing-mirroring-disconnected.adoc#updating-mirror-registry-content[Mirroring images for a disconnected installation using the oc-mirror plugin -> Keeping your mirror registry content updated] +* xref:../../disconnected/installing-mirroring-disconnected.adoc#updating-mirror-registry-content[Mirroring images for a disconnected installation using the oc-mirror plugin -> Keeping your mirror registry content updated] * xref:../../disconnected/using-olm.adoc#olm-creating-catalog-from-index_olm-restricted-networks[Adding a catalog source to a cluster] endif::openshift-dedicated,openshift-rosa,openshift-rosa-hcp[] diff --git a/operators/understanding/olm-packaging-format.adoc b/operators/understanding/olm-packaging-format.adoc index 73d99a4ffc45..fd47e8eabfa6 100644 --- a/operators/understanding/olm-packaging-format.adoc +++ b/operators/understanding/olm-packaging-format.adoc @@ -41,7 +41,7 @@ The `opm` subcommands, flags, and functionality related to the SQLite database f Many of the `opm` subcommands and flags for working with the SQLite database format, such as `opm index prune`, do not work with the file-based catalog format. ifndef::openshift-dedicated,openshift-rosa,openshift-rosa-hcp[] -For more information about working with file-based catalogs, see xref:../../operators/admin/olm-managing-custom-catalogs.adoc#olm-managing-custom-catalogs-fb[Managing custom catalogs] and xref:../../disconnected/mirroring/installing-mirroring-disconnected.adoc#installing-mirroring-disconnected[Mirroring images for a disconnected installation using the oc-mirror plugin]. +For more information about working with file-based catalogs, see xref:../../operators/admin/olm-managing-custom-catalogs.adoc#olm-managing-custom-catalogs-fb[Managing custom catalogs] and xref:../../disconnected/installing-mirroring-disconnected.adoc#installing-mirroring-disconnected[Mirroring images for a disconnected installation using the oc-mirror plugin]. endif::openshift-dedicated,openshift-rosa,openshift-rosa-hcp[] ifdef::openshift-dedicated,openshift-rosa,openshift-rosa-hcp[] For more information about working with file-based catalogs, see xref:../../operators/admin/olm-managing-custom-catalogs.adoc#olm-managing-custom-catalogs-fb[Managing custom catalogs]. diff --git a/operators/understanding/olm-rh-catalogs.adoc b/operators/understanding/olm-rh-catalogs.adoc index 443ee9bcbbf5..e2629395d21d 100644 --- a/operators/understanding/olm-rh-catalogs.adoc +++ b/operators/understanding/olm-rh-catalogs.adoc @@ -17,7 +17,7 @@ The `opm` subcommands, flags, and functionality related to the SQLite database f Many of the `opm` subcommands and flags for working with the SQLite database format, such as `opm index prune`, do not work with the file-based catalog format. ifndef::openshift-dedicated,openshift-rosa,openshift-rosa-hcp[] For more information about working with file-based catalogs, see xref:../../operators/admin/olm-managing-custom-catalogs.adoc#olm-managing-custom-catalogs[Managing custom catalogs], -xref:../../operators/understanding/olm-packaging-format.adoc#olm-file-based-catalogs_olm-packaging-format[Operator Framework packaging format], and xref:../../disconnected/mirroring/installing-mirroring-disconnected.adoc#installing-mirroring-disconnected[Mirroring images for a disconnected installation using the oc-mirror plugin]. +xref:../../operators/understanding/olm-packaging-format.adoc#olm-file-based-catalogs_olm-packaging-format[Operator Framework packaging format], and xref:../../disconnected/installing-mirroring-disconnected.adoc#installing-mirroring-disconnected[Mirroring images for a disconnected installation using the oc-mirror plugin]. endif::openshift-dedicated,openshift-rosa,openshift-rosa-hcp[] ifdef::openshift-dedicated,openshift-rosa,openshift-rosa-hcp[] For more information about working with file-based catalogs, see xref:../../operators/admin/olm-managing-custom-catalogs.adoc#olm-managing-custom-catalogs[Managing custom catalogs], and diff --git a/post_installation_configuration/preparing-for-users.adoc b/post_installation_configuration/preparing-for-users.adoc index 14903a921f22..abd19fceec85 100644 --- a/post_installation_configuration/preparing-for-users.adoc +++ b/post_installation_configuration/preparing-for-users.adoc @@ -130,7 +130,7 @@ If you mirrored Operator catalogs for use with disconnected clusters, you can po [id="prerequisites_post-install-mirrored-catalogs"] === Prerequisites -* xref:../disconnected/mirroring/installing-mirroring-installation-images.adoc#olm-mirror-catalog_installing-mirroring-installation-images[Mirroring Operator catalogs for use with disconnected clusters] +* xref:../disconnected/installing-mirroring-installation-images.adoc#olm-mirror-catalog_installing-mirroring-installation-images[Mirroring Operator catalogs for use with disconnected clusters] include::modules/olm-mirroring-catalog-icsp.adoc[leveloffset=+3] include::modules/olm-creating-catalog-from-index.adoc[leveloffset=+3] diff --git a/rosa_architecture/index.adoc b/rosa_architecture/index.adoc index 7037d62a4f18..7b20c50b8b95 100644 --- a/rosa_architecture/index.adoc +++ b/rosa_architecture/index.adoc @@ -119,8 +119,8 @@ xref:../installing/installing_vsphere/upi/installing-restricted-networks-vsphere or xref:../installing/installing_bare_metal/installing-restricted-networks-bare-metal.adoc#installing-restricted-networks-bare-metal[bare metal] and the cluster does not have full access to the internet, you must mirror the {product-title} installation images. To do this action, use one of the following methods, so that you can install a cluster in a restricted network. -*** xref:../disconnected/mirroring/installing-mirroring-installation-images.adoc#installing-mirroring-installation-images[Mirroring images for a disconnected installation] -*** xref:../disconnected/mirroring/about-installing-oc-mirror-v2.adoc#about-installing-oc-mirror-v2[Mirroring images for a disconnected installation by using the oc-mirror plugin v2] +*** xref:../disconnected/installing-mirroring-installation-images.adoc#installing-mirroring-installation-images[Mirroring images for a disconnected installation] +*** xref:../disconnected/about-installing-oc-mirror-v2.adoc#about-installing-oc-mirror-v2[Mirroring images for a disconnected installation by using the oc-mirror plugin v2] endif::openshift-origin[] ifdef::openshift-origin[] @@ -131,7 +131,7 @@ xref:../installing/installing_gcp/installing-restricted-networks-gcp.adoc#instal or xref:../installing/installing_bare_metal/installing-restricted-networks-bare-metal.adoc#installing-restricted-networks-bare-metal[bare metal] does not have full access to the internet, then -xref:../disconnected/mirroring/installing-mirroring-installation-images.adoc#installing-mirroring-installation-images[mirror the {product-title} installation images] and install a cluster in a restricted network. +xref:../disconnected/installing-mirroring-installation-images.adoc#installing-mirroring-installation-images[mirror the {product-title} installation images] and install a cluster in a restricted network. endif::openshift-origin[] - **Install a cluster in an existing network**: If you use an existing Virtual Private Cloud (VPC) in diff --git a/security/cert_manager_operator/cert-manager-operator-release-notes.adoc b/security/cert_manager_operator/cert-manager-operator-release-notes.adoc index 5c60e9dad983..d157aedeca60 100644 --- a/security/cert_manager_operator/cert-manager-operator-release-notes.adoc +++ b/security/cert_manager_operator/cert-manager-operator-release-notes.adoc @@ -106,7 +106,7 @@ With this release, the {cert-manager-operator} has been verified to be mirrored The Operator has also been validated to work with the following issuer types in disconnected environments: ACME, CA, Self-signed, and Vault. Specifically, private or self-hosted ACME servers have been validated, as Let's Encrypt or other public ACME services are not feasible options in disconnected environments. The oc-mirror plugin v2 is the preferred method to mirror Operator images. -For more information, see xref:../../disconnected/mirroring/about-installing-oc-mirror-v2.adoc#about-installing-oc-mirror-v2[Mirroring images for a disconnected installation by using the oc-mirror plugin v2]. +For more information, see xref:../../disconnected/about-installing-oc-mirror-v2.adoc#about-installing-oc-mirror-v2[Mirroring images for a disconnected installation by using the oc-mirror plugin v2]. *Extended operand metrics support* diff --git a/storage/persistent_storage_local/persistent-storage-using-lvms.adoc b/storage/persistent_storage_local/persistent-storage-using-lvms.adoc index fbeeee276ee7..79c6ccbdc24f 100644 --- a/storage/persistent_storage_local/persistent-storage-using-lvms.adoc +++ b/storage/persistent_storage_local/persistent-storage-using-lvms.adoc @@ -29,15 +29,15 @@ include::modules/lvms-installing-logical-volume-manager-operator-disconnected-en [id="additional-resources-2_{context}"] .Additional resources -* xref:../../disconnected/mirroring/index.adoc#installing-mirroring-disconnected-about[About disconnected installation mirroring] +* xref:../../disconnected/index.adoc#installing-mirroring-disconnected-about[About disconnected installation mirroring] -* xref:../../disconnected/mirroring/installing-mirroring-creating-registry.adoc#installing-mirroring-creating-registry[Creating a mirror registry with mirror registry for Red Hat OpenShift] +* xref:../../disconnected/installing-mirroring-creating-registry.adoc#installing-mirroring-creating-registry[Creating a mirror registry with mirror registry for Red Hat OpenShift] -* xref:../../disconnected/mirroring/installing-mirroring-installation-images.adoc#installation-mirror-repository_installing-mirroring-installation-images[Mirroring the {product-title} image repository] +* xref:../../disconnected/installing-mirroring-installation-images.adoc#installation-mirror-repository_installing-mirroring-installation-images[Mirroring the {product-title} image repository] -* xref:../../disconnected/mirroring/about-installing-oc-mirror-v2.adoc#oc-mirror-building-image-set-config-v2_about-installing-oc-mirror-v2[Creating the image set configuration] +* xref:../../disconnected/about-installing-oc-mirror-v2.adoc#oc-mirror-building-image-set-config-v2_about-installing-oc-mirror-v2[Creating the image set configuration] -* xref:../../disconnected/mirroring/about-installing-oc-mirror-v2.adoc#using-oc-mirror_about-installing-oc-mirror-v2[Mirroring an image set to a mirror registry] +* xref:../../disconnected/about-installing-oc-mirror-v2.adoc#using-oc-mirror_about-installing-oc-mirror-v2[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] diff --git a/welcome/learn_more_about_openshift.adoc b/welcome/learn_more_about_openshift.adoc index cd4433bb08a9..3fd0a1dc6477 100644 --- a/welcome/learn_more_about_openshift.adoc +++ b/welcome/learn_more_about_openshift.adoc @@ -88,7 +88,7 @@ Explore the following {product-title} installation tasks: |=== |Learn about installing in a restricted network |Optional additional resources -a|xref:../disconnected/mirroring/index.adoc#index[About disconnected installation mirroring] +a|xref:../disconnected/index.adoc#index[About disconnected installation mirroring] a| If your cluster uses user-provisioned infrastructure, and the cluster does not have full access to the internet, you must mirror the {product-title} installation images. * xref:../installing/installing_aws/upi/installing-restricted-networks-aws.adoc#installing-restricted-networks-aws[{aws-first}] diff --git a/windows_containers/enabling-windows-container-workloads.adoc b/windows_containers/enabling-windows-container-workloads.adoc index 0d2259dfc386..3bfdcf1eb0ad 100644 --- a/windows_containers/enabling-windows-container-workloads.adoc +++ b/windows_containers/enabling-windows-container-workloads.adoc @@ -65,7 +65,7 @@ include::modules/wmco-disconnected-cluster.adoc[leveloffset=+1] [role="_additional-resources"] .Additional resources -* xref:../disconnected/mirroring/index.adoc#installing-mirroring-disconnected-about[About disconnected installation mirroring] +* xref:../disconnected/index.adoc#installing-mirroring-disconnected-about[About disconnected installation mirroring] include::modules/images-configuration-registry-mirror.adoc[leveloffset=+2]