ostinru commented on code in PR #151:
URL: https://github.com/apache/cloudberry-pxf/pull/151#discussion_r3965175646
##########
README.md:
##########
@@ -69,11 +69,34 @@ To build PXF, you must have:
source /usr/local/cloudberry-db/cloudberry-env.sh # For Cloudberry 2.1+
```
-3. JDK 1.8 or JDK 11 to compile/run
+3. JDK 1.8, 11, 17, or 21 to compile/run
- Export your `JAVA_HOME`:
+ > [!NOTE]
+ > Support for JDK 1.8 will be removed in PXF 3.0. Use JDK 11 or later for
new setups.
+
+ A full JDK is required -- a JRE is not enough, because the server module
needs
+ `javac`. If only a JRE is installed, Gradle fails with
+ `Toolchain installation '...' does not provide the required capabilities:
[JAVA_COMPILER]`.
+ Note that on Debian/Ubuntu the `maven` package depends on
`default-jre-headless` and does
+ **not** pull in a JDK.
+
+ > [!IMPORTANT]
+ > If you hit that error and then install the JDK, you must also stop the
Gradle
+ > daemon (`cd server && ./gradlew --stop`) before rebuilding. The daemon
caches JVM
+ > installation metadata for its whole lifetime, so a daemon started while
only the
+ > JRE was present keeps reporting the identical error even after `javac`
exists.
+
+ ```
+ # Debian/Ubuntu
+ sudo apt-get install -y openjdk-11-jdk
+ # RHEL/Rocky
+ sudo dnf install -y java-11-openjdk-devel
+ ```
Review Comment:
I think that main README shouldn't go in such details into troubleshooting.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
