docs: align distributed startup requirements

[imbajin]

中文说明 (Chinese Summary)

背景与目标

原文档存在混杂 1.7.0 发行版说明与 master 最新启动脚本行为的问题。本 PR 系统梳理了 分布式组件启动要求、版本兼容边界与环境配置，同时补充了服务身份标识、图空间别名和认证密钥升级的最新指引。

主要改动

1. 启动脚本与 JDK/GC 版本分界 (hugegraph-pd.md, hugegraph-hstore.md, hugegraph-server.md):
   • JDK 版本：明确 1.7.0 的 PD/Store 脚本针对 Java 11；master 修复后的脚本正式要求 Java 17。
   • GC 选项：明确 1.7.0 脚本不支持显式指定 -g g1；master 脚本已支持显式 G1 参数（#3305）。
   • 脚本能力增强：纳入前台启动、退出状态码保留以及 HStore jemalloc 连接超时的最新指引（#3310, #3311, #3316）。
2. 服务身份与图空间别名 (hugegraph-docker-cluster.md, hugegraph-server.md):
   • 补充 server.serviceId / HG_SERVER_SERVICE_ID 的命名约束（支持可打印 ASCII，字面保留 $)。
   • 补充 server.testGraphAlias 说明：别名必须严格匹配本地图配置的大小写（配套 Server #3322）。
3. 认证升级与密钥修复 (hugegraph-server.md):
   • 说明签名密钥配置修复后的处理步骤，以及旧版初始化管理员密码涉及的 Unicode 字符更新注意事项（配套 Server #3327）。

边界与注意事项

• 部分服务身份与图空间特性为未正式发版功能，需配合对应代码 PR 或镜像使用。
• 启动脚本检查通过不代表具备完整的全链路 JDK 兼容性，升级生产环境请参考对应版本发行说明。

---

English Description

Summary

Disentangle 1.7.0 package instructions from current-master launcher behaviors across PD, Store, and Server startup guides, while documenting service identity, graph-space bindings, and authentication upgrade fixes.

Key Changes

1. Launcher & Runtime Boundaries (hugegraph-pd.md, hugegraph-hstore.md, hugegraph-server.md):
   • JDK requirements: clarify that 1.7.0 PD/Store scripts target Java 11, whereas repaired master scripts require Java 17.
   • GC selection: 1.7.0 launchers reject explicit -g g1/-g G1; master launchers officially support explicit G1 (#3305).
   • Launcher enhancements: document foreground mode, preserved exit statuses, and Store jemalloc timeout settings (#3310, #3311, #3316).
2. Service Identity & GraphSpace Settings (hugegraph-docker-cluster.md, hugegraph-server.md):
   • Clarified server.serviceId rules (printable ASCII, literal handling of $ without env expansion).
   • Documented server.testGraphAlias case-sensitive matching for local bindings (paired with Server #3322).
3. Authentication Upgrade Fixes (hugegraph-server.md):
   • Documented signing-key re-supply procedures and admin password update caveats (paired with Server #3327).

Scope & Boundaries

• Service identity and dynamic graph-space alias settings are unreleased features requiring matching master / PR image builds.
• Passing launcher script validations alone does not substitute for full end-to-end JDK 17 runtime testing.

---

Related Implementation PRs

• Launchers & GC: #3305, #3310, #3311, #3316
• Service Identity: apache/hugegraph#3322
• Auth Fixes: apache/hugegraph#3327
• Org PR: hugegraph/hugegraph-doc#42

Verification

• Hugo 0.165 Extended bilingual build passed
• Markdown links & anchors validated (dist/validate-links.sh)

Implementation Overview

[bitflicker64]

Blocking: yes. Summary: The Docker entrypoint, partition-diagnostic, jemalloc and JDK/Maven statements match apache/hugegraph master, and the English and Chinese pages agree. Two things need changes before merge: the Server service identity section documents apache/hugegraph#3322, which is still open, and the new -g rows on the Store and PD pages describe master only while those pages install the 1.7.0 tarball, where -g g1 aborts. Evidence: read the full diff at f569d15 (8 files, +148/-22) against base 2d0b830; compared it with apache/hugegraph master 62faab73d (docker-entrypoint.sh, wait-partition.sh, start-hugegraph.sh, Store and PD launchers, Store util.sh, root pom.xml, .github/workflows/.java-version) and with tag 1.7.0; #3305, #3310, #3311, #3316 and #3327 are merged, #3322 is open; helm template of the master chart with the documented values fails schema validation; the four site build checks on this head pass (publish is skipped).

[bitflicker64]

Blocking: yes. Summary: The launcher, JDK, GC, jemalloc, partition-diagnostic and entrypoint statements match apache/hugegraph master and tag 1.7.0, and the earlier -g thread is fixed. The Server service identity section still documents settings from apache/hugegraph#3322, which is open, and this head removed the only pointer that said so; a Minor note covers fix boundaries that lost their PR links. Evidence: read the full diff 2d0b830..957409f (8 files, +204/-30) and the delta f569d15..957409f; checked apache/hugegraph master 4b77b7bcb (start-hugegraph-pd.sh, start-hugegraph-store.sh, Store util.sh, wait-partition.sh, docker-entrypoint.sh, root pom.xml, helm/hugegraph) and tag 1.7.0; helm template of the master chart with the documented values fails schema validation; #3305, #3310, #3311, #3316 and #3327 are merged, #3322 is open; the site build checks on this head pass (publish is skipped).

[imbajin]

Blocking: no. Summary: The startup note should also say that partition polling can delay observation of Java exit before the final diagnostic. Evidence: the master entrypoint waits for the partition process before the launcher, and wait-partition.sh gives polling and diagnosis separate timeouts.