From Fedora Project Wiki

(Explain straightforward install)
(Large update discussed on IRC and mailing list)
Line 1: Line 1:
= Java on Fedora =


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]]. As simple as "<code>sudo dnf install java</code>".
<div class="messagebox" style="float: right; margin-left: 10px;">__TOC__</div>


Third party packages may be in archive formats (.zip, tar) for which case-specific instructions should be provided.
== Java ==


= Terminology =
Java is about:
* Communities: the [https://www.jcp.org/ Java Comunity 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)


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.
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]]. ('''Careful to change the link for production''')


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


=== JRE JDK JVM JSE ... ===


= Java Runtime Environments (JRE) =
Some vocabulary, if you are lost:


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:
* '''JRE''' Java Runtime Environment. Required to run Java code and applications. Install {{package|java-1.8.0-openjdk}}.
<pre># alternatives --display java</pre>
* '''JVM''' Java Virtual Machine. Main component of the JRE.
<pre># alternatives --config java</pre>
* '''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 plateform 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''.


See alternative's own documentation for more information for usage and parts involved.
=== What is in Java OpenJDK package ===


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.
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.


== OpenJDK and project IcedTea ==
Beware that JavaFX and JavaWS are packaged separately!
Fedora has shipped OpenJDK as default JRE implementation. It is 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 library paths for i386 are:
== Multiple implementations ==
<pre>
/usr/lib
/usr/lib/jvm/java-1.?.0-openjdk-1.?.0.0.x86_64/jre/lib/
</pre>


and for x86_64:
Fedora provides the Free {{package|java-1.8.0-openjdk}}. If this Open Source stack does not fulfil your requirements. Alternatives can be installed alongside or separately.
<pre>
/usr/lib64
/usr/lib/jvm/java-1.?.0-openjdk-1.?.0.0.x86_64/jre/lib/amd64/
</pre>


OpenJDK package name on Fedora is ''java-1.?.0-openjdk''.
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.


== Oracle's Java SE ==
Multiple implementations can be installed side-by-side without interfering:
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.
* 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.)


You're, however, encouraged to try out the OpenJDK runtime first.
=== 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.


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


Fedora's JRE in browser environment can be tested using the following test pages:
Oracle provides a tarball: https://java.com/en/download/help/linux_x64_install.xml
* [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.
We recommend to simply unpack the archives (tarball) to your home folder and set to path if necessary.


= Java Development Tools (SDK) =
=== Switching alternatives ===


The following SDKs are listed in alphabetic order.
If you installed multiple Java implementations or version, you can configure your system to use one or another.  


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


See our [[Eclipse]] page for an integrated development environment platform that itself is written in Java and has plugin support for many programming languages.
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>


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


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.
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.
 
== 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.
 
== 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.
 
= Java Server Side Environments =
 
== Apache Tomcat ==
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.


== JBoss AS ==
= Java packages in Fedora =


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.
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 learn more about the effort and the current progress on the [[JBossAS7|JBoss AS 7 on Fedora]] page.
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


[[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.


= Teaching and Learning Java =
<pre>dnf install java-1.8.0-openjdk</pre> might be the most safe (until 1.8 is EOL.)


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]]
'''Note''' that Java Web Start ('''JavaWS''') and '''JavaFX''' are packaged separately 'icedtea-web' and 'javafx' respectively.
[[Category:Language-specific_SIGs]]


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>


= Open Issues with Java packages =
<pre>dnf install icedtea-web javafx</pre>
* [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]
* [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 =
= Communicate =
Line 118: Line 111:
* [[Java/FAQ]]
* [[Java/FAQ]]
* [[Java/Troubleshooting]]
* [[Java/Troubleshooting]]
* [[Java/PKIAppletCompatibility]]
* [https://Ask.FedoraProject.org/en/questions/scope:all/sort:activity-desc/tags:java/page:1/ Ask Fedora about Java]
* [[Java/StackTraces]]
 
* [[Java/JPPMavenReadme]]
 
* [[Java/FedoraJavaMarketingBrief]]
* [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]
* [[Docs/Drafts/JavaProgramming]]
 
* [[Packaging:Java]]
* [[JDK_on_Fedora]]
* [https://developer.fedoraproject.org/tech/languages/java/java-installation.html Developer.FedoraProject.Org/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]]

Revision as of 19:01, 19 October 2017


Java

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. (Careful to change the link for production)


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 plateform 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 fulfil 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 Freenode IRC channel. Read Communicate page for more information.

See Also


References