Actions

Release Upgrade Whonix 15 to Whonix 16

From Whonix


Upgrade.jpg

Notices[edit]

Table: Release Upgrade Whonix ™ Notices

Notice Description
Difficulty
Release Upgrade vs Re-Installation

To use Whonix ™ 16, users can either:

Standard Updates
Automated Release Upgrade vs Manual Release Upgrade
  • Automated Release Upgrade is the newer method that has been implemented. It does not ask for user input and is therefore easier to use.
  • The former Manual Release Upgrade effectively did the same, but it offered more control over system customization. It is now deprecated. [1]
Configuration Files Resets Since this is an automated release upgrade, user modified configuration files (if any) in folder /etc will be reset, overwritten with the Debian or Whonix ™ package version. The user is free to restore the configuration after the release upgrade.

High Level Overview[edit]

  1. Backup all data - ideally have a copy of the VM(s) so it is possible to try again (if necessary). [2]
  2. Perform the usual standard ("everyday") update instructions.
  3. Consider running the optional sanity tests.
  4. Release Upgrade Whonix-Workstation ™ (whonix-ws-15).
  5. Power off Whonix-Workstation ™ (whonix-ws-15).
  6. Release Upgrade Whonix-Gateway ™ (whonix-gw-15).
  7. Restart Whonix-Gateway ™ (whonix-gw-15).
  8. Restart Whonix-Workstation ™ (whonix-ws-15).

Sanity Tests[edit]

These are optional, but recommended. To complete sanity tests, please press on expand on the right. 

sudo dpkg --audit ; echo $?

Expected output. 

0

sudo dpkg --configure -a ; echo $?

Expected output. 

0

Get package upgrades. 

sudo apt update

sudo apt full-upgrade

For testing purposes, install package nano. 

sudo apt install nano ; echo $?

## ... successful installation of nano ...
0

Apt install fix missing. 

sudo apt install -f

Expected upgrade. 

Reading package lists... Done
Building dependency tree... Done
Reading state information... Done
0 upgraded, 0 newly installed, 0 to remove and 0 not upgraded.

Release Upgrade[edit]

  1. Backup all data - ideally have a clone of the VM(s) so it is possible to try again (if necessary).
  2. Perform the usual standard ("everyday") update instructions.
  3. Consider running the optional sanity tests.
  4. Run systemcheck.
  5. View release-upgrade command version. 
    cat /usr/sbin/release-upgrade | grep version=

  6. Check release-upgrade command version. Should be minimum 1.5, should show version="1.5".
  7. Consider keeping the full release upgrade log output. It will be required for Support in case there are issues.
  8. Perform the automated release upgrade using release-upgrade command. 
    sudo release-upgrade

  9. Done. If everything went well, at the end it will show:

    INFO: OK. (release-upgrade version: 1.5) Release upgrade success.

  10. Reboot.
  11. Optional, recommended: Re-install Meta Packages and Safely Run Autoremove

Footnotes[edit]

  1. ↑ This method is still possible. All the automated release-upgrade [archive] script does is perform actions which the user could perform manually. If a manual release upgrade is desired, emulate what the release-upgrade script is doing. The manual release upgrading procedure is undocumented due to the size of the instructions and duplication involved.
  2. ↑ Have at least one cloned backup before proceeding; for example, whonix-ws-15-backup and whonix-gw-15-backup.
Fosshost is sponsors Kicksecure ™ stage server 100px
Fosshost About Advertisements

Search engines: YaCy | Qwant | ecosia | MetaGer | peekier | Whonix ™ Wiki

Follow: 1024px-Telegram 2019 Logo.svg.png Iconfinder Apple Mail 2697658.png Twitter.png Facebook.png Rss.png Reddit.jpg 200px-Mastodon Logotype (Simple).svg.png

Support: Discourse logo.png

Donate: Donate Bank Wire Paypal Bitcoin accepted here Monero accepted here Contribute

Whonix donate bitcoin.png Monero donate Whonix.png United Federation of Planets 1000px.png

Twitter-share-button.png Facebook-share-button.png Telegram-share.png link=mailto:?subject=Release Upgrade Whonix 15 to Whonix 16&body=./Release_Upgrade_Whonix_15_to_Whonix_16 link=https://reddit.com/submit?url=./Release_Upgrade_Whonix_15_to_Whonix_16&title=Release Upgrade Whonix 15 to Whonix 16 link=https://news.ycombinator.com/submitlink?u=./Release_Upgrade_Whonix_15_to_Whonix_16&t=Release Upgrade Whonix 15 to Whonix 16 link=https://mastodon.technology/share?message=Release Upgrade Whonix 15 to Whonix 16%20./Release_Upgrade_Whonix_15_to_Whonix_16&t=Release Upgrade Whonix 15 to Whonix 16

Did you know that anyone can edit the Whonix ™ wiki to improve it?

https link onion link Priority Support | Investors | Professional Support

Whonix ™ | © ENCRYPTED SUPPORT LP | Heckert gnu.big.png Freedom Software / Osi standard logo 0.png Open Source (Why?)

The personal opinions of moderators or contributors to the Whonix ™ project do not represent the project as a whole.

Retrieved from "https://www.whonix.org/w/index.php?title=Release_Upgrade_Whonix_15_to_Whonix_16&oldid=71022"
By using our website, you acknowledge that you have read, understood and agreed to our Privacy Policy, Cookie Policy, Terms of Service, and E-Sign Consent.
More information