7. FAQ

1. Which Java versions are supported?

Currently, Open JDK and Oracle JDK versions 8, 9 and 10 are known to work. Java 11 does not currently work.

2. Gradle gets stuck

If you experience problems with gradle seemingly getting stuck (such as staying at 0% progress) make sure that you are connected to the internet. If you are sure that you are connected to the internet, cancel the current task, eg. by pressing Ctrl+C, and restart it again.

Depending on which task got stuck, and in which phase, you might have to delete the folders that were created by the task.

1. Bootstrap gets stuck: delete the jde folder
2. Setup gets stuck: delete the jde/runtime sub-folder which was being created, eg. jde/runtime/6.0.6
3. If backup gets stuck: Delete the backup 7z file that was being created. Backups are created in the jazz-development-environment/backup folder

3. I get weird Gradle errors

> Task :buildSrc:compileJava
D:\workspaces_git\jazz-debug-environment\buildSrc\src\main\java\org\jazzcommunity\development\BackupTask.java:9: error: package org.gradle.api.tasks.options does not exist
import org.gradle.api.tasks.options.Option;
                                   ^
D:\workspaces_git\jazz-debug-environment\buildSrc\src\main\java\org\jazzcommunity\development\SetupTask.java:7: error: package org.gradle.api.tasks.options does not exist
import org.gradle.api.tasks.options.Option;
                                   ^
D:\workspaces_git\jazz-debug-environment\buildSrc\src\main\java\org\jazzcommunity\development\BackupTask.java:58: error: cannot find symbol
  @Option(option = "mode", description = "Sets which backup mode to use.")
   ^
  symbol:   class Option
  location: class BackupTask
D:\workspaces_git\jazz-debug-environment\buildSrc\src\main\java\org\jazzcommunity\development\SetupTask.java:76: error: cannot find symbol
  @Option(option = "sdk", description = "Which SDK version to set up. Default is latest.")
   ^
  symbol:   class Option
  location: class SetupTask
4 errors


FAILURE: Build failed with an exception.

Make sure that you are always using the gradle wrapper (./gradlew) to run any jazz development environment task. If you do not wish to use the gradle wrapper, make sure that you are at least running gradle 4.10, ensuring compatibility with all features used by the tool.

4. The run task runs, a terminal pops up and closes again right away

Most likely, you have another instance of jazz development version running. Only one run time can be executed at a time. Stop the other instance, and then try running again.

5. Which versions are currently available?

Currently, versions 6.0.3 and 6.0.6 have all configuration files necessary for creating a run time.

6. So my computer is really old...

Non 64-bit systems are untested, unknown if they work, and you probably won't have fun working on them anyway. You're welcome to try, but I doubt that will work.

7. I'm behind a proxy

If you are behind a proxy server, you have to make sure that your gradle proxy settings can pass through the proxy. Jazz development environment requires external dependencies, so you either need to make sure that gradle can reach the internet, or that all required packages are in your local package repository (eg. Artifactory). This link explains the gradle proxy settings.

8. I'm still behind a proxy

My personal workaround for the windows proxy situation is to use fiddler as a local remote proxy. Download Fiddler and make sure an instance is running. You can then use the fiddler to manage your http and https connections. Example gradle config:

systemProp.https.proxyHost=127.0.0.1
systemProp.https.proxyPort=8888
systemProp.http.proxyHost=127.0.0.1
systemProp.http.proxyPort=8888

9. Gradle compileJava task fails.

Starting a Gradle Daemon (subsequent builds will be faster)
> Task :buildSrc:compileJava FAILED

FAILURE: Build failed with an exception.

* What went wrong:
Execution failed for task ':buildSrc:compileJava'.
> Could not find tools.jar. Please check that D:\Java\jre contains a valid JDK installation.

* Try:
Run with --stacktrace option to get the stack trace. Run with --info or --debug option to get more log output. Run with --scan to get full insights.

* Get more help at https://help.gradle.org

You need to make absolutely sure that the location of JAVA_HOME points to an installation of the JDK (Java Development Kit), and no just the JRE (Java Runtime Environment). The relevant part of the error message is this:

> Could not find tools.jar. Please check that D:\Java\jre contains a valid JDK installation.