Bug 2214537 - MDS manual service deployment pool creation step lacks required pg count arguments
Summary: MDS manual service deployment pool creation step lacks required pg count argu...
Keywords:
Status: RELEASE_PENDING
Alias: None
Product: Red Hat Ceph Storage
Classification: Red Hat Storage
Component: Documentation
Version: 6.0
Hardware: Unspecified
OS: Unspecified
unspecified
low
Target Milestone: ---
: 6.1z1
Assignee: Ranjini M N
QA Contact: Hemanth Kumar
Anjana Suparna Sriram
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2023-06-13 09:38 UTC by Harald Klein
Modified: 2023-07-26 15:50 UTC (History)
5 users (show)

Fixed In Version:
Doc Type: If docs needed, set a value
Doc Text:
Clone Of:
Environment:
Last Closed:
Embargoed:


Attachments (Terms of Use)


Links
System ID Private Priority Status Summary Last Updated
Red Hat Issue Tracker RHCEPH-6977 0 None None None 2023-07-10 11:13:01 UTC

Description Harald Klein 2023-06-13 09:38:06 UTC
Describe the issue:

The documented example in method 2 step a) [1] for manually deploying the MDS service via CLI does lack the pg count argument on pool creation.

~~~
[ceph: root@host01 /]# ceph osd pool create cephfs_data
[ceph: root@host01 /]# ceph osd pool create cephfs_metadata
~~~

Running those pool creation examples gives an error like this:
~~~
# ceph osd pool create cephfs_metadata
Error ERANGE: 'pgp_num' must be greater than 0 and lower or equal than 'pg_num', which in this case is 1
~~~

Describe the task you were trying to accomplish:

Follow the example from method 2 step a.

Suggestions for improvement:

Example should include reasonable PG counts so that the commands do run without error, e.g. like:

~~~
# ceph osd pool create cephfs_metadata 64 64
~~~

RHCS4 still had the pg count in the command: https://access.redhat.com/documentation/en-us/red_hat_ceph_storage/4/html/file_system_guide/deployment-of-the-ceph-file-system#creating-a-ceph-file-system_fs
That doc also recommends a typical range for this argument ("Recommended metadata pool sizes range from 64 PGs to 512 PGs. ")

Document URL:

https://access.redhat.com/documentation/en-us/red_hat_ceph_storage/6/html-single/file_system_guide/index#deploying-the-mds-service-using-the-command-line-interface_fs


Chapter/Section Number and Title:

2.5.1. Deploying the MDS service using the command line interface

Method 2 step a) 

Product Version:

RHCS6

Environment Details:

n/a

Any other versions of this document that also needs this update:

RHCS4 has the right command. RHCS5 doesn't list manual creation as possible step at all.

Additional information:

n/a

Comment 6 Hemanth Kumar 2023-07-24 07:31:11 UTC
Looks Good.


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