From 2a93dc53aba2bf771491e7b54bb7d86a7f0d0b95 Mon Sep 17 00:00:00 2001 From: Andrew David Wong Date: Wed, 25 Apr 2018 20:32:47 -0500 Subject: [PATCH] Add manual https repo fix instructions Closes QubesOS/qubes-issues#3737 --- installing/installation-guide.md | 34 ++++++++++++++++++++++++++++++-- releases/4.0/release-notes.md | 30 ++++++++++++++++++++++++++++ 2 files changed, 62 insertions(+), 2 deletions(-) diff --git a/installing/installation-guide.md b/installing/installation-guide.md index 452baa54..9f2f5774 100644 --- a/installing/installation-guide.md +++ b/installing/installation-guide.md @@ -19,8 +19,8 @@ redirect_from: Installation Guide ================== -Warning -------- +Warnings +-------- There is a set of known upstream bugs in the Fedora installer that affect Qubes 3.2 ([Bug 1170803], [Bug 1374983], and [Bug 1268700]; tracked in Qubes issue [#2835]). This issue is fixed in Qubes 4.0. @@ -28,6 +28,35 @@ On Qubes 3.2, because of these bugs, the installer will try to access all existi Therefore, we *strongly* recommended that, prior to starting the Qubes installer, you physically disconnect all disks that you do not want to be modified. Furthermore, if you are installing Qubes on a potentially compromised system, we *strongly* recommended that you wipe your target installation disk before starting the installer. +In new installations of Qubes, the following steps may need to be applied in dom0 and Fedora 26 TemplateVMs in order to receive updates (see [#3737]). + +Steps for dom0 updates: + +1. Open the Qubes Menu by clicking on the "Q" icon in the top-left corner of the screen. +2. Select `Terminal Emulator`. +3. In the window that opens, enter this command: + + sudo nano /etc/yum.repos.d/qubes-dom0.repo + +4. This opens the nano text editor. Change all four instances of `http` to `https`. +5. Press `CTRL+X`, then `Y`, then `ENTER` to save changes and exit. +6. Check for updates normally. + +Steps for Fedora 26 TemplateVM updates: + +1. Open the Qubes Menu by clicking on the "Q" icon in the top-left corner of the screen. +2. Select `Template: fedora-26`, then `fedora-26: Terminal`. +3. In the window that opens, enter the command for your version: + + [Qubes 3.2] sudo gedit /etc/yum.repos.d/qubes-r3.repo + [Qubes 4.0] sudo gedit /etc/yum.repos.d/qubes-r4.repo + +4. This opens the gedit text editor in a window. Change all four instances of `http` to `https`. +5. Click the "Save" button in the top-right corner of the window. +6. Close the window. +7. Check for updates normally. +8. Shut down the TemplateVM. + Hardware Requirements --------------------- @@ -135,6 +164,7 @@ Getting Help [Bug 1374983]: https://bugzilla.redhat.com/show_bug.cgi?id=1374983 [Bug 1268700]: https://bugzilla.redhat.com/show_bug.cgi?id=1268700 [#2835]: https://github.com/QubesOS/qubes-issues/issues/2835 +[#3737]: https://github.com/QubesOS/qubes-issues/issues/3737 [system requirements]: /doc/system-requirements/ [Hardware Compatibility List]: /hcl/ [live USB]: /doc/live-usb/ diff --git a/releases/4.0/release-notes.md b/releases/4.0/release-notes.md index 93a280d4..e6cb8614 100644 --- a/releases/4.0/release-notes.md +++ b/releases/4.0/release-notes.md @@ -39,6 +39,35 @@ Security Notes However, PV VMs migrated from any earlier 4.0 release candidate (RC1, RC2, or RC3) are not automatically set to PVH mode. These must be set manually. +* The following steps may need to be applied in dom0 and Fedora 26 TemplateVMs in order to receive updates (see [#3737]). + + Steps for dom0 updates: + + 1. Open the Qubes Menu by clicking on the "Q" icon in the top-left corner of the screen. + 2. Select `Terminal Emulator`. + 3. In the window that opens, enter this command: + + sudo nano /etc/yum.repos.d/qubes-dom0.repo + + 4. This opens the nano text editor. Change all four instances of `http` to `https`. + 5. Press `CTRL+X`, then `Y`, then `ENTER` to save changes and exit. + 6. Check for updates normally. + + Steps for Fedora 26 TemplateVM updates: + + 1. Open the Qubes Menu by clicking on the "Q" icon in the top-left corner of the screen. + 2. Select `Template: fedora-26`, then `fedora-26: Terminal`. + 3. In the window that opens, enter the command for your version: + + [Qubes 3.2] sudo gedit /etc/yum.repos.d/qubes-r3.repo + [Qubes 4.0] sudo gedit /etc/yum.repos.d/qubes-r4.repo + + 4. This opens the gedit text editor in a window. Change all four instances of `http` to `https`. + 5. Click the "Save" button in the top-right corner of the window. + 6. Close the window. + 7. Check for updates normally. + 8. Shut down the TemplateVM. + Known issues ------------ @@ -95,3 +124,4 @@ We also provide [detailed instruction][upgrade-to-r4.0] for this procedure. [upgrade-to-r4.0]: /doc/upgrade-to-r4.0/ [locale-bug]: https://github.com/QubesOS/qubes-issues/issues/3753 [keyboard-layout-bug]: https://github.com/QubesOS/qubes-issues/issues/3352 +[#3737]: https://github.com/QubesOS/qubes-issues/issues/3737