Skip to content

Commit

Permalink
update upgrade menu items
Browse files Browse the repository at this point in the history
  • Loading branch information
mletalie committed Apr 29, 2024
1 parent 0cc3ced commit 233a466
Show file tree
Hide file tree
Showing 8 changed files with 17 additions and 32 deletions.
10 changes: 5 additions & 5 deletions _topic_maps/_topic_map_rosa.yml
Original file line number Diff line number Diff line change
Expand Up @@ -680,12 +680,10 @@ Name: Upgrading
Dir: upgrading
Distros: openshift-rosa
Topics:
- Name: Upgrading ROSA with STS
File: rosa-upgrading-sts
- Name: Upgrading ROSA
File: rosa-upgrading
- Name: Upgrading ROSA with HCP
- Name: Upgrading ROSA with HCP clusters
File: rosa-hcp-upgrading
- Name: Upgrading ROSA Classic clusters
File: rosa-upgrading-sts
---
Name: CI/CD
Dir: cicd
Expand Down Expand Up @@ -1911,3 +1909,5 @@ Topics:
# File: virt-collecting-virt-data
# - Name: Preparing to upgrade ROSA to 4.9
# File: rosa-upgrading-cluster-prepare
# - Name: Upgrading ROSA Classic clusters
# File: rosa-upgrading
9 changes: 1 addition & 8 deletions modules/rosa-upgrading-cli-tutorial.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -15,11 +15,7 @@ endif::[]
[id="rosa-upgrading-cli_{context}"]
= Upgrading with the ROSA CLI

You can upgrade a {product-title} (ROSA) cluster
ifdef::sts[]
that uses the AWS Security Token Service (STS)
endif::sts[]
manually by using the ROSA CLI (`rosa`).
You can upgrade a {product-title} (ROSA) cluster manually by using the ROSA CLI (`rosa`).

This method schedules the cluster for an immediate upgrade, if a more recent version is available.

Expand Down Expand Up @@ -65,9 +61,6 @@ endif::rosa-hcp[]
The cluster is scheduled for an immediate upgrade. This action can take an hour or longer, depending on your workload configuration, such as pod disruption budgets.
+
You will receive an email when the upgrade is complete. You can also check the status by running the `rosa describe cluster` command again from the ROSA CLI or view the status in {cluster-manager} console.
ifeval::["{context}" == "rosa-upgrading-sts"]
:!sts:
endif::[]

.Troubleshooting
* Sometimes a scheduled upgrade does not trigger. See link:https://access.redhat.com/solutions/6648291[Upgrade maintenance cancelled] for more information.
10 changes: 1 addition & 9 deletions modules/rosa-upgrading-manual-ocm.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -11,11 +11,7 @@ endif::[]
[id="rosa-upgrade-ocm_{context}"]
= Scheduling individual upgrades through the {cluster-manager} console

You can schedule upgrades for a {product-title} cluster
ifdef::sts[]
that uses the AWS Security Token Service (STS)
endif::sts[]
manually one time by using {cluster-manager} console.
You can schedule upgrades for a {product-title} cluster manually one time by using {cluster-manager} console.

.Procedure

Expand Down Expand Up @@ -53,9 +49,5 @@ The cluster is scheduled for an upgrade to the target version. This action can t
+
The status is displayed in the *Update status* pane.

ifeval::["{context}" == "rosa-upgrading-sts"]
:!sts:
endif::[]

.Troubleshooting
* Sometimes a scheduled upgrade does not trigger. See link:https://access.redhat.com/solutions/6648291[Upgrade maintenance cancelled] for more information.
4 changes: 2 additions & 2 deletions rosa_getting_started/rosa-getting-started.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -88,6 +88,6 @@ include::modules/rosa-getting-started-deleting-a-cluster.adoc[leveloffset=+1]

* For more information about setting up accounts and ROSA clusters using AWS STS, see xref:../rosa_planning/rosa-sts-aws-prereqs.adoc#rosa-sts-overview-of-the-deployment-workflow[Understanding the ROSA with STS deployment workflow]

* For information about setting up accounts and ROSA clusters without using AWS STS, see xref:../rosa_install_access_delete_clusters/rosa_getting_started_iam/rosa-getting-started-workflow.adoc#rosa-understanding-the-deployment-workflow[Understanding the ROSA deployment workflow]
* For more information about setting up accounts and ROSA clusters without using AWS STS, see xref:../rosa_install_access_delete_clusters/rosa_getting_started_iam/rosa-getting-started-workflow.adoc#rosa-understanding-the-deployment-workflow[Understanding the ROSA deployment workflow]

* For documentation on upgrading your cluster, see xref:../upgrading/rosa-upgrading.adoc#rosa-upgrading[Upgrading ROSA clusters]
* For more information about upgrading your cluster, see xref:../upgrading/rosa-upgrading-sts.adoc#rosa-upgrading-sts[Upgrading ROSA Classic clusters]
4 changes: 2 additions & 2 deletions rosa_getting_started/rosa-quickstart-guide-ui.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -163,6 +163,6 @@ include::modules/rosa-getting-started-deleting-a-cluster.adoc[leveloffset=+1]

* For more information about setting up accounts and ROSA clusters using AWS STS, see xref:../rosa_planning/rosa-sts-aws-prereqs.adoc#rosa-sts-overview-of-the-deployment-workflow[Understanding the ROSA with STS deployment workflow].

* For information about setting up accounts and ROSA clusters without using AWS STS, see xref:../rosa_install_access_delete_clusters/rosa_getting_started_iam/rosa-getting-started-workflow.adoc#rosa-understanding-the-deployment-workflow[Understanding the ROSA deployment workflow].
* For more information about setting up accounts and ROSA clusters without using AWS STS, see xref:../rosa_install_access_delete_clusters/rosa_getting_started_iam/rosa-getting-started-workflow.adoc#rosa-understanding-the-deployment-workflow[Understanding the ROSA deployment workflow].

* For documentation on upgrading your cluster, see xref:../upgrading/rosa-upgrading.adoc#rosa-upgrading[Upgrading ROSA clusters].
* For more information about upgrading your cluster, see xref:../upgrading/rosa-upgrading-sts.adoc#rosa-upgrading-sts[Upgrading ROSA Classic clusters].
2 changes: 1 addition & 1 deletion upgrading/rosa-hcp-upgrading.adoc
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
:_mod-docs-content-type: ASSEMBLY
[id="rosa-hcp-upgrading"]
= Upgrading {hcp-title}
= Upgrading {hcp-title} clusters
include::_attributes/attributes-openshift-dedicated.adoc[]
:context: rosa-hcp-upgrading

Expand Down
8 changes: 4 additions & 4 deletions upgrading/rosa-upgrading-sts.adoc
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
:_mod-docs-content-type: ASSEMBLY
[id="rosa-upgrading-sts"]
= Upgrading ROSA clusters with STS
= Upgrading ROSA Classic clusters
include::_attributes/attributes-openshift-dedicated.adoc[]
:context: rosa-upgrading-sts

Expand All @@ -14,16 +14,16 @@ To plan an upgrade, review the xref:../rosa_architecture/rosa_policy_service_def
Upgrades are manually initiated or automatically scheduled. Red Hat Site Reliability Engineers (SREs) monitor upgrade progress and remedy any issues encountered.

[id="rosa-sts-upgrading-a-cluster-with-sts"]
== Upgrading a ROSA cluster that uses STS
== Upgrading a ROSA Classic cluster

There are two methods to upgrade {product-title} (ROSA) clusters that uses the AWS Security Token Service (STS):
There are two methods to upgrade Classic {product-title} (ROSA) clusters:

* Individual upgrades through the ROSA CLI (`rosa`)
* Individual upgrades through the {cluster-manager} console

[NOTE]
====
For steps to upgrade a ROSA cluster that does not use the AWS Security Token Service (STS), see xref:../upgrading/rosa-upgrading.adoc#rosa-upgrading[Upgrading ROSA clusters].
When you follow a scheduled upgrade policy, a delay of an hour or more before the upgrade process begins might occur, even if the upgrade is configured to begin immediately. Additionally, the duration of the upgrade might vary based on your workload configuration.
====

include::modules/rosa-upgrading-cli-tutorial.adoc[leveloffset=+2]
Expand Down
2 changes: 1 addition & 1 deletion upgrading/rosa-upgrading.adoc
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
:_mod-docs-content-type: ASSEMBLY
[id="rosa-upgrading"]
= Upgrading ROSA clusters
= Upgrading ROSA Classic clusters
include::_attributes/attributes-openshift-dedicated.adoc[]
:context: rosa-upgrading

Expand Down

0 comments on commit 233a466

Please sign in to comment.