Bug 2214537

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