Bug 1267690 - [director] document how to partition disks manually
[director] document how to partition disks manually
Product: Red Hat OpenStack
Classification: Red Hat
Component: documentation (Show other bugs)
7.0 (Kilo)
Unspecified Unspecified
high Severity unspecified
: y1
: 7.0 (Kilo)
Assigned To: Dan Macpherson
RHOS Documentation Team
: Documentation, FutureFeature, ZStream
Depends On: 1252260 1256103
Blocks: 1190166 1243520
  Show dependency treegraph
Reported: 2015-09-30 12:46 EDT by Mike Burns
Modified: 2016-06-16 00:40 EDT (History)
13 users (show)

See Also:
Fixed In Version:
Doc Type: Enhancement
Doc Text:
Story Points: ---
Clone Of: 1252260
Last Closed: 2016-06-16 00:40:56 EDT
Type: Bug
Regression: ---
Mount Type: ---
Documentation: ---
Verified Versions:
Category: ---
oVirt Team: ---
RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: ---

Attachments (Terms of Use)

  None (edit)
Comment 1 Mike Burns 2015-09-30 12:48:06 EDT
Giulio,  can you provide the required information here?
Comment 2 Giulio Fidente 2015-10-02 06:52:04 EDT
Mike, I think the existing docs cover much of the issue, see:


(if on the first load attempt the link does not bring you to the relevant section try a reload)

Regardless, the existing docs say so:

 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

This remains valid, I think we might just add a command to create the actual journal partition.

 This following will create a primary partition on [device] which spans the entire disk. For more options refer to parted(8).

  # parted -a optimal [device] mkpart primary 0% 100%
Comment 3 Giulio Fidente 2015-10-02 07:01:33 EDT
Maybe it is useful to state clearly that users are only required to partition manually the disks if they want to use dedicated disks as journal devices.

In which case only the journal disks need to be partitioned manually, using a GPT table. The OSD disks mapping config parameter should look something like:

ceph::profile::params::osds: {/dev/sdb: {journal: /dev/sdd1}, /dev/sdc: {journal: /dev/sdd2}}

where /dev/sdb and /dev/sdc are data disks and /dev/sdc{1,2} the partitions to be used for the respective journals.
Comment 4 Giulio Fidente 2015-10-02 07:03:51 EDT
Amend, in the example in c#3 /dev/sdd{1,2} are the partitions to be used for the respective journals.
Comment 5 Dan Macpherson 2016-05-12 21:24:37 EDT
I think I got this covered in the Ceph Guide:


Mike, Giulio -- Anything else I should add/modify for this section?
Comment 8 Dan Macpherson 2016-05-23 02:25:22 EDT
Removed admonition:

Will be published on the next cycle.

How does that sound, Giulio? Is it okay to close this BZ?
Comment 9 Giulio Fidente 2016-05-23 04:57:00 EDT
Yes thanks, I think we can close the BZ!
Comment 10 Dan Macpherson 2016-05-23 05:50:44 EDT
Closing BZ as verified. Final chance will be published on the next cycle (which should be this week).
Comment 11 Dan Macpherson 2016-06-16 00:40:56 EDT
Changes now live on the customer portal.

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