Skip to content

Commit

Permalink
[Installation] Clarify JRE recommendations in index page (#287)
Browse files Browse the repository at this point in the history
* Clarified JRE recommendations in installation index page

-Updated language in JRE support statement for clarity
-Added JRE comparison table
-Updated 32-bit JRE statement to indicate it applies to ARM systems

Signed-off-by: Stephen Bonar <contactme@stephenbonar.com> (github: stephenbonar)

* Fixed JRE recommendations

-Put all sentences in each paragraph on their own line
-Added links to supporting information
-Removed redunant language
-Removed references to JRE

Signed-off-by: Stephen Bonar <contactme@stephenbonar.com> (github: stephenbonar)

* Updated landing page links in Java platform table

-Links in Java platform table now point to landing pages instead of downloads

Signed-off-by: Stephen Bonar <contactme@stephenbonar.com> (github: stephenbonar)
  • Loading branch information
stephenbonar authored and ThomDietrich committed Feb 4, 2017
1 parent 7fd52b3 commit f98f04e
Showing 1 changed file with 12 additions and 7 deletions.
19 changes: 12 additions & 7 deletions installation/index.md
Expand Up @@ -36,13 +36,18 @@ The previously mentioned [openHABian](openhabian.html) can also be used to kicks

## Prerequisites

Make sure that you have an up to date version of the [Oracle Java Runtime Environment](https://java.com/en/download/manual.jsp) on your host system installed.
A famous choice is OpenJDK, however, Oracle Java Version 8 is recommended for openHAB.
openHAB may be unstable and slower executed by OpenJDK.

> Oracle Java offers significant performance advantages over OpenJDK on ARM platforms, and will expand the range of Java applications that run well [on the Raspberry Pi].
Also make sure to use the 32-bit version of the JVM, even on 64-bit operating systems. Serial connections won't work with a 64-bit JVM, so bindings like Z-Wave won't be working with it.
Make sure that you have an up to date Java platform installed on your host system.
Zulu is currently the recommended Java platform for openHAB, although Oracle Java is also suitable for most configurations.
OpenJDK may be used, but it has some [known limitations](https://community.openhab.org/t/running-openhab-2-on-openjdk/21443/8?u=gatekeeper6838) with openHAB.

| Java Platform | Advantages | Disadvantages |
| --- | --- | --- |
| [Zulu](https://www.azul.com/products/zulu/) | Completely open source, fully certified Java SE compliant build of OpenJDK, embedded version optimized for ARM devices [available here](http://www.azul.com/downloads/zulu-embedded/) | Not available in most default distribution package repositories |
| [Oracle Java](https://java.com/en/) | Full openHAB support on all platforms | [Licensing restrictions](https://blog.takipi.com/running-java-on-docker-youre-breaking-the-law/), manual installation required on many Linux systems: [Ubuntu](https://help.ubuntu.com/community/Java), [Mint](https://community.linuxmint.com/tutorial/view/1091), and [Debian](https://wiki.debian.org/Java/Sun) are some examples |
| [OpenJDK](http://openjdk.java.net) | Supported by many Linux distributions, packages [typically available](http://openjdk.java.net/install/index.html) | [Performance issues](https://github.com/openhab/openhab-distro/issues/10#issuecomment-223786506) on ARM platforms, [compatibility issues](https://community.openhab.org/t/openhab-is-offline-message-fixed/17441/8) with certain bindings and certificates |

> Make sure to use the 32-bit version of the JVM for ARM platforms, even on 64-bit operating systems.
> Serial connections won't work with a 64-bit JVM, preventing bindings like Z-Wave from functioning.
As for now, a pre-release Java 9 installation is not recommended and is not yet supported by openHAB 2.

Expand Down

0 comments on commit f98f04e

Please sign in to comment.