Bug 1460275 - rbd image needs to be created before the ceph-pod1 is asked to be created.
rbd image needs to be created before the ceph-pod1 is asked to be created.
Status: NEW
Product: OpenShift Container Platform
Classification: Red Hat
Component: Documentation (Show other bugs)
3.5.0
Unspecified Unspecified
unspecified Severity unspecified
: ---
: ---
Assigned To: Vikram Goyal
Vikram Goyal
Vikram Goyal
:
Depends On:
Blocks:
  Show dependency treegraph
 
Reported: 2017-06-09 10:34 EDT by Ruchika K
Modified: 2017-06-09 10:34 EDT (History)
3 users (show)

See Also:
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: ---


Attachments (Terms of Use)

  None (edit)
Description Ruchika K 2017-06-09 10:34:08 EDT
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:

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