Bug 1889687

Summary: Document Installing Red Hat OpenShift Container Storage Operator Install with Approval Strategy: Manual
Product: [Red Hat Storage] Red Hat OpenShift Container Storage Reporter: Neha Berry <nberry>
Component: documentationAssignee: Agil Antony <agantony>
Status: CLOSED CURRENTRELEASE QA Contact: suchita <sgatfane>
Severity: high Docs Contact:
Priority: unspecified    
Version: 4.6CC: agantony, asriram, assingh, mmuench, ocs-bugs, sgatfane, uchapaga
Target Milestone: ---   
Target Release: OCS 4.6.z Async   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of:
: 1938108 (view as bug list) Environment:
Last Closed: 2021-08-25 14:55:04 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:
Bug Depends On:    
Bug Blocks: 1938108    

Description Neha Berry 2020-10-20 11:29:07 UTC
Description of problem:
---------------------------------

Currently, OCS Deployment guides only have following documented for 

>>Installing Red Hat OpenShift Container Storage Operator

Approval Strategy as Automatic

But, Users may select Manual(in case they want subsequent Upgrades to be Approval: Manual) Strategy while Installing OCS Operator in Operator Hub

We need to document the Maual procedure too, preferably with screenshots or detailed steps of how to 

a) Click on Requires Approval or Upgrade Available in the Subscription Page
b) Preview Install Plan
c) Approve the Install Plan
d) and then OCS Operator starts installing and comes in Succeeded state.



Version-Release number of selected component (if applicable):
----------------------------------------------
True for OCS 4.2 through 4.6 but the Manual approval screenshot may look different for OCP 4.6  + OCS 4.6 . Hence, we need to decide which docs we want to backport the new content.


More discussions here - https://chat.google.com/room/AAAAK3AjBdo/YPr7mhRYSgE

Sample Deployment guide of OCS 4.5 where Manual startegy could have been added

https://access.redhat.com/documentation/en-us/red_hat_openshift_container_storage/4.5/html-single/deploying_openshift_container_storage_on_vmware_vsphere/index?lb_target=preview#installing-openshift-container-storage-operator-using-the-operator-hub_cloud-storage

Section Number
=================
1.2. Installing Red Hat OpenShift Container Storage Operator

2.4. Installing Red Hat OpenShift Container Storage Operator


Thanks.

Comment 2 Neha Berry 2020-12-11 05:29:29 UTC
Hi Anjana, Bipin,

Let's consider this bug for upcoming doc asyncs and try to come up with the content

As @mmuench also raised, it would be good to give option to customers to have manual strategy. 

automatic strategy means upgrade would also be automatic, and many customers would not want that.

@

uchapaga please help in providing the content

Comment 3 umanga 2020-12-14 04:47:39 UTC
IIRC we already have content for Upgrading with Manual Strategy. Same is applicable here, only difference is user needs to select "Manual" during installation instead of changing channels during upgrades.

Comment 4 Neha Berry 2020-12-14 14:03:09 UTC
Yes we have in Upgrade section, we can use that for reference

But It would be good for us to prepare or let the doc team know the exact content to be added to all deployment guides.

Comment 8 suchita 2021-03-10 07:57:01 UTC
I have verified OCS 4.5 installation on the OCP4.5 cluster on the AWS platform.
Minor correction is needed in step ii of section 1.2

1.2. Installing Red Hat OpenShift Container Storage Operator
    * Approval Strategy as Manual.
      i   Click Install
      ii  On the Manual approval required page, click View Installed Operators in namespace openshift-storage.

My observation is that with OCS 4.5 after clicking on install "View Installed Operators in namespace openshift-storage." link is not available and it redirects to the installed operator page directly. 
So remove text "click View Installed Operators in namespace openshift-storage" from step ii

Comment 14 suchita 2021-03-12 11:09:35 UTC
I verified all the preview document links given in Comment7 and it looks good to me. 
All the changes as per group discussion and as per drafted g-doc[1] are present in the preview doc.
 
[1] https://docs.google.com/document/d/1AGGSRqrYUZYO9q2kMbZ1m4UqpPxT2yf5a_pHnEPGOk0/edit?usp=sharing

Hence Marking this BZ as Verified.

Comment 15 Red Hat Bugzilla 2023-09-15 00:49:55 UTC
The needinfo request[s] on this closed bug have been removed as they have been unresolved for 500 days