wiki/src/blueprint/incremental_upgrades.mdwn

   1 [[!toc levels=4]]
   2
   3 See also:
   4
   5  * the [[corresponding design document|contribute/design/incremental_upgrades]];
   6  * the tickets with the _Incremental upgrades_ category on [[!tails_redmine "" desc="Redmine"]].
   7
   8 # Roadmap
   9
  10 1. (**past**) Tails 0.13 has the harmless part of the
  11    `feature/incremental-upgrades` branch merged (users creation with
  12    sudo credentials, dependencies installation), leaving aside the
  13    part about running the upgrade frontend automatically at startup.
  14    => Tails 0.13 should have been able to incrementally upgrade to
  15    something newer, when running the upgrade frontend by hand,
  16    but the included Tails OpenPGP signing key expired too quickly for
  17    this to happen.
  18
  19 2. (**past**) Now that 0.14 is out:
  20
  21    * Prepare IUK: **done**
  22    * Update upgrade-description files: **done**
  23    * Ask beta testers to try the incremental upgrade process: **done**
  24    * Find most critical bugs: **done**.
  25
  26 3. (**pending review**) Complete **phase one: make ready for more alpha testing**
  27
  28    See [[!tails_ticket 5922 desc="phase one"]].
  29
  30 4. (**pending review**) Complete **phase two: make ready for beta testing**
  31
  32    See [[!tails_ticket 5490 desc="phase two"]]. Once part of a release
  33    (candidate):
  34
  35    * Prepare IUK
  36    * Update upgrade-description files
  37    * Ask beta testers to try the incremental upgrade process
  38    * Catch and fix most remaining bugs
  39
  40 5. Complete **phase three: deploy in production**
  41
  42    Once we're happy with the whole thing, ship it, enabled by
  43    default, in the next Tails major release.
  44
  45    See child tickets of [[!tails_ticket 6014 desc="phase three"]].
  46
  47 6. Later
  48
  49    See tickets with *Incremental upgrades* category on
  50    [[!tails_redmine desc="Redmine"]].
  51
  52 # Code
  53
  54 * The bulk of the code needed to implement this design lives in the
  55   `iuk` [[contribute/Git]] repository.
  56 * Integration work is being done in the `feature/incremental-upgrades`
  57   branch of the main Tails [[contribute/Git]] repository.
  58
  59 # Random ideas for future improvements
  60
  61 These are not worth creating tickets yet, as it's not even clear these
  62 changes are useful enough to put time in it.
  63
  64 ### Packaging could be more self-contained
  65
  66 Move `/etc/sudoers.d/zzz_upgrade` and IUK-related user creation from
  67 the Tails main Git repository to the `tails-iuk` Debian package, so
  68 that it's more self-contained and easier to test.
  69
  70 ### Button for aborting upgrade cleanly
  71
  72 ### Compute and display ETA
  73
  74 ### Multi-step incremental upgrade
  75
  76 E.g. 0.11 boots after 0.11.1 and 0.11.2 are out. Tails fetches
  77 https://tails.boum.org/upgrade/v1/Tails/0.11/i386/stable/upgrades.yml,
  78 that shall contain an incremental upgrade path with two target files:
  79 the 0.11 to 0.11.1 IUK, and the 0.11.1 to 0.11.2 IUK. The upgrader
  80 would download these two files and install the two IUKs in the
  81 correct order.
  82
  83 ### sharing upgrade material
  84
  85 Once the incremental upgrade has been applied, I may be proposed to
  86 save a copy of the target files to a location of my choosing.
  87
  88 ### allow one to download target files in the clear
  89
  90 The downloader program could provide an opt-in way to have the
  91 download happen in the clear, that is without going through the Tor
  92 network. It looks doable given it's a separate process: we may run it
  93 as a dedicated user, and reuse the `clearnet` infrastructure
  94 implemented for the Unsafe Browser.
  95
  96 ### "Retry with new circuit" button
  97
  98 Circuit throughput varies wildly, and since this is a large download,
  99 it'll quickly wear out users' patience if a bad circuit is picked.
 100 Or maybe this can happen behind the scenes, e.g.:  Automatically
 101 switch circuit every X minutes or Y% progress? That could even make
 102 fingerprinting the download on the Tor client <-> Entry Node side of
 103 the pipe a bit more difficult, for whatever that's worth.
 104
 105 # Dialogs and error messages
 106
 107 ## Not enough memory available
 108
 109 **Not enough memory available to check for upgrades.**
 110
 111 - Make sure this system satisfies the requirements for running Tails.<br/>
 112   See file:///usr/share/doc/tails/website/doc/about/requirements.en.html
 113 - Try to restart Tails and upgrade again.
 114 - Or do a manual upgrade.<br/>
 115   See https://tails.boum.org/doc/first_steps/upgrade#manual
 116
 117 ## Error while checking for upgrades
 118
 119 **Could not determine whether an upgrade is available from our website.**
 120
 121 Check your network connection, and restart Tails to try upgrading again.
 122
 123 If the problem persists, go to file:///usr/share/doc/tails/website/doc/upgrade/error/check.en.html.
 124
 125 **Debugging information**
 126
 127 ...
 128
 129 ## Upgrade available
 130
 131 **You should upgrade to Tails 0.22.**
 132
 133 For more information about this new version, go to https://tails.boum.org/news/version_0.22/.
 134
 135 Note that:
 136
 137   - It is recommended to close all the open applications during the upgrade.
 138   - Downloading the upgrade might take a long time, from several minutes to a few hours.
 139   - The networking will be disabled after downloading the upgrade.
 140
 141 Download size: 201 MB
 142
 143 Do you want to upgrade now?
 144
 145 [Upgrade later] [Upgrade now]
 146
 147 ## New version available
 148
 149 **You should do a manual upgrade to Tails 0.22.**
 150
 151 For more information about this new version, go to https://tails.boum.org/news/version_0.22/.
 152
 153 It is not possible to automatically upgrade your device to this new version.
 154
 155 To learn how to do a manual upgrade, go to https://tails.boum.org/doc/first_steps/upgrade#manual
 156
 157 ## Downloading upgrade
 158
 159 Downloading the upgrade to Tails 0.22...
 160
 161 ## Error while downloading the upgrade
 162
 163 **The upgrade could not be downloaded.**
 164
 165 Check your network connection, and restart Tails to try upgrading again.
 166
 167 If the problem persists, go to file:///usr/share/doc/tails/website/doc/upgrade/error/download.en.html.
 168
 169 **Debugging information**
 170
 171 ...
 172
 173 ## Upgrading the system
 174
 175 **Your Tails device is being upgraded...**
 176
 177 For security reasons, the networking is now disabled.
 178
 179 ## Error while installing the upgrade
 180
 181 **An error occured while installing the upgrade.**
 182
 183 Your Tails device needs to be repaired and might be unable to restart.
 184
 185 Please follow the instructions at file:///usr/share/doc/tails/website/doc/upgrade/error/install.en.html
 186
 187 **Debugging information**
 188
 189 ...
 190
 191 ## Restart Tails
 192
 193 **Your Tails device was successfully upgraded.**
 194
 195 Some security features were temporarily disabled.<br/>
 196 You should restart Tails on the new version as soon as possible.
 197
 198 Do you want to restart now?
 199
 200 [Restart later] [Restart now]