Note: This bug is displayed in read-only format because the product is no longer active in Red Hat Bugzilla.
This project is now read‑only. Starting Monday, February 2, please use https://ibm-ceph.atlassian.net/ for all bug tracking management.

Bug 2159850

Summary: [DOC] Ceph5 Troubleshooting Guide - need to fix some explanations
Product: [Red Hat Storage] Red Hat Ceph Storage Reporter: tsaito
Component: DocumentationAssignee: Ranjini M N <rmandyam>
Documentation sub component: Troubleshooting Guide QA Contact: Vinayak Papnoi <vpapnoi>
Status: CLOSED CURRENTRELEASE Docs Contact:
Severity: medium    
Priority: unspecified CC: akraj, gjose, lithomas, pdhange, rmandyam, vdas
Version: 5.2   
Target Milestone: ---   
Target Release: 6.1   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2023-06-21 06:59:51 UTC 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:
Bug Depends On: 2160330    
Bug Blocks:    

Description tsaito 2023-01-11 00:29:37 UTC
[DOC] Ceph5 Troubleshooting Guide -  need to fix some explanations in the Ceph5 Troubleshooting Guide

I understood that Red Hat Ceph Storage 5 is supported on container-based deployments only.
Ι think There may be missing about container-based deployments on the Troubleshooting guide

So, I submitted the BZ, Would you please confirm it ?

Describe the issue:
 - 1.6. Understanding Ceph logs
 - 2.2. Ceph subsystems
 - 5.2.6. Down OSDs
 - 5.4. Mounting the OSD data partition
 - 9. Troubleshooting Ceph objects
 - 9.3. Troubleshooting low-level object operations

Describe the task you were trying to accomplish:
Suggestions for improvement:
> 1.6. Understanding Ceph logs
=> I think It need a description of the container such as "1.4. Understanding Ceph logs" on the Ceph4 troubleshooting guide [1].

> 2.2. Ceph subsystems
=> I think It need a description of the container such as "2.2. Ceph subsystems of Note"[2] the Ceph4 troubleshooting guide.

> 5.2.6. Down OSDs
=> Because it is a description of OSD using bare metal and file system,
=> I think it need a description using container and bluestore.

> 5.4. Mounting the OSD data partition
=> Because it is a description of OSD using bare metal and file system,
=> I think it need a description using container and bluestore.

> 9. Troubleshooting Ceph objects
=> I think it need a description of the container such as the Ceph4 troubleshooting guide ("10.4 Troubleshooting Ceph objects in a containerized environment"[3]).

> 9.3. Troubleshooting low-level object operations
 => I think it need a description loging in to the Cephadm shell such as "9.2. Troubleshooting high-level object operations"[4].
    Part 9.3.2 , 9.3.6 and 9.3.8 are missing the description of "# cephadm shell".

Document URL:
Chapter/Section Number and Title:
 1.6. Understanding Ceph logs
 https://access.redhat.com/documentation/en-us/red_hat_ceph_storage/5/html-single/troubleshooting_guide/index#understanding-ceph-logs_diag

 2.2. Ceph subsystems
 https://access.redhat.com/documentation/en-us/red_hat_ceph_storage/5/html-single/troubleshooting_guide/index#ceph-subsystems_diag

 5.2.6. Down OSDs
 https://access.redhat.com/documentation/en-us/red_hat_ceph_storage/5/html-single/troubleshooting_guide/index#down-osds_diag

 5.4. Mounting the OSD data partition
 https://access.redhat.com/documentation/en-us/red_hat_ceph_storage/5/html-single/troubleshooting_guide/index#mounting-the-osd-data-partition_diag

 9. Troubleshooting Ceph objects
 https://access.redhat.com/documentation/en-us/red_hat_ceph_storage/5/html-single/troubleshooting_guide/index#troubleshooting-ceph-objects

 9.3. Troubleshooting low-level object operations
 https://access.redhat.com/documentation/en-us/red_hat_ceph_storage/5/html-single/troubleshooting_guide/index#troubleshooting-low-level-object-operations

Product Version:
 Red Hat Ceph Storage 5 Troubleshooting Guide

Environment Details:
 The container and bluestore environment

Additional information:
 There are the same requests on Red Hat Ceph Storage 4 Troubleshooting Guide as BZ#2011149.

 [1] https://access.redhat.com/documentation/en-us/red_hat_ceph_storage/4/html-single/troubleshooting_guide/index#non_containerized_deployment
 [2] https://access.redhat.com/documentation/en-us/red_hat_ceph_storage/4/html-single/troubleshooting_guide/index#ceph-subsystems_diag
 [3] https://access.redhat.com/documentation/en-us/red_hat_ceph_storage/4/html-single/troubleshooting_guide/index#troubleshooting-ceph-objects-in-a-containerized-environment_diag
 [4] https://access.redhat.com/documentation/en-us/red_hat_ceph_storage/5/html-single/troubleshooting_guide/index#troubleshooting-high-level-object-operations