diff --git a/doc/install-guide/section_swift-initial-rings.xml b/doc/install-guide/section_swift-initial-rings.xml
index 0d06eb8c08..aa57c0e7f3 100644
--- a/doc/install-guide/section_swift-initial-rings.xml
+++ b/doc/install-guide/section_swift-initial-rings.xml
@@ -31,6 +31,9 @@
Create the base account.builder file:
# swift-ring-builder account.builder create 10 3 1
+
+ This command provides no output.
+
Add each storage node to the ring:
@@ -48,28 +51,31 @@
Repeat this command for each storage device on each storage
node. In the example architecture, use the command in four variations:
# swift-ring-builder account.builder add r1z1-10.0.0.51:6002/sdb1 100
+Device d0r1z1-10.0.0.51:6002R10.0.0.51:6002/sdb1_"" with 100.0 weight got id 0
# swift-ring-builder account.builder add r1z2-10.0.0.51:6002/sdc1 100
+Device d1r1z2-10.0.0.51:6002R10.0.0.51:6002/sdc1_"" with 100.0 weight got id 1
# swift-ring-builder account.builder add r1z3-10.0.0.52:6002/sdb1 100
-# swift-ring-builder account.builder add r1z4-10.0.0.52:6002/sdc1 100
+Device d2r1z3-10.0.0.52:6002R10.0.0.52:6002/sdb1_"" with 100.0 weight got id 2
+# swift-ring-builder account.builder add r1z4-10.0.0.52:6002/sdc1 100
+Device d3r1z4-10.0.0.52:6002R10.0.0.52:6002/sdc1_"" with 100.0 weight got id 3
Verify the ring contents:
# swift-ring-builder account.builder
account.builder, build version 4
-1024 partitions, 3.000000 replicas, 1 regions, 1 zones, 4 devices, 0.00 balance
+1024 partitions, 3.000000 replicas, 1 regions, 4 zones, 4 devices, 100.00 balance, 0.00 dispersion
The minimum number of hours before a partition can be reassigned is 1
-Devices: id region zone ip address port replication ip replication port name weight partitions balance meta
- 0 1 1 10.0.0.51 6002 10.0.0.51 6002 sdb1 100.00 768 0.00
- 1 1 1 10.0.0.51 6002 10.0.0.51 6002 sdc1 100.00 768 0.00
- 2 1 1 10.0.0.52 6002 10.0.0.52 6002 sdb1 100.00 768 0.00
- 3 1 1 10.0.0.52 6002 10.0.0.52 6002 sdc1 100.00 768 0.00
+The overload factor is 0.00% (0.000000)
+Devices: id region zone ip address port replication ip replication port name weight partitions balance meta
+ 0 1 1 10.0.0.51 6002 10.0.0.51 6002 sdb1 100.00 0 -100.00
+ 1 1 2 10.0.0.51 6002 10.0.0.51 6002 sdc1 100.00 0 -100.00
+ 2 1 3 10.0.0.52 6002 10.0.0.52 6002 sdb1 100.00 0 -100.00
+ 3 1 4 10.0.0.52 6002 10.0.0.52 6002 sdc1 100.00 0 -100.00
Rebalance the ring:
- # swift-ring-builder account.builder rebalance
-
- This process can take a while.
-
+ # swift-ring-builder account.builder rebalance
+Reassigned 1024 (100.00%) partitions. Balance is now 0.00. Dispersion is now 0.00
@@ -89,6 +95,9 @@ Devices: id region zone ip address port replication ip replication
Create the base container.builder
file:
# swift-ring-builder container.builder create 10 3 1
+
+ This command provides no output.
+
Add each storage node to the ring:
@@ -106,28 +115,31 @@ Devices: id region zone ip address port replication ip replication
Repeat this command for each storage device on each storage
node. In the example architecture, use the command in four variations:
# swift-ring-builder container.builder add r1z1-10.0.0.51:6001/sdb1 100
+Device d0r1z1-10.0.0.51:6001R10.0.0.51:6001/sdb1_"" with 100.0 weight got id 0
# swift-ring-builder container.builder add r1z2-10.0.0.51:6001/sdc1 100
+Device d1r1z2-10.0.0.51:6001R10.0.0.51:6001/sdc1_"" with 100.0 weight got id 1
# swift-ring-builder container.builder add r1z3-10.0.0.52:6001/sdb1 100
-# swift-ring-builder container.builder add r1z4-10.0.0.52:6001/sdc1 100
+Device d2r1z3-10.0.0.52:6001R10.0.0.52:6001/sdb1_"" with 100.0 weight got id 2
+# swift-ring-builder container.builder add r1z4-10.0.0.52:6001/sdc1 100
+Device d3r1z4-10.0.0.52:6001R10.0.0.52:6001/sdc1_"" with 100.0 weight got id 3
Verify the ring contents:
# swift-ring-builder container.builder
container.builder, build version 4
-1024 partitions, 3.000000 replicas, 1 regions, 1 zones, 4 devices, 0.00 balance
+1024 partitions, 3.000000 replicas, 1 regions, 4 zones, 4 devices, 100.00 balance, 0.00 dispersion
The minimum number of hours before a partition can be reassigned is 1
-Devices: id region zone ip address port replication ip replication port name weight partitions balance meta
- 0 1 1 10.0.0.51 6001 10.0.0.51 6001 sdb1 100.00 768 0.00
- 1 1 1 10.0.0.51 6001 10.0.0.51 6001 sdc1 100.00 768 0.00
- 2 1 1 10.0.0.52 6001 10.0.0.52 6001 sdb1 100.00 768 0.00
- 3 1 1 10.0.0.52 6001 10.0.0.52 6001 sdc1 100.00 768 0.00
+The overload factor is 0.00% (0.000000)
+Devices: id region zone ip address port replication ip replication port name weight partitions balance meta
+ 0 1 1 10.0.0.51 6001 10.0.0.51 6001 sdb1 100.00 0 -100.00
+ 1 1 2 10.0.0.51 6001 10.0.0.51 6001 sdc1 100.00 0 -100.00
+ 2 1 3 10.0.0.52 6001 10.0.0.52 6001 sdb1 100.00 0 -100.00
+ 3 1 4 10.0.0.52 6001 10.0.0.52 6001 sdc1 100.00 0 -100.00
Rebalance the ring:
- # swift-ring-builder container.builder rebalance
-
- This process can take a while.
-
+ # swift-ring-builder container.builder rebalance
+Reassigned 1024 (100.00%) partitions. Balance is now 0.00. Dispersion is now 0.00
@@ -146,6 +158,9 @@ Devices: id region zone ip address port replication ip replication
Create the base object.builder file:
# swift-ring-builder object.builder create 10 3 1
+
+ This command provides no output.
+
Add each storage node to the ring:
@@ -163,28 +178,31 @@ Devices: id region zone ip address port replication ip replication
Repeat this command for each storage device on each storage
node. In the example architecture, use the command in four variations:
# swift-ring-builder object.builder add r1z1-10.0.0.51:6000/sdb1 100
+Device d0r1z1-10.0.0.51:6000R10.0.0.51:6000/sdb1_"" with 100.0 weight got id 0
# swift-ring-builder object.builder add r1z2-10.0.0.51:6000/sdc1 100
+Device d1r1z2-10.0.0.51:6000R10.0.0.51:6000/sdc1_"" with 100.0 weight got id 1
# swift-ring-builder object.builder add r1z3-10.0.0.52:6000/sdb1 100
-# swift-ring-builder object.builder add r1z4-10.0.0.52:6000/sdc1 100
+Device d2r1z3-10.0.0.52:6000R10.0.0.52:6000/sdb1_"" with 100.0 weight got id 2
+# swift-ring-builder object.builder add r1z4-10.0.0.52:6000/sdc1 100
+Device d3r1z4-10.0.0.52:6000R10.0.0.52:6000/sdc1_"" with 100.0 weight got id 3
Verify the ring contents:
# swift-ring-builder object.builder
object.builder, build version 4
-1024 partitions, 3.000000 replicas, 1 regions, 1 zones, 4 devices, 0.00 balance
+1024 partitions, 3.000000 replicas, 1 regions, 4 zones, 4 devices, 100.00 balance, 0.00 dispersion
The minimum number of hours before a partition can be reassigned is 1
-Devices: id region zone ip address port replication ip replication port name weight partitions balance meta
- 0 1 1 10.0.0.51 6000 10.0.0.51 6000 sdb1 100.00 768 0.00
- 1 1 1 10.0.0.51 6000 10.0.0.51 6000 sdc1 100.00 768 0.00
- 2 1 1 10.0.0.52 6000 10.0.0.52 6000 sdb1 100.00 768 0.00
- 3 1 1 10.0.0.52 6000 10.0.0.52 6000 sdc1 100.00 768 0.00
+The overload factor is 0.00% (0.000000)
+Devices: id region zone ip address port replication ip replication port name weight partitions balance meta
+ 0 1 1 10.0.0.51 6000 10.0.0.51 6000 sdb1 100.00 0 -100.00
+ 1 1 2 10.0.0.51 6000 10.0.0.51 6000 sdc1 100.00 0 -100.00
+ 2 1 3 10.0.0.52 6000 10.0.0.52 6000 sdb1 100.00 0 -100.00
+ 3 1 4 10.0.0.52 6000 10.0.0.52 6000 sdc1 100.00 0 -100.00
Rebalance the ring:
- # swift-ring-builder object.builder rebalance
-
- This process can take a while.
-
+ # swift-ring-builder object.builder rebalance
+Reassigned 1024 (100.00%) partitions. Balance is now 0.00. Dispersion is now 0.00