[tor-bugs] #27278 [Webpages/Website]: Bad Instruction Page

Tor Bug Tracker & Wiki blackhole at torproject.org
Thu Aug 23 15:26:04 UTC 2018


#27278: Bad Instruction Page
------------------------------+------------------------
 Reporter:  TormanToo         |          Owner:  (none)
     Type:  defect            |         Status:  new
 Priority:  Very High         |      Milestone:
Component:  Webpages/Website  |        Version:
 Severity:  Normal            |     Resolution:
 Keywords:                    |  Actual Points:
Parent ID:                    |         Points:
 Reviewer:                    |        Sponsor:
------------------------------+------------------------

Comment (by teor):

 Replying to [comment:2 TormanToo]:
 > I chose Option Two then I selected Ubuntu Xenial Xerus 16.04LTS.  There
 is a whole litany of issues.
 >
 > 1. I manually added the two lines to the /etc/apt/sources.list file.
 >
 > 2. Then I tried apt install apt-transport-https.  I got these results:
 > E: Could not open lock file /var/lib/dpkg/lock - open (13: Permission
 denied)
 > E: Unable to lock the administration directory  (/var/lib/dpkg/), are
 you root?
 >
 > The writer forgot sudo.

 Sometimes we assume that sysadmins understand which commands need root on
 their machine, and which root method they use (sudo, su, or ssh root at ...).

 We can add a note at the top, and add sudo to the commands that need root.

 > But tried that and got:
 > Reading package lists... Done
 > Building dependency tree
 > Reading state information... Done
 > apt-transport-https is already the newest version (1.2.27)
 > 0 upgraded, 0 newly installed, 0 to remove and 1 not upgraded.

 That's not an error, that's a normal status message on distributions that
 come with apt-transport-https.

 > 3. Next it says, to use Apt with Tor later replace https:// with tor://
 and run apt install apt-transport-tor.  Why doesn't it just say to do that
 to begin with?  There is no explanation.

 Because you have to install tor and apt-transport-tor using apt-transport-
 https to use apt-transport-tor.

 > apt install apt-transport-tor
 >
 > E: Could not open lock file /var/lib/dpkg/lock - open (13: Permission
 denied)
 > E: Unable to lock the administration directory  (/var/lib/dpkg/), are
 you root?
 >
 > The writer forgot sudo again.

 Ok, we'll add sudo to the commands.

 > Tried with it and got:
 > Building dependency tree
 > Reading state information... Done
 > The following additional packages will be installed;
 >   tor tor-geioipdb torsocks
 > Suggested packages:
 >   mixmaster torbrowser-launcher socat tor-arm apparmor-utils obfs4proxy
 > The following NEW packages will be installed:
 >   apt-transport-tor tor tor-geoipbd torsocks
 > 0 upgraded, 4 newly installed, 0 to remove and 1 not upgraded.
 > E: The method driver /usr/lib/apt/methods/tor could not be found.

 You can't use tor:// URLs to install apt-transport-tor. You have to
 install tor and apt-transport-tor using apt-transport-https to use apt-
 transport-tor.

 > 4. Attempting to add the two keys causes errors also.
 > gpg --recv A3C4F0F979CAA22CDBA8F512EE8CBC9E886DDD89
 > gpg: no keyserver known (use opton --keyserver)
 > gpg: keyserver receive failed: bad URI
 >
 > So I tried:
 > gpg --recv --keyserver A3C4F0F979CAA22CDBA8F512EE8CBC9E886DDD89
 > I got the prompt back, so I guess something happened.

 Hmm, "--keyserver A3C4F0F979CAA22CDBA8F512EE8CBC9E886DDD89" is probably
 your "gpg: keyserver receive failed: bad URI".

 We should add the sks high availability pool URL to the instructions.

 > Next I tried:
 > gpg --export A3C4F0F979CAA22CDBA8F512EE8CBC9E886DDD89 | sudo apt-key add
 -
 > gpg: can't open '/home/me/.gnupg/pubring.gpg'
 > gpg: WARNING: nothing exported
 > gpg: key export failted: file open error
 > gpg:no valid OpenPGP data found.

 The keyserver step failed, so key export won't work.

 > So then I tried:
 > sudo gpg --export A3C4F0F979CAA22CDBA8F512EE8CBC9E886DDD89 | sudo apt-
 key add -
 > gpg: WARNING: nothing exported
 > gpg: no valid OpenPGP data found.

 The keyserver step failed, so key export won't work.

 > 5. "You can install it with the following commands:"  Install what????
 >
 > 6. apt update:
 > Forgot sudo again.

 Ok, we'll add it.

 > sudo apt update
 > .....
 > .....
 > E: The method driver /usr/lib/apt/methods/tor could not be found.

 You can't use tor:// URLs to install apt-transport-tor. You have to
 install tor and apt-transport-tor using apt-transport-https to use apt-
 transport-tor.

 > .....
 > .....
 >
 >
 > Another forgotten sudo,

 Ok, we'll add it.

 > but running:
 > sudo apt install tor deb.torproject.org-keyring
 > This got the normal responses, plus ended with:
 > E: The method driver /usr/lib/apt/methods/tor could not be found.

 You can't use tor:// URLs to install apt-transport-tor. You have to
 install tor and apt-transport-tor using apt-transport-https to use apt-
 transport-tor.

 > But after all this, Tor was still not showing up on any menu.

 The dependencies aren't installed.

 > 7. No one did any proof reading to the line, "deb.torproject.org is also
 served through now also served via onion service:
 http://sdscoq7snqtznauu.onion/".  It's also missing punctuation.
 >
 > 8. "To use the onion service..."  What?????
 >
 > Proof read and test!!!!

 People have different English skill levels, access to different
 distributions, and different sysadmin skill levels.

 Please be patient while we update our documentation.

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


More information about the tor-bugs mailing list