Bug 1881207 - [Documentation Bug] crush_rules configuration for ceph-ansible is wrong
Summary: [Documentation Bug] crush_rules configuration for ceph-ansible is wrong
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat Ceph Storage
Classification: Red Hat
Component: Documentation
Version: 4.0
Hardware: Unspecified
OS: Unspecified
unspecified
medium
Target Milestone: rc
: 5.*
Assignee: Ranjini M N
QA Contact: Veera Raghava Reddy
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2020-09-21 19:42 UTC by Matthew Secaur
Modified: 2020-09-25 14:47 UTC (History)
3 users (show)

Fixed In Version:
Doc Type: If docs needed, set a value
Doc Text:
Clone Of:
Environment:
Last Closed: 2020-09-25 14:47:06 UTC
Target Upstream Version:


Attachments (Terms of Use)

Description Matthew Secaur 2020-09-21 19:42:52 UTC
Describe the issue:
The Ceph 4.x documentation section titled "4.8. Deploying OSDs with different hardware on the same host" has incorrect syntax and a typo.

Describe the task you were trying to accomplish:
Configuring an SSD tier and an HDD tier on a single Ceph cluster using ceph-ansible

Suggestions for improvement:
The documentation has this stanza which has erroneous formatting and a typo that will cause a failure:

create_crush_tree: true
crush_rule_config: true
crush_rules:
  name: HDD
    root: default
    type: host
    class: hdd
    default: true
  name: SDD
    root: default
    type: host
    class: sdd
    default: true

This is the correct formatting of the "crush_rules" section and using a valid device class (s/sdd/ssd/):

create_crush_tree: true
crush_rule_config: true
crush_rules:
  - name: HDD
    root: default
    type: host
    class: hdd
    default: true
  - name: SDD
    root: default
    type: host
    class: ssd
    default: true

Document URL:
https://access.redhat.com/documentation/en-us/red_hat_ceph_storage/4/html-single/installation_guide/index#deploying-osds-with-different-hardware-on-the-same-host_install

Chapter/Section Number and Title:
4.8. Deploying OSDs with different hardware on the same host

Product Version:
Ceph 4.x

Environment Details:
Environments with two tiers of disks.

Any other versions of this document that also needs this update:
Probably all of the Ceph 4 versions.

Additional information:
none

Comment 1 RHEL Program Management 2020-09-21 19:42:59 UTC
Please specify the severity of this bug. Severity is defined here:
https://bugzilla.redhat.com/page.cgi?id=fields.html#bug_severity.


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