Bug 1969586 - [5.0] - Changes to Configuration guide
Summary: [5.0] - Changes to Configuration guide
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat Ceph Storage
Classification: Red Hat Storage
Component: Documentation
Version: 5.0
Hardware: Unspecified
OS: Unspecified
urgent
urgent
Target Milestone: ---
: 5.0
Assignee: Karen Norteman
QA Contact: Preethi
URL:
Whiteboard:
Depends On:
Blocks: 1966486
TreeView+ depends on / blocked
 
Reported: 2021-06-08 17:22 UTC by Preethi
Modified: 2021-09-09 11:42 UTC (History)
5 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:23 UTC
Embargoed:


Attachments (Terms of Use)


Links
System ID Private Priority Status Summary Last Updated
Red Hat Issue Tracker RHCEPH-1485 0 None None None 2021-09-09 11:42:55 UTC

Description Preethi 2021-06-08 17:22:43 UTC
[5.0] - Changes to Configuration guide


Following are the inputs for the above mentioned guide

Guide carries the exact 4.x contents to 5.0 which is applicable as well however, few things needs to be added/modified as per 5.0

1)Remove ansible contents from guide and wherever it talks about ansible as deployment tool

2) Need to add Cephadm as deployment tool for 5.0 and info related to that 

3) We also need to add the option of adding public network and cluster network related using cephadm option to use them 

4)Ceph debugging and Logging configuration - Should change as per 5.0, example :as we have cephadm.log now

Comment 4 Preethi 2021-07-09 06:49:21 UTC
@Anjan/Karen, We still see the contents of 4.x in the doc guide. Also, regarding " We also need to add the option of adding public network and cluster network related using cephadm option to use them " - We have option to pass this in bootstrap argument itself. - CHeck with dev for the content


Example: We have said to refer group_vars/osds.yaml which is incorrect for 5.0

Sec 1.8. OSD MEMORY TARGET
BlueStore keeps OSD heap memory usage under a designated target size with the osd_memory_target configuration option.

The option osd_memory_target sets OSD memory based upon the available RAM in the system. You can change the value, expressed in bytes, in the group_vars/all.yml file when deploying the daemon.

Example: Set the osd_memory_target to 6000000000 bytes

ceph_conf_overrides:
  osd:
    osd_memory_target=6000000000
Ceph OSD memory caching is more important when the block device is slow, for example, traditional hard drives, because the benefit of a cache hit is much higher than it would be with a solid state drive. However, this has to be weighed-in to co-locate OSDs with other services, such as in a hyper-converged infrastructure (HCI), or other applications.

Note
The value of osd_memory_target is one OSD per device for traditional hard drive device, and two OSDs per device for NVMe SSD devices. The osds_per_device is defined in group_vars/osds.yml file.

Comment 5 Preethi 2021-07-09 06:52:25 UTC
(In reply to Preethi from comment #0)
> [5.0] - Changes to Configuration guide
> 
> 
> Following are the inputs for the above mentioned guide
> 
> Guide carries the exact 4.x contents to 5.0 which is applicable as well
> however, few things needs to be added/modified as per 5.0
> 
> 1)Remove ansible contents from guide and wherever it talks about ansible as
> deployment tool - We see the contents related to refer .yaml files in couple of sections as mentioned below
> 
> 2) Need to add Cephadm as deployment tool for 5.0 and info related to that - This is addressed
> 
> 3) We also need to add the option of adding public network and cluster -- This we have option to pass the arguments at the time of bootstrapping. We need to doc this as well
> network related using cephadm option to use them 
> 
> 4)Ceph debugging and Logging configuration - Should change as per 5.0, - Looks good as links are provided for reference
> example :as we have cephadm.log now

Comment 10 Preethi 2021-07-12 17:10:44 UTC
@Karen, Section 1.8 has content related to 4.x - Post that fix, will move it to verified.

Comment 12 Preethi 2021-07-13 05:06:54 UTC
@karen, Thanks. Content looks good and 4.x info is removed. Will move the BZ to verfiied.


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