From 1b423f4674cc3291af10a060f4428357ac8a89cb Mon Sep 17 00:00:00 2001 From: Vaibhav Joshi Date: Mon, 11 May 2026 17:05:17 +0530 Subject: [PATCH 1/2] =?UTF-8?q?[Bug]=20Update=20README=20=E2=80=9CBuild=20?= =?UTF-8?q?from=20Source=E2=80=9D=20instructions=20and=20add=20Gremlin=20C?= =?UTF-8?q?onsole=20troubleshooting=20for=20Mac=20M4=20(Apple=20Silicon)?= =?UTF-8?q?=20(apache#3006)=20-=20Fix=20outdated=20server=20startup=20step?= =?UTF-8?q?s=20in=20Option=203:=20Build=20from=20Source=20-=20Add=20troubl?= =?UTF-8?q?eshooting=20note=20for=20gremlin-console.sh=20failures=20on=20A?= =?UTF-8?q?pple=20Silicon=20and=20Java=2017+=20-=20Reference:=20apache#300?= =?UTF-8?q?6?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 19 +++++++++++++++---- hugegraph-server/hugegraph-dist/pom.xml | 7 +++++++ install-dist/pom.xml | 3 +++ install-dist/release-docs/LICENSE | 6 ++++++ install-dist/release-docs/NOTICE | 9 +++++++++ .../licenses/LICENSE-jansi-2.4.0.txt | 16 ++++++++++++++++ .../scripts/dependency/known-dependencies.txt | 1 + 7 files changed, 57 insertions(+), 4 deletions(-) create mode 100644 install-dist/release-docs/licenses/LICENSE-jansi-2.4.0.txt diff --git a/README.md b/README.md index 610c29fc91..2fda55a914 100644 --- a/README.md +++ b/README.md @@ -267,10 +267,14 @@ cd hugegraph # Build all modules (skip tests for faster build) mvn clean package -DskipTests -# Extract built package -cd install-dist/target -tar -xzf hugegraph-{version}.tar.gz -cd hugegraph-{version} + # After building, the unpacked distribution will be in the project root: +ls apache-hugegraph-* + +# Enter the unpacked directory (e.g., apache-hugegraph-1.7.0): +cd apache-hugegraph-* + +# Enter the server package directory: +cd apache-hugegraph-server-1.7.0 # Initialize and start bin/init-store.sh @@ -308,6 +312,13 @@ gremlin> :remote connect tinkerpop.server conf/remote.yaml gremlin> :> g.V().limit(5) ``` + > **Troubleshooting for Java 17+ users:** + > The bundled Gremlin Console is only compatible with Java 11. If you run it with Java 17 or newer, you may encounter native library errors or startup failures. Please ensure you are using Java 11 when running `bin/gremlin-console.sh`. + + > **Troubleshooting for Apple Silicon (M1/M2/M3/M4) users:** + > Starting from this release, an aarch64-compatible `jansi 2.4.0` is bundled into `lib/`, which should resolve the native-library `UnsatisfiedLinkError` on Apple Silicon. + > If you still hit native errors, download the ARM64 Gremlin Console from the [TinkerPop website](https://tinkerpop.apache.org/download.html) and use its `bin/gremlin.sh` to connect to your HugeGraph server. + For comprehensive documentation, visit the [HugeGraph Documentation](https://hugegraph.apache.org/docs/). diff --git a/hugegraph-server/hugegraph-dist/pom.xml b/hugegraph-server/hugegraph-dist/pom.xml index 1fe20b6d9b..8a6e213767 100644 --- a/hugegraph-server/hugegraph-dist/pom.xml +++ b/hugegraph-server/hugegraph-dist/pom.xml @@ -33,6 +33,7 @@ ${project.basedir}/src/assembly ${assembly.dir}/descriptor ${assembly.dir}/static + 2.4.0 @@ -123,6 +124,12 @@ grpc-stub ${grpc.version} + + org.fusesource.jansi + jansi + ${jansi.version} + runtime + diff --git a/install-dist/pom.xml b/install-dist/pom.xml index 45de069d07..6c921888ff 100644 --- a/install-dist/pom.xml +++ b/install-dist/pom.xml @@ -32,6 +32,9 @@ apache-${release.name}-${project.version} + + + diff --git a/install-dist/release-docs/LICENSE b/install-dist/release-docs/LICENSE index bd00dbc118..b9fd034f43 100644 --- a/install-dist/release-docs/LICENSE +++ b/install-dist/release-docs/LICENSE @@ -912,3 +912,9 @@ The text of each license is also included in licenses/LICENSE-[project].txt. https://central.sonatype.com/artifact/xmlpull/xmlpull/1.1.3.1 -> Public Domain https://central.sonatype.com/artifact/xpp3/xpp3_min/1.1.4c -> Public Domain + +# +# jansi 2.4.0 (https://github.com/fusesource/jansi) +# +# This product includes software developed by the Jansi project (http://fusesource.github.io/jansi/). +# See licenses/LICENSE-jansi-2.4.0.txt for license details (Apache License 2.0 or LGPL 3.0+). diff --git a/install-dist/release-docs/NOTICE b/install-dist/release-docs/NOTICE index 247b9dadd0..95ef9dc64b 100644 --- a/install-dist/release-docs/NOTICE +++ b/install-dist/release-docs/NOTICE @@ -2764,3 +2764,12 @@ swagger-ui NOTICE swagger-ui Copyright 2020-2021 SmartBear Software Inc. + +======================================================================== + +# +# jansi 2.4.0 (https://github.com/fusesource/jansi) +# +# This product includes software developed by the Jansi project (http://fusesource.github.io/jansi/). +# See licenses/LICENSE-jansi-2.4.0.txt for license details (Apache License 2.0 or LGPL 3.0+). + diff --git a/install-dist/release-docs/licenses/LICENSE-jansi-2.4.0.txt b/install-dist/release-docs/licenses/LICENSE-jansi-2.4.0.txt new file mode 100644 index 0000000000..09b4ae371e --- /dev/null +++ b/install-dist/release-docs/licenses/LICENSE-jansi-2.4.0.txt @@ -0,0 +1,16 @@ +Copyright (c) 2007-2021, the original author(s) +All rights reserved. + +This software is dual-licensed under the Apache License, Version 2.0 and the GNU Lesser General Public License, version 3 or later (LGPL-3.0-or-later). + +You may obtain a copy of the Apache License at + + http://www.apache.org/licenses/LICENSE-2.0 + +You may obtain a copy of the GNU Lesser General Public License at + + http://www.gnu.org/licenses/lgpl-3.0.html + +Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. + +This product includes software developed by the Jansi project (http://fusesource.github.io/jansi/). diff --git a/install-dist/scripts/dependency/known-dependencies.txt b/install-dist/scripts/dependency/known-dependencies.txt index 4a0f255124..d4640aaf97 100644 --- a/install-dist/scripts/dependency/known-dependencies.txt +++ b/install-dist/scripts/dependency/known-dependencies.txt @@ -179,6 +179,7 @@ httpcore-4.4.13.jar ikanalyzer-2012_u6.jar ivy-2.4.0.jar j2objc-annotations-1.1.jar +jansi-2.4.0.jar j2objc-annotations-1.3.jar j2objc-annotations-2.8.jar jackson-annotations-2.13.0.jar From 14ca9dcd48794cab9d3b6ede5f864a15871c0f87 Mon Sep 17 00:00:00 2001 From: Vaibhav Joshi Date: Wed, 20 May 2026 10:55:41 +0530 Subject: [PATCH 2/2] =?UTF-8?q?[Bug]=20README=20=E2=80=9CBuild=20from=20So?= =?UTF-8?q?urce=E2=80=9D=20instructions=20outdated.=20#3006=20Implemented?= =?UTF-8?q?=20review=20comments=20-Kept=20only=20changes=20related=20to=20?= =?UTF-8?q?README.md.=20We=20will=20have=20separate=20PR=20for=20mac=20sil?= =?UTF-8?q?licon=20issues.?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 7 ------- hugegraph-server/hugegraph-dist/pom.xml | 7 ------- install-dist/pom.xml | 3 --- install-dist/release-docs/LICENSE | 6 ------ install-dist/release-docs/NOTICE | 9 --------- .../licenses/LICENSE-jansi-2.4.0.txt | 16 ---------------- .../scripts/dependency/known-dependencies.txt | 1 - 7 files changed, 49 deletions(-) delete mode 100644 install-dist/release-docs/licenses/LICENSE-jansi-2.4.0.txt diff --git a/README.md b/README.md index 2fda55a914..bd12dcff7b 100644 --- a/README.md +++ b/README.md @@ -312,13 +312,6 @@ gremlin> :remote connect tinkerpop.server conf/remote.yaml gremlin> :> g.V().limit(5) ``` - > **Troubleshooting for Java 17+ users:** - > The bundled Gremlin Console is only compatible with Java 11. If you run it with Java 17 or newer, you may encounter native library errors or startup failures. Please ensure you are using Java 11 when running `bin/gremlin-console.sh`. - - > **Troubleshooting for Apple Silicon (M1/M2/M3/M4) users:** - > Starting from this release, an aarch64-compatible `jansi 2.4.0` is bundled into `lib/`, which should resolve the native-library `UnsatisfiedLinkError` on Apple Silicon. - > If you still hit native errors, download the ARM64 Gremlin Console from the [TinkerPop website](https://tinkerpop.apache.org/download.html) and use its `bin/gremlin.sh` to connect to your HugeGraph server. - For comprehensive documentation, visit the [HugeGraph Documentation](https://hugegraph.apache.org/docs/). diff --git a/hugegraph-server/hugegraph-dist/pom.xml b/hugegraph-server/hugegraph-dist/pom.xml index 8a6e213767..1fe20b6d9b 100644 --- a/hugegraph-server/hugegraph-dist/pom.xml +++ b/hugegraph-server/hugegraph-dist/pom.xml @@ -33,7 +33,6 @@ ${project.basedir}/src/assembly ${assembly.dir}/descriptor ${assembly.dir}/static - 2.4.0 @@ -124,12 +123,6 @@ grpc-stub ${grpc.version} - - org.fusesource.jansi - jansi - ${jansi.version} - runtime - diff --git a/install-dist/pom.xml b/install-dist/pom.xml index 6c921888ff..45de069d07 100644 --- a/install-dist/pom.xml +++ b/install-dist/pom.xml @@ -32,9 +32,6 @@ apache-${release.name}-${project.version} - - - diff --git a/install-dist/release-docs/LICENSE b/install-dist/release-docs/LICENSE index b9fd034f43..bd00dbc118 100644 --- a/install-dist/release-docs/LICENSE +++ b/install-dist/release-docs/LICENSE @@ -912,9 +912,3 @@ The text of each license is also included in licenses/LICENSE-[project].txt. https://central.sonatype.com/artifact/xmlpull/xmlpull/1.1.3.1 -> Public Domain https://central.sonatype.com/artifact/xpp3/xpp3_min/1.1.4c -> Public Domain - -# -# jansi 2.4.0 (https://github.com/fusesource/jansi) -# -# This product includes software developed by the Jansi project (http://fusesource.github.io/jansi/). -# See licenses/LICENSE-jansi-2.4.0.txt for license details (Apache License 2.0 or LGPL 3.0+). diff --git a/install-dist/release-docs/NOTICE b/install-dist/release-docs/NOTICE index 95ef9dc64b..247b9dadd0 100644 --- a/install-dist/release-docs/NOTICE +++ b/install-dist/release-docs/NOTICE @@ -2764,12 +2764,3 @@ swagger-ui NOTICE swagger-ui Copyright 2020-2021 SmartBear Software Inc. - -======================================================================== - -# -# jansi 2.4.0 (https://github.com/fusesource/jansi) -# -# This product includes software developed by the Jansi project (http://fusesource.github.io/jansi/). -# See licenses/LICENSE-jansi-2.4.0.txt for license details (Apache License 2.0 or LGPL 3.0+). - diff --git a/install-dist/release-docs/licenses/LICENSE-jansi-2.4.0.txt b/install-dist/release-docs/licenses/LICENSE-jansi-2.4.0.txt deleted file mode 100644 index 09b4ae371e..0000000000 --- a/install-dist/release-docs/licenses/LICENSE-jansi-2.4.0.txt +++ /dev/null @@ -1,16 +0,0 @@ -Copyright (c) 2007-2021, the original author(s) -All rights reserved. - -This software is dual-licensed under the Apache License, Version 2.0 and the GNU Lesser General Public License, version 3 or later (LGPL-3.0-or-later). - -You may obtain a copy of the Apache License at - - http://www.apache.org/licenses/LICENSE-2.0 - -You may obtain a copy of the GNU Lesser General Public License at - - http://www.gnu.org/licenses/lgpl-3.0.html - -Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. - -This product includes software developed by the Jansi project (http://fusesource.github.io/jansi/). diff --git a/install-dist/scripts/dependency/known-dependencies.txt b/install-dist/scripts/dependency/known-dependencies.txt index d4640aaf97..4a0f255124 100644 --- a/install-dist/scripts/dependency/known-dependencies.txt +++ b/install-dist/scripts/dependency/known-dependencies.txt @@ -179,7 +179,6 @@ httpcore-4.4.13.jar ikanalyzer-2012_u6.jar ivy-2.4.0.jar j2objc-annotations-1.1.jar -jansi-2.4.0.jar j2objc-annotations-1.3.jar j2objc-annotations-2.8.jar jackson-annotations-2.13.0.jar