(move docker/cgroups v2 issue and rewrite it a bit) |
(rewrite arm entries a bit (better style, macro use etc)) |
||
Line 42: | Line 42: | ||
{{Common bugs issue|nvidia-jetson-tk1-nouveau|Nvidia Jetson TK1 requires nouveau driver to be blacklisted for graphical output|}} | {{Common bugs issue|nvidia-jetson-tk1-nouveau|Nvidia Jetson TK1 requires nouveau driver to be blacklisted for graphical output|}} | ||
Due to an issue with Nouveau on the Nvidia Jetson TK1 you will need to blacklist the driver. To do this before booting the system, mount the installation media and edit the | Due to an issue with Nouveau on the Nvidia Jetson TK1 you will need to blacklist the driver. To do this before booting the system, mount the installation media and edit the file {{filename|/etc/extlinux.conf}}, adding {{code|1=rd.driver.blacklist=nouveau}} to the kernel parameters (line that begins with append). | ||
{{Common bugs issue|etnaviv-cma|Etnaviv on imx.6 requires CMA adjustment for graphical output|}} | {{Common bugs issue|etnaviv-cma|Etnaviv on imx.6 requires CMA adjustment for graphical output|}} | ||
To use the Etnaviv driver on imx.6 based boards you will need to make a small adjustment to the kernel parameters to fix CMA memory allocation issues. To do this before booting the system, mount the installation media and edit the | To use the Etnaviv driver on imx.6 based boards you will need to make a small adjustment to the kernel parameters to fix CMA memory allocation issues. To do this before booting the system, mount the installation media and edit the file {{filename|/etc/extlinux.conf}}, changing {{code|1=cma=256MB}} to {{code|1=cma=256M@2G}}. This was fixed in a recent [https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/commit/?id=f3057ad767542be7bbac44e548cb44017178a163| upstream kernel commit], so the fix should appear in a future Fedora kernel update. | ||
{{Common bugs issue|low-memory-systems|Low memory systems|}} | {{Common bugs issue|low-memory-systems|Low memory systems|}} | ||
Systems with low memory (less than 512MB) may run out of memory when running some applications- most notably dnf. To workaround this, stop and disable the zram service | Systems with low memory (less than 512MB) may run out of memory when running some applications- most notably dnf. To workaround this, stop and disable the zram service: | ||
systemctl stop zram; systemctl disable zram; swapoff /dev/zram0 | |||
It is recommended you then create a swap file to use in its place. | |||
== AArch64 issues == | == AArch64 issues == | ||
Line 56: | Line 58: | ||
{{Common bugs issue|aarch64-arm-smmu-errors|Some AArch64 systems may boot with iommu/arm-smmu errors using Device Tree|1724276}} | {{Common bugs issue|aarch64-arm-smmu-errors|Some AArch64 systems may boot with iommu/arm-smmu errors using Device Tree|1724276}} | ||
Some Enterprise AArch64 systems may boot with iommu/arm-smmu errors when booting using device tree (the fedora default). It is recommended to boot these systems using ACPI by adding | Some Enterprise AArch64 systems may boot with iommu/arm-smmu errors when booting using device tree (the fedora default). It is recommended to boot these systems using ACPI by adding {{code|1=acpi=force}} to the kernel parameters. If you would like to use device tree you can work around this issue by adding {{code|1=arm-smmu.disable_bypass=n}}. To do one of these permanently, you can use one of the following: | ||
sudo grub2-editenv - set "$(grub2-editenv - list | grep kernelopts) acpi=force" | |||
sudo grub2-editenv - set "$(grub2-editenv - list | grep kernelopts) arm-smmu.disable_bypass=n" | |||
This should be fixed in a system firmware update. | |||
== Other software issues == | == Other software issues == |
Revision as of 01:13, 29 October 2019
This page documents common bugs in Fedora 31 and, if available, fixes or workarounds for these problems. If you find your problem in this page, please do not file a bug for it, unless otherwise instructed. Where appropriate, a reference to the current bug(s) in Bugzilla is included.
Release Notes
Read the Fedora 31 release announcement and the Fedora 31 release notes for specific information about changes in Fedora 31 and other general information.
My bug is not listed
Not every bug is listed in this page, but Bugzilla should be a comprehensive database of known bugs. This page is a sampling of the bugs most commonly discussed on our mailing lists and forums.
To see if your bug has already been reported, you can search Bugzilla. If it has not yet been reported, we encourage you to do so to help improve Fedora for yourself and others. A guide to Bugs and feature requests has been prepared to assist you.
If you believe an already-reported bug report should be added to this page because it is commonly encountered, you can:
- Add it yourself, if you have wiki access. Common bugs instructions provides guidance on how to add an entry to the page correctly, but the most important thing is to make sure that the bug is listed - don't worry if you don't get the format quite right, we can clean it up later.
- Or, add the CommonBugs keyword to the bug report. Someone from the QA team will then inspect the issue to determine whether the bug should be listed as a common bug. To expedite your request, please add a comment to the bug that includes
- a summary of the problem
- any known workarounds
- an assessment on the impact to Fedora users
For reference, you can query Bugzilla for bugs tagged CommonBugs:
- CommonBugs? (bugs with CommonBugs keyword, but do not yet have a link to this page)
- CommonBugs+(bugs with CommonBugs keyword and contain a link to this page)
Core system issues
Encrypted system does not resume from hibernation correctly if you wait more than 90 seconds to input encryption password
link to this item - Bugzilla: #1705522
If you install Fedora 31 with the system partitions encrypted, and then use the hibernate (suspend-to-disk) feature, you will be prompted to input the encryption password during system resume. If you wait longer than 90 seconds before inputting the password, the system will not resume from hibernation correctly - instead a fresh boot will be performed and your previous state will be lost.
There is currently no known workaround for this problem besides simply making sure you input the password soon enough to avoid it happening.
Installation issues
Workstation (GNOME) issues
Custom keyboard layout switch key combinations do not work in X11
link to this item - Bugzilla: #1743005
It has been reported that in Fedora 31, if you run GNOME on X11 (not on Wayland) and configure a custom key combination for switching the keyboard layout via GNOME Tweak Tool or direct configuration editing, the custom combination will not work. Custom switcher combos do work in Wayland, and the several pre-defined combos available via the GNOME Control Center do work in both X11 and Wayland. Switching layout via the graphical menu in the top panel also works.
KDE issues
Upgrade issues
Upgrading Fedora Silverblue or Fedora IoT from an older Fedora release to Fedora 31 might result in duplicate GRUB entries at boot time. However, the default boot entry is still the correct one. Hence, updating and rebooting should still work as usual. This is due to both GRUB2 (via blscfg
) and ostree-grub2 (via /etc/grub.d/15_ostree
) emitting menu entries. However, we cannot yet turn off the latter in favour of pure BLS booting due to a combination of: (1) older systems may have a GRUB2 too old to understand BLS, (2) OSTree systems do not yet have a mechanism for updating bootloader software, and (3) there is no easy way to detect the currently installed GRUB2 version.
We're working on ways to address this. In the meantime, one way to remove the duplicate menu entries is to disable blscfg
support by setting GRUB_ENABLE_BLSCFG=false
in /etc/default/grub
. This will take effect on the next update and reboot.
For more information, see https://github.com/ostreedev/ostree/pull/1929 and https://discussion.fedoraproject.org/t/boot-entries-gone-after-upgrade/8026.
ARM issues
Nvidia Jetson TK1 requires nouveau driver to be blacklisted for graphical output
Due to an issue with Nouveau on the Nvidia Jetson TK1 you will need to blacklist the driver. To do this before booting the system, mount the installation media and edit the file /etc/extlinux.conf
, adding rd.driver.blacklist=nouveau to the kernel parameters (line that begins with append).
To use the Etnaviv driver on imx.6 based boards you will need to make a small adjustment to the kernel parameters to fix CMA memory allocation issues. To do this before booting the system, mount the installation media and edit the file /etc/extlinux.conf
, changing cma=256MB to cma=256M@2G. This was fixed in a recent upstream kernel commit, so the fix should appear in a future Fedora kernel update.
Low memory systems
Systems with low memory (less than 512MB) may run out of memory when running some applications- most notably dnf. To workaround this, stop and disable the zram service:
systemctl stop zram; systemctl disable zram; swapoff /dev/zram0
It is recommended you then create a swap file to use in its place.
AArch64 issues
Some AArch64 systems may boot with iommu/arm-smmu errors using Device Tree
link to this item - Bugzilla: #1724276
Some Enterprise AArch64 systems may boot with iommu/arm-smmu errors when booting using device tree (the fedora default). It is recommended to boot these systems using ACPI by adding acpi=force to the kernel parameters. If you would like to use device tree you can work around this issue by adding arm-smmu.disable_bypass=n. To do one of these permanently, you can use one of the following:
sudo grub2-editenv - set "$(grub2-editenv - list | grep kernelopts) acpi=force" sudo grub2-editenv - set "$(grub2-editenv - list | grep kernelopts) arm-smmu.disable_bypass=n"
This should be fixed in a system firmware update.
Other software issues
Docker package no longer available and will not run by default (due to switch to cgroups v2)
link to this item - Bugzilla: #1757078
The Docker package has been removed from Fedora 31. It has been replaced by the upstream package moby-engine, which includes the Docker CLI as well as the Docker Engine. However, we recommend instead that you use podman
, which is a Cgroups v2-compatible container engine whose CLI is compatible with Docker's. Fedora 31 uses Cgroups v2 by default. The moby-engine package does not support Cgroups v2 yet, so if you need to run the moby-engine or run the Docker CE package, then you need to switch the system to using Cgroups v1, by passing the kernel parameter systemd.unified_cgroup_hierarchy=0. To do this permanently, run sudo grub2-editenv - set "$(grub2-editenv - list | grep kernelopts) systemd.unified_cgroup_hierarchy=0"
.