From aeac69940a3777447fb90cd36531719f54e65eb8 Mon Sep 17 00:00:00 2001 From: Ayan Alam Date: Mon, 28 Sep 2026 01:30:00 +0530 Subject: [PATCH 1/2] doc(server): remove role election config options The server no longer registers server.role_election or the server.role.* options (apache/hugegraph#3244), so drop them from the en and cn config option pages. --- content/cn/docs/config/config-option.md | 13 ------------- content/en/docs/config/config-option.md | 13 ------------- 2 files changed, 26 deletions(-) diff --git a/content/cn/docs/config/config-option.md b/content/cn/docs/config/config-option.md index e8b03cef72..936b935d0f 100644 --- a/content/cn/docs/config/config-option.md +++ b/content/cn/docs/config/config-option.md @@ -39,7 +39,6 @@ search_boost: 1.5 | init_store.enabled | true | Whether init-store initializes the local backend stores and the built-in admin account. Set false in distributed deployments (PD/HStore) where the storage side already owns the metadata. | | server.id | 空字符串 | The optional legacy id of hugegraph-server. | | server.role | master | The role of nodes in the cluster, available types are [master, worker, computer] | -| server.role_election | false | Whether to enable role election, if enabled, the server will elect a master node in the cluster. | | server.node_id | node-id1 | The node id of the server. | | server.node_role | worker | The node role of the server. | | server.graphspace | DEFAULT | The graph space of the server. | @@ -80,18 +79,6 @@ search_boost: 1.5 | log.slow_query_threshold | 1000 | The threshold time(ms) of logging slow query, 0 means logging slow query is disabled. | | log.slow_query_body_limit | 512 | 慢查询日志记录的请求体最大字节数，0 表示不记录。记录的前缀原样写入，可能包含敏感的 Gremlin 或 Cypher 字面量。 | -> [!DETAILS]- **角色选举配置项 (可选)** -> 对应配置文件`rest-server.properties`，仅在 `server.role_election=true` 时生效。 -> -> | config option | default value | description | -> |--------------------------------|-----------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -> | server.role.node_external_url | http://127.0.0.1:8080 | The url of external accessibility. | -> | server.role.base_timeout | 500 | The role state machine candidate state base timeout time, in ms. | -> | server.role.random_timeout | 1000 | The random timeout in ms that be used when candidate node request to become master state to reduce competitive voting. | -> | server.role.heartbeat_interval | 2 | The role state machine heartbeat interval second time. | -> | server.role.fail_count | 5 | When the node failed count of update or query heartbeat is reaches this threshold, the node will become abdication state to guardsafe property. | -> | server.role.master_dead_times | 10 | When the worker node detects that the number of times the master node fails to update heartbeat reaches this threshold, the worker node will become to a candidate node. | - ### PD/Meta 配置项 (分布式模式) 对应配置文件`rest-server.properties` diff --git a/content/en/docs/config/config-option.md b/content/en/docs/config/config-option.md index fa43f13e53..71f621f4c2 100644 --- a/content/en/docs/config/config-option.md +++ b/content/en/docs/config/config-option.md @@ -39,7 +39,6 @@ Corresponding configuration file `rest-server.properties` | init_store.enabled | true | Whether init-store initializes the local backend stores and the built-in admin account. Set false in distributed deployments (PD/HStore) where the storage side already owns the metadata. | | server.id | Empty string | The optional legacy id of hugegraph-server. | | server.role | master | The role of nodes in the cluster, available types are [master, worker, computer] | -| server.role_election | false | Whether to enable role election, if enabled, the server will elect a master node in the cluster. | | server.node_id | node-id1 | The node id of the server. | | server.node_role | worker | The node role of the server. | | server.graphspace | DEFAULT | The graph space of the server. | @@ -80,18 +79,6 @@ Corresponding configuration file `rest-server.properties` | log.slow_query_threshold | 1000 | The threshold time(ms) of logging slow query, 0 means logging slow query is disabled. | | log.slow_query_body_limit | 512 | The max bytes of request body recorded in the slow query log, 0 means the body is not recorded. The recorded prefix is written as-is and may contain sensitive Gremlin or Cypher literals. | -> [!DETAILS]- **Role Election Config Options (Optional)** -> Corresponding configuration file `rest-server.properties`, only used when `server.role_election=true`. -> -> | config option | default value | description | -> |--------------------------------|-----------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -> | server.role.node_external_url | http://127.0.0.1:8080 | The url of external accessibility. | -> | server.role.base_timeout | 500 | The role state machine candidate state base timeout time, in ms. | -> | server.role.random_timeout | 1000 | The random timeout in ms that be used when candidate node request to become master state to reduce competitive voting. | -> | server.role.heartbeat_interval | 2 | The role state machine heartbeat interval second time. | -> | server.role.fail_count | 5 | When the node failed count of update or query heartbeat is reaches this threshold, the node will become abdication state to guardsafe property. | -> | server.role.master_dead_times | 10 | When the worker node detects that the number of times the master node fails to update heartbeat reaches this threshold, the worker node will become to a candidate node. | - ### PD/Meta Config Options (Distributed Mode) Corresponding configuration file `rest-server.properties` From 5ffb6bc86ce0bfa3fcb2422634ee96cd20c1af05 Mon Sep 17 00:00:00 2001 From: Ayan Alam Date: Mon, 28 Sep 2026 20:05:02 +0530 Subject: [PATCH 2/2] doc(server): note that role election options apply to 1.7.0 only The 1.7.0 release still runs role election when server.role_election is true, so leave a short version note where the removed block was instead of dropping the only reference for 1.7.0 users. --- content/cn/docs/config/config-option.md | 2 ++ content/en/docs/config/config-option.md | 2 ++ 2 files changed, 4 insertions(+) diff --git a/content/cn/docs/config/config-option.md b/content/cn/docs/config/config-option.md index 936b935d0f..bc72276a11 100644 --- a/content/cn/docs/config/config-option.md +++ b/content/cn/docs/config/config-option.md @@ -79,6 +79,8 @@ search_boost: 1.5 | log.slow_query_threshold | 1000 | The threshold time(ms) of logging slow query, 0 means logging slow query is disabled. | | log.slow_query_body_limit | 512 | 慢查询日志记录的请求体最大字节数，0 表示不记录。记录的前缀原样写入，可能包含敏感的 Gremlin 或 Cypher 字面量。 | +角色选举配置项 `server.role_election` 和 `server.role.*` 仅适用于 1.7.0 及更早版本。之后的版本不再读取这些配置项：若仍然设置，服务可以正常启动，并为每个配置项输出一条警告日志。 + ### PD/Meta 配置项 (分布式模式) 对应配置文件`rest-server.properties` diff --git a/content/en/docs/config/config-option.md b/content/en/docs/config/config-option.md index 71f621f4c2..588a5e1948 100644 --- a/content/en/docs/config/config-option.md +++ b/content/en/docs/config/config-option.md @@ -79,6 +79,8 @@ Corresponding configuration file `rest-server.properties` | log.slow_query_threshold | 1000 | The threshold time(ms) of logging slow query, 0 means logging slow query is disabled. | | log.slow_query_body_limit | 512 | The max bytes of request body recorded in the slow query log, 0 means the body is not recorded. The recorded prefix is written as-is and may contain sensitive Gremlin or Cypher literals. | +The role election options `server.role_election` and `server.role.*` apply to version 1.7.0 and earlier only. Later versions no longer read them: a server that still sets them starts normally and logs a warning for each key. + ### PD/Meta Config Options (Distributed Mode) Corresponding configuration file `rest-server.properties`