Howto troubleshoot issues with the easy-installer

General hints

Please specify operating system and phone model

In case you ask for help, please specify which operating system you are using and whether you try to install on FP3 or FP3+. If it’s an FP3, please also specify if you’ve done the update to Android 10 or if you’re still on Android 9.

Where to find the log

The installer creates a log file with a randomly generated name (e.g. 45761d08-711f-435a-881d-a236949654bb.log) that might contain useful information if something doesn’t work as expected.

Location of the log file:

  • Linux: ~/snap/easy-installer/common
  • Windows: %LOCALAPPDATA%\easy-installer

The log file is too large to upload to the forum directly. If you report a problem, please paste the contents of the logfile to https://haste.tchncs.de/ and click the save icon there which will generate a link which you can then use here.

If the log is too large even for haste and you already have an /e/ account, you can ZIP the log and upload it to your /e/ account cloud storage.

Problems running the installer

If the installer just doesn’t start as if nothing happens (on Linux)

If you click on the easy-installer icon and nothing happens at all, please open a terminal and execute

snap run easy-installer

This will likely generate some error output you can check against the known issues below.

Unable to open DISPLAY (on Linux)

This happens when the installer is run on wayland. It should work in an xorg session. See: Running Easy Installer on Linux

The full error looks like this:

    Exception in thread "main" java.lang.reflect.InvocationTargetException
	at java.base/jdk.internal.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
	at java.base/jdk.internal.reflect.NativeMethodAccessorImpl.invoke(Unknown Source)
	at java.base/jdk.internal.reflect.DelegatingMethodAccessorImpl.invoke(Unknown Source)
	at java.base/java.lang.reflect.Method.invoke(Unknown Source)
	at java.base/sun.launcher.LauncherHelper$FXHelper.main(Unknown Source)
Caused by: java.lang.UnsupportedOperationException: Unable to open DISPLAY
	at javafx.graphics/com.sun.glass.ui.gtk.GtkApplication.lambda$new$6(Unknown Source)
	at java.base/java.security.AccessController.doPrivileged(Native Method)
	at javafx.graphics/com.sun.glass.ui.gtk.GtkApplication.<init>(Unknown Source)
	at javafx.graphics/com.sun.glass.ui.gtk.GtkPlatformFactory.createApplication(Unknown Source)
	at javafx.graphics/com.sun.glass.ui.Application.run(Unknown Source)
	at javafx.graphics/com.sun.javafx.tk.quantum.QuantumToolkit.startup(Unknown Source)
	at javafx.graphics/com.sun.javafx.application.PlatformImpl.startup(Unknown Source)
	at javafx.graphics/com.sun.javafx.application.PlatformImpl.startup(Unknown Source)
	at javafx.graphics/com.sun.javafx.application.LauncherImpl.startToolkit(Unknown Source)
	at javafx.graphics/com.sun.javafx.application.LauncherImpl.launchApplicationWithArgs(Unknown Source)
	at javafx.graphics/com.sun.javafx.application.LauncherImpl.launchApplication(Unknown Source)
	... 5 more

Internal Error (on Linux)

This so far only happened with version v0.12.0-beta and is fixed in v0.12.1-beta, so just upgrade your installer via:

snap refresh easy-installer --channel=latest/beta

You may have to prepend sudo to the command above.

Full error is

Exception in thread “main” java.lang.reflect.InvocationTargetException
at java.base/jdk.internal.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
at java.base/jdk.internal.reflect.NativeMethodAccessorImpl.invoke(Unknown Source)
at java.base/jdk.internal.reflect.DelegatingMethodAccessorImpl.invoke(Unknown Source)
at java.base/java.lang.reflect.Method.invoke(Unknown Source)
at java.base/sun.launcher.LauncherHelper$FXHelper.main(Unknown Source)
Caused by: java.lang.UnsupportedOperationException: Internal Error
at javafx.graphics/com.sun.glass.ui.gtk.GtkApplication.lambda$new$6(Unknown Source)
at java.base/java.security.AccessController.doPrivileged(Native Method)
at javafx.graphics/com.sun.glass.ui.gtk.GtkApplication.(Unknown Source)
at javafx.graphics/com.sun.glass.ui.gtk.GtkPlatformFactory.createApplication(Unknown Source)
at javafx.graphics/com.sun.glass.ui.Application.run(Unknown Source)
at javafx.graphics/com.sun.javafx.tk.quantum.QuantumToolkit.startup(Unknown Source)
at javafx.graphics/com.sun.javafx.application.PlatformImpl.startup(Unknown Source)
at javafx.graphics/com.sun.javafx.application.PlatformImpl.startup(Unknown Source)
at javafx.graphics/com.sun.javafx.application.LauncherImpl.startToolkit(Unknown Source)
at javafx.graphics/com.sun.javafx.application.LauncherImpl.launchApplicationWithArgs(Unknown Source)
at javafx.graphics/com.sun.javafx.application.LauncherImpl.launchApplication(Unknown Source)
… 5 more

Installer hangs after unlock instructions in “Start device in Fastboot mode” (on Windows)

start fastboot instruction

If detection of the phone in fastboot mode fails on Windows (also when a manual fastboot devices doesn’t see the phone) you might have to install extra drivers.

For detailed instructions (incl. Screenshots) see [HOWTO] Easy Installer for Windows stuck after booting the Fairphone in fastboot mode or FP3+ no USB conection via fastboot, unlocking bootloader not possible

Problems compiling the installer

$JAVA_HOME not set

To compile the easy-installer the $JAVA_HOME environment variable needs to be set. See Can't compile easy installer

The error message is not very helpful in this case, it just outputs the following:

./gradlew dist

[...]

> Task :prepareMergedJarsDir FAILED
:prepareMergedJarsDir (Thread[Task worker for ':',5,main]) completed. Took 0.0 secs.

FAILURE: Build failed with an exception.

* What went wrong:
Execution failed for task ':prepareMergedJarsDir'.
> No value has been specified for this provider.

To see a more detailed compile log, execute

./gradlew dist --debug --stacktrace

Running in IntelliJ: JavaFXPlugin has been compiled by a more recent version of the Java Runtime

The full error message is

Cause: org/openjfx/gradle/JavaFXPlugin has been compiled by a more recent version of the Java Runtime (class file version 55.0), this version of the Java Runtime only recognizes class file versions up to 52.0

This can be fixed by selecting a JDK with version 11 as “Gradle JVM” in the IntelliJ settings:
grafik

By default, IntelliJ uses a bundled JVM which is not new enough.

3 Likes

Hi,
when will be the next /e/installer release ?

Edit : i mean with more devices

The easy installer is open for developers from the community to update. If there are users who would want to upgrade the Easy Installer they are welcome to modify the code.

The documentation to get someone started adding new devices is at: https://gitlab.e.foundation/e/tools/easy-installer/-/wikis/home

If you want a rough breakdown of the steps involved, see

Just updates my FP3 from and. 9 to and. 10 using Easy Installer on Manjaro linux. Superb.
Lots off data is stored on /e/cloud, perfect for me.

Thanks a lot!

1 Like

The missing driver seem to be a frequent error. Do you see a possibility to include a mention of this in your howto? There are multiple ways of solving it (different drivers). No idea which one is the best practice.

Well, there is already one entry about missing drivers what do you think is missing there (except the full solution which is so long I’d rather not include it here but point to the existing post with all the details and screenshots)?

My idea behind the existing entries of this troubleshooting document was to describe the situation people might find themselves in and then give hints how to solve it or at least where to find more information.

Talking about “missing drivers”: I probably missed some people’s issues but the ones I remember should be covered by the " Installer hangs after unlock instructions in “Start device in Fastboot mode” (on Windows)" section.
If someone writes a Howto install necessary drivers in Windows I’d happily link it from here if the existing one is not sufficient (I found it to be helpful in the situation where fastboot cannot detect the phone).

Sorry, I didn’t see the section. Adding a screenshot to the section of the moment where easy-installer hangs would increase visibility.

1 Like

Bonjour Piero,
excusez-moi de passer par ici, mais je ne savais comment vous contacter.
Je suis un Finistérien de 67 ans qui boycotte les GAFAM.
Mon ordi est sous Linux Mint. Je ne connaissais pas l’existence de /e/ quans j’ai acheté mon FP3 chez Orange.
Je voudrais donc installer /e/ mais je n’y arrive pas. J’ai installé Easy installer et suivi toutes les procédures jusqu’à l’étape “transfert de fichiers” comprise, mais ensuite easy installer ne trouve pas mon téléphone. Il semble quela procédure de déblocage du bootloader ne marche pas, pourtant je suis la procédure décrite sur le site de Fairphone, avec le code de déblocage". Rien, j’ai essayé +eurs fois.
J’ai passé près de 6h à m’acharner sur ce machin et je ne sais plus quoi faire. L’aide de Ingo FP Angel ne m’a pas permis d’avancer.
Pouvez-vous quelquechose pour moi?
Merci
Yves