summaryrefslogtreecommitdiffstats
path: root/wiki/src/doc/upgrade
diff options
context:
space:
mode:
authorTails developers <amnesia@boum.org>2013-11-29 14:10:23 +0000
committerTails developers <amnesia@boum.org>2013-11-29 14:10:23 +0000
commita5e563658c85c326c5cdf1c4446bbf97a9ee48f3 (patch)
tree280753e771b42a743e63ca4298188db64754e205 /wiki/src/doc/upgrade
parent698e61656c4672198f17ddf696f95da5443319bb (diff)
Add draft documentation for incremental upgrades failure modes.
Diffstat (limited to 'wiki/src/doc/upgrade')
-rw-r--r--wiki/src/doc/upgrade/error/check.mdwn19
-rw-r--r--wiki/src/doc/upgrade/error/download.mdwn21
-rw-r--r--wiki/src/doc/upgrade/error/install.mdwn29
3 files changed, 65 insertions, 4 deletions
diff --git a/wiki/src/doc/upgrade/error/check.mdwn b/wiki/src/doc/upgrade/error/check.mdwn
index 1f61ccc..49f632f 100644
--- a/wiki/src/doc/upgrade/error/check.mdwn
+++ b/wiki/src/doc/upgrade/error/check.mdwn
@@ -1,3 +1,18 @@
-possible causes:
+[[!meta title="Could not determine whether an upgrade is available"]]
-* network issues
+Tails could not determine whether an upgrade is available.
+
+This is probably caused by a network problem. Restart Tails. If this
+error happens again, [[report an error|support/troubleshooting]]
+including the complete error message.
+
+Other possible causes for this failure are attacks by an adversary who
+is controlling either the Tor exit node being used, or the
+<https://tails.boum.org> web server, or anything in-between:
+
+* Endless data attacks
+* Slow retrieval attacks
+
+Read the [[security
+discussion|contribute/design/incremental_upgrades#security]] about
+incremental upgrades for details.
diff --git a/wiki/src/doc/upgrade/error/download.mdwn b/wiki/src/doc/upgrade/error/download.mdwn
index 1f61ccc..ed8d677 100644
--- a/wiki/src/doc/upgrade/error/download.mdwn
+++ b/wiki/src/doc/upgrade/error/download.mdwn
@@ -1,3 +1,20 @@
-possible causes:
+[[!meta title="Could not download the upgrade"]]
-* network issues
+The upgrade could not be downloaded.
+
+This is probably caused by a network problem. Restart Tails. If this
+error happens again, [[report an error|support/troubleshooting]]
+including the complete error message.
+
+Other possible causes for this failure are attacks by an adversary who
+is controlling either the Tor exit node, or the web mirror being used,
+or anything in-between:
+
+* Endless data attacks
+* Slow retrieval attacks
+* Malicious mirror preventing upgrades (missing or corrupted files,
+ misconfiguration, etc.)
+
+Read the [[security
+discussion|contribute/design/incremental_upgrades#security]] about
+incremental upgrades for details.
diff --git a/wiki/src/doc/upgrade/error/install.mdwn b/wiki/src/doc/upgrade/error/install.mdwn
index e69de29..c369e20 100644
--- a/wiki/src/doc/upgrade/error/install.mdwn
+++ b/wiki/src/doc/upgrade/error/install.mdwn
@@ -0,0 +1,29 @@
+[[!meta title="Failed to install the upgrade"]]
+
+The upgrade could not be installed.
+
+<div class="caution">
+
+ This copy of Tails may be in a broken state. Do not restart Tails.
+
+</div>
+
+Follow these instructions to repair this copy of Tails:
+
+1. [[Report an error|support/troubleshooting]] including:
+ * the complete error message
+ * the output of the two following commands, run in a
+ <span class=\"application\">Terminal</span>:
+
+ ls -l /lib/live/mount/medium/live
+ cat /lib/live/mount/medium/live/Tails.module
+
+1. Make sure you have another known-working copy of Tails.
+1. Take note of this page's address so that you can find it again
+ after restarting.
+1. Shut down the system.
+1. Start your known-working copy of Tails.
+1. Use Tails Installer to *Clone & Upgrade* the known-working Tails
+ onto the broken Tails.
+1. Restart the broken Tails that should now be repaired. If it does
+ not work correctly, [[report an error|support/troubleshooting]].