Bug 2176088 - [GSS] Document the common issues and troubleshooting steps for MDS/CephFS
Summary: [GSS] Document the common issues and troubleshooting steps for MDS/CephFS
Keywords:
Status: NEW
Alias: None
Product: Red Hat Ceph Storage
Classification: Red Hat Storage
Component: Documentation
Version: 5.3
Hardware: All
OS: Linux
unspecified
high
Target Milestone: ---
: 6.1z2
Assignee: Anjana Suparna Sriram
QA Contact: Aditya Ramteke
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2023-03-07 11:27 UTC by Karun Josy
Modified: 2023-07-25 18: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-6237 0 None None None 2023-03-07 11:29:38 UTC

Description Karun Josy 2023-03-07 11:27:13 UTC
* Describe the issue:

In RHCS 5, we do not have a troubleshooting section for MDS.
In the Filesystem guide[1] we have a section : "Appendix A. Health messages for the Ceph File System"

But this just lists out and defines various Health errors/warnings for MDS.
It does not explain the steps that support/customers should take to address individual issues. Nor do we think it is comprehensive enough to understand the issue. 


[1] https://access.redhat.com/documentation/en-us/red_hat_ceph_storage/5/html/file_system_guide/health-messages-for-the-ceph-file-system_fs


* Suggestions for improvement:

We are looking for a comprehensive document that
- explains all the common issues with MDS/CephFS
- Logs that need to be collected(at what level) for further review
- Steps needed to fix the issue or apply any workaround



* Document URL:

We can either add this as a separate section in 
Filesystem Guide or Troubleshooting Guide

Comment 1 Karun Josy 2023-03-07 11:27:13 UTC
Additional Information :

For example, we have a Ceph-ISCSI section that is well documented with the support of ISCSI developers:  https://bugzilla.redhat.com/show_bug.cgi?id=1713514


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