Bug 1850891 - [Doc RFE] Document how to upgrade OCS 4.4 cluster to OCS 4.5
Summary: [Doc RFE] Document how to upgrade OCS 4.4 cluster to OCS 4.5
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat OpenShift Container Storage
Classification: Red Hat Storage
Component: documentation
Version: 4.5
Hardware: Unspecified
OS: Unspecified
unspecified
high
Target Milestone: ---
: OCS 4.5.0
Assignee: Erin Donnelly
QA Contact: Aviad Polak
URL:
Whiteboard:
Depends On:
Blocks: 1826399
TreeView+ depends on / blocked
 
Reported: 2020-06-25 06:12 UTC by Anjana Suparna Sriram
Modified: 2023-09-14 06:02 UTC (History)
9 users (show)

Fixed In Version:
Doc Type: If docs needed, set a value
Doc Text:
Clone Of:
Environment:
Last Closed: 2020-09-20 15:25:18 UTC
Embargoed:


Attachments (Terms of Use)

Comment 18 Neha Berry 2020-08-17 08:11:14 UTC
Hi Erin,

10.2.1. Enabling automatic updates for OpenShift Container Storage operator in external mode

Prerequisites

Ensure that all OpenShift Container Storage nodes are in Ready status.
 >> NA for external Mode as we do not have designated OCS nodes. But we do have worker Nodes with operator and noobaa pods running, do we need them to be in Ready state too ? @umanga?

Under Persistent Storage in Status card, confirm that the Ceph cluster is healthy and data is resilient.

>> No data resiliency status in the external Mode. 

Ensure that you have sufficient time to complete the Openshift Container Storage (OCS) upgrade process, as the upgrade time varies depending on the number of OSDs that run in the cluster.

>> We do not have OSDs on OCS side in external Mode, SO IMO, we can remove this. @umanga ?

Note: Changes suggested are applicable for both 10.2.1 and 10.2.2 Pre-req section for External mode

Comment 19 umanga 2020-08-17 08:30:25 UTC
We need operator pods to be in Ready state for it to be upgradable. Which means operator should not be doing any work at that time (so all pods should be in running state).

We don't have OSDs in external mode Storage Cluster. So no need to mention that.
But, it might be worth mentioning that OSDs of rhceph cluster will not be updated or affect OCS upgrade. (if you think it's helpful)

Comment 20 Neha Berry 2020-08-17 08:58:50 UTC
(In reply to umanga from comment #19)
> We need operator pods to be in Ready state for it to be upgradable. Which
> means operator should not be doing any work at that time (so all pods should
> be in running state).
> 

+1. So let's change the step to : Ensure that all Openshift Container Storage Pods including the operator pods are in Running state in the openshift-storage namespace.

> We don't have OSDs in external mode Storage Cluster. So no need to mention
> that.
> But, it might be worth mentioning that OSDs of rhceph cluster will not be
> updated or affect OCS upgrade. (if you think it's helpful)

We do have a Common Note in the beginning of 10.2 . But, if needed, we can rephrase the sentence as you suggested.

```
NOTE
Upgrading Red Hat OpenShift Container Storage will not upgrade the external Red Hat Ceph Storage cluster. To upgrade the external Red Hat Ceph Storage cluster, either follow the Red Hat Ceph Storage upgrade documentation, or contact your Red Hat Ceph Storage administrator.
```

Comment 28 Neha Berry 2020-08-25 16:47:51 UTC
Some minor change requests for both 10.1.1. and 10.1.2


For requires Approval

`Upgrade status shows *requires approval* if  new OCS version is already detected in the channel and approval strategy was changed from Manual to Automatic at the time of upgrade`


Verification steps

1) IMO, step 2 and 3 are to be joined as we are asking to check the Storagecluster in the navigated path of #2

2) Better to add one more step to:  Ensure that all OpenShift Container Storage Pods, including the operator pods, are in Running state in the openshift-storage namespace
Procedure

Click Workloads → Pods from the left pane of the OpenShift Web Console.
Select openshift-storage from the Project drop down list.

OR  (maybe redirect to Deployment Guide or mention  3.1. Verifying the state of the pods - but to which one is the question ) :P

Comment 33 Red Hat Bugzilla 2023-09-14 06:02:52 UTC
The needinfo request[s] on this closed bug have been removed as they have been unresolved for 1000 days


Note You need to log in before you can comment on or make changes to this bug.