[Bug] describe the main problem

[bitflicker64]

Bug Type (问题类型)

others (please edit later)

Before submit

• 我已经确认现有的 Issues 与 FAQ 中没有相同 / 重复问题 (I have confirmed and searched that there are no similar problems in the historical issue and documents)

Environment (环境信息)

Environment (环境信息)
Server Version: 1.0.0 (Apache Release Version)
Backend: RocksDB x nodes, HDD or SSD
OS: xx CPUs, xx G RAM, Ubuntu 2x.x / CentOS 7.x
Data Size: xx vertices, xx edges

Expected & Actual behavior (期望与实际表现)

Expected & Actual behavior (期望与实际表现)
Description:

The README’s “Build from Source” instructions are outdated and do not match the current directory structure and startup instructions after building from source. As a result, users cannot start the server as described.
Additionally, the bundled Gremlin Console (bin/gremlin-console.sh) fails to start on Mac M4 (Apple Silicon) due to native library (Jansi) incompatibility and Java version issues.
Details:

After building from source, the server scripts are not in the location described in the README, causing startup failures.
On Mac M4, running Gremlin Console results in errors like: java.lang.UnsatisfiedLinkError: Could not load library. Reasons: [no jansi in java.library.path ... (fat file, but missing compatible architecture (have 'x86_64,i386', need 'arm64'))] and the gremlin console works only with Java 11
Proposed Fix:

Update the README to reflect the correct post-build directory structure and server startup steps.
Add troubleshooting notes for Apple Silicon and Java 17+ users regarding Gremlin Console

Vertex/Edge example (问题点 / 边数据举例)

Schema [VertexLabel, EdgeLabel, IndexLabel] (元数据结构)

[github-actions]

Issue Summary and Proposed Solution

The issue reported is related to outdated instructions in the README.md for building and running HugeGraph from source, coupled with compatibility problems of the Gremlin Console on Mac M4 (Apple Silicon). Specifically, the server startup instructions and the location of server scripts are incorrect post-build, and the bin/gremlin-console.sh fails to start due to incompatibility with the Jansi native library and a requirement for Java 11, while some users are on Java 17+.

Steps to Resolve

1. Update README.md: Reflect the correct post-build directory structure. After building from source, the server scripts can be found in hugegraph-server/hugegraph-dist/src/assembly/static/bin/, which includes necessary scripts like bin/init-store.sh and bin/start-hugegraph.sh.
2. Add Troubleshooting Notes: Include notes for users on Mac M4 (Apple Silicon) and those using Java 17+, regarding the Gremlin Console's compatibility issues. This could involve specifying the need for Java 11 for the Gremlin Console or providing alternative solutions for compatibility with newer Java versions and Apple Silicon architectures.
3. Consider Jansi Native Library Update: Look into updating or configuring the Jansi native library to support arm64 architecture for compatibility with Apple Silicon.

Next Steps

These proposed fixes should address the immediate issues reported. It's also worth considering long-term solutions, such as automating the update of documentation to reflect changes in the build process and continuously testing compatibility across different environments (including Apple Silicon and various Java versions).

---

Note: I am an AI bot powered by DeepWiki + Groq. If you have follow-up questions or need further assistance, don't hesitate to quote-reply this message, and I'll be happy to help.

---

✅ Powered by DeepWiki + Groq — answer based on actual repo documentation.