Bug 1263850

Summary: [Docs] [Director] Requesting Clarification in Openstack Overcloud/Ceph Documentation
Product: Red Hat OpenStack Reporter: Justin Bautista <jbautist>
Component: documentationAssignee: Dan Macpherson <dmacpher>
Status: CLOSED CURRENTRELEASE QA Contact:
Severity: medium Docs Contact:
Priority: medium    
Version: 7.0 (Kilo)CC: adahms, jbautist, yeylon
Target Milestone: y2Keywords: Documentation, ZStream
Target Release: 7.0 (Kilo)   
Hardware: x86_64   
OS: Linux   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2015-10-07 01:49:36 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 Justin Bautista 2015-09-16 21:24:59 UTC 
Description of problem:

Customer required clarification on a note included in the OpenStack docs, specifically:

https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux_OpenStack_Platform/7/html/Director_Installation_and_Usage/sect-Advanced-Scenario_3_Using_the_CLI_to_Create_an_Advanced_Overcloud_with_Ceph_Nodes.html#sect-Advanced-Configuring_Ceph_Storage

> The director does not create partitions on the journal disk. Manually create the journal partitions before installing Ceph storage servers.
The Ceph Storage OSDs and journals partitions require GPT disk labels, which you also configure prior to customization. For example, use the following command on the potential Ceph Storage host to create a GPT disk label for a disk or partition.

The wording in the document left them confused & felt that the document was suggesting that they create journal partitions before installing Ceph storage servers. It was not clear that those steps need to be taken before the director deployment on the storage nodes (with a separate image).

Filing this BZ in hopes that the wording in this section of the document could be made more clear & possibly provide the process.
===================================================================

Possibly something like the following:

"The director does not create partitions on the journal disk. The journal disk partition will need to be manually created before Director can deploy the storage nodes. The Ceph Storage OSDs and journal partitions require GPT disk labels, which you also configure prior to customization. For example, use the following command on the potential Ceph Storage host to create a GPT disk label for a disk or partition:"

  <example>
Comment 3 Andrew Dahms 2015-09-23 23:04:10 UTC 
Assigning to Dan for review.
Comment 5 Dan Macpherson 2015-09-28 01:43:04 UTC 
The note now reads:

== Important ==
The director does not create partitions on the journal disk. You must manually create these journal partitions before the Director can deploy the Ceph Storage nodes.
The Ceph Storage OSDs and journals partitions require GPT disk labels, which you also configure prior to customization. For example, use the following command on the potential Ceph Storage host to create a GPT disk label for a disk or partition:

# parted [device] mklabel gpt


Link to text: https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux_OpenStack_Platform/7/html/Director_Installation_and_Usage/sect-Advanced-Scenario_3_Using_the_CLI_to_Create_an_Advanced_Overcloud_with_Ceph_Nodes.html#sect-Advanced-Configuring_Ceph_Storage

Justin, how does the note read now? Is it clearer? Did you have any other suggestions for changes?
Comment 7 Dan Macpherson 2015-10-07 01:49:36 UTC 
Awesome! Closing this bug.