From Fedora Project Wiki

No edit summary
 
(9 intermediate revisions by one other user not shown)
Line 1: Line 1:
= Java on Fedora =
<div class="messagebox" style="float: right; margin-left: 10px;">__TOC__</div>
Java is about:
* Communities: the [https://www.jcp.org/ Java Community Process] to define the platform, but also [https://community.oracle.com/community/java/jug Java User Groups]
* Platforms (JVM, JRE ...) to run applications on PC, mobiles, embedded devices https://en.wikipedia.org/wiki/Java_(software_platform)
* Programming languages (Java is the most popular, but there are Scala, Groovy, Clojure ...) https://en.wikipedia.org/wiki/Java_(programming_language)


Fedora uses a Free software stack that consists of [http://en.wikipedia.org/wiki/Openjdk OpenJDK] and IcedTea. Refer to our [[Java/FAQ]]  for more information on that.  Software mentioned on this page may come in different packaging formats. Fedora's own packages (''RPM'') are easy to install (''with [[Dnf]]'') and installation instructions can be found from [[Docs/Drafts/SoftwareManagementGuide]]. Third party packages may be in archive formats (.zip, tar) for which case-specific instructions should be provided.


= Terminology =
What do you want to do:
* If you came here because an '''application ask for Java''' (or JRE, JVM) '''to be installed''', then simply install {{package|java-1.8.0-openjdk}}.
* If it still does not work:
** Install javafx and icedtea-web packages as well.
** Lastly, and if the application '''ask specifically for [http://www.oracle.com/technetwork/java/javase/index.html Oracle Java]''': See here [[#Oracle_version]].
* If '''you want to develop, code, on the Java Platform''': See [[Java/Development]].


In Java context, terms may be a bit confusing for newcomers. '''JRE''' (''Java Runtime Environment'') stands for ''virtual machine'', which is able to run Java programs.


'''JDK''' (''Java Development Kit'') or '''SDK''' (''Software Development Kit'') is needed to develop Java programs. Many SDK packages these days also ship JRE, or to confuse more, no separate JRE is provided and thus terminal installations are supposed to include the development environment.
=== JRE JDK JVM JSE ... ===


Terms '''AOT''' (''[http://en.wikipedia.org/wiki/AOT_compiler Ahead of Time]]''), '''SE''', '''J2EE''' need some more explanation.
Some vocabulary, if you are lost:


* '''JRE''' Java Runtime Environment. Required to run Java code and applications. Install {{package|java-1.8.0-openjdk}}.
* '''JVM''' Java Virtual Machine. Main component of the JRE.
* '''JDK''' Java Development Kit.  Required only for development, coding.
* '''SDK''' Software Development Kit. idem JDK
* '''JavaWS''' [https://en.wikipedia.org/wiki/Java_Web_Start Java Web Start] is a framework to start application from the Internet
* '''JavaFX''' [https://en.wikipedia.org/wiki/JavaFX JavaFX] is a platform to create and deliver desktop and Rich Internet Apps.
* '''OpenJFX''' is the JavaFX Open Source implementation
* '''OpenJDK''' Open Source project behind the Java Platform http://openjdk.java.net/.
* '''IcedTea''' is a support project for OpenJDK (concern only developers) http://icedtea.classpath.org/
* '''IcedTea-Web''' is the Java Web Start package (It contains only JavaWS, No Applets anymore.) Install to run '''JNPL''' files.
* '''Applets''' Obsolete techno. Not implemented in any recent package.
* '''JSE''', '''J2SE''', '''JEE''' ... obsolete acronyms for '''J'''ava '''S'''tandard & '''E'''nterprise '''E'''dition.  ''JavaSE'' is like ''JRE''.


= Java Runtime Environments (JRE) =
=== What is in Java OpenJDK package ===


Java has different JRE implementations and wide variety of combinations which work together. Different implementations can be installed simultaneously to Fedora and activated one at a time. Activation is done using the [[Alternatives]] system (''also used to change some other subsystems''). Java's subsystem name is surprisingly ''java'' and typical commands include:
For most users, it is just another system library. It is not an application with a GUI, but it is required by some other applications to run.
<pre># alternatives --display java</pre>
You might see a ''OpenJDK Policy tool'' desktop application that comes with the package, but you should not have to use it.
<pre># alternatives --config java</pre>


See alternative's own documentation for more information for usage and parts involved.
Beware that JavaFX and JavaWS are packaged separately!


Should be noted that JRE implementations installed outside Fedora distribution, may not support alternatives and thus not be visible there. Then the symbolic links under directory ''/etc/alternatives'' must be manually fixed.
== Multiple implementations ==


== OpenJDK and project IcedTea ==
Fedora provides the Free {{package|java-1.8.0-openjdk}}. If this Open Source stack does not fulfill your requirements. Alternatives can be installed alongside or separately.
Fedora has shipped OpenJDK as default JRE implementation. It's based on Sun Microsystem's/Oracle's [http://en.wikipedia.org/wiki/JavaOne JavaOne] open source release and complemented by Red Hat's [http://en.wikipedia.org/wiki/IcedTea IcedTea] project that implements the missing third party components that Sun/Oracle could not release under free License.


OpenJDK's '''java.library.path''', shared librarary paths for i386 are:
The '''J'''ava '''C'''ommunity '''P'''rocess defines the specifications of the platform that many implements (IBM J9, Jikes, Zing, Zulu Dalvik ...). We will only focus on Oracle here.
<pre>
/usr/lib
/usr/lib/jvm/java-1.?.0-openjdk-1.6.0.0.x86_64/jre/lib/
</pre>


and for x86_64:
Multiple implementations can be installed side-by-side without interfering:
<pre>
* The [[alternatives system]] allows to switch from one to another.
/usr/lib64
* An application can directly reference a specific Java installation
/usr/lib/jvm/java-1.?.0-openjdk-1.6.0.0.x86_64/jre/lib/amd64/
* Some applications include a java platform, it is then transparent for the user. (But the package is bigger.)
</pre>


OpenJDK package name on Fedora is ''java-1.?.0-openjdk''.
=== Oracle version ===


Some applications still ask for Oracle's implementation.  It is mostly based on the OpenJDK Open Source project, but there is proprietary code and Fedora does not package non-free software.


== Oracle's Java SE ==
Installing Oracle Java is fine. Just beware '''not''' to use Oracle '''RPM''', as it will kill OpenJDK default packages!
Original Oracle's Java SE (Standard Edition) can be downloaded directly from [http://www.java.com/en/download/ http://www.java.com/en/download/] and installed manually.


You're, however, encouraged to try out the OpenJDK runtime first.
Oracle provides a tarball: https://java.com/en/download/help/linux_x64_install.xml


We recommend to simply unpack the archives (tarball) to your home folder and set to path if necessary.


== Troubleshooting JRE ==
=== Switching alternatives ===


Fedora's JRE in browser environment can be tested using the following test pages:
If you installed multiple Java implementations or version, you can configure your system to use one or another.
* [http://www.java.com/en/download/help/testvm.xml http://www.java.com/en/download/help/testvm.xml]
* [http://java.com/en/download/installed.jsp?detect=jre&try=1 http://java.com/en/download/installed.jsp?detect=jre&try=1]


If these don't work, proceed with [[Java/Troubleshooting]] page.
'''Developers''': beware that javac has its own independent alternative. i.e. to change the JDK, use ''alternatives ... javac''!


= Java Development Tools (SDK) =
Switching is done using the [[alternatives system]] (''also used to change some other subsystems''). Java's subsystem name is surprisingly ''java'' and typical commands include:
<pre># alternatives --display java</pre>
<pre># alternatives --config java</pre>


The following SDKs are listed in alphabetic order.
See alternative's own documentation for more information for usage and parts involved.


== Eclipse ==
Should be noted that JRE implementations installed outside Fedora distribution, may not support alternatives and thus not be visible there. Then the symbolic links under directory ''/etc/alternatives'' must be manually fixed.


See our [[Eclipse]] page for an integrated development environment platform that itself is written in Java and has plugin support for many programming languages.
= Java packages in Fedora =


== IntelliJ IDEA ==
There are many aliases for OpenJDK package, see http://pkgs.fedoraproject.org/cgit/rpms/java-1.8.0-openjdk.git/tree/java-1.8.0-openjdk.spec or do "dnf repoquery --provides java-1.8.0-openjdk".


IntelliJ IDEA is considered by many the ultimate Java development environment. A commercial project for many years, IntelliJ IDEA became open-source in 2009 by releasing the IntelliJ IDEA Community Edition. IntelliJ is written in Java, features a portable Swing UI and is extensible via plugins.
You can use any of the following names:
* java
* java-1.8.0
* java-1.8.0-openjdk
* java-openjdk
* jre
* jre-1.8.0
* jre-1.8.0-openjdk
* jre-openjdk


== Maven ==


Fedora includes a somewhat customized version of Maven in the distribution. The customization is purely to make Maven work well in offline mode with the rest of the system. Details on how packagers can use this customized Maven are located [http://sochotni.fedorapeople.org/java-packaging-howto/ here] . Generally the latest stable Maven version is shipped. Also related to maven, a feasibility study is being performed to change the installation of Java packages to become a valid maven repository. It will make it easier to support parallel installation of either "legacy" or "progressive" versions of Java packages.  Once some positive results are obtained, it will be discussed on the fedora-devel-java-list. Maven itself is no longer patched to add support for Fedora's file layout but a pristine copy is shipped. Customizations are done via the [https://github.com/mizdebsk/xmvn XMvn project]. It is recommended to install maven-local rpm which will bring in xmvn as dependency but will also install some other helper scripts and customizations for Fedora.
<pre>dnf install java-1.8.0-openjdk</pre> might be the most safe (until 1.8 is EOL.)


== NetBeans IDE ==


The "reference" Java IDE, developed for many years by Sun(now Oracle). NetBeans is written in Java, features a portable Swing UI, out of the box support for many Java tools and frameworks and it's extensible via plugins.
'''Note''' that Java Web Start ('''JavaWS''') and '''JavaFX''' are packaged separately 'icedtea-web' and 'javafx' respectively.


= Java Server Side Environments =
Typically, without JavaFX, you may have error like:
<pre>java -jar scram.jar
Error: Could not find or load main class com.frequal.scram.designer.jfx.Main</pre>


== Apache Tomcat ==
<pre>dnf install icedtea-web javafx</pre>
Fedora ships [http://en.wikipedia.org/wiki/Apache_Tomcat Apache Tomcat] as part of standard distribution.


Apache Tomcat package name on Fedora is ''tomcat'' and is currently at version 7.x.
= Communicate =


== JBoss AS ==
You can subscribe to [https://admin.fedoraproject.org/mailman/listinfo/java-devel java-devel list] or talk to us in [irc://irc.freenode.net/fedora-java #fedora-java] Libera Chat IRC channel. Read [[Communicate]]  page for more information.


The [[SIGs/Java|Java SIG]] is working on packaging [http://jboss.org/as7 JBoss AS 7], along with a minimal set of required JARs, to make this open-source Java EE application server available as a service in Fedora.
= See Also =
* [[Java/FAQ]]
* [[Java/Troubleshooting]]
* [https://Ask.FedoraProject.org/en/questions/scope:all/sort:activity-desc/tags:java/page:1/ Ask Fedora about Java]


You can learn more about the effort and the current progress on the [[JBossAS7|JBoss AS 7 on Fedora]] page.


[[JBossAS7_in_Fedora_marketing_collateral|Talking points]] about JBoss AS 7 on Fedora 17 are available and are used to create marketing cards and information sheets.
* [https://bugzilla.redhat.com/buglist.cgi?component=java-1.8.0-openjdk&product=Fedora&bug_status=NEW&bug_status=ASSIGNED&bug_status=MODIFIED&bug_status=ON_DEV&bug_status=ON_QA&order=bugs.votes,bugs.bug_id Java-1.8.0-OpenJDK bugs]


= Teaching and Learning Java =
As part of planning and implementing new 100% FLOSS Java components into Fedora, this draft document has been opened to give developers a place to teach each other about best practices, patterns, etc.
[[Docs/Drafts/JavaProgramming]]
[[Category:Language-specific_SIGs]]
= Open Issues with Java packages =
* [https://bugzilla.redhat.com/buglist.cgi?component=java-1.8.0-openjdk&product=Fedora&bug_status=NEW&bug_status=ASSIGNED&bug_status=MODIFIED&bug_status=ON_DEV&bug_status=ON_QA&order=bugs.votes,bugs.bug_id java-1.7.0-openjdk]
* [https://bugzilla.redhat.com/bugzilla/buglist.cgi?product=Fedora&component=azureus Azureus]
* [https://bugzilla.redhat.com/bugzilla/buglist.cgi?product=Fedora&component=erlang erlang]
* [https://bugzilla.redhat.com/bugzilla/buglist.cgi?product=Fedora&component=itext itext]
* [https://bugzilla.redhat.com/bugzilla/buglist.cgi?product=Fedora&component=jogl JOGL]
* [https://bugzilla.redhat.com/bugzilla/buglist.cgi?product=Fedora&component=kawa kawa]
* [https://bugzilla.redhat.com/bugzilla/buglist.cgi?product=Fedora&component=pdftk PDFTK]
* [https://bugzilla.redhat.com/bugzilla/buglist.cgi?product=Fedora&component=plplot plplot]
* [https://bugzilla.redhat.com/bugzilla/buglist.cgi?product=Fedora&component=mod_cluster mod_cluster]
= Communicate =
You can subscribe to [https://admin.fedoraproject.org/mailman/listinfo/java-devel java-devel list] or talk to us in [irc://irc.freenode.net/fedora-java #fedora-java] Freenode IRC channel. Read [[Communicate]]  page for more information.
= See Also =
* [[Java/FAQ]]
* [[Java/Troubleshooting]]
* [[Java/PKIAppletCompatibility]]
* [[Java/StackTraces]]
* [[Java/JPPMavenReadme]]
* [[Java/FedoraJavaMarketingBrief]]
* [[Docs/Drafts/JavaProgramming]]
* [[Packaging:Java]]
* [[SIGs/Java]]
* [[SIGs/Java]]


= References =
= References =
* [http://openjdk.java.net/ OpenJDK Home]
* [http://openjdk.java.net/ OpenJDK Home]
* [https://bugs.openjdk.java.net/ OpenJDK bug tracking system]
* [https://wiki.openjdk.java.net/ OpenJDK Wiki]
* [http://icedtea.classpath.org/ IcedTea Home page]
* [http://icedtea.classpath.org/bugzilla/ IcedTea bug tracking system]
* [http://tomcat.apache.org/ Apache Tomcat]
* [http://java-source.net/open-source/web-servers Java web servers]
* [http://en.wikipedia.org/wiki/JBoss_application_server JBoss application server]
* [http://www.jboss.org/ JBoss Home page]
* [http://www.redhat.com/magazine/012oct05/features/java/ Red Hat Magazine article about java from 2005]
* [http://developer.classpath.org/ http://developer.classpath.org/]  
* [http://jpackage.org/ Jpackage.org]
* [http://jpackage.org/ Jpackage.org]
* [http://www.marketwire.com/press-release/Oracle-and-IBM-Collaborate-to-Accelerate-Java-Innovation-Through-OpenJDK-NASDAQ-ORCL-1332855.htm IBM joins to OpenJDK project]


[[Category:Java]]
[[Category:Java]]
[[Category:Language-specific_SIGs]]

Latest revision as of 15:41, 14 July 2021

Java is about:


What do you want to do:

  • If you came here because an application ask for Java (or JRE, JVM) to be installed, then simply install java-1.8.0-openjdk.
  • If it still does not work:
    • Install javafx and icedtea-web packages as well.
    • Lastly, and if the application ask specifically for Oracle Java: See here #Oracle_version.
  • If you want to develop, code, on the Java Platform: See Java/Development.


JRE JDK JVM JSE ...

Some vocabulary, if you are lost:

  • JRE Java Runtime Environment. Required to run Java code and applications. Install java-1.8.0-openjdk.
  • JVM Java Virtual Machine. Main component of the JRE.
  • JDK Java Development Kit. Required only for development, coding.
  • SDK Software Development Kit. idem JDK
  • JavaWS Java Web Start is a framework to start application from the Internet
  • JavaFX JavaFX is a platform to create and deliver desktop and Rich Internet Apps.
  • OpenJFX is the JavaFX Open Source implementation
  • OpenJDK Open Source project behind the Java Platform http://openjdk.java.net/.
  • IcedTea is a support project for OpenJDK (concern only developers) http://icedtea.classpath.org/
  • IcedTea-Web is the Java Web Start package (It contains only JavaWS, No Applets anymore.) Install to run JNPL files.
  • Applets Obsolete techno. Not implemented in any recent package.
  • JSE, J2SE, JEE ... obsolete acronyms for Java Standard & Enterprise Edition. JavaSE is like JRE.

What is in Java OpenJDK package

For most users, it is just another system library. It is not an application with a GUI, but it is required by some other applications to run. You might see a OpenJDK Policy tool desktop application that comes with the package, but you should not have to use it.

Beware that JavaFX and JavaWS are packaged separately!

Multiple implementations

Fedora provides the Free java-1.8.0-openjdk. If this Open Source stack does not fulfill your requirements. Alternatives can be installed alongside or separately.

The Java Community Process defines the specifications of the platform that many implements (IBM J9, Jikes, Zing, Zulu Dalvik ...). We will only focus on Oracle here.

Multiple implementations can be installed side-by-side without interfering:

  • The alternatives system allows to switch from one to another.
  • An application can directly reference a specific Java installation
  • Some applications include a java platform, it is then transparent for the user. (But the package is bigger.)

Oracle version

Some applications still ask for Oracle's implementation. It is mostly based on the OpenJDK Open Source project, but there is proprietary code and Fedora does not package non-free software.

Installing Oracle Java is fine. Just beware not to use Oracle RPM, as it will kill OpenJDK default packages!

Oracle provides a tarball: https://java.com/en/download/help/linux_x64_install.xml

We recommend to simply unpack the archives (tarball) to your home folder and set to path if necessary.

Switching alternatives

If you installed multiple Java implementations or version, you can configure your system to use one or another.

Developers: beware that javac has its own independent alternative. i.e. to change the JDK, use alternatives ... javac!

Switching is done using the alternatives system (also used to change some other subsystems). Java's subsystem name is surprisingly java and typical commands include:

# alternatives --display java
# alternatives --config java

See alternative's own documentation for more information for usage and parts involved.

Should be noted that JRE implementations installed outside Fedora distribution, may not support alternatives and thus not be visible there. Then the symbolic links under directory /etc/alternatives must be manually fixed.

Java packages in Fedora

There are many aliases for OpenJDK package, see http://pkgs.fedoraproject.org/cgit/rpms/java-1.8.0-openjdk.git/tree/java-1.8.0-openjdk.spec or do "dnf repoquery --provides java-1.8.0-openjdk".

You can use any of the following names:

  • java
  • java-1.8.0
  • java-1.8.0-openjdk
  • java-openjdk
  • jre
  • jre-1.8.0
  • jre-1.8.0-openjdk
  • jre-openjdk


dnf install java-1.8.0-openjdk

might be the most safe (until 1.8 is EOL.)


Note that Java Web Start (JavaWS) and JavaFX are packaged separately 'icedtea-web' and 'javafx' respectively.

Typically, without JavaFX, you may have error like:

java -jar scram.jar
Error: Could not find or load main class com.frequal.scram.designer.jfx.Main
dnf install icedtea-web javafx

Communicate

You can subscribe to java-devel list or talk to us in #fedora-java Libera Chat IRC channel. Read Communicate page for more information.

See Also


References