[tor-dev] Help Wanted: Fallback Directory Update

teor teor2345 at gmail.com
Mon Dec 11 03:51:17 UTC 2017

(You might have already read this email on a closed list.
I'm re-posting it here, with an extra "step 0".)

Hi all,

Fallback directory mirrors help clients reach the Tor network.

We need to rebuild the list every so often when their details change.
(We have an automated check for 25% failure, and it just triggered.)

Does anyone want to help me do this?
It would be nice to get it done this month - but it's not urgent.

Here's what needs to be done in detail:

0. Ask operators to opt-in stable relays as fallback directory mirrors
  If they are on the whitelist already, they don't need to do anything.
  Ticket: https://trac.torproject.org/projects/tor/ticket/22527
  File:   https://gitweb.torproject.org/tor.git/tree/scripts/maint/fallback.whitelist

1. Update the fallback whitelist with new and changed relay details
  Tickets: https://trac.torproject.org/projects/tor/ticket/22321
  File:    tor/scripts/maint/fallback.whitelist

2. Update updateFallbackDirs.py to have a CONSENSUS_EXPIRY_TOLERANCE of 0.
  Ticket: https://trac.torproject.org/projects/tor/ticket/20942
  File:   tor/scripts/maint/updateFallbackDirs.py

3. Run updateFallbackDirs.py with the new whitelist and CONSENSUS_EXPIRY_TOLERANCE.
  You'll need a decent network connection for this.
  Please attach the script logs to the trac ticket.
  Command: tor/scripts/maint/updateFallbackDirs.py > src/or/fallback_dirs.inc

4. Write a changes file
  Ticket: https://trac.torproject.org/projects/tor/ticket/22271

 o Minor features (fallback directory list):
   - Replace the 151 fallbacks originally introduced in Tor in
     May 2017 (of which ~111 were still functional) with a list of
     NNN fallbacks (NNN new, NNN unchanged, NNN removed) generated in December
     2017. Resolves ticket 22271.

  There are some commands that count fallback changes here:

5. Announce the new list on tor-relays@

6. Tell the relay search maintainer that the list has changed

Next Time:

I'd like to make the process quicker and easier next time.
But I don't want to make any big changes to it at the moment.
Let's do that when we have time to try different things.


> On 7 Dec 2017, at 11:57, atagar at torproject.org wrote:
> 40/151 (26%) fallback directories have become slow or unresponsive...
> (snip)

Tim / teor

PGP C855 6CED 5D90 A0C5 29F6 4D43 450C BA7F 968F 094B

-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 833 bytes
Desc: Message signed with OpenPGP
URL: <http://lists.torproject.org/pipermail/tor-dev/attachments/20171211/8bef9038/attachment.sig>

More information about the tor-dev mailing list