Bug 1962223

Summary: [Doc RFE] Document how to expand lifecycle transition by associating cloud endpoints to storage classes
Product: [Red Hat Storage] Red Hat Ceph Storage Reporter: Anjana Suparna Sriram <asriram>
Component: DocumentationAssignee: lysanche
Documentation sub component: Object Gateway Guide QA Contact: Tejas <tchandra>
Status: CLOSED CURRENTRELEASE Docs Contact: Ranjini M N <rmandyam>
Severity: medium    
Priority: high CC: agunn, ivancich, kdreyer, lysanche, mbenjamin, mkasturi, rmandyam, skoduri, tchandra
Version: 5.1Keywords: Documentation, FutureFeature
Target Milestone: ---Flags: lysanche: needinfo-
lysanche: needinfo-
Target Release: 6.1   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2023-06-21 09:56:49 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: 1962217    

Description Anjana Suparna Sriram 2021-05-19 14:26:27 UTC
Use Case: Expand lifecycle transition by associating cloud endpoints to storage classes 

Documentation Requirement: 

* Provide concept information that informs administrators of the purpose and advantages of lifecycle transition and support for AWS, Microsoft Azure, and Google Cloud endpoints.

* Provide task information that informs administrators how to set endpoints for AWS, Microsoft Azure, and Google Cloud.




Reference Information: 
Managing your storage lifecycle - Amazon Simple Storage Service

Comment 1 RHEL Program Management 2021-05-19 14:26:29 UTC
Please specify the severity of this bug. Severity is defined here:
https://bugzilla.redhat.com/page.cgi?id=fields.html#bug_severity.

Comment 5 lysanche 2023-03-21 14:59:28 UTC
Hi Anjana,

Could you please provide me with the SME contact for this BZ?

Thanks,
Lynn

Comment 6 lysanche 2023-03-23 12:19:04 UTC
Hi Matt,

Could you please send me more information on what is needed for this BZ in the Object Gateway Guide or recommend someone on your team for this?

https://access.redhat.com/documentation/en-us/red_hat_ceph_storage/6/html-single/object_gateway_guide/index

Thanks very much.
Lynn

Comment 7 Matt Benjamin (redhat) 2023-03-23 12:29:08 UTC
(In reply to lysanche from comment #6)
> Hi Matt,
> 
> Could you please send me more information on what is needed for this BZ in
> the Object Gateway Guide or recommend someone on your team for this?
> 
> https://access.redhat.com/documentation/en-us/red_hat_ceph_storage/6/html-
> single/object_gateway_guide/index
> 
> Thanks very much.
> Lynn

I would say what is in the upstream documentation, which is here https://docs.ceph.com/en/quincy/radosgw/cloud-transition/ . 
Soumya Koduri can answer questions on the implementation.

Matt

Comment 8 lysanche 2023-03-27 16:52:40 UTC
Hi Soumya,

Could you please provide the information needed for this and the placement for it?

I might suggest this placement, but will use your recommendation: 

https://access.redhat.com/documentation/en-us/red_hat_ceph_storage/6/html-single/object_gateway_guide/index#s3-bucket-lifecycle-transition-within-a-storage-cluster_rgw

Thanks very much.
Lynn

Comment 9 lysanche 2023-03-28 12:38:17 UTC
Hi Soumya,

On further investigation, I believe some if not all of the information requested in this BZ is here:

https://access.redhat.com/documentation/en-us/red_hat_ceph_storage/6/html-single/object_gateway_guide/index#transitioning-data-to-amazon-s3-cloud-service_rgw

Could you please confirm and let me know if further changes/additions are needed?

Thanks,
Lynn

Comment 10 Soumya Koduri 2023-03-28 12:57:27 UTC
(In reply to lysanche from comment #9)
> Hi Soumya,
> 
> On further investigation, I believe some if not all of the information
> requested in this BZ is here:
> 
> https://access.redhat.com/documentation/en-us/red_hat_ceph_storage/6/html-
> single/object_gateway_guide/index#transitioning-data-to-amazon-s3-cloud-
> service_rgw
> 
> Could you please confirm and let me know if further changes/additions are
> needed?
> 
> Thanks,
> Lynn


Hi Lynn,

Thanks for the link. The above section seems almost complete, except for the tech-preview note. Also I think it may be helpful to add a bit of description of the necessary/important parameters to configure in the "step(3) Update storage_class:" or maybe atleast we could add link to the upstream doc here - https://docs.ceph.com/en/quincy/radosgw/cloud-transition/#cloud-transition-specific-configurables.

The mandatory parameters are -
*access_key
*secret
*endpoint
*region (in case of AWS)

Other optional parameters to note -
*target_path
*target_storage_class
*retain_head_object
*multipart_sync_threshold/multipart_min_part_size

Thanks,
Soumya

Comment 11 lysanche 2023-03-28 13:31:01 UTC
Hi Soumya,

Thanks very much for your input. I will add the description to step 3. 

What would you like for me to change about the tech-preview note? (For the IBM side, this will be changed to meet IBM's requirements.)

Thanks,
Lynn

Comment 12 Soumya Koduri 2023-03-28 13:34:29 UTC
 
> What would you like for me to change about the tech-preview note? (For the
> IBM side, this will be changed to meet IBM's requirements.)

I meant since this will be supported feature in 6.1, that tech-preview note needs to removed, which I guess will be changed to IBM release note (as you mentioned).

Comment 15 lysanche 2023-04-05 15:15:29 UTC
Hi Ranjini,

I added explanations from upstream and left a question in the MR. Could you please take a look?

https://gitlab.cee.redhat.com/red-hat-ceph-storage-documentation/red-hat-ceph-storage-6/-/merge_requests/95#note_6257508

Thanks,
Lynn

Comment 21 lysanche 2023-04-21 12:29:44 UTC
Hi Soumya Koduri,

There is nothing for you to change regarding tech preview because that has been removed.

This is ready for QA.

Thanks,
Lynn

Comment 23 lysanche 2023-04-24 11:33:39 UTC
QA,

Do you need any further information from me?

This is ready for QA.

Thanks,
Lynn

Comment 24 Tejas 2023-04-24 12:43:00 UTC
hi Lynn,

I discussed with Soumya , and we need 1 additional note.
At the beginning of step 3 "Update storage_class:", we need another note like this:
"If the cluster is part of a Multisite setup , we need to run "period update --commit" so that the zonegroup changes are propagated to all the zones in the multisite"

Comment 26 Tejas 2023-04-24 15:03:42 UTC
Thanks Lynn.
Looks good , moving to Verified state.

Comment 27 lysanche 2023-04-24 15:22:06 UTC
Thanks, Tejas.

Comment 28 lysanche 2023-04-25 15:04:59 UTC
Hi Eric,

The changes have been made and verified for 6.1.

Could you please provide what changes are needed for 5.x since the guide was substantially changed from 5.x to 6.x?

Most current Object Gateway 5 Guide: https://access.redhat.com/documentation/en-us/red_hat_ceph_storage/5/html-single/object_gateway_guide/index

Most current Object Gateway 6 Guide: https://access.redhat.com/documentation/en-us/red_hat_ceph_storage/6/html-single/object_gateway_guide/index

Thanks very much.
Lynn