BZ#1995435: Change the update server

Fixes: BZ1995435
Added a section on how to change the upstream for both the cases: CLI
and web console.

Signed-off-by: Servesha Dudhgaonkar <[email protected]>

Author: xenolinux

modules/update-changing-update-server-cli.adoc

@@ -0,0 +1,26 @@
+// Module included in the following assemblies:
+//
+// * updating/updating-cluster-cli.adoc
+// * updating/updating-cluster-rhel-compute.adoc
+
+[id="update-changing-update-server-cli_{context}"]
+= Changing the update server by using the CLI
+
+Changing the update server is optional. If you have an OpenShift Update Service (OSUS) installed and configured locally, you must set the URL for the server as the `upstream` to use the local server during updates. The default value for `upstream` is `\https://api.openshift.com/api/upgrades_info/v1/graph`.
+
+.Procedure
+
+* Change the `upstream` parameter value in the cluster version:
++
+[source,terminal]
+----
+$ oc patch clusterversion/version --patch '{"spec":{"upstream":"<update-server-url>"}}' --type=merge
+----
+The `<update-server-url>` variable specifies the URL for the update server.
++
+.Example output
++
+[source,terminal]
+----
+clusterversion.config.openshift.io/version patched
+----

modules/update-changing-update-server-web.adoc

@@ -0,0 +1,29 @@
+// Module included in the following assemblies:
+//
+// * updating/updating-cluster.adoc
+
+[id="update-changing-update-server-web_{context}"]
+= Changing the update server by using the web console
+
+Changing the update server is optional. If you have an OpenShift Update Service (OSUS) installed and configured locally, you must set the URL for the server as the `upstream` to use the local server during updates.
+
+.Procedure
+
+. Navigate to *Administration* -> *Cluster Settings*, click *version*.
+. Click the *YAML* tab and then edit the `upstream` parameter value:
++
+.Example output
++
+[source,yaml]
+----
+  ...
+  spec:
+    clusterID: db93436d-7b05-42cc-b856-43e11ad2d31a
+    upstream: '<update-server-url>' <1>
+  ...
+----
+<1> The `<update-server-url>` variable specifies the URL for the update server.
++
+The default `upstream` is `\https://api.openshift.com/api/upgrades_info/v1/graph`.
+
+. Click *Save*.

updating/updating-cluster-between-minor.adoc

@@ -44,3 +44,5 @@ include::modules/update-using-custom-machine-config-pools-canary.adoc[leveloffse
 If you want to use the canary rollout update process, see xref:../updating/update-using-custom-machine-config-pools.adoc#update-using-custom-machine-config-pools[Performing a canary rollout update].
 
 include::modules/update-upgrading-web.adoc[leveloffset=+1]
+
+include::modules/update-changing-update-server-web.adoc[leveloffset=+1]

updating/updating-cluster-cli.adoc

@@ -35,3 +35,5 @@ include::modules/update-service-overview.adoc[leveloffset=+1]
 include::modules/understanding-upgrade-channels.adoc[leveloffset=+1]
 
 include::modules/update-upgrading-cli.adoc[leveloffset=+1]
+
+include::modules/update-changing-update-server-cli.adoc[leveloffset=+1]

updating/updating-cluster.adoc

@@ -28,4 +28,6 @@ include::modules/update-service-overview.adoc[leveloffset=+1]
 
 include::modules/understanding-upgrade-channels.adoc[leveloffset=+1]
 
+include::modules/update-changing-update-server-web.adoc[leveloffset=+1]
+
 include::modules/update-upgrading-web.adoc[leveloffset=+1]