Opened at 2010-01-17T05:20:35Z
Closed at 2010-06-19T03:04:39Z
#911 closed task (fixed)
Create a specification for the servers of happiness behavior
| Reported by: | kevan | Owned by: | davidsarah |
|---|---|---|---|
| Priority: | major | Milestone: | 1.7.0 |
| Component: | documentation | Version: | 1.5.0 |
| Keywords: | docs | Cc: | |
| Launchpad Bug: |
Description
The discussion in #778 is a bit jumbled to be a canonical specification for the servers of happiness behavior. It would be nice to distill that discussion into a coherent specification, and then to put that specification at docs/specifications/servers-of-happiness.txt.
Attachments (3)
Change History (17)
comment:1 Changed at 2010-02-01T19:56:23Z by davidsarah
- Milestone changed from undecided to 1.7.0
comment:2 Changed at 2010-05-08T19:19:14Z by zooko
comment:3 Changed at 2010-05-08T19:20:04Z by zooko
Oh, perhaps you mean to add doc of *how* Tahoe-LAFS calculates the servers-of-happiness for a given server-share mapping, or how it decides which servers to use or not use on upload. That is *not* currently done in your docs.txt over on #778.
comment:4 Changed at 2010-05-08T19:44:36Z by kevan
Your second comment is correct -- the specification would cover what is in the docs for #778, as well as the reduction of the happiness behavior to a matching in a bipartite graph.
comment:5 Changed at 2010-05-16T00:32:42Z by zooko
Kevan: we've now added a bit more doc about servers-of-happiness in architecture.txt, but I guess you want to actually write a complete specification of the matching algorithm and so on. Perhaps you should just add it as another paragraph in the "Server Select" part of architecture.txt? Anyway, it may be worth doing for 1.7.0 final.
comment:6 Changed at 2010-05-16T01:44:08Z by kevan
- Status changed from new to assigned
I'm planning on having whichever approach we want to go with done by 1.7.0 final.
comment:7 Changed at 2010-05-19T00:59:03Z by kevan
I made docs/specifications/servers-of-happiness.txt -- I wanted to summarize a bit more of the discussion on #778 than I thought would fit well in the architecture document. I'm attaching a patch with that. However, the actual matching specification would very easily fit in architecture.txt. What do you think? Is the separate file overkill?
Changed at 2010-05-19T00:59:20Z by kevan
comment:8 Changed at 2010-05-22T20:58:16Z by kevan
- Keywords review-needed added
comment:9 Changed at 2010-05-22T20:58:29Z by kevan
- Owner kevan deleted
- Status changed from assigned to new
comment:10 Changed at 2010-05-23T00:10:34Z by davidsarah
- Owner set to davidsarah
- Status changed from new to assigned
Changed at 2010-05-24T00:46:18Z by kevan
revised specification that mentions that servers of happiness only applies to immutable files for now
comment:11 Changed at 2010-06-16T18:58:16Z by zooko
- Resolution set to fixed
- Status changed from assigned to closed
Applied in 7cadb49b88c03209. Thanks!
comment:12 Changed at 2010-06-17T05:12:03Z by zooko
- Keywords reviewed added; review-needed removed
comment:13 Changed at 2010-06-19T00:49:46Z by davidsarah
- Keywords reviewed removed
- Resolution fixed deleted
- Status changed from closed to reopened
Changed at 2010-06-19T00:52:37Z by davidsarah
configuration.txt and servers-of-happiness.txt: 1 <= happy <= N, not k <= happy <= N. Also minor wording changes.
comment:14 Changed at 2010-06-19T03:04:39Z by davidsarah
- Resolution set to fixed
- Status changed from reopened to closed
servers-of-happiness-doc.dpatch applied in a92a23fe343862f2.
Kevan: your docs in your docs patch on #778 look sufficient to me. Shall we close this ticket as a dup of #778? If you agree then please go ahead and mark it as dup and close it.