ring documentation confusing with regards to 'partition'

Bug #1033903 reported by Tom Fifield on 2012-08-07
6
This bug affects 1 person
Affects Status Importance Assigned to Milestone
openstack-manuals
High
Tom Fifield

Bug Description

I have encountered several people who have been confused into creating some huge amount of (physical) disk partitions by the following:

"""
Preparing the Ring

The first step is to determine the number of partitions that will be in the ring. We recommend that there be a minimum of 100 partitions per drive to insure even distribution across the drives. A good starting point might be to figure out the maximum number of drives the cluster will contain, and then multiply by 100, and then round up to the nearest power of two.

For example, imagine we are building a cluster that will have no more than 5,000 drives. That would mean that we would have a total number of 500,000 partitions, which is pretty close to 2^19, rounded up.
"""

http://docs.openstack.org/trunk/openstack-object-storage/admin/content/preparing-the-ring.html

Of course, what the doc is referring to is partitions in the ring, not physical disk partitions. Each disk should have one partition - as correctly described in the install documentation fdisk commands.

I would suggest that we change the first paragraph of "Preparing the Ring" to ensure that the reader can easily determine which are disk partitions are which are partitions in the ring.

See also: https://bugs.launchpad.net/openstack-manuals/+bug/988048

Tom Fifield (fifieldt) on 2012-08-07
Changed in openstack-manuals:
status: New → Triaged
importance: Undecided → High
Tom Fifield (fifieldt) on 2012-08-07
Changed in openstack-manuals:
assignee: nobody → Tom Fifield (fifieldt)

Fix proposed to branch: master
Review: https://review.openstack.org/10946

Changed in openstack-manuals:
status: Triaged → In Progress

Reviewed: https://review.openstack.org/10946
Committed: http://github.com/openstack/openstack-manuals/commit/68b9e95fe2ce0c23c797b03b1fe9cb048d78e86e
Submitter: Jenkins
Branch: master

commit 68b9e95fe2ce0c23c797b03b1fe9cb048d78e86e
Author: Tom Fifield <email address hidden>
Date: Tue Aug 7 20:27:23 2012 +1000

    Adds a clarifying statement re: partition meaning

    fixes bug 1033903

    Have encountered several people who have been confused into creating some
    huge amount of (physical) disk partitions by the text following this
    change. So the idea here is to add a clarifying note so there is no
    ambiguity about what "partition" means in this section.

    Change-Id: Ieea81d8f1aad8ddf0f31697d4c2cd54a8b0c288d

Changed in openstack-manuals:
status: In Progress → Fix Released
To post a comment you must log in.
This report contains Public information  Edit
Everyone can see this information.

Other bug subscribers