diff options
| author | Daniel Micay <danielmicay@gmail.com> | 2022-12-05 04:46:15 -0500 |
|---|---|---|
| committer | Daniel Micay <danielmicay@gmail.com> | 2022-12-05 04:46:15 -0500 |
| commit | cb1664099b90e87717966185102dc8820621d185 (patch) | |
| tree | 33acff7a6e2d01b8f317fe103100ffdfeafc7994 | |
| parent | 454f76e426f863822878c4744b5720b896e5c0e5 (diff) | |
document GNOME bug causing installation issues
| -rw-r--r-- | static/install/cli.html | 8 | ||||
| -rw-r--r-- | static/install/web.html | 8 |
2 files changed, 16 insertions, 0 deletions
diff --git a/static/install/cli.html b/static/install/cli.html index d16992aa..6cafc2f4 100644 --- a/static/install/cli.html +++ b/static/install/cli.html @@ -339,6 +339,14 @@ Installed as /home/username/platform-tools/fastboot</pre> <p>Connect the phone to the computer. On Linux, you'll need to do this again if you didn't have the udev rules set up when you connected it.</p> + <p>On Linux, GNOME has a bug causing compatibility issues with the installation + process. It wrongly detects the phone in fastboot mode or fastbootd mode as being + an MTP device and claims exclusive control over it. This will block the install + process from proceeding. We don't yet have more specific instructions on working + around this issue than avoiding GNOME or another desktop environment running the + GNOME services such as GVFS. We expect the problem is in GVFS, so stopping all of + the services should work, but you'll need to mask them or they'll auto restart.</p> + <p>On Windows, you need to install a driver for fastboot if you don't already have it. No driver is needed on other operating systems. You can obtain the driver from Windows Update which will detect it as an optional update when the device is diff --git a/static/install/web.html b/static/install/web.html index 5902684b..eccdbfa2 100644 --- a/static/install/web.html +++ b/static/install/web.html @@ -220,6 +220,14 @@ <p>Connect the phone to the computer. On Linux, you'll need to do this again if you didn't have the udev rules set up when you connected it.</p> + <p>On Linux, GNOME has a bug causing compatibility issues with the installation + process. It wrongly detects the phone in fastboot mode or fastbootd mode as being + an MTP device and claims exclusive control over it. This will block the install + process from proceeding. We don't yet have more specific instructions on working + around this issue than avoiding GNOME or another desktop environment running the + GNOME services such as GVFS. We expect the problem is in GVFS, so stopping all of + the services should work, but you'll need to mask them or they'll auto restart.</p> + <p>On Windows, you need to install a driver for fastboot if you don't already have it. No driver is needed on other operating systems. You can obtain the driver from Windows Update which will detect it as an optional update when the device is |