[tahoe-lafs-trac-stream] [tahoe-lafs] #2105: fix the definition of needs-rebalancing

[tahoe-lafs]

#2105: fix the definition of needs-rebalancing
-------------------------+-------------------------------------------------
     Reporter:  daira    |      Owner:  daira
         Type:  defect   |     Status:  assigned
     Priority:  normal   |  Milestone:  1.11.0
    Component:  code-    |    Version:  1.9.1
  frontend-web           |   Keywords:  check verify repair servers-of-
   Resolution:           |  happiness blocks-release
Launchpad Bug:           |
-------------------------+-------------------------------------------------

Comment (by daira):

 Replying to [comment:5 zooko]:
 > I think this ticket is actually about "needs-repair" rather than about
 "needs-rebalancing". I'm not 100% sure of the definition of "needs-
 rebalancing", but I think of it as something like "The file ''doesn't''
 need repair (i.e. its Happiness level is already above the requirement),
 but it would be better to move some of the shares around to other servers.

 From [source:docs/frontends/webapi.rst at 0bebbe32#debugging-and-testing-
 features]:
 {{{
   needs-rebalancing: (bool) This field is intended to be True iff
                      reliability could be improved for this file by
                      rebalancing, i.e. by moving some shares to other
                      servers. It may be incorrect in some cases for
                      Tahoe-LAFS up to and including v1.10, and its
                      precise definition is expected to change.
 }}}

 Reliability can be improved when the shares-of-happiness count is less
 than `shares.total`. (In some cases, adding more servers may be necessary
 for an improvement, but I think that's fine.)

-- 
Ticket URL: <https://tahoe-lafs.org/trac/tahoe-lafs/ticket/2105#comment:6>
tahoe-lafs <https://tahoe-lafs.org>
secure decentralized storage