This is an automated email from the ASF dual-hosted git repository.
baunsgaard pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/systemds.git
The following commit(s) were added to refs/heads/main by this push:
new c484d92c73 [DOCS] Update Docs to Specify Java 17
c484d92c73 is described below
commit c484d92c739a8d436c09858f12f564bad2aa6575
Author: Sebastian Baunsgaard <[email protected]>
AuthorDate: Thu May 15 20:20:02 2025 +0200
[DOCS] Update Docs to Specify Java 17
---
docs/README.md | 2 +-
.../python/sources/getting_started/install.rst.txt | 10 ++++----
docs/index.md | 2 +-
docs/site/install.md | 29 +++++++++++-----------
scripts/resource/README.md | 2 +-
src/assembly/bin/README.md | 2 +-
.../python/docs/source/getting_started/install.rst | 12 ++++-----
7 files changed, 29 insertions(+), 30 deletions(-)
diff --git a/docs/README.md b/docs/README.md
index cdf36fa74e..87d78b6f33 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -62,7 +62,7 @@ The Documentation is separated into different parts by sub
folders.
and install any other missing packages
-4. Make sure Maven and [Java 11 and above](https://www.java.com/releases/) are
installed.
+4. Make sure Maven and [Java 17 and above](https://www.java.com/releases/) are
installed.
```bash
mvn --version
diff --git a/docs/api/python/sources/getting_started/install.rst.txt
b/docs/api/python/sources/getting_started/install.rst.txt
index 55ee1ac0dc..69133344cf 100644
--- a/docs/api/python/sources/getting_started/install.rst.txt
+++ b/docs/api/python/sources/getting_started/install.rst.txt
@@ -34,14 +34,14 @@ Installation is quite simple with `pip`, just execute the
following command::
pip install systemds
SystemDS is a java-project, the `pip` package contains all the necessary
`jars`,
-but you will need java version 11 installed. Do not use an older or newer
+but you will need java version 17 installed. Do not use an older or newer
version of java, because SystemDS is non compatible with other java versions.
Check the output of ``java -version``. The output should look similar to::
- openjdk version "11.0.18" 2023-01-17
- OpenJDK Runtime Environment (build 11.0.18+10-post-Ubuntu-0ubuntu122.04)
- OpenJDK 64-Bit Server VM (build 11.0.18+10-post-Ubuntu-0ubuntu122.04, mixed
mode, sharing)
+ openjdk 17.0.11 2024-04-16
+ OpenJDK Runtime Environment Temurin-17.0.11+9 (build 17.0.11+9)
+ OpenJDK 64-Bit Server VM Temurin-17.0.11+9 (build 17.0.11+9, mixed mode,
sharing)
The important part is in the first line ``openjdk version "11.xx"``,
please make sure this is the case.
@@ -56,7 +56,7 @@ Install Dependencies
- `Maven <https://maven.apache.org/>`_
- `Python 3.6+ <https://www.python.org/downloads/>`_ and
-- `OpenJDK 11.xxx Java <https://openjdk.java.net/install/>`_
+- `OpenJDK 17.xxx Java <https://openjdk.java.net/install/>`_
Once installed you please verify your version numbers.
Additionally you have to install a few python packages.
diff --git a/docs/index.md b/docs/index.md
index a462a677fa..12226bae79 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -28,7 +28,7 @@ SystemDS's distinguishing characteristics are:
2. **Multiple execution modes**, including Spark MLContext, Spark Batch,
Standalone, and JMLC.
3. **Automatic optimization** based on data and cluster characteristics to
ensure both efficiency and scalability.
-This version of SystemDS supports: Java 11, Python 3.5+, Hadoop 3.3.x, and
Spark 3.5.x, Nvidia CUDA 10.2
+This version of SystemDS supports: Java 17, Python 3.5+, Hadoop 3.3.x, and
Spark 3.5.x, Nvidia CUDA 10.2
(CuDNN 7.x) Intel MKL (<=2019.x).
## Links
diff --git a/docs/site/install.md b/docs/site/install.md
index 4aaf710d52..140f2e5b10 100644
--- a/docs/site/install.md
+++ b/docs/site/install.md
@@ -41,7 +41,7 @@ Once the individual versions is set up skip to the common
part of building the s
### Windows
-First setup java and maven to compile the system note the java version is 11,
we suggest using Java OpenJDK 11.
+First setup java and maven to compile the system note the java version is 17,
we suggest using Java OpenJDK 17.
- <https://openjdk.org/>
- <https://maven.apache.org/download.cgi?.>
@@ -62,10 +62,10 @@ A suggested starting point would be to run some of the
component tests from your
### Ubuntu 22.04
-First setup java and maven to compile the system note that the java version is
11.
+First setup java and maven to compile the system note that the java version is
17.
```bash
-sudo apt install openjdk-11-jdk
+sudo apt install openjdk-17-jdk
sudo apt install maven
```
@@ -79,15 +79,15 @@ mvn -version
This should return something like:
```bash
-openjdk 11.0.17 2022-10-18
-OpenJDK Runtime Environment (build 11.0.17+8-post-Ubuntu-1ubuntu220.04)
-OpenJDK 64-Bit Server VM (build 11.0.17+8-post-Ubuntu-1ubuntu220.04, mixed
mode, sharing)
+openjdk 17.0.11 2024-04-16
+OpenJDK Runtime Environment Temurin-17.0.11+9 (build 17.0.11+9)
+OpenJDK 64-Bit Server VM Temurin-17.0.11+9 (build 17.0.11+9, mixed mode,
sharing)
-Apache Maven 3.6.3
-Maven home: /usr/share/maven
-Java version: 1.8.0_252, vendor: Private Build, runtime:
/usr/lib/jvm/java-8-openjdk-amd64/jre
+Apache Maven 3.9.9 (8e8579a9e76f7d015ee5ec7bfcdc97d260186937)
+Maven home: /home/usr/Programs/maven
+Java version: 17.0.11, vendor: Eclipse Adoptium, runtime:
/home/usr/Programs/jdk-17.0.11+9
Default locale: en_US, platform encoding: UTF-8
-OS name: "linux", version: "5.4.0-37-generic", arch: "amd64", family: "unix"
+OS name: "linux", version: "6.8.0-59-generic", arch: "amd64", family: "unix"
```
#### Testing
@@ -120,9 +120,8 @@ Prerequisite install homebrew on the device.
```bash
# To allow relative paths:
brew install coreutils
-# To install open jdk 11.
-brew tap adoptopenjdk/openjdk
-brew cask install adoptopenjdk11
+# To install open jdk 17.
+brew install openjdk@17
# Install maven to enable compilation of SystemDS.
brew install maven
```
@@ -136,10 +135,10 @@ mvn --version
This should print java version.
-Note that if you have multiple __java__ versions installed then you have to
change the used version to 11, on __both java and javadoc__. This is done by
setting the environment variable JAVA_HOME to the install path of open JDK 11 :
+Note that if you have multiple __java__ versions installed then you have to
change the used version to 17, on __both java and javadoc__. This is done by
setting the environment variable JAVA_HOME to the install path of open JDK 17 :
```bash
-export JAVA_HOME=`/usr/libexec/java_home -v 11`
+export JAVA_HOME=`/usr/libexec/java_home -v 17`
```
For running all tests [r-base](https://cran.r-project.org/bin/macosx/) has to
be installed as well since this is used as a secondary system to verify the
correctness of our code, but it is not a requirement to enable building the
project.
diff --git a/scripts/resource/README.md b/scripts/resource/README.md
index 47371f064c..50815f5d4e 100644
--- a/scripts/resource/README.md
+++ b/scripts/resource/README.md
@@ -50,7 +50,7 @@ export SYSTEMDS_ROOT=$(pwd)
# specific steps for the extension
export PATH=$PATH:$SYSTEMDS_ROOT/scripts/resource/bin
```
-The proper execution requires JDK 11 so make sure to export the correct JDK
version to `$JAVA_HOME` environmental variable.
+The proper execution requires JDK 17 so make sure to export the correct JDK
version to `$JAVA_HOME` environmental variable.
### Usage
diff --git a/src/assembly/bin/README.md b/src/assembly/bin/README.md
index fac2e0d2a4..7f8f5ef67b 100644
--- a/src/assembly/bin/README.md
+++ b/src/assembly/bin/README.md
@@ -27,7 +27,7 @@ SystemDS is a versatile system for the end-to-end data
science lifecycle from da
## Getting started
-Requirements for running SystemDS are a bash shell and OpenJDK 11 or a Spark
3.5.x cluster installation (to run distributed jobs).
+Requirements for running SystemDS are a bash shell and OpenJDK 17 or a Spark
3.5.x cluster installation (to run distributed jobs).
These requirements should be available via standard system packages in all
major Linux distributions
(make sure to have the right JDK version enabled, if you have multiple
versions in your system).
For Windows, a bash comes with [git for windows](http://git-scm.com) and
OpenJDK builds can be obtained at <http://adoptopenjdk.net>
diff --git a/src/main/python/docs/source/getting_started/install.rst
b/src/main/python/docs/source/getting_started/install.rst
index 55ee1ac0dc..0ed68570ab 100644
--- a/src/main/python/docs/source/getting_started/install.rst
+++ b/src/main/python/docs/source/getting_started/install.rst
@@ -34,16 +34,16 @@ Installation is quite simple with `pip`, just execute the
following command::
pip install systemds
SystemDS is a java-project, the `pip` package contains all the necessary
`jars`,
-but you will need java version 11 installed. Do not use an older or newer
+but you will need java version 17 installed. Do not use an older or newer
version of java, because SystemDS is non compatible with other java versions.
Check the output of ``java -version``. The output should look similar to::
- openjdk version "11.0.18" 2023-01-17
- OpenJDK Runtime Environment (build 11.0.18+10-post-Ubuntu-0ubuntu122.04)
- OpenJDK 64-Bit Server VM (build 11.0.18+10-post-Ubuntu-0ubuntu122.04, mixed
mode, sharing)
+ openjdk 17.0.11 2024-04-16
+ OpenJDK Runtime Environment Temurin-17.0.11+9 (build 17.0.11+9)
+ OpenJDK 64-Bit Server VM Temurin-17.0.11+9 (build 17.0.11+9, mixed mode,
sharing)
-The important part is in the first line ``openjdk version "11.xx"``,
+The important part is in the first line ``openjdk version "17.xx"``,
please make sure this is the case.
@@ -56,7 +56,7 @@ Install Dependencies
- `Maven <https://maven.apache.org/>`_
- `Python 3.6+ <https://www.python.org/downloads/>`_ and
-- `OpenJDK 11.xxx Java <https://openjdk.java.net/install/>`_
+- `OpenJDK 17.xxx Java <https://openjdk.java.net/install/>`_
Once installed you please verify your version numbers.
Additionally you have to install a few python packages.
