From 439831f81cb81f4bf93da96850511c73af6f409e Mon Sep 17 00:00:00 2001 From: Alexandra Date: Tue, 12 Jul 2016 11:50:48 +0100 Subject: [PATCH] [DOCS] Adding in note for pretend_min_part_hours_passed After careful consideration, this was the best placement for this addition. It does not fit into the swift config files, nor the dev docs or openstack-manuals. Open to suggestion, but this is my recommendation. Change-Id: I945c1852a8e3e1a317bd6550b077ab24dd937eb8 --- doc/source/developer-docs/playbooks.rst | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/doc/source/developer-docs/playbooks.rst b/doc/source/developer-docs/playbooks.rst index 85ba1528aa..b07a9b29d9 100644 --- a/doc/source/developer-docs/playbooks.rst +++ b/doc/source/developer-docs/playbooks.rst @@ -49,6 +49,25 @@ OpenStack services: * Heat * Horizon +After successful deployment, you are able to update variables in +``/etc/openstack_deploy/user_variables.yml``. + +* Object Storage (swift) + + - The ``pretend_min_part_hours_passed`` option can now be + passed to swift-ring-builder prior to performing a rebalance. This is set by + the ``swift_pretend_min_part_hours_passed`` boolean variable. + The default for this variable is False. However, we recommend using + ``-e swift_pretend_min_part_hours_passed=True`` when running the + ``os-swift.yml`` playbook to avoid resetting ``min_part_hours`` unintentionally. + + .. important:: + + If you run this command and deploy rebalanced rings before a replication + pass completes, you may introduce unavailability in your cluster. + + This should only be used for testing or fully rebalanced clusters. + -------------- .. include:: navigation.txt