[tor-bugs] #20897 [Core Tor/Fallback Scripts]: Make it easier to check the entire fallback whitelist for errors

[Tor Bug Tracker & Wiki]

#20897: Make it easier to check the entire fallback whitelist for errors
---------------------------------------+----------------------------------
 Reporter:  teor                       |          Owner:  (none)
     Type:  enhancement                |         Status:  new
 Priority:  Medium                     |      Milestone:  Tor: unspecified
Component:  Core Tor/Fallback Scripts  |        Version:
 Severity:  Normal                     |     Resolution:
 Keywords:  fallback                   |  Actual Points:
Parent ID:                             |         Points:  0.5
 Reviewer:                             |        Sponsor:
---------------------------------------+----------------------------------

Comment (by teor):

 This is the old text from the wiki:

 You can check the entire whitelist by running the script like this:

 i. Make sure the whitelist and blacklist and script are the current ones,
 including the latest operator updates (not the modified ones from other
 instructions)
 ii. Set the log level to INFO for both the script and stem:
 {{{
 - logging.basicConfig(level=logging.WARNING)
 + logging.basicConfig(level=logging.INFO)
 }}}
 {{{
 - logging.getLogger('stem').setLevel(logging.WARNING)
 + logging.getLogger('stem').setLevel(logging.INFO)
 }}}
 iii. Output candidate fallbacks (ignore the whitelist, log operator
 contact details):
 {{{
 - OUTPUT_CANDIDATES = False
 + OUTPUT_CANDIDATES = True
 }}}
 iv. Perform IPv4 checks:
 {{{
 - PERFORM_IPV4_DIRPORT_CHECKS = False if OUTPUT_CANDIDATES else True
 + PERFORM_IPV4_DIRPORT_CHECKS = True
 }}}
 v. If you have a working IPv6 connection (or can set up an IPv6 tunnel),
 perform IPv6 checks:
 {{{
 - PERFORM_IPV6_DIRPORT_CHECKS = False if OUTPUT_CANDIDATES else False
 + PERFORM_IPV6_DIRPORT_CHECKS = True
 }}}
 iv. Run the fallback selection script, saving the list:
 {{{
 scripts/maint/updateFallbackDirs.py > whitelist_check 2>
 whitelist_check.log
 }}}
 This can take a long time, as it downloads ~150MB of OnionOO data, parses
 it, then tries each fallback's DirPort.

--
Ticket URL: <https://trac.torproject.org/projects/tor/ticket/20897#comment:6>
Tor Bug Tracker & Wiki <https://trac.torproject.org/>
The Tor Project: anonymity online