Skip to content

Commit

Permalink
Add instructions for deleting ~/.ansible/cp to work around #4364
Browse files Browse the repository at this point in the history
These instructions should be removed once #4364 is reliably
resolved.
  • Loading branch information
eloquence authored and kushaldas committed Sep 25, 2019
1 parent 83b8eb5 commit c3a7e17
Show file tree
Hide file tree
Showing 3 changed files with 17 additions and 2 deletions.
12 changes: 12 additions & 0 deletions docs/includes/rerun-install-is-safe.txt
Original file line number Diff line number Diff line change
Expand Up @@ -3,3 +3,15 @@
network connectivity to the servers), it is safe to run the
``./securedrop-admin install`` command again. If you see the same
issue consistently, then you will need to troubleshoot it.

If you see the error message "timeout (62s) waiting for privilege
escalation prompt", try deleting the Ansible control path directory on
your *Admin Workstation* (``rm -rf ~/.ansible/cp``) to reset the
connection to the servers, then re-run the
``./securedrop-admin install`` command from within
``~/Persistent/securedrop``.

If you encounter other errors, we encourage you to
`submit a bug report <https://github.com/freedomofpress/securedrop/issues/new>`_,
or to contact us at securedrop@freedom.press
(`GPG encrypted <https://securedrop.org/sites/default/files/fpf-email.asc>`__).
5 changes: 3 additions & 2 deletions docs/upgrade/xenial_backup_install_restore.rst
Original file line number Diff line number Diff line change
Expand Up @@ -205,8 +205,9 @@ using the following command:
./securedrop-admin install
This command will take several minutes to complete, and will reboot the
*Application* and *Monitor* servers as part of the process. If it fails, try
running it again. If it fails repeatedly, :ref:`contact us. <bir_contact_us>`
*Application* and *Monitor* servers as part of the process.

.. include:: ../includes/rerun-install-is-safe.txt

When the server installation completes successfully, you should set up the
*Admin Workstation* to connect to the new servers over Tor. To do so, run the
Expand Down
2 changes: 2 additions & 0 deletions docs/upgrade/xenial_upgrade_in_place.rst
Original file line number Diff line number Diff line change
Expand Up @@ -257,6 +257,8 @@ configuration:
You will be prompted for the admin user's passphrase on the servers. Type it in
and press Enter.

.. include:: ../includes/rerun-install-is-safe.txt

Step 4: Validate the Instance
-----------------------------

Expand Down

0 comments on commit c3a7e17

Please sign in to comment.