Bug 1477260 - [Doc-RFE] Document how to co-locate containerized daemons with OSD containers
Summary: [Doc-RFE] Document how to co-locate containerized daemons with OSD containers
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat Ceph Storage
Classification: Red Hat Storage
Component: Documentation
Version: 3.0
Hardware: Unspecified
OS: Unspecified
high
unspecified
Target Milestone: rc
: 3.0
Assignee: Bara Ancincova
QA Contact: Vasishta
URL:
Whiteboard:
Depends On: 1477276
Blocks:
TreeView+ depends on / blocked
 
Reported: 2017-08-01 15:07 UTC by Anjana Suparna Sriram
Modified: 2017-12-26 03:41 UTC (History)
6 users (show)

Fixed In Version:
Doc Type: If docs needed, set a value
Doc Text:
Clone Of:
Environment:
Last Closed: 2017-12-26 03:41:20 UTC
Embargoed:


Attachments (Terms of Use)

Description Anjana Suparna Sriram 2017-08-01 15:07:05 UTC
Additional info:

RHCS 3.0 Content Plan:
https://docs.google.com/document/d/1fp1j6iPr9UPHCMWqqS8QG3SXiSQ3n9Y9a1YogivhtzA/edit

Comment 4 seb 2017-09-12 17:18:21 UTC
The section looks good Bara

Comment 7 Vasishta 2017-09-19 10:17:49 UTC
Hi Bara,

In Section 1.2, Step 5.ii,

1) All mentions of ceph_osd_docker_extra_env has to be removed as it is no longer needed.

2) value of ceph_osd_docker_prepare_env should be "-e OSD_JOURNAL_SIZE={{ journal_size }}" So it can be added in example usage section as,

ceph_osd_docker_prepare_env: -e OSD_JOURNAL_SIZE={{ journal_size }}

3) As example description says 'For example, if you want to use encrypted OSDs with a separated journal, use', I think we need to provide steps/instructions to enable the variable 'dmcrypt', 'devices', 'dedicated_devices', and 'osd_scenario'.

In this case,
dmcrypt: true
osd_scenario: non-collocated

I think we can suggest users to select for appropriate as per their environment devices and dedicated_devices.
I think the word 'separated' in example description can be changed to 'dedicated' to maintain consistency between variable name and description.

REF - https://bugzilla.redhat.com/show_bug.cgi?id=1475820#c12

----------------------------------------------------------------

In Section 1.3, Step 3 needs to be removed as the variable 'rgw_containerized_deployment' has been removed from rgws.yml


Moving back to ASSIGNED, please let me know if there are any concerns.


Regards,
Vasishta

Comment 9 seb 2017-09-20 12:41:47 UTC
Bara, after looking at https://doc-stage.usersys.redhat.com/documentation/en-us/red_hat_ceph_storage/3/html-single/container_guide/#installing-a-red-hat-ceph-storage-cluster-in-containers

You can remove some variables:

* 'docker' has never been needed

The 3.3. Purging Clusters Deployed by Ansible section

You have to copy the file at the root of the repo. So:

[user@admin ceph-ansible]$ cp infrastructure-playbooks/purge-docker-cluster.yml . 

The rest looks good.

Comment 11 Vasishta 2017-10-12 13:26:44 UTC
Hi Bara,

Sorry for the delayed update.

Here are some points that I think doc needs to be having.

1) In the list of daemons supported to be colocated with OSD, NFS is missing, can you please add it ?

2) In procedure section of 2.2, As we are talking about colocated daemons, it would be better if we mention like - 
By default, the value of ceph_<daemon_type>_docker_memory_limit and ceph_<daemon_type>_docker_cpu_limit will be 1 and the colocated daemon will be configured with default value if its not changed.

3) Can you please add an example for "How Colocation Works" ? 
Though the description for "How Colocation Works" looks good, It would be better if we can add an example of "Ansible inventory file" following the convention as in step 6 of Section 1.2 -

like -

[mons]
<monitor-host-name>

[mgrs]
<monitor-host-name>

[osds]
<monitor-host-name>
<osd-host-name-1>
<osd-host-name-2>

[rgws]
<osd-host-name-1> #RGW will be collocated with OSD 
<gateway>

Can we expect this bug come ON_QA once we get the diagram ? (Just to make sure that QE doesn't miss out checking the diagram) ?

Regards,
Vasishta

Comment 16 Vasishta 2017-10-17 11:19:16 UTC
Hi Bara,

Yes, Looks good to me, Moving to VERIFIED state.

Thanks,
Vasishta


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