Bug 1460275

Summary: rbd image needs to be created before the ceph-pod1 is asked to be created.
Product: OpenShift Container Platform Reporter: Ruchika K <rkharwar>
Component: DocumentationAssignee: Vikram Goyal <vigoyal>
Status: CLOSED EOL QA Contact: Vikram Goyal <vigoyal>
Severity: unspecified Docs Contact: Vikram Goyal <vigoyal>
Priority: unspecified    
Version: 3.5.0CC: aos-bugs, jokerman, mmccomas
Target Milestone: ---   
Target Release: ---   
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: 2019-08-10 06:40:29 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:

Description Ruchika K 2017-06-09 14:34:08 UTC 
Document URL: 
https://access.redhat.com/documentation/en-us/openshift_container_platform/3.5/html-single/installation_and_configuration/#using-ceph-rbd-installing-the-ceph-common-package


Section Number and Name: 

Section 22 .3 

Describe the issue: 
The example describes the pv, pvc and the ceph-pod1 creation.
It leaves out one VERY important detail.

Suggestions for improvement: 
In the example here
22.3.4. Creating the Persistent Volume

A number should be assigned to the line "image: ceph-image"
indicating that 
ceph-image rbd image should be created like this on a ceph monitor node

[root@cephmon1 ~]# rbd create --image ceph-image --size 2G --image-feature 
layering

This should be called out specifically to prevent the user from assuming the rbd will be created since the admin key is used. 
Without this the user is likely to see an error thus:

1m         9h          207       ceph-pod1   Pod                   Warning   FailedMount   {kubelet node1.ose.rukh.org}   Unable to mount volumes for pod "ceph-pod1_default(faf66b53-4cca-11e7-9fde-52540023ddd6)": timeout expired waiting for volumes to attach/mount for pod "ceph-pod1"/"default". list of unattached/unmounted volumes=[ceph-vol1]
1m         9h          250       ceph-pod1   Pod                   Warning   FailedSync    {kubelet node1.ose.rukh.org}   Error syncing pod, skipping: timeout expired waiting for volumes to attach/mount for pod "ceph-pod1"/"default". list of unattached/unmounted volumes=[ceph-vol1]
33s        9h          317       ceph-pod1   Pod                   Warning   FailedMount   {kubelet node1.ose.rukh.org}   (events with common reason combined)

Additional information: