Ticket #68: multiple-introducer-client-side-002.dpatch

Sun Aug  1 16:00:56 BST 2010  writefaruq@gmail.com
  * multiple-introducer-client-side-002.dpatch
  docs/architecture.txt: Added description of using multiple introducers
  docs/configuration.txt: Changed the method of configuring introducer(s)
  docs/running.html: Introduced the multiple introducers

New patches:

[multiple-introducer-client-side-002.dpatch
writefaruq@gmail.com**20100801150056
 Ignore-this: df8eab0bfc5cd05c242b47b8b414454
 docs/architecture.txt: Added description of using multiple introducers
 docs/configuration.txt: Changed the method of configuring introducer(s)
 docs/running.html: Introduced the multiple introducers
] {
hunk ./docs/architecture.txt 75
 suffers an unrecoverable hardware problem. Second, even if the private key is
 lost, clients can be reconfigured to use a new introducer.
 
-For future releases, we have plans to decentralize introduction, allowing any
-server to tell a new client about all the others.
+By deploying multiple introducers in a Tahoe-LAFS grid, the above SPoF challenge 
+can be overcome. In that case if one introducer fails clients are still be
+able to get announcement about new servers from remaining introducers. This is
+our first step towards implementing a fully distributed introduction. 
 
hunk ./docs/architecture.txt 80
+For future releases, we have plans to enhance our distributed introduction, 
+allowing any server to tell a new client about all the others. 
 
 == File Encoding ==
 
hunk ./docs/configuration.txt 23
 an initial tahoe.cfg file for you. After creation, the node will never modify
 the 'tahoe.cfg' file: all persistent state is put in other files.
 
+A seond file "BASEDIR/introducers" configures introducers. It is necessary to 
+write all FURL entries into this file. Each line in this file contains exactly 
+one FURL entry. For backward compatibility reasons, any "introducer.furl" 
+entry found in tahoe.cfg file will automatically be copied into this file. Keeping
+any FURL entry in tahoe.cfg file is not recommended for new users.
+
 The item descriptions below use the following types:
 
  boolean: one of (True, yes, on, 1, False, off, no, 0), case-insensitive
hunk ./docs/running.html 40
     <p>To construct a client node, run
     "<code>tahoe create-client</code>", which will create <code>~/.tahoe</code> to be the
     node's base directory. Acquire a copy of the <code>introducer.furl</code>
-    from the introducer and put it into this directory, then use
+    from the introducers and put it into "BASEDIR/introducers" file, one FURL entry per line,
+    then use
     "<code>tahoe run</code>". After that, the node should be off and running. The first
     thing it will do is connect to the introducer and get itself connected to
     all other nodes on the grid.  By default, a node will serve as a storage
}

Context:

[abbreviate time edge case python2.5 unit test
jacob.lyles@gmail.com**20100729210638
 Ignore-this: 80f9b1dc98ee768372a50be7d0ef66af
] 
[docs: add Jacob Lyles to CREDITS
zooko@zooko.com**20100730230500
 Ignore-this: 9dbbd6a591b4b1a5a8dcb69b7b757792
] 
[web: don't use %d formatting on a potentially large negative float -- there is a bug in Python 2.5 in that case
jacob.lyles@gmail.com**20100730220550
 Ignore-this: 7080eb4bddbcce29cba5447f8f4872ee
 fixes #1055
] 
[test_upload.py: rename test_problem_layout_ticket1124 to test_problem_layout_ticket_1124 -- fix .todo reference.
david-sarah@jacaranda.org**20100729152927
 Ignore-this: c8fe1047edcc83c87b9feb47f4aa587b
] 
[test_upload.py: rename test_problem_layout_ticket1124 to test_problem_layout_ticket_1124 for consistency.
david-sarah@jacaranda.org**20100729142250
 Ignore-this: bc3aad5919ae9079ceb9968ad0f5ea5a
] 
[docs: fix licensing typo that was earlier fixed in [20090921164651-92b7f-7f97b58101d93dc588445c52a9aaa56a2c7ae336]
zooko@zooko.com**20100729052923
 Ignore-this: a975d79115911688e5469d4d869e1664
 I wish we didn't copies of this licensing text in several different files so that changes can be accidentally omitted from some of them.
] 
[misc/build_helpers/run-with-pythonpath.py: fix stale comment, and remove 'trial' example that is not the right way to run trial.
david-sarah@jacaranda.org**20100726225729
 Ignore-this: a61f55557ad69a1633bfb2b8172cce97
] 
[docs/specifications/dirnodes.txt: 'mesh'->'grid'.
david-sarah@jacaranda.org**20100723061616
 Ignore-this: 887bcf921ef00afba8e05e9239035bca
] 
[docs/specifications/dirnodes.txt: bring layer terminology up-to-date with architecture.txt, and a few other updates (e.g. note that the MAC is no longer verified, and that URIs can be unknown). Also 'Tahoe'->'Tahoe-LAFS'.
david-sarah@jacaranda.org**20100723054703
 Ignore-this: f3b98183e7d0a0f391225b8b93ac6c37
] 
[docs: use current cap to Zooko's wiki page in example text
zooko@zooko.com**20100721010543
 Ignore-this: 4f36f36758f9fdbaf9eb73eac23b6652
 fixes #1134
] 
[__init__.py: silence DeprecationWarning about BaseException.message globally. fixes #1129
david-sarah@jacaranda.org**20100720011939
 Ignore-this: 38808986ba79cb2786b010504a22f89
] 
[test_runner: test that 'tahoe --version' outputs no noise (e.g. DeprecationWarnings).
david-sarah@jacaranda.org**20100720011345
 Ignore-this: dd358b7b2e5d57282cbe133e8069702e
] 
[TAG allmydata-tahoe-1.7.1
zooko@zooko.com**20100719131352
 Ignore-this: 6942056548433dc653a746703819ad8c
] 
Patch bundle hash:
dd0d39cc88840f1f77806c8dd37d4146dbb74964