Bug 2182366

Summary:	[CEE/SDS][doc]2.11. Ephemeral pinning policies section contains incorrect information
Product:	[Red Hat Storage] Red Hat Ceph Storage	Reporter:	Geo Jose <gjose>
Component:	Documentation	Assignee:	Anjana Suparna Sriram <asriram>
Documentation sub component:	File System Guide	QA Contact:	Aditya Ramteke <aramteke>
Status:	RELEASE_PENDING ---	Docs Contact:
Severity:	medium
Priority:	unspecified	CC:	rmandyam
Version:	5.3	Keywords:	NoDocsQEReview
Target Milestone:	---
Target Release:	Backlog
Hardware:	x86_64
OS:	All
Whiteboard:
Fixed In Version:		Doc Type:	If docs needed, set a value
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:		Type:	Bug
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:

Description Geo Jose 2023-03-28 12:33:38 UTC

Describe the issue:
 - 2.11. Ephemeral pinning policies section contains incorrect information 

Describe the task you were trying to accomplish:
 - The below statement seems to be wrong:
~~~
By default, both of these ephemeral pin policies are disabled. This feature can be enabled by setting either the mds_export_ephemeral_distributed or mds_export_ephemeral_random Ceph MDS configuration options. 
~~~ 

Suggestions for improvement:
 - The parameters "mds_export_ephemeral_distributed" and "mds_export_ephemeral_random" are already enabled.

Document URL:
[RHCS 5] https://access.redhat.com/documentation/en-us/red_hat_ceph_storage/5/html/file_system_guide/the-ceph-file-system-metadata-server#ephemeral-pinning-policies_fs 
[RHCS 6] https://access.redhat.com/documentation/en-us/red_hat_ceph_storage/6/html/file_system_guide/the-ceph-file-system-metadata-server#ephemeral-pinning-policies_fs

Chapter/Section Number and Title:
2.11. Ephemeral pinning policies [RHCS 5]
2.10. Ephemeral pinning policies [RHCS 6]

Product Version:
RHCS 5.3 and RHCS 6

Environment Details:
NA

Comment 1 Geo Jose 2023-03-28 12:35:47 UTC

Additional information:

The parameters "mds_export_ephemeral_distributed" and "mds_export_ephemeral_random" are already enabled.

1) For RHCS 5.3 on RHEL 9:
~~~
[root@02-91-05-node1 ~]# ceph tell mds.myvolume.02-91-05-node1.icicot config show | egrep -a 'mds_export_ephemeral_random|mds_export_ephemeral_distributed'
2023-03-24T17:37:34.148+0530 7fefcdffb640  0 client.195627 ms_handle_reset on v2:192.168.122.103:6800/1468072543
2023-03-24T17:37:34.164+0530 7fefcdffb640  0 client.195633 ms_handle_reset on v2:192.168.122.103:6800/1468072543
    "mds_export_ephemeral_distributed": "true",
    "mds_export_ephemeral_distributed_factor": "2.000000",
    "mds_export_ephemeral_random": "true",
    "mds_export_ephemeral_random_max": "0.010000",
[root@02-91-05-node1 ~]# ceph version
ceph version 16.2.10-138.el8cp (a63ae467c8e1f7503ea3855893f1e5ca189a71b9) pacific (stable)
[root@02-91-05-node1 ~]# 
~~~

2) For RHCS 5.3 on RHEL 8
~~~
[root@01-87-05-node1 ~]# ceph tell mds.cephfs.01-87-05-node2.jtwsrb config show | egrep -a 'mds_export_ephemeral_random|mds_export_ephemeral_distributed'
2023-03-24T17:41:44.238+0530 7fc505ffb700  0 client.224223 ms_handle_reset on v2:192.168.122.50:6800/2402226047
2023-03-24T17:41:44.271+0530 7fc505ffb700  0 client.224218 ms_handle_reset on v2:192.168.122.50:6800/2402226047
    "mds_export_ephemeral_distributed": "true",
    "mds_export_ephemeral_distributed_factor": "2.000000",
    "mds_export_ephemeral_random": "true",
    "mds_export_ephemeral_random_max": "0.010000",
[root@01-87-05-node1 ~]# ceph version
ceph version 16.2.10-94.el8cp (48ce8ed67474ea50f10c019b9445be7f49749d23) pacific (stable)
[root@01-87-05-node1 ~]# 
~~~

Regards,
Geo Jose

Comment 2 lysanche 2023-05-01 12:06:16 UTC

Hi Ranjini,

Could you please peer review?

For RHCS 6

MR: https://gitlab.cee.redhat.com/red-hat-ceph-storage-documentation/red-hat-ceph-storage-6/-/merge_requests/104

Preview: https://jenkins.dxp.redhat.com/job/CCS/job/ccs-mr-preview/47059/artifact/titles/file-system/preview/index.html#ephemeral-pinning-policies_fs


For RHCS 5

MR: https://gitlab.cee.redhat.com/red-hat-ceph-storage-documentation/doc-Red_Hat_Ceph_Storage_5-File_System_Guide/-/merge_requests/108

Preview: https://jenkins.dxp.redhat.com/job/CCS/job/ccs-mr-preview/47060/artifact/preview/index.html#ephemeral-pinning-policies_fs

Thanks,
Lynn

Comment 4 lysanche 2023-05-03 11:44:10 UTC

Merged to master/main and moved to release_pending.