Merge pull request #55174 from kalexand-rh/xref_updating

kalexand-rh · web-flow · commit ee9686425f4b · 2023-01-25T17:03:11.000-05:00
making changes that should appease the portal
diff --git a/_topic_maps/_topic_map.yml b/_topic_maps/_topic_map.yml
@@ -588,7 +588,7 @@ Topics:
   - Name: About disconnected environment updates
     File: index
   - Name: Updating disconnected environments using OSUS
-    File: restricted-network-update-OSUS
+    File: restricted-network-update-osus
   - Name: Updating disconnected environments without OSUS
     File: restricted-network-update
 - Name: Updating hardware on nodes running on vSphere
diff --git a/getting_started/openshift-overview.adoc b/getting_started/openshift-overview.adoc
@@ -104,7 +104,7 @@ be reviewed by cluster administrators and xref:../operators/admin/olm-adding-ope
 
 * **xref:../scalability_and_performance/scaling-cluster-monitoring-operator.adoc#scaling-cluster-monitoring-operator[Scale] and xref:../scalability_and_performance/using-node-tuning-operator.adoc#using-node-tuning-operator[tune] clusters**: Set cluster limits, tune nodes, scale cluster monitoring, and optimize networking, storage, and routes for your environment.
 
-* **xref:../updating/updating-restricted-network-cluster/restricted-network-update-OSUS.adoc#update-service-overview_updating-restricted-network-cluster-OSUS[Understanding the OpenShift Update Service]**: Learn about installing and managing a local OpenShift Update Service for recommending {product-title} updates in disconnected environments.
+* **xref:../updating/updating-restricted-network-cluster/restricted-network-update-osus.adoc#update-service-overview_updating-restricted-network-cluster-osus[Understanding the OpenShift Update Service]**: Learn about installing and managing a local OpenShift Update Service for recommending {product-title} updates in disconnected environments.
 
 * **xref:../monitoring/monitoring-overview.adoc#monitoring-overview[Monitor clusters]**:
 Learn to  xref:../monitoring/configuring-the-monitoring-stack.adoc#configuring-the-monitoring-stack[configure the monitoring stack].
diff --git a/installing/disconnected_install/installing-mirroring-disconnected.adoc b/installing/disconnected_install/installing-mirroring-disconnected.adoc
@@ -69,7 +69,7 @@ include::modules/oc-mirror-creating-image-set-config.adoc[leveloffset=+1]
 
 * xref:../../installing/disconnected_install/installing-mirroring-disconnected.adoc#oc-mirror-imageset-config-params_installing-mirroring-disconnected[Image set configuration parameters]
 * xref:../../installing/disconnected_install/installing-mirroring-disconnected.adoc#oc-mirror-image-set-examples_installing-mirroring-disconnected[Image set configuration examples]
-* xref:../../updating/updating-restricted-network-cluster/restricted-network-update-OSUS.adoc#update-service-overview_updating-restricted-network-cluster-OSUS[About the OpenShift Update Service]
+* xref:../../updating/updating-restricted-network-cluster/restricted-network-update-osus.adoc#update-service-overview_updating-restricted-network-cluster-osus[About the OpenShift Update Service]
 
 [id="mirroring-image-set"]
 == Mirroring an image set to a mirror registry
diff --git a/modules/images-update-global-pull-secret.adoc b/modules/images-update-global-pull-secret.adoc
@@ -2,7 +2,7 @@
 // * openshift_images/managing_images/using-image-pull-secrets.adoc
 // * post_installation_configuration/cluster-tasks.adoc
 // * support/remote_health_monitoring/opting-out-of-remote-health-reporting.adoc
-// * updating/updating-restricted-network-cluster/restricted-network-update-OSUS.adoc
+// * updating/updating-restricted-network-cluster/restricted-network-update-osus.adoc
 // * updating/updating-restricted-network-cluster/restricted-network-update.adoc
 //
 // Not included, but linked to from:
diff --git a/modules/update-mirror-repository-oc-mirror.adoc b/modules/update-mirror-repository-oc-mirror.adoc
@@ -1,6 +1,6 @@
 // Module included in the following assemblies:
 // * updating/updating-restricted-network-cluster/restricted-network-update.adoc
-// * updating/updating-restricted-network-cluster/restricted-network-update-OSUS.adoc
+// * updating/updating-restricted-network-cluster/restricted-network-update-osus.adoc
 
 :_content-type: PROCEDURE
 [id="update-mirror-repository-oc-mirror_{context}"]
@@ -22,4 +22,4 @@ Use the oc-mirror OpenShift CLI (`oc`) plugin to mirror images onto a mirror reg
 
 ** If you are using oc-mirror for the first time, follow the instructions on that page up until and including the section titled _Installing the ImageContentSourcePolicy and CatalogSource resources into the cluster_.
 
-** If you have already used oc-mirror to mirror resources onto a registry, follow the instructions in the section titled _Keeping your mirror registry content updated_.
+** If you have already used oc-mirror to mirror resources onto a registry, follow the instructions in the section titled _Keeping your mirror registry content updated_.
diff --git a/modules/update-service-configure-cvo.adoc b/modules/update-service-configure-cvo.adoc
@@ -1,5 +1,5 @@
 // Module included in the following assemblies:
-// * updating/updating-restricted-network-cluster/restricted-network-update-OSUS.adoc
+// * updating/updating-restricted-network-cluster/restricted-network-update-osus.adoc
 
 :_content-type: PROCEDURE
 [id="update-service-configure-cvo"]
diff --git a/modules/update-service-create-service-cli.adoc b/modules/update-service-create-service-cli.adoc
@@ -1,5 +1,5 @@
 // Module included in the following assemblies:
-// * updating/updating-restricted-network-cluster/restricted-network-update-OSUS.adoc
+// * updating/updating-restricted-network-cluster/restricted-network-update-osus.adoc
 
 :_content-type: PROCEDURE
 [id="update-service-create-service-cli_{context}"]
diff --git a/modules/update-service-create-service-web-console.adoc b/modules/update-service-create-service-web-console.adoc
@@ -1,5 +1,5 @@
 //Module included in the following assemblies:
-// * updating/updating-restricted-network-cluster/restricted-network-update-OSUS.adoc
+// * updating/updating-restricted-network-cluster/restricted-network-update-osus.adoc
 
 :_content-type: PROCEDURE
 [id="update-service-create-service-web-console_{context}"]
diff --git a/modules/update-service-delete-service-cli.adoc b/modules/update-service-delete-service-cli.adoc
@@ -1,5 +1,5 @@
 // Module included in the following assemblies:
-// * updating/updating-restricted-network-cluster/restricted-network-update-OSUS.adoc
+// * updating/updating-restricted-network-cluster/restricted-network-update-osus.adoc
 
 :_content-type: PROCEDURE
 [id="update-service-delete-service-cli_{context}"]
diff --git a/modules/update-service-delete-service-web-console.adoc b/modules/update-service-delete-service-web-console.adoc
@@ -1,5 +1,5 @@
 // Module included in the following assemblies:
-// * updating/updating-restricted-network-cluster/restricted-network-update-OSUS.adoc
+// * updating/updating-restricted-network-cluster/restricted-network-update-osus.adoc
 
 :_content-type: PROCEDURE
 [id="update-service-delete-service-web-console_{context}"]
diff --git a/modules/update-service-graph-data.adoc b/modules/update-service-graph-data.adoc
@@ -1,5 +1,5 @@
 // Module included in the following assemblies:
-// * updating/updating-restricted-network-cluster/restricted-network-update-OSUS.adoc
+// * updating/updating-restricted-network-cluster/restricted-network-update-osus.adoc
 
 :_content-type: PROCEDURE
 [id="update-service-graph-data_{context}"]
diff --git a/modules/update-service-install-cli.adoc b/modules/update-service-install-cli.adoc
@@ -1,5 +1,5 @@
 // Module included in the following assemblies:
-// * updating/updating-restricted-network-cluster/restricted-network-update-OSUS.adoc
+// * updating/updating-restricted-network-cluster/restricted-network-update-osus.adoc
 
 :_content-type: PROCEDURE
 [id="update-service-install-cli_{context}"]
diff --git a/modules/update-service-install-web-console.adoc b/modules/update-service-install-web-console.adoc
@@ -1,5 +1,5 @@
 // Module included in the following assemblies:
-// * updating/updating-restricted-network-cluster/restricted-network-update-OSUS.adoc
+// * updating/updating-restricted-network-cluster/restricted-network-update-osus.adoc
 
 :_content-type: PROCEDURE
 [id="update-service-install-web-console_{context}"]
diff --git a/modules/update-service-mirror-release.adoc b/modules/update-service-mirror-release.adoc
@@ -1,5 +1,5 @@
 // Module included in the following assemblies:
-// *updating/updating-restricted-network-cluster/restricted-network-update-OSUS.adoc
+// *updating/updating-restricted-network-cluster/restricted-network-update-osus.adoc
 
 :_content-type: PROCEDURE
 [id="update-service-mirror-release-adm-release-mirror_{context}"]
diff --git a/modules/update-service-overview.adoc b/modules/update-service-overview.adoc
@@ -4,7 +4,7 @@
 // * updating/updating-cluster-within-minor.adoc
 // * updating/updating-cluster-cli.adoc
 // * updating/updating-cluster-rhel-compute.adoc
-// * updating/updating-restricted-network-cluster/restricted-network-update-OSUS.adoc
+// * updating/updating-restricted-network-cluster/restricted-network-update-osus.adoc
 
 :_content-type: CONCEPT
 [id="update-service-overview_{context}"]
diff --git a/modules/update-service-uninstall-cli.adoc b/modules/update-service-uninstall-cli.adoc
@@ -1,5 +1,5 @@
 // Module included in the following assemblies:
-// * updating/updating-restricted-network-cluster/restricted-network-update-OSUS.adoc
+// * updating/updating-restricted-network-cluster/restricted-network-update-osus.adoc
 
 :_content-type: PROCEDURE
 [id="update-service-uninstall-cli_{context}"]
diff --git a/modules/update-service-uninstall-web-console.adoc b/modules/update-service-uninstall-web-console.adoc
@@ -1,5 +1,5 @@
 // Module included in the following assemblies:
-// * updating/updating-restricted-network-cluster/restricted-network-update-OSUS.adoc
+// * updating/updating-restricted-network-cluster/restricted-network-update-osus.adoc
 
 :_content-type: PROCEDURE
 [id="update-service-uninstall-web-console_{context}"]
diff --git a/security/container_security/security-hosts-vms.adoc b/security/container_security/security-hosts-vms.adoc
@@ -31,7 +31,7 @@ ifndef::openshift-origin[]
 endif::[]
 * xref:../../installing/install_config/installing-customizing.adoc#installation-special-config-encrypt-disk_installing-customizing[Disk encryption]
 * xref:../../installing/install_config/installing-customizing.adoc#installation-special-config-chrony_installing-customizing[Chrony time service]
-* xref:../../updating/updating-restricted-network-cluster/restricted-network-update-OSUS.adoc#update-service-overview_updating-restricted-network-cluster-OSUS[{product-title} cluster updates]
+* xref:../../updating/updating-restricted-network-cluster/restricted-network-update-osus.adoc#update-service-overview_updating-restricted-network-cluster-osus[{product-title} cluster updates]
 
 // Virtualization versus containers
 include::modules/security-hosts-vms-vs-containers.adoc[leveloffset=+1]
diff --git a/updating/index.adoc b/updating/index.adoc
@@ -71,14 +71,14 @@ xref:../updating/updating-restricted-network-cluster/index.adoc#about-restricted
 
 * xref:../updating/updating-restricted-network-cluster/restricted-network-update.adoc#updating-restricted-network-mirror-host[Preparing your mirror host]
 * xref:../updating/updating-restricted-network-cluster/restricted-network-update.adoc#installation-adding-registry-pull-secret_updating-restricted-network-cluster[Configuring credentials that allow images to be mirrored]
-* xref:../updating/updating-restricted-network-cluster/restricted-network-update.adoc#update-mirror-repository_updating-restricted-network-cluster[Mirroring the {product-title} image repository]
+* xref:../updating/updating-restricted-network-cluster/restricted-network-update.adoc#update-mirror-repository[Mirroring the {product-title} image repository]
 * xref:../updating/updating-restricted-network-cluster/restricted-network-update.adoc#update-restricted_updating-restricted-network-cluster[Updating the disconnected cluster]
 * xref:../updating/updating-restricted-network-cluster/restricted-network-update.adoc#images-configuration-registry-mirror_updating-restricted-network-cluster[Configuring image registry repository mirroring]
 * xref:../updating/updating-restricted-network-cluster/restricted-network-update.adoc#generating-icsp-object-scoped-to-a-registry_updating-restricted-network-cluster[Widening the scope of the mirror image catalog to reduce the frequency of cluster node reboots]
-* xref:../updating/updating-restricted-network-cluster/restricted-network-update-OSUS.adoc#update-service-install[Installing the OpenShift Update Service Operator]
-* xref:../updating/updating-restricted-network-cluster/restricted-network-update-OSUS.adoc#update-service-create-service[Creating an OpenShift Update Service application]
-* xref:../updating/updating-restricted-network-cluster/restricted-network-update-OSUS.adoc#update-service-delete-service[Deleting an OpenShift Update Service application]
-* xref:../updating/updating-restricted-network-cluster/restricted-network-update-OSUS.adoc#update-service-uninstall[Uninstalling the OpenShift Update Service Operator]
+* xref:../updating/updating-restricted-network-cluster/restricted-network-update-osus.adoc#update-service-install[Installing the OpenShift Update Service Operator]
+* xref:../updating/updating-restricted-network-cluster/restricted-network-update-osus.adoc#update-service-create-service[Creating an OpenShift Update Service application]
+* xref:../updating/updating-restricted-network-cluster/restricted-network-update-osus.adoc#update-service-delete-service[Deleting an OpenShift Update Service application]
+* xref:../updating/updating-restricted-network-cluster/restricted-network-update-osus.adoc#update-service-uninstall[Uninstalling the OpenShift Update Service Operator]
 
 [id="updating-clusters-overview-vsphere-updating-hardware"]
 == Updating hardware on nodes running in vSphere
diff --git a/updating/understanding-openshift-updates.adoc b/updating/understanding-openshift-updates.adoc
@@ -24,6 +24,6 @@ include::modules/update-common-terms.adoc[leveloffset=+1]
 
 * xref:../post_installation_configuration/machine-configuration-tasks.adoc#machine-config-overview-post-install-machine-configuration-tasks[Machine config overview]
 ifdef::openshift-enterprise[]
-* xref:../updating/updating-restricted-network-cluster/restricted-network-update-OSUS.adoc#update-service-overview_updating-restricted-network-cluster-OSUS[About the OpenShift Update Service]
+* xref:../updating/updating-restricted-network-cluster/restricted-network-update-osus.adoc#update-service-overview_updating-restricted-network-cluster-osus[About the OpenShift Update Service]
 endif::openshift-enterprise[]
 * xref:../updating/understanding-upgrade-channels-release.adoc#understanding-upgrade-channels_understanding-upgrade-channels-releases[Update channels and releases]
diff --git a/updating/updating-restricted-network-cluster/index.adoc b/updating/updating-restricted-network-cluster/index.adoc
@@ -6,9 +6,9 @@ include::_attributes/common-attributes.adoc[]
 
 toc::[]
 
-A disconnected environment is one in which your cluster nodes cannot access the internet. 
-For this reason, you must populate a registry with the installation images. 
-If your registry host cannot access both the internet and the cluster, you can mirror the images to a file system that is disconnected from that environment and then bring that host or removable media across that gap. 
+A disconnected environment is one in which your cluster nodes cannot access the internet.
+For this reason, you must populate a registry with the installation images.
+If your registry host cannot access both the internet and the cluster, you can mirror the images to a file system that is disconnected from that environment and then bring that host or removable media across that gap.
 If the local container registry and the cluster are connected to the mirror registry's host, you can directly push the release images to the local registry.
 
 A single container image registry is sufficient to host mirrored images for several clusters in the disconnected network.
@@ -17,7 +17,7 @@ A single container image registry is sufficient to host mirrored images for seve
 
 You can use one of the following procedures to update a disconnected {product-title} cluster:
 
-* xref:restricted-network-update-OSUS.adoc#updating-restricted-network-cluster-OSUS[Updating disconnected environments using the OpenShift Update Service]
+* xref:../../updating/updating-restricted-network-cluster/restricted-network-update-osus.adoc#updating-restricted-network-cluster-OSUS[Updating disconnected environments using the OpenShift Update Service]
 
-* xref:restricted-network-update.adoc#updating-restricted-network-cluster[Updating disconnected environments without the OpenShift Update Service]
+* xref:../../updating/updating-restricted-network-cluster/restricted-network-update.adoc#updating-restricted-network-cluster[Updating disconnected environments without the OpenShift Update Service]
 
diff --git a/updating/updating-restricted-network-cluster/restricted-network-update-osus.adoc b/updating/updating-restricted-network-cluster/restricted-network-update-osus.adoc
@@ -2,7 +2,7 @@
 [id="updating-restricted-network-cluster-OSUS"]
 = Updating disconnected environments using the OpenShift Update Service
 include::_attributes/common-attributes.adoc[]
-:context: updating-restricted-network-cluster-OSUS
+:context: updating-restricted-network-cluster-osus
 
 toc::[]
 
@@ -73,7 +73,7 @@ include::modules/update-service-install-cli.adoc[leveloffset=+2]
 
 include::modules/update-service-graph-data.adoc[leveloffset=+1]
 
-[id="update-service-mirror-release_updating-restricted-network-cluster"]
+[id="update-service-mirror-release-osus"]
 == Mirroring the {product-title} image repository
 
 The OpenShift Update Service requires a locally accessible registry containing update release payloads.
@@ -135,4 +135,4 @@ To uninstall the OpenShift Update Service, you must first delete all OpenShift U
 
 include::modules/update-service-uninstall-web-console.adoc[leveloffset=+2]
 
-include::modules/update-service-uninstall-cli.adoc[leveloffset=+2]
+include::modules/update-service-uninstall-cli.adoc[leveloffset=+2]
diff --git a/updating/updating-restricted-network-cluster/restricted-network-update.adoc b/updating/updating-restricted-network-cluster/restricted-network-update.adoc
@@ -12,7 +12,7 @@ toc::[]
 * Have write access to a container registry in the disconnected environment to push and pull images. The container registry must be compatible with Docker registry API v2.
 * You must have the `oc` command-line interface (CLI) tool installed.
 * Have access to the cluster as a user with `admin` privileges.
-See xref:../../authentication/using-rbac.adoc[Using RBAC to define and apply permissions].
+See xref:../../authentication/using-rbac.adoc#using-rbac[Using RBAC to define and apply permissions].
 * Have a recent xref:../../backup_and_restore/control_plane_backup_and_restore/backing-up-etcd.adoc#backup-etcd[etcd backup] in case your update fails and you must xref:../../backup_and_restore/control_plane_backup_and_restore/disaster_recovery/scenario-2-restoring-cluster-state.adoc#dr-restoring-cluster-state[restore your cluster to a previous state].
 * Ensure that all machine config pools (MCPs) are running and not paused. Nodes associated with a paused MCP are skipped during the update process. You can pause the MCPs if you are performing a canary rollout update strategy.
 * If your cluster uses manually maintained credentials, ensure that the Cloud Credential Operator (CCO) is in an upgradeable state. For more information, see _Upgrading clusters with manually maintained credentials_ for xref:../../installing/installing_aws/manually-creating-iam.adoc#manually-maintained-credentials-upgrade_manually-creating-iam-aws[AWS], xref:../../installing/installing_azure/manually-creating-iam-azure.adoc#manually-maintained-credentials-upgrade_manually-creating-iam-azure[Azure], or xref:../../installing/installing_gcp/manually-creating-iam-gcp.adoc#manually-maintained-credentials-upgrade_manually-creating-iam-gcp[GCP].
@@ -32,7 +32,7 @@ include::modules/cli-installing-cli.adoc[leveloffset=+2]
 
 include::modules/installation-adding-registry-pull-secret.adoc[leveloffset=+2]
 
-[id="update-mirror-repository_updating-restricted-network-cluster"]
+[id="update-mirror-repository"]
 == Mirroring the {product-title} image repository
 
 You must mirror container images onto a mirror registry before you can update a cluster in a disconnected environment. You can also use this procedure in connected environment to ensure your clusters only use container images that have satisfied your organizational controls on external content.
@@ -68,4 +68,4 @@ include::modules/generating-icsp-object-scoped-to-a-registry.adoc[leveloffset=+1
 
 * xref:../../operators/admin/olm-restricted-networks.adoc#olm-restricted-networks[Using Operator Lifecycle Manager on restricted networks]
 
-* xref:../../post_installation_configuration/machine-configuration-tasks.adoc#machine-config-overview-post-install-machine-configuration-tasks[Machine Config Overview]
+* xref:../../post_installation_configuration/machine-configuration-tasks.adoc#machine-config-overview-post-install-machine-configuration-tasks[Machine Config Overview]
diff --git a/welcome/index.adoc b/welcome/index.adoc
@@ -308,7 +308,7 @@ There is a separate process for
 xref:../updating/updating-disconnected-cluster.adoc#updating-disconnected-cluster[updating a cluster on a restricted network].
 ////
 
-- **xref:../updating/updating-restricted-network-cluster/restricted-network-update-OSUS.adoc#update-service-overview_updating-restricted-network-cluster-OSUS[Understanding the OpenShift Update Service]**: Learn about installing and managing a local OpenShift Update Service for recommending {product-title} updates in disconnected environments.
+- **xref:../updating/updating-restricted-network-cluster/restricted-network-update-osus.adoc#update-service-overview_updating-restricted-network-cluster-osus[Understanding the OpenShift Update Service]**: Learn about installing and managing a local OpenShift Update Service for recommending {product-title} updates in disconnected environments.
 
 === Monitor the cluster
 
