Deuxfleurs/garage
48
56
Fork 73
Code Issues 100 Pull requests 13 Releases 30 Wiki Activity

New layout: fixes and UX improvements #634

Merged
lx merged 10 commits from new-layout-ux into next 2023-09-27 09:04:32 +00:00
Conversation 0 Commits 10 Files changed 9 +8 -7
1 changed files with 8 additions and 7 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files
Showing only changes of commit 0e5925fff6 - Show all commits

15
doc/book/operations/layout.md
View file

@ -94,12 +94,13 @@ follow the following recommendations:
## Understanding unexpected layout calculations ## Understanding unexpected layout calculations
When adding, removing or modifying nodes in a cluster layout, sometimes When adding, removing or modifying nodes in a cluster layout, sometimes
unexpected assigntations of partitions to node can occure. These assignations unexpected assigntations of partitions to node can occur. These assignations
are in fact normal and logical, given the objectives of the algorihtm. Indeed, are in fact normal and logical, given the objectives of the algorihtm. Indeed,
**the layout algorithm prioritizes moving less data between nodes over the fact **the layout algorithm prioritizes moving less data between nodes over the fact
of achieving equal distribution of load**. This section presents two examples of achieving equal distribution of load. It also tries to use all links between
and illustrates how one can control Garage's behavior to obtain the desired pairs of nodes in equal proportions when moving data.** This section presents
results. two examples and illustrates how one can control Garage's behavior to obtain
the desired results.
### Example 1 ### Example 1
@ -266,8 +267,8 @@ This explains why node3 ends with 75% utilization (100% from before minus 25%
that is moved to node1), and node4 ends with 25% (50% from before minus 25% that is moved to node1), and node4 ends with 25% (50% from before minus 25%
that is moved to node1). that is moved to node1).
This illustrates another principle of the layout computation: **if there is a This illustrates the second principle of the layout computation: **if there is
choice in moving data out of some nodes, then all links between pairs of nodes a choice in moving data out of some nodes, then all links between pairs of
are used in equal proportions** (this is approximately true, there is nodes are used in equal proportions** (this is approximately true, there is
randomness in the algorihtm to achieve this so there might be some small randomness in the algorihtm to achieve this so there might be some small
fluctuations, as we see above). fluctuations, as we see above).