Bug 2182366 - [CEE/SDS][doc]2.11. Ephemeral pinning policies section contains incorrect information
Summary: [CEE/SDS][doc]2.11. Ephemeral pinning policies section contains incorrect inf...
Keywords:
Status: RELEASE_PENDING
Alias: None
Product: Red Hat Ceph Storage
Classification: Red Hat Storage
Component: Documentation
Version: 5.3
Hardware: x86_64
OS: All
unspecified
medium
Target Milestone: ---
: Backlog
Assignee: Anjana Suparna Sriram
QA Contact: Aditya Ramteke
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2023-03-28 12:33 UTC by Geo Jose
Modified: 2023-08-03 11:12 UTC (History)
1 user (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-6330 0 None None None 2023-03-28 12:34:10 UTC

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 4 lysanche 2023-05-03 11:44:10 UTC
Merged to master/main and moved to release_pending.


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