You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@hugegraph.apache.org by "imbajin (via GitHub)" <gi...@apache.org> on 2026/10/02 16:34:37 UTC
[PR] docs: clarify Java 17 upgrade requirements [hugegraph-doc]
imbajin opened a new pull request, #508:
URL: https://github.com/apache/hugegraph-doc/pull/508
The Server guide describes Java 11 packages but does not explain the incoming Java 17/TinkerPop upgrade. Add branch-specific JDK 17 and Maven 3.6.3 requirements, the TinkerPop/Groovy versions, and the bundled serializer configuration guidance in both English and Chinese.
This is the paired website update for hugegraph/hugegraph#231 and hugegraph/hugegraph#233. Coordinate its merge with the upgrade stack; existing Java 11-based packages retain their documented requirements.
Validation: bilingual content review, link validation, and `git diff --check` passed.
--
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: issues-unsubscribe@hugegraph.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@hugegraph.apache.org
For additional commands, e-mail: issues-help@hugegraph.apache.org
Re: [PR] docs: require Java 17 starting with 1.8.0 [hugegraph-doc]
Posted by "imbajin (via GitHub)" <gi...@apache.org>.
imbajin commented on code in PR #508:
URL: https://github.com/apache/hugegraph-doc/pull/508#discussion_r4250607241
##########
content/en/docs/quickstart/hugegraph/hugegraph-server.md:
##########
@@ -35,17 +35,46 @@ flowchart TD
## 2 Dependency for Building/Running
-### 2.1 Install Java 11 (JDK 11)
+<span id="21-install-java-11-jdk-11"></span>
-The `hugegraph-server` module in HugeGraph 1.7.0 is compiled with Java 11. Running and building it from source require Java 11 or later.
+### 2.1 Install Java 17 (JDK 17)
-**Before continuing, run `java -version` to confirm your JDK version.**
-
-> Java 8 is no longer supported starting from 1.7.0. `bin/hugegraph-server.sh` refuses to start on anything older than Java 11.
+Starting with HugeGraph 1.8.0, use **Java 17**; **1.7.0 is the last release supporting Java 11**.
Review Comment:
⚠️ Important. Blocking: no. Summary: The source-build section later says master is at 1.7.0 and instructs readers to extract `apache-hugegraph-1.7.0`, but `apache/hugegraph` master now sets `revision` to 1.8.0, so those build paths are stale. Please update the master build/version examples in both languages while keeping the ASF 1.7.0 download examples scoped to that release. Evidence: `apache/hugegraph/pom.xml` at master declares `<revision>1.8.0</revision>`; the conflicting source-build instructions remain at English line 191 and Chinese line 188.
##########
content/en/docs/quickstart/hugegraph/hugegraph-server.md:
##########
@@ -35,17 +35,46 @@ flowchart TD
## 2 Dependency for Building/Running
-### 2.1 Install Java 11 (JDK 11)
+<span id="21-install-java-11-jdk-11"></span>
-The `hugegraph-server` module in HugeGraph 1.7.0 is compiled with Java 11. Running and building it from source require Java 11 or later.
+### 2.1 Install Java 17 (JDK 17)
-**Before continuing, run `java -version` to confirm your JDK version.**
-
-> Java 8 is no longer supported starting from 1.7.0. `bin/hugegraph-server.sh` refuses to start on anything older than Java 11.
+Starting with HugeGraph 1.8.0, use **Java 17**; **1.7.0 is the last release supporting Java 11**.
+Build all modules with **JDK 17 and Maven 3.6.3 or later**, and run Server, PD and Store with **JDK 17**.
-> The security check is on by default and installs `HugeSecurityManager`, which needs Java 11 to 23. JDK 24 removed the Security Manager ([JEP 486](https://openjdk.org/jeps/486)), so on Java 24 or later you must start the service with the check disabled: `bin/start-hugegraph.sh -s false`.
+**Before continuing, run `java -version` to confirm your JDK version.**
-> Building from source also needs Maven 3.5.0 or later.
+> [!NOTE]
+> **TinkerPop compatibility**
+>
+> HugeGraph 1.8.0 uses TinkerPop 3.8.1 and Groovy 4.0.25. Use the Gremlin configuration files bundled with Server.
+> Serializer classes move from `org.apache.tinkerpop.gremlin.driver.ser` to `org.apache.tinkerpop.gremlin.util.ser`;
+> retain the supplied HugeGraph registries. Gremlin Groovy remains the default engine.
+> Check application scripts against the TinkerPop 3.5.1 to 3.8.1 upgrade interval; this upgrade does not switch remote requests to GremlinLang.
+>
+> `supportsUniformListValues()` now returns `false` for vertex and edge properties, so clients that inspect `Graph.Features` must adjust that capability check.
+> Schema-defined `valueList()`/`LIST` properties remain supported; this flag change alone does not require rewriting existing list data.
+>
+> A mid-traversal scan retains its input multiplicity: with three vertices, `g.V().V().count()` returns `9L`.
+> `P.typeOf()` runs as a local filter, including in negated or combined predicates; it does not use backend indexes on its own.
+>
+> The bundled Driver and Console configurations use GraphBinary V1: schema results are standard maps and Blob values are binary,
+> including inside returned graph elements. Default HTTP JSON with untyped GraphSON V1 preserves the legacy Tree `key`/`value` array, with scalar or element
+> keys.
+> Optional results carry their value or null when empty; File results keep the map shape `{"file": "name"}` with the file name, including in nested results.
+> HugeGraph enums return their names; `graph.schema()` returns a map with property key, vertex label, edge label and index label lists.
+> Typed GraphSON V1 is disabled because class-name deserialization can construct Java objects before authentication; typed V2/V3 remain available.
Review Comment:
⚠️ Important. Blocking: no. Summary: Saying typed GraphSON V2/V3 remain available can imply they support ordinary vertex, edge, and schema results. Please qualify this in both languages: typed GraphSON only covers supported simple values and IDs; direct graph/schema users to untyped GraphSON or GraphBinary. Evidence: `apache/hugegraph/docs/server-runtime.md` says typed GraphSON is not a replacement for untyped serialization of every HugeGraph schema or graph object.
##########
content/en/docs/quickstart/hugegraph/hugegraph-server.md:
##########
@@ -35,17 +35,46 @@ flowchart TD
## 2 Dependency for Building/Running
-### 2.1 Install Java 11 (JDK 11)
+<span id="21-install-java-11-jdk-11"></span>
-The `hugegraph-server` module in HugeGraph 1.7.0 is compiled with Java 11. Running and building it from source require Java 11 or later.
+### 2.1 Install Java 17 (JDK 17)
-**Before continuing, run `java -version` to confirm your JDK version.**
-
-> Java 8 is no longer supported starting from 1.7.0. `bin/hugegraph-server.sh` refuses to start on anything older than Java 11.
+Starting with HugeGraph 1.8.0, use **Java 17**; **1.7.0 is the last release supporting Java 11**.
+Build all modules with **JDK 17 and Maven 3.6.3 or later**, and run Server, PD and Store with **JDK 17**.
-> The security check is on by default and installs `HugeSecurityManager`, which needs Java 11 to 23. JDK 24 removed the Security Manager ([JEP 486](https://openjdk.org/jeps/486)), so on Java 24 or later you must start the service with the check disabled: `bin/start-hugegraph.sh -s false`.
+**Before continuing, run `java -version` to confirm your JDK version.**
-> Building from source also needs Maven 3.5.0 or later.
+> [!NOTE]
+> **TinkerPop compatibility**
+>
+> HugeGraph 1.8.0 uses TinkerPop 3.8.1 and Groovy 4.0.25. Use the Gremlin configuration files bundled with Server.
+> Serializer classes move from `org.apache.tinkerpop.gremlin.driver.ser` to `org.apache.tinkerpop.gremlin.util.ser`;
+> retain the supplied HugeGraph registries. Gremlin Groovy remains the default engine.
+> Check application scripts against the TinkerPop 3.5.1 to 3.8.1 upgrade interval; this upgrade does not switch remote requests to GremlinLang.
+>
+> `supportsUniformListValues()` now returns `false` for vertex and edge properties, so clients that inspect `Graph.Features` must adjust that capability check.
+> Schema-defined `valueList()`/`LIST` properties remain supported; this flag change alone does not require rewriting existing list data.
+>
+> A mid-traversal scan retains its input multiplicity: with three vertices, `g.V().V().count()` returns `9L`.
+> `P.typeOf()` runs as a local filter, including in negated or combined predicates; it does not use backend indexes on its own.
+>
+> The bundled Driver and Console configurations use GraphBinary V1: schema results are standard maps and Blob values are binary,
+> including inside returned graph elements. Default HTTP JSON with untyped GraphSON V1 preserves the legacy Tree `key`/`value` array, with scalar or element
+> keys.
+> Optional results carry their value or null when empty; File results keep the map shape `{"file": "name"}` with the file name, including in nested results.
+> HugeGraph enums return their names; `graph.schema()` returns a map with property key, vertex label, edge label and index label lists.
+> Typed GraphSON V1 is disabled because class-name deserialization can construct Java objects before authentication; typed V2/V3 remain available.
+> The bundled Cypher predicate imports use the compatible factories, including when replaying the Gremlin translation returned by `EXPLAIN`.
+> Named `GValue` predicates retain bindings when reused or cloned; named `limit()`/`range()` bounds count like literal bounds.
+> Local mixed ID collections preserve typed string, number and UUID matches; all-string collections retain standard string-ID comparisons.
+> Local edge ID filters accept mixed serialized strings and native edge IDs with consistent membership and count results.
+> Jackson JSON and YAML modules use one compatible version, including parsing decimal-valued Kubernetes kubeconfig extensions.
+> Count filtering keeps the complete count if any predicate branch has no proven safe truncation bound, including unsupported negated collections and custom
+> predicates.
+> DATE schema properties accept `OffsetDateTime` for writes and indexed equality/range queries, normalized by instant to milliseconds;
+> sub-millisecond precision is truncated, and existing DATE data needs no migration.
+> See the [TinkerPop 3.8.1 upgrade guide](https://github.com/apache/hugegraph/blob/master/docs/upgrade-tinkerpop-3.8.md)
Review Comment:
🧹 Minor. Blocking: no. Summary: This URL currently returns 404, so readers cannot reach the client configuration and verification details. Please point both language versions to an existing guide such as `docs/server-runtime.md`, or add the linked file. Evidence: `gh api repos/apache/hugegraph/contents/docs/upgrade-tinkerpop-3.8.md` returned HTTP 404.
--
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: issues-unsubscribe@hugegraph.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@hugegraph.apache.org
For additional commands, e-mail: issues-help@hugegraph.apache.org
Re: [PR] docs: require Java 17 starting with 1.8.0 [hugegraph-doc]
Posted by "bitflicker64 (via GitHub)" <gi...@apache.org>.
bitflicker64 commented on code in PR #508:
URL: https://github.com/apache/hugegraph-doc/pull/508#discussion_r4273003460
##########
content/en/docs/quickstart/hugegraph/hugegraph-hstore.md:
##########
@@ -22,8 +22,8 @@ Each Store node keeps graph data in RocksDB and replicates it with Raft (JRaft):
#### 2.1 Requirements
- Operating System: Linux or macOS (Windows has not been fully tested)
-- Java version: ≥ 11 (enforced by the build and re-checked by `bin/start-hugegraph-store.sh`)
-- Maven version: ≥ 3.5.0
+- Java version: ≥ 17 for HugeGraph 1.8.0+ (enforced by the build and re-checked by `bin/start-hugegraph-store.sh`; 1.7.0 is the last release supporting Java 11)
Review Comment:
Important: This line says Java `≥ 17` is "enforced by the build", but the build accepts only JDK 17, so a reader on JDK 21 who follows section 3.2 here fails before compiling. This line came from the fix for the earlier PD/HStore thread.
Evidence, apache/hugegraph master at 06f90a9f0: root `pom.xml` sets `java.supported.version.range` to `[17,18)` ("Java 17 is the only qualified build/runtime release") and the enforcer applies it. `mvn -N validate` there fails on JDK 26 with "not in the allowed range [17,18)" and passes on JDK 17. Only the start scripts accept newer runtimes. EN `hugegraph-pd.md` line 28 (beside its own section 3.2), CN `hugegraph-hstore.md` line 25 and CN `hugegraph-pd.md` line 28 say the same.
Please split build and run on all four lines, for example "Java 17 for HugeGraph 1.8.0+ (the Maven build accepts only JDK 17; the start script rejects anything older; 1.7.0 is the last release supporting Java 11)".
##########
content/en/docs/quickstart/hugegraph/hugegraph-server.md:
##########
@@ -35,17 +35,49 @@ flowchart TD
## 2 Dependency for Building/Running
-### 2.1 Install Java 11 (JDK 11)
+<span id="21-install-java-11-jdk-11"></span>
-The `hugegraph-server` module in HugeGraph 1.7.0 is compiled with Java 11. Running and building it from source require Java 11 or later.
+### 2.1 Install Java 17 (JDK 17)
-**Before continuing, run `java -version` to confirm your JDK version.**
-
-> Java 8 is no longer supported starting from 1.7.0. `bin/hugegraph-server.sh` refuses to start on anything older than Java 11.
+Starting with HugeGraph 1.8.0, use **Java 17**; **1.7.0 is the last release supporting Java 11**.
Review Comment:
Minor: This sets the 1.8.0 boundary, but pages outside this PR still give Java 11 as the requirement for master and the next release.
Evidence at this head: `content/en/docs/guides/faq.md` line 17 (CN line 17) tells readers with a startup crash to confirm "Java 11 or later". `content/en/docs/contribution-guidelines/validate-release.md` lines 8, 26 and 140 (CN lines 8, 24 and 129) tell release verifiers to use Java 11, which fails the `[17,18)` enforcer on master at 06f90a9f0 and will fail for the 1.8.0 vote. `hugegraph-server-idea-setup.md` line 19 (CN line 18) asks for Java 11 to build master in IDEA, where `maven.compiler.release` is now 17.
Please update those pages here or in a linked follow-up, scoping Java 11 to 1.7.0 and earlier.
##########
content/en/docs/quickstart/hugegraph/hugegraph-server.md:
##########
@@ -159,13 +191,13 @@ A successful build logs:
[INFO] BUILD SUCCESS
```
-The build creates an aggregate master archive under repository-root `target/` (the current source version property is 1.7.0):
+The build creates an aggregate master archive under repository-root `target/` (the current source version property is 1.8.0):
Review Comment:
Minor: This now says the source version is 1.8.0, but the version-scope note at line 17 of the same page still says a master build is not an ASF release "even if its version number matches 1.7.0". With master at `<revision>1.8.0</revision>` (apache/hugegraph 06f90a9f0), that example no longer applies.
Please reword line 17 to not tie the master build to 1.7.0, for example "even if its version number matches a release". CN line 17 ("即使包内版本号相同也不代表与 1.7.0 发布包相同") needs the same change.
--
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: issues-unsubscribe@hugegraph.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@hugegraph.apache.org
For additional commands, e-mail: issues-help@hugegraph.apache.org
Re: [PR] docs: require Java 17 starting with 1.8.0 [hugegraph-doc]
Posted by "bitflicker64 (via GitHub)" <gi...@apache.org>.
bitflicker64 commented on code in PR #508:
URL: https://github.com/apache/hugegraph-doc/pull/508#discussion_r4256494121
##########
content/en/docs/quickstart/hugegraph/hugegraph-server.md:
##########
@@ -525,10 +554,10 @@ This indicates the successful creation of the sample graph.
| Option | Values | Default | Purpose |
|---|---|---|---|
| `-d` | `true`, `false` | `true` | Daemon mode. With `-d false` the script stays in the foreground and forwards `SIGTERM`/`SIGINT` to the server. |
-| `-g` | `zgc` or `ZGC` | omit for G1GC | Garbage collector to use. Only ZGC is accepted, any other value aborts the startup. ZGC needs Java 11 or later. |
+| `-g` | `zgc` or `ZGC` | omit for G1GC | Garbage collector to use. Only ZGC is accepted, any other value aborts the startup. |
| `-m` | `true`, `false` | `false` | Install the cron-based monitor task (`bin/start-monitor.sh`). For VM and bare-metal deployments only. |
| `-p` | `true`, `false` | `false` | Preload the sample graph, as in 5.1.4. |
-| `-s` | `true`, `false` | `true` | Run with the security check (`HugeSecurityManager`) enabled. It requires Java 11 to 23 and a readable `conf/java-security.properties`. |
+| `-s` | `true`, `false` | `true` | Enable `HugeSecurityManager`; requires readable `conf/java-security.properties`. |
Review Comment:
Minor: The Java upper bound of the security check was removed here and in section 2.1, but the launcher still enforces it.
Evidence, from apache/hugegraph master at 0b7c0de: `bin/hugegraph-server.sh` sets `MIN_JAVA_VERSION=17` and `MAX_SECURITY_JAVA_VERSION=23`, and with `-s true` (the default) on a newer JDK it exits with "The security check requires Java 17-23 ... JDK 24+ removed the Security Manager (JEP 486)". The launcher only rejects versions below 17, so a reader on Java 25 passes the version check and then fails on the default start. `content/en/docs/download/download.md` line 12 and `content/cn/docs/download/download.md` line 11 also send readers to this section "for other supported JDKs", and after this change the section lists none.
Please keep the range, for example "requires Java 17 to 23 and a readable `conf/java-security.properties`; on Java 24 or later start with `-s false`", in this row and in section 2.1. The same applies to line 557 and section 2.1 of the CN page.
##########
content/en/docs/quickstart/hugegraph/hugegraph-server.md:
##########
@@ -525,10 +554,10 @@ This indicates the successful creation of the sample graph.
| Option | Values | Default | Purpose |
|---|---|---|---|
| `-d` | `true`, `false` | `true` | Daemon mode. With `-d false` the script stays in the foreground and forwards `SIGTERM`/`SIGINT` to the server. |
-| `-g` | `zgc` or `ZGC` | omit for G1GC | Garbage collector to use. Only ZGC is accepted, any other value aborts the startup. ZGC needs Java 11 or later. |
+| `-g` | `zgc` or `ZGC` | omit for G1GC | Garbage collector to use. Only ZGC is accepted, any other value aborts the startup. |
Review Comment:
Minor: This row is edited here but still does not match the launcher on master, which this page says it follows for startup behaviour.
Evidence, from `bin/hugegraph-server.sh` at apache/hugegraph 0b7c0de: the `case "$GC_OPTION"` block accepts `g1` and `G1` (adds `-XX:+UseG1GC`) as well as `zgc` and `ZGC`. With `-g` omitted it prints "Using JVM garbage collector configuration" and adds no collector flag, so G1 is not forced. Only other values abort, with "supported options: g1, ZGC".
Please list `g1`/`G1` and `zgc`/`ZGC` as accepted values and describe the default as the JVM's own collector choice. Line 554 of the CN page needs the same change.
##########
content/en/docs/quickstart/hugegraph/hugegraph-server.md:
##########
@@ -35,17 +35,46 @@ flowchart TD
## 2 Dependency for Building/Running
-### 2.1 Install Java 11 (JDK 11)
+<span id="21-install-java-11-jdk-11"></span>
-The `hugegraph-server` module in HugeGraph 1.7.0 is compiled with Java 11. Running and building it from source require Java 11 or later.
+### 2.1 Install Java 17 (JDK 17)
-**Before continuing, run `java -version` to confirm your JDK version.**
-
-> Java 8 is no longer supported starting from 1.7.0. `bin/hugegraph-server.sh` refuses to start on anything older than Java 11.
+Starting with HugeGraph 1.8.0, use **Java 17**; **1.7.0 is the last release supporting Java 11**.
+Build all modules with **JDK 17 and Maven 3.6.3 or later**, and run Server, PD and Store with **JDK 17**.
Review Comment:
Minor: This line says PD and Store run with JDK 17 and builds need Maven 3.6.3, but the PD and HStore quick starts in the same section still state the old requirements.
Evidence at this head: `content/en/docs/quickstart/hugegraph/hugegraph-pd.md` lines 28-29 and `hugegraph-hstore.md` lines 25-26 say "Java version: >= 11" and "Maven version: >= 3.5.0", and the HStore page adds that `bin/start-hugegraph-store.sh` re-checks it. The CN pages say the same, and CN `hugegraph-pd.md` line 304 says the script needs JDK 11 or later. On apache/hugegraph master at 0b7c0de both `start-hugegraph-pd.sh` and `start-hugegraph-store.sh` set `EXPECT_JDK_VERSION=17`, and the root `pom.xml` enforces Maven `[3.6.3,)`.
Please add the same 1.8.0 boundary to those pages in this PR, or link them to this section, so the three quick starts do not disagree.
--
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: issues-unsubscribe@hugegraph.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@hugegraph.apache.org
For additional commands, e-mail: issues-help@hugegraph.apache.org
Re: [PR] docs: require Java 17 starting with 1.8.0 [hugegraph-doc]
Posted by "imbajin (via GitHub)" <gi...@apache.org>.
imbajin commented on code in PR #508:
URL: https://github.com/apache/hugegraph-doc/pull/508#discussion_r4274020656
##########
content/en/docs/quickstart/hugegraph/hugegraph-hstore.md:
##########
@@ -22,8 +22,8 @@ Each Store node keeps graph data in RocksDB and replicates it with Raft (JRaft):
#### 2.1 Requirements
- Operating System: Linux or macOS (Windows has not been fully tested)
-- Java version: ≥ 11 (enforced by the build and re-checked by `bin/start-hugegraph-store.sh`)
-- Maven version: ≥ 3.5.0
+- Java version: ≥ 17 for HugeGraph 1.8.0+ (enforced by the build and re-checked by `bin/start-hugegraph-store.sh`; 1.7.0 is the last release supporting Java 11)
Review Comment:
Updated both English and Chinese prerequisites in HugeGraph-HStore and HugeGraph-PD to explicitly separate the Maven source build (accepts only JDK 17) from runtime (Java 17+; launcher rejects < 17; 1.7.0 was the last release supporting Java 11).
##########
content/en/docs/quickstart/hugegraph/hugegraph-server.md:
##########
@@ -35,17 +35,49 @@ flowchart TD
## 2 Dependency for Building/Running
-### 2.1 Install Java 11 (JDK 11)
+<span id="21-install-java-11-jdk-11"></span>
-The `hugegraph-server` module in HugeGraph 1.7.0 is compiled with Java 11. Running and building it from source require Java 11 or later.
+### 2.1 Install Java 17 (JDK 17)
-**Before continuing, run `java -version` to confirm your JDK version.**
-
-> Java 8 is no longer supported starting from 1.7.0. `bin/hugegraph-server.sh` refuses to start on anything older than Java 11.
+Starting with HugeGraph 1.8.0, use **Java 17**; **1.7.0 is the last release supporting Java 11**.
Review Comment:
Updated external guides including FAQ, validate-release, and hugegraph-server-idea-setup in both English and Chinese to scope Java 11 to 1.7.0 and specify Java 17 for HugeGraph 1.8.0+.
--
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: issues-unsubscribe@hugegraph.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@hugegraph.apache.org
For additional commands, e-mail: issues-help@hugegraph.apache.org
Re: [PR] docs: require Java 17 starting with 1.8.0 [hugegraph-doc]
Posted by "imbajin (via GitHub)" <gi...@apache.org>.
imbajin commented on code in PR #508:
URL: https://github.com/apache/hugegraph-doc/pull/508#discussion_r4274022906
##########
content/en/docs/quickstart/hugegraph/hugegraph-server.md:
##########
@@ -159,13 +191,13 @@ A successful build logs:
[INFO] BUILD SUCCESS
```
-The build creates an aggregate master archive under repository-root `target/` (the current source version property is 1.7.0):
+The build creates an aggregate master archive under repository-root `target/` (the current source version property is 1.8.0):
Review Comment:
Reworded the version-scope note in both English and Chinese to decouple master builds from release 1.7.0 (even if its version number matches a release).
--
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: issues-unsubscribe@hugegraph.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@hugegraph.apache.org
For additional commands, e-mail: issues-help@hugegraph.apache.org
Re: [PR] docs: require Java 17 starting with 1.8.0 [hugegraph-doc]
Posted by "imbajin (via GitHub)" <gi...@apache.org>.
imbajin merged PR #508:
URL: https://github.com/apache/hugegraph-doc/pull/508
--
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: issues-unsubscribe@hugegraph.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@hugegraph.apache.org
For additional commands, e-mail: issues-help@hugegraph.apache.org
Re: [PR] docs: require Java 17 starting with 1.8.0 [hugegraph-doc]
Posted by "imbajin (via GitHub)" <gi...@apache.org>.
imbajin commented on code in PR #508:
URL: https://github.com/apache/hugegraph-doc/pull/508#discussion_r4263648383
##########
content/en/docs/quickstart/hugegraph/hugegraph-server.md:
##########
@@ -35,17 +35,46 @@ flowchart TD
## 2 Dependency for Building/Running
-### 2.1 Install Java 11 (JDK 11)
+<span id="21-install-java-11-jdk-11"></span>
-The `hugegraph-server` module in HugeGraph 1.7.0 is compiled with Java 11. Running and building it from source require Java 11 or later.
+### 2.1 Install Java 17 (JDK 17)
-**Before continuing, run `java -version` to confirm your JDK version.**
-
-> Java 8 is no longer supported starting from 1.7.0. `bin/hugegraph-server.sh` refuses to start on anything older than Java 11.
+Starting with HugeGraph 1.8.0, use **Java 17**; **1.7.0 is the last release supporting Java 11**.
Review Comment:
Updated source build artifact version examples to 1.8.0 in both English and Chinese documentation while keeping 1.7.0 binary download instructions scoped to that release.
##########
content/en/docs/quickstart/hugegraph/hugegraph-server.md:
##########
@@ -35,17 +35,46 @@ flowchart TD
## 2 Dependency for Building/Running
-### 2.1 Install Java 11 (JDK 11)
+<span id="21-install-java-11-jdk-11"></span>
-The `hugegraph-server` module in HugeGraph 1.7.0 is compiled with Java 11. Running and building it from source require Java 11 or later.
+### 2.1 Install Java 17 (JDK 17)
-**Before continuing, run `java -version` to confirm your JDK version.**
-
-> Java 8 is no longer supported starting from 1.7.0. `bin/hugegraph-server.sh` refuses to start on anything older than Java 11.
+Starting with HugeGraph 1.8.0, use **Java 17**; **1.7.0 is the last release supporting Java 11**.
+Build all modules with **JDK 17 and Maven 3.6.3 or later**, and run Server, PD and Store with **JDK 17**.
-> The security check is on by default and installs `HugeSecurityManager`, which needs Java 11 to 23. JDK 24 removed the Security Manager ([JEP 486](https://openjdk.org/jeps/486)), so on Java 24 or later you must start the service with the check disabled: `bin/start-hugegraph.sh -s false`.
+**Before continuing, run `java -version` to confirm your JDK version.**
-> Building from source also needs Maven 3.5.0 or later.
+> [!NOTE]
+> **TinkerPop compatibility**
+>
+> HugeGraph 1.8.0 uses TinkerPop 3.8.1 and Groovy 4.0.25. Use the Gremlin configuration files bundled with Server.
+> Serializer classes move from `org.apache.tinkerpop.gremlin.driver.ser` to `org.apache.tinkerpop.gremlin.util.ser`;
+> retain the supplied HugeGraph registries. Gremlin Groovy remains the default engine.
+> Check application scripts against the TinkerPop 3.5.1 to 3.8.1 upgrade interval; this upgrade does not switch remote requests to GremlinLang.
+>
+> `supportsUniformListValues()` now returns `false` for vertex and edge properties, so clients that inspect `Graph.Features` must adjust that capability check.
+> Schema-defined `valueList()`/`LIST` properties remain supported; this flag change alone does not require rewriting existing list data.
+>
+> A mid-traversal scan retains its input multiplicity: with three vertices, `g.V().V().count()` returns `9L`.
+> `P.typeOf()` runs as a local filter, including in negated or combined predicates; it does not use backend indexes on its own.
+>
+> The bundled Driver and Console configurations use GraphBinary V1: schema results are standard maps and Blob values are binary,
+> including inside returned graph elements. Default HTTP JSON with untyped GraphSON V1 preserves the legacy Tree `key`/`value` array, with scalar or element
+> keys.
+> Optional results carry their value or null when empty; File results keep the map shape `{"file": "name"}` with the file name, including in nested results.
+> HugeGraph enums return their names; `graph.schema()` returns a map with property key, vertex label, edge label and index label lists.
+> Typed GraphSON V1 is disabled because class-name deserialization can construct Java objects before authentication; typed V2/V3 remain available.
Review Comment:
Qualified typed GraphSON note to explicitly state it is supported only for simple values and IDs, recommending untyped GraphSON or GraphBinary for schema and graph objects.
##########
content/en/docs/quickstart/hugegraph/hugegraph-server.md:
##########
@@ -35,17 +35,46 @@ flowchart TD
## 2 Dependency for Building/Running
-### 2.1 Install Java 11 (JDK 11)
+<span id="21-install-java-11-jdk-11"></span>
-The `hugegraph-server` module in HugeGraph 1.7.0 is compiled with Java 11. Running and building it from source require Java 11 or later.
+### 2.1 Install Java 17 (JDK 17)
-**Before continuing, run `java -version` to confirm your JDK version.**
-
-> Java 8 is no longer supported starting from 1.7.0. `bin/hugegraph-server.sh` refuses to start on anything older than Java 11.
+Starting with HugeGraph 1.8.0, use **Java 17**; **1.7.0 is the last release supporting Java 11**.
+Build all modules with **JDK 17 and Maven 3.6.3 or later**, and run Server, PD and Store with **JDK 17**.
-> The security check is on by default and installs `HugeSecurityManager`, which needs Java 11 to 23. JDK 24 removed the Security Manager ([JEP 486](https://openjdk.org/jeps/486)), so on Java 24 or later you must start the service with the check disabled: `bin/start-hugegraph.sh -s false`.
+**Before continuing, run `java -version` to confirm your JDK version.**
-> Building from source also needs Maven 3.5.0 or later.
+> [!NOTE]
+> **TinkerPop compatibility**
+>
+> HugeGraph 1.8.0 uses TinkerPop 3.8.1 and Groovy 4.0.25. Use the Gremlin configuration files bundled with Server.
+> Serializer classes move from `org.apache.tinkerpop.gremlin.driver.ser` to `org.apache.tinkerpop.gremlin.util.ser`;
+> retain the supplied HugeGraph registries. Gremlin Groovy remains the default engine.
+> Check application scripts against the TinkerPop 3.5.1 to 3.8.1 upgrade interval; this upgrade does not switch remote requests to GremlinLang.
+>
+> `supportsUniformListValues()` now returns `false` for vertex and edge properties, so clients that inspect `Graph.Features` must adjust that capability check.
+> Schema-defined `valueList()`/`LIST` properties remain supported; this flag change alone does not require rewriting existing list data.
+>
+> A mid-traversal scan retains its input multiplicity: with three vertices, `g.V().V().count()` returns `9L`.
+> `P.typeOf()` runs as a local filter, including in negated or combined predicates; it does not use backend indexes on its own.
+>
+> The bundled Driver and Console configurations use GraphBinary V1: schema results are standard maps and Blob values are binary,
+> including inside returned graph elements. Default HTTP JSON with untyped GraphSON V1 preserves the legacy Tree `key`/`value` array, with scalar or element
+> keys.
+> Optional results carry their value or null when empty; File results keep the map shape `{"file": "name"}` with the file name, including in nested results.
+> HugeGraph enums return their names; `graph.schema()` returns a map with property key, vertex label, edge label and index label lists.
+> Typed GraphSON V1 is disabled because class-name deserialization can construct Java objects before authentication; typed V2/V3 remain available.
+> The bundled Cypher predicate imports use the compatible factories, including when replaying the Gremlin translation returned by `EXPLAIN`.
+> Named `GValue` predicates retain bindings when reused or cloned; named `limit()`/`range()` bounds count like literal bounds.
+> Local mixed ID collections preserve typed string, number and UUID matches; all-string collections retain standard string-ID comparisons.
+> Local edge ID filters accept mixed serialized strings and native edge IDs with consistent membership and count results.
+> Jackson JSON and YAML modules use one compatible version, including parsing decimal-valued Kubernetes kubeconfig extensions.
+> Count filtering keeps the complete count if any predicate branch has no proven safe truncation bound, including unsupported negated collections and custom
+> predicates.
+> DATE schema properties accept `OffsetDateTime` for writes and indexed equality/range queries, normalized by instant to milliseconds;
+> sub-millisecond precision is truncated, and existing DATE data needs no migration.
+> See the [TinkerPop 3.8.1 upgrade guide](https://github.com/apache/hugegraph/blob/master/docs/upgrade-tinkerpop-3.8.md)
Review Comment:
Updated link to point to existing server-runtime.md documentation in both English and Chinese guides.
--
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: issues-unsubscribe@hugegraph.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@hugegraph.apache.org
For additional commands, e-mail: issues-help@hugegraph.apache.org
Re: [PR] docs: require Java 17 starting with 1.8.0 [hugegraph-doc]
Posted by "imbajin (via GitHub)" <gi...@apache.org>.
imbajin commented on PR #508:
URL: https://github.com/apache/hugegraph-doc/pull/508#issuecomment-6176791770
[P2] Use the shipped GraphBinary registry configuration
In content/en/docs/quickstart/hugegraph/hugegraph-server.md:84–87 and the matching Chinese example, please use ioRegistries: [org.apache.hugegraph.io.HugeGraphIoRegistry] and builder: org.apache.hugegraph.io.HugeGraphTypeSerializerRegistryBuilder, as in the shipped remote.yaml. The currently shown org.apache.hugegraph.structure.io.HugeGraphIoRegistry class does not exist in the Server source tree, so this copy-paste example cannot configure the bundled client.
--
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: issues-unsubscribe@hugegraph.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@hugegraph.apache.org
For additional commands, e-mail: issues-help@hugegraph.apache.org
Re: [PR] docs: require Java 17 starting with 1.8.0 [hugegraph-doc]
Posted by "imbajin (via GitHub)" <gi...@apache.org>.
imbajin commented on code in PR #508:
URL: https://github.com/apache/hugegraph-doc/pull/508#discussion_r4263650488
##########
content/en/docs/quickstart/hugegraph/hugegraph-server.md:
##########
@@ -525,10 +554,10 @@ This indicates the successful creation of the sample graph.
| Option | Values | Default | Purpose |
|---|---|---|---|
| `-d` | `true`, `false` | `true` | Daemon mode. With `-d false` the script stays in the foreground and forwards `SIGTERM`/`SIGINT` to the server. |
-| `-g` | `zgc` or `ZGC` | omit for G1GC | Garbage collector to use. Only ZGC is accepted, any other value aborts the startup. ZGC needs Java 11 or later. |
+| `-g` | `zgc` or `ZGC` | omit for G1GC | Garbage collector to use. Only ZGC is accepted, any other value aborts the startup. |
| `-m` | `true`, `false` | `false` | Install the cron-based monitor task (`bin/start-monitor.sh`). For VM and bare-metal deployments only. |
| `-p` | `true`, `false` | `false` | Preload the sample graph, as in 5.1.4. |
-| `-s` | `true`, `false` | `true` | Run with the security check (`HugeSecurityManager`) enabled. It requires Java 11 to 23 and a readable `conf/java-security.properties`. |
+| `-s` | `true`, `false` | `true` | Enable `HugeSecurityManager`; requires readable `conf/java-security.properties`. |
Review Comment:
Restored the Java 17-23 range description for HugeSecurityManager and added explicit instructions to run with -s false on JDK 24+ in both section 2.1 and startup options tables.
##########
content/en/docs/quickstart/hugegraph/hugegraph-server.md:
##########
@@ -525,10 +554,10 @@ This indicates the successful creation of the sample graph.
| Option | Values | Default | Purpose |
|---|---|---|---|
| `-d` | `true`, `false` | `true` | Daemon mode. With `-d false` the script stays in the foreground and forwards `SIGTERM`/`SIGINT` to the server. |
-| `-g` | `zgc` or `ZGC` | omit for G1GC | Garbage collector to use. Only ZGC is accepted, any other value aborts the startup. ZGC needs Java 11 or later. |
+| `-g` | `zgc` or `ZGC` | omit for G1GC | Garbage collector to use. Only ZGC is accepted, any other value aborts the startup. |
Review Comment:
Updated -g option description to list g1/G1 and zgc/ZGC, noting that omitting -g uses the JVM default collector.
##########
content/en/docs/quickstart/hugegraph/hugegraph-server.md:
##########
@@ -35,17 +35,46 @@ flowchart TD
## 2 Dependency for Building/Running
-### 2.1 Install Java 11 (JDK 11)
+<span id="21-install-java-11-jdk-11"></span>
-The `hugegraph-server` module in HugeGraph 1.7.0 is compiled with Java 11. Running and building it from source require Java 11 or later.
+### 2.1 Install Java 17 (JDK 17)
-**Before continuing, run `java -version` to confirm your JDK version.**
-
-> Java 8 is no longer supported starting from 1.7.0. `bin/hugegraph-server.sh` refuses to start on anything older than Java 11.
+Starting with HugeGraph 1.8.0, use **Java 17**; **1.7.0 is the last release supporting Java 11**.
+Build all modules with **JDK 17 and Maven 3.6.3 or later**, and run Server, PD and Store with **JDK 17**.
Review Comment:
Aligned HugeGraph-PD and HugeGraph-Store prerequisites and startup script descriptions with Java 17 and Maven 3.6.3+ for HugeGraph 1.8.0.
--
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: issues-unsubscribe@hugegraph.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@hugegraph.apache.org
For additional commands, e-mail: issues-help@hugegraph.apache.org