Bug 1967448 - [DOC][RBD] - Doc changes for RBD 5.0 block devices guide
Summary: [DOC][RBD] - Doc changes for RBD 5.0 block devices guide
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat Ceph Storage
Classification: Red Hat Storage
Component: Documentation
Version: 5.0
Hardware: x86_64
OS: Linux
unspecified
urgent
Target Milestone: ---
: 5.0
Assignee: Amrita
QA Contact: Veera Raghava Reddy
URL:
Whiteboard:
: 1962508 (view as bug list)
Depends On:
Blocks: 1966486
TreeView+ depends on / blocked
 
Reported: 2021-06-03 07:52 UTC by Harish Munjulur
Modified: 2021-09-09 11:38 UTC (History)
6 users (show)

Fixed In Version:
Doc Type: If docs needed, set a value
Doc Text:
Clone Of:
Environment:
Last Closed: 2021-09-09 11:38:28 UTC
Embargoed:


Attachments (Terms of Use)


Links
System ID Private Priority Status Summary Last Updated
Red Hat Issue Tracker RHCEPH-274 0 None None None 2021-08-31 12:26:48 UTC

Description Harish Munjulur 2021-06-03 07:52:44 UTC
Multiple changes are required for RBD block device guide. Using this BZ as a place holder for all the changes to be done. 

1. [root@rbd-client ~]# rbd help snap list - needs to be accessed using cephadm shell or container. This change has to be done in the complete document. 

2. ISCSI - cephadm installation changes - https://docs.ceph.com/en/latest/cephadm/iscsi/

3. ISCSI - GWCLI access changes https://bugzilla.redhat.com/show_bug.cgi?id=1962508

4. RBD-mirror in section 4 is same as the 4.x of configuration. Commands need to change as per cephadm for configure rbd-mirror
Section 6(The rbd kernel module) is changed which was there in section3 in 4.x doc. Just want to know the reason.

Comment 2 Gopi 2021-06-23 06:44:51 UTC
As per our discussion, please make changes to doc and let us know in case you need any further help.

Comment 4 Amrita 2021-06-30 17:36:00 UTC
Hi Harish and Gopi,

I have incorporated the feedback as per the description and also based on your feedback. 

Gitlab MR:
https://gitlab.cee.redhat.com/red-hat-ceph-storage-documentation/doc-Red_Hat_Ceph_Storage_5-Block_Device_Guide/-/merge_requests/50/diffs

Jenkins preview:
https://jenkins.dxp.redhat.com/job/CCS/job/ccs-mr-preview/1825/artifact/preview/index.html

Thanks
Amrita

Comment 5 Harish Munjulur 2021-07-01 00:41:27 UTC
Hi Amrita I have reviewed chapter 1 and 2. Will add all the changes required into the document.

Comment 6 Harish Munjulur 2021-07-02 19:40:41 UTC
Completed review of chapter 3 to 7 and provided the required changes in the document. 

Chapter 8 will be reviewed by gopi.

Comment 7 Anjana Suparna Sriram 2021-07-06 09:29:25 UTC
*** Bug 1962508 has been marked as a duplicate of this bug. ***

Comment 8 Gopi 2021-07-06 11:47:03 UTC
Hi Amrita,

In section 8.3.2.4 -- Create a configuration file on a Ceph iSCSI gateway node, and then copy it to all iSCSI gateway nodes. ---> No need to copy to all nodes, we can just apply from bootstrap node.

In section 8.3.2.5 -- Apply the specification with the following command: ---> Need to change the path of "iscsi-gateway.yaml" i.e need to cd /etc/ceph/ first then apply from there.

In section 8.3.2.6 -- On all Ceph iSCSI gateway nodes, enable and start the API services: ---> I had couple of questions regarding iscsi services and asked to the developer whether those steps are needed are not as we are not following now. I will get back you once those are clarified.

In section 8.4.2.4 -- You can remove note as we support mixed ip's (ipv4 & ipv6) now.

In section 8.4.4.5 -- Add a host to the host group: --- We need to remove all disks which are added to host before adding host to hots group, else we can't add host to host group. There should be note for it.

Comment 9 Gopi 2021-07-06 12:14:01 UTC
Hi Amrita,

As I said in above command:

In section 8.3.2.2 -- On all Ceph iSCSI gateway nodes, install the ceph-iscsi and tcmu-runner packages: -- you can remove this step as this is not needed for container setups. 

In section 8.3.2.6 -- On all Ceph iSCSI gateway nodes, enable and start the API services:  -- This step is not needed.

Comment 11 Harish Munjulur 2021-07-08 04:16:34 UTC
Working on the doc verification. Need more time.

Comment 12 Veera Raghava Reddy 2021-07-08 08:29:38 UTC
Hi Amritha, Gopi,

I think the preview link does not have changes for Chapter 8?
https://jenkins.dxp.redhat.com/job/CCS/job/ccs-mr-preview/2169/artifact/preview/index.html#prepare-for-fail-back_block

Can we track iSCSI changes in separate BZ? It is confusing to track BZs can be verified or moved to Assigned once RBD changes are validated.

Regards,
Veera

Comment 14 Harish Munjulur 2021-07-08 20:52:36 UTC
I have commented all the changes in the document. chapter 1-7

Comment 15 Veera Raghava Reddy 2021-07-09 04:33:30 UTC
Thanks Amrita, We can continue to track iSCSI changes in this BZ for now.

Comment 16 Amrita 2021-07-09 06:08:30 UTC
Team,

For visibility the scope of this bz is not limited to the description and includes changes, chapter wise in the Guide.

Also `An overview of journal based and snapshot based mirroring` has been added.

Comment 1 tracks the changes .

Thanks
Amrita


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