ring documentation confusing with regards to 'partition'

[Tom Fifield]

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

[OpenStack Infra (hudson-openstack)]

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

[OpenStack Infra (hudson-openstack)]

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