Ticket #1793: 0001-Clarified-risks-of-shares.happy-k-in-docs.patch

File 0001-Clarified-risks-of-shares.happy-k-in-docs.patch, 879 bytes (added by Sagi, at 2012-07-12T19:38:23Z)

  • docs/configuration.rst 

    diff --git a/docs/configuration.rst b/docs/configuration.rst
index 31962d4..0d1b694 100644
    a b Client Configuration 
    347347    larger than the number of servers on your grid.
    348348
    349349    A value of ``shares.happy`` <= ``k`` is allowed, but does not provide any
    350     redundancy if some servers fail or lose shares.
     350    redundancy if ``grid size`` >= ``N`` and some servers fail or lose shares.
     351    This can intuitively be explained by noting that ``grid size`` < ``N``
     352    means multiple shares per storage node: in this situation losing a node
     353    does not cause immediate loss of data. Observe that growing the grid
     354    without changing ``shares.happy`` > k can cause unpleasant surprises.
    351355
    352356    (Mutable files use a different share placement algorithm that does not
    353357    currently consider this parameter.)