This is an automated email from the ASF dual-hosted git repository.
polandll pushed a commit to branch CASS-18231-CEP-7
in repository https://gitbox.apache.org/repos/asf/cassandra.git
commit 038dbd2ef561ee6c4fce04f49b7e61f0a9e491a2
Author: Lorina Poland <lor...@datastax.com>
AuthorDate: Tue Sep 26 12:10:29 2023 -0700
fix java17.adoc file
---
doc/modules/cassandra/pages/reference/java17.adoc | 96 ++++++++++++-----------
1 file changed, 52 insertions(+), 44 deletions(-)
diff --git a/doc/modules/cassandra/pages/reference/java17.adoc
b/doc/modules/cassandra/pages/reference/java17.adoc
index 6958e1c9f3..540886104e 100644
--- a/doc/modules/cassandra/pages/reference/java17.adoc
+++ b/doc/modules/cassandra/pages/reference/java17.adoc
@@ -7,88 +7,95 @@ the vertical axis and the run version is along the horizontal
axis.
.Support Matrix for Java
[width="68%",cols="34%,30%,36%",]
|===
-| |Java 11 (Run) |Java 17 (Run)
-|Java 11 (Build) |Supported |Supported
-|Java 17(Build) |Not Supported |Experimental
+| | Java 11 (Run) | Java 17 (Run)
+| Java 11 (Build) | Supported | Supported
+| Java 17(Build) | Not Supported | Experimental
|===
Apache 4.0 source code built with Java 17 cannot be run with Java 11.
All binary releases are built with Java 11.
-== Using Java 11 to Build
+== Using Java 17 to Build
-To start with, install Java 11.
-As an example, for installing Java 11 on RedHat Linux the command is as
follows:
+To start with, install Java 17.
+As an example, for installing Java 17 on RedHat Linux the command is as
follows:
[source, console]
----
-$ sudo yum install java-1.8.0-openjdk-devel
+$ sudo yum install java-17-openjdk
----
Set the environment variables `JAVA_HOME` and `PATH`.
-....
-$ export JAVA_HOME=/usr/lib/jvm/java-1.8.0-openjdk
+[source, console]
+----
+$ export JAVA_HOME=/usr/lib/jvm/java-17-openjdk
$ export PATH=$PATH:$JAVA_HOME/bin:$JRE_HOME/bin
-....
+----
-Download and install Apache Cassandra 4.0 source code from the Git along
+Download and install Apache Cassandra 5.0 source code from the Git along
with the dependencies.
-....
+[source, console]
+----
$ git clone https://github.com/apache/cassandra.git
-....
+----
If Cassandra is already running stop Cassandra with the following
command.
-....
+[source, console]
+----
$ ./nodetool stopdaemon
-....
+----
Build the source code from the `cassandra` directory, which has the
`build.xml` build script. The Apache Ant uses the Java version set in
the `JAVA_HOME` environment variable.
-....
+[source, console]
+----
$ cd ~/cassandra
$ ant
-....
+----
-Apache Cassandra 4.0 gets built with Java 8. Set the environment
+Apache Cassandra 5.0 gets built with Java 11. Set the environment
variable for `CASSANDRA_HOME` in the bash script. Also add the
`CASSANDRA_HOME/bin` to the `PATH` variable.
-....
+[source, console]
+----
$ export CASSANDRA_HOME=~/cassandra
$ export PATH=$PATH:$JAVA_HOME/bin:$JRE_HOME/bin:$CASSANDRA_HOME/bin
-....
+----
-To run Apache Cassandra 4.0 with either of Java 8 or Java 11 run the
+To run Apache Cassandra 5.0 with either of Java 11 or Java 17 run the
Cassandra application in the `CASSANDRA_HOME/bin` directory, which is in
the `PATH` env variable.
-....
+[source, console]
+----
$ cassandra
-....
+----
The Java version used to run Cassandra gets output as Cassandra is
getting started. As an example if Java 11 is used, the run output should
include similar to the following output snippet:
-....
+[source, console]
+----
INFO [main] 2019-07-31 21:18:16,862 CassandraDaemon.java:480 - Hostname:
ip-172-30-3-
146.ec2.internal:7000:7001
INFO [main] 2019-07-31 21:18:16,862 CassandraDaemon.java:487 - JVM
vendor/version: OpenJDK
64-Bit Server VM/11.0.3
INFO [main] 2019-07-31 21:18:16,863 CassandraDaemon.java:488 - Heap size:
1004.000MiB/1004.000MiB
-....
+----
-The following output indicates a single node Cassandra 4.0 cluster has
-started.
+The following output indicates a single node Cassandra 5.0 cluster has started.
-....
+[source, console]
+----
INFO [main] 2019-07-31 21:18:19,687 InboundConnectionInitiator.java:130 -
Listening on
address: (127.0.0.1:7000), nic: lo, encryption: enabled (openssl)
...
@@ -106,28 +113,30 @@ bootstrap because it is configured to be a seed node.
INFO [main] 2019-07-31 21:18:20,809 StorageService.java:1507 - JOINING:
Finish joining ring
INFO [main] 2019-07-31 21:18:20,921 StorageService.java:2508 - Node
127.0.0.1:7000 state
jump to NORMAL
-....
+----
== Using Java 11 to Build
-If Java 11 is used to build Apache Cassandra 4.0, first Java 11 must be
-installed and the environment variables set. As an example, to download
-and install Java 11 on RedHat Linux run the following command.
+If Java 17 is used to build Apache Cassandra 5.0, first Java 11 must be
installed and the environment variables set.
+As an example, to download and install Java 11 on RedHat Linux run the
following command.
-....
-$ yum install java-11-openjdk-devel
-....
+[source, console]
+----
+$ yum install java-11-openjdk
+----
Set the environment variables `JAVA_HOME` and `PATH`.
-....
+[source, console]
+----
$ export JAVA_HOME=/usr/lib/jvm/java-11-openjdk
$ export PATH=$PATH:$JAVA_HOME/bin:$JRE_HOME/bin
-....
+----
The build output should now include the following.
-....
+[source, console]
+----
[echo] Non default JDK version used: 11
...
...
@@ -156,20 +165,19 @@ jar:
BUILD SUCCESSFUL
Total time: 1 minute 3 seconds
-....
+----
== Common Issues
-The Java 11 built Apache Cassandra 4.0 source code may be run with Java
-11 only. If a Java 11 built code is run with Java 8 the following error
-message gets output.
+The Java 17 built Apache Cassandra 5.0 source code may be run with Java 17
only.
+If a Java 17 built code is run with Java 11 the following error message gets
output.
-[source, shell]
+[source, console]
----
# ssh -i cassandra.pem ec2-u...@ec2-3-85-85-75.compute-1.amazonaws.com
Last login: Wed Jul 31 20:47:26 2019 from 75.155.255.51
$ echo $JAVA_HOME
-/usr/lib/jvm/java-1.8.0-openjdk
+/usr/lib/jvm/java-11-openjdk
$ cassandra
...
...
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscr...@cassandra.apache.org
For additional commands, e-mail: commits-h...@cassandra.apache.org
