From Fedora Project Wiki

(added broekn icon of https://bugzilla.redhat.com/show_bug.cgi?id=1626810)
(Improve Shenandoah section)
Line 169: Line 169:
=== Shenandoah  ===
=== Shenandoah  ===
<pre>
<pre>
   # jdk8 and jdk11 have new garabge collector
   # jdk8 and jdk11 have new garabge collector (on x86_64 and aarch64)
   # you can use it via:
   # you can use it via:
java -XX:+UseShenandoahGC  ohter_params_as_ususally
java -XX:+UseShenandoahGC  ohter_params_as_ususal
   # or set it up globally:
   # or set it up globally:
export JAVA_TOOL_OPTIONS="-XX:+UseShenandoahGC $JAVA_TOOL_OPTIONS"
export JAVA_TOOL_OPTIONS="-XX:+UseShenandoahGC $JAVA_TOOL_OPTIONS"
   # are you arpplications working with Shenandoah?  
   # are you applications working with Shenandoah?  
   # are there working better?
   # are they working better?


</pre>
</pre>
=== JAVA_HOME ===
=== JAVA_HOME ===
* See https://fedoraproject.org/wiki/Changes/Decouple_system_java_setting_from_java_command_setting for more details.
* See https://fedoraproject.org/wiki/Changes/Decouple_system_java_setting_from_java_command_setting for more details.

Revision as of 15:15, 14 September 2018

java OpenJDK
Test-days-banner.svg

Date 2018-09-26
Time all day

Website QA/Test Days
IRC #fedora-devel (webirc)
Mailing list test


Note.png
Can't make the date?
If you come to this page before or after the test day is completed, your testing is still valuable, and you can use the information on this page to test, file any bugs you find at Bugzilla, and add your results to the results section. If this page is more than a month old when you arrive here, please check the current schedule and see if a similar but more recent Test Day is planned or has already happened.

What to test?

Today's instalment of Fedora Test Day will focus on OpenJDK 11 and OpenJDK 10. Currently we have java-1.8.0-openjdk as main JDK in Fedora. It accompanied java-1.7.0-openjdk as JRE for a year, and replaced it in buildroot in F21. Similarly, as did java-1.7.0-openjdk to java-1.6.0-openjdk in F16 as parallel JRE and replaced it in F17 in build root and main JDK. However, today the situation is more complicated. Oracle changed release process, see OpenJDK 11 summary and OpenJDK 10 summary, so currently, in F27 and up, you have java-1.8.0-openjdk as main JDK, java-openjdk as rolling release of STS JDK 10, and java-11-openjdk as techpreview of future LTS JDK. Javaws is provided in another package - icedtea-web

  • Most crucial is, that JDK10 and JDK11, unlike JDK8, are modular, so many java applications will cease to work.
    • This is not crucial part of the testing, but to have an matrix of most common failures would be interesting

Among other changes are

  • parallel installability
  • switching of JRE/JDK
  • platform docs and sources
  • config files in /etc
  • system wide crypto policy

Who's available

The following cast of characters will be available testing, workarounds, bug fixes, and general discussion. In case of problem related to test day organization/wiki/whatever, please reach out to sumantrom.

  • CET: jvanek, zzambers, mvala, pmikova, jerboaa
  • EDT: still_looking_for_volunteers


Prerequisite for Test Day

  • kind relationship to java
  • basic knowledge of java and javac or rpms.
  • basic knowledge of java's jigsaw (major change in jdk9) is advantage
  • Root access on the system where testing is happening

Known issues

  • [dnf reinstall is broken]
  • -debug or -slowdebug packages are not for reasonable use. They are for people debugging JDK iself. This testcase is not covering them. Feel free to try to install them, and to switch them, also some apps should run in them (although terribly slowly) so if you face some issues with them, it is most likely not an issue.
  • accessibility works only on java-1.8.0-openjdk
    • even there it is known to have side effects and strange consequences
  • recently was found broken icon at jdk8: https://bugzilla.redhat.com/show_bug.cgi?id=1626810

How to test?

Basic cases

sudo dnf install java
   # have it installed JRE you expected?
   # is java on path and working?
   # are java applications working?
   # do you miss something?
   # is content of /usr/lib/jvm sane?
   # is content of /etc/java  sane? (jdk8 got /etc/java support in f29)
   # are alternatives sane? (see lower)

sudo dnf install java-devel
   # have it installed JDK you expected?
   # is java  and javac on path and working?
   # do you miss something?
   # is content of /usr/lib/jvm sane?
   # is content of /etc/java  sane? (jdk8 got /etc/java support in f29)
   # are alternatives sane? (see lower)

sudo dnf install java-openjdk
   # have it installed JRE you expected?
   # is java on path and working?
   # are java applications working?
   # do you miss something?
   # similarly for java-openjdk-devel as  jwith ava-devel
   # is content of /usr/lib/jvm sane?
   # is content of /etc/java  sane? (jdk8 got /etc/java support in f29)
   # are alternatives sane? (see lower)

sudo dnf install java-11-openjdk
   # have it installed JRE you expected?
   # is java on path and working?
   # are java applications working?
   # do you miss something?
   # similarly for java-11-openjdk-devel as  jwith ava-devel
   # is content of /usr/lib/jvm sane?
   # is content of /etc/java  sane? (jdk8 got /etc/java support in f29)
   # are alternatives sane? (see lower)

sudo dnf install java-1.8.0-openjdk
   # have it installed JRE you expected?
   # is java on path and working?
   # are java applications working?
   # do you miss something?
   # similarly for java-1.8.0-openjdk-devel as  jwith ava-devel
   # is content of /usr/lib/jvm sane?
   # is content of /etc/java  sane? (jdk8 got /etc/java support in f29)
   # are alternatives sane? (see lower)

sudo dnf install java-9-openjdk
  # should install nothing on f29
  # if it does, it is a bug
  # should install on f28, but please donot

sudo dnf install icedtea-web
   # is javaws on path and working?
   # are alternatives sane? (see lower)

sudo dnf update $JDK
sudo dnf remove $JDK
   # is the system sane after upgrade/remove?

Switching JRE/JDK

  • Multiple jdks are handled by alternatives
  • Major masters are:
  • for SDK: javac, java_sdk_openjdk, java_sdk_$VERSION, java_sdk_$VERSION_openjdk
  • for JRE: java, jre_openjdk, jre_$VERSION, jre_$VERSION_openjdk
    • where version is one of 1.8.0, 10, 11
  • for javadoc: javadocdir
  • or javadoc-zip: javadoczip
  • for icedtea-web: javaws
sudo alternatives --config  $MASTER
   # will select the tooling acocrding by masters from above
   # except programs on PATH, also direcotries in /usr/lib/jvm are shufled. Please observe!
alternatives --display $MASTER
   # will show current setup for given master

### headless JRE ###
   # if your application do not need X (GUI) operate with ...-headless subpackage  only in above examples
   # if you need javac,  operate with ...-devel subpackage  in above examples
   # if you need javadoc or sources,  operate with ...-src, -javadoc and javadoc-zip  subpackage   in above examples

########################################################
# There are *many*  jdk  packages and  countless  subpackages
########################################################
no | sudo dnf install "java*openjdk*"
dnf   search  "java*openjdk*" 
   # note for f28 -   jdk9 is no longer supported, and is there only because jdk10 was not alive in time of f28 release 
   # on f29 you should NOT see jdk9 appear

  # Please try to install and use various combinations. This is quite crucial part of this testday.
  # is the combination working and you can switch? 
  # can you switch installtaions
  # are slaves as expected?
  # is /etc/java affecting correct jdk and so on....

System wide crypto policy

Your java and javaws is affected by system crypto policy

update-crypto-policies --show
   # will should you current

sudo  update-crypto-policies --set DEFAULT
  # will set standart policy
  # many javaws or https applications may cause to work

sudo  update-crypto-policies --set LEGACY
  # will allow  insecure algorithms
  # is your failing javaws or https applications fixed?

sudo  update-crypto-policies --set FUTURE
  # will harden your computer
  # nearly no  javaws or https application will remain working

Shenandoah

   # jdk8 and jdk11 have new garabge collector (on x86_64 and aarch64)
   # you can use it via:
java -XX:+UseShenandoahGC  ohter_params_as_ususal
   # or set it up globally:
export JAVA_TOOL_OPTIONS="-XX:+UseShenandoahGC $JAVA_TOOL_OPTIONS"
   # are you applications working with Shenandoah? 
   # are they working better?

JAVA_HOME

   # is JAVA_HOME working for you?

Install Only JDK

  • Our RPMs, can be installed fully in paralel:
  • To enable this very special case, you have to modify /etc/dnf/dnf.conf and add/modify installonlypkgs
installonlypkgs=list_of_packages_you_care_about

The list differs if you care about headless jre only, or full JDK. eg.:

installonlypkgs=java-1.8.0-openjdk-headless java-1.8.0-openjdk java-1.8.0-openjdk-devel

Most commonly:

installonlypkgs=java-1.8.0-openjdk*

Or:

installonlypkgs=java-11-openjdk*

This case, however hard to maintain is really used by people developing java itself. Also it is very useful for admins, who cna try to deploy application on newer version by parts, or try first.

   # is the multiple install feature working for you as advertised?

Exploratory testing

If you run out of test cases, congratulations! But that's not the end! You can still help out by playing around with the various installs uninstalls parallel isntalls jre/jdk switching... in whatever ways you can think of: try out all the things you can find. Get creative! Any problems you find please file a bug, or report to the IRC channel.

Reporting bugs

If you have problems with any of the tests, report a bug to Bugzilla usually for the component java-openjdk or java-11-openjdk or java-1.8.0-openjdk. If you are unsure about exactly how to file the report or what other information to include, just ask on IRC and we will help you.