This is an automated email from the ASF dual-hosted git repository.
morningman pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/doris-website.git
The following commit(s) were added to refs/heads/master by this push:
new 1ce85100bdd Add HMS/HDFS Access Port Requirements (#3202)
1ce85100bdd is described below
commit 1ce85100bdd643323332da5773c7c17eaf401520
Author: Calvin Kirs <[email protected]>
AuthorDate: Thu Dec 18 17:15:56 2025 +0800
Add HMS/HDFS Access Port Requirements (#3202)
---
docs/lakehouse/metastores/hive-metastore.md | 11 +++++++++++
docs/lakehouse/storages/hdfs.md | 13 +++++++++++++
.../current/lakehouse/metastores/hive-metastore.md | 12 ++++++++++++
.../current/lakehouse/storages/hdfs.md | 15 +++++++++++++++
.../version-2.1/lakehouse/metastores/hive-metastore.md | 11 +++++++++++
.../version-2.1/lakehouse/storages/hdfs.md | 14 ++++++++++++++
.../version-3.x/lakehouse/metastores/hive-metastore.md | 11 +++++++++++
.../version-3.x/lakehouse/storages/hdfs.md | 14 ++++++++++++++
.../version-4.x/lakehouse/metastores/hive-metastore.md | 11 +++++++++++
.../version-4.x/lakehouse/storages/hdfs.md | 14 ++++++++++++++
.../version-2.1/lakehouse/metastores/hive-metastore.md | 11 +++++++++++
versioned_docs/version-2.1/lakehouse/storages/hdfs.md | 14 ++++++++++++++
.../version-3.x/lakehouse/metastores/hive-metastore.md | 11 +++++++++++
versioned_docs/version-3.x/lakehouse/storages/hdfs.md | 13 +++++++++++++
.../version-4.x/lakehouse/metastores/hive-metastore.md | 11 +++++++++++
versioned_docs/version-4.x/lakehouse/storages/hdfs.md | 13 +++++++++++++
16 files changed, 199 insertions(+)
diff --git a/docs/lakehouse/metastores/hive-metastore.md
b/docs/lakehouse/metastores/hive-metastore.md
index 5abefd52081..971d1f87249 100644
--- a/docs/lakehouse/metastores/hive-metastore.md
+++ b/docs/lakehouse/metastores/hive-metastore.md
@@ -226,6 +226,17 @@ The following parameters are specific to each Catalog
type, in addition to the c
'oss.endpoint' = 'oss-cn-beijing.aliyuncs.com'
);
```
+## HMS Access Port Requirements
+
+Doris requires at least the following ports to be open to access HMS:
+
+| Service | Port Purpose | Default Port | Protocol |
+|----------------|-----------------------|--------------|----------|
+| Hive Metastore | Thrift (metadata access) | 9083 | TCP |
+
+Notes:
+- Ports may be customized in `hive-site.xml`. Always follow your actual
configuration.
+- When Kerberos authentication is enabled, ensure network connectivity from
Doris to the Kerberos KDC. The KDC listens on TCP port 88 by default, unless
customized in your KDC configuration.
## Frequently Asked Questions (FAQ)
diff --git a/docs/lakehouse/storages/hdfs.md b/docs/lakehouse/storages/hdfs.md
index 6e214cc85ba..a122dc1d70d 100644
--- a/docs/lakehouse/storages/hdfs.md
+++ b/docs/lakehouse/storages/hdfs.md
@@ -184,6 +184,19 @@ Note:
In summary, properly configuring the `dfs.client.socket-timeout` parameter can
improve I/O response speed while ensuring system stability and reliability.
+## HDFS Access Port Requirements (NameNode \& DataNode only)
+
+Doris requires the following ports to be open to access HDFS:
+
+| Service | Port Purpose | Default Port | Protocol|
+|-----------|-------------------------------|--------------|---------|
+| NameNode | RPC (client/metadata access) | 8020 |TCP |
+| DataNode | Data transfer (block I/O) | 9866 |TCP |
+
+Notes:
+- Ports may be customized in `core-site.xml` \& `hdfs-site.xml`. Use actual
configs.
+- When Kerberos authentication is enabled, Doris must also be able to reach
the Kerberos KDC service. The KDC listens on TCP port 88 by default, but the
actual port should follow your KDC configuration.
+
## Debugging HDFS
Hadoop environment configuration is complex, and in some cases, connectivity
issues and poor access performance may occur. Here are some third-party tools
to help users quickly troubleshoot connectivity issues and basic performance
problems.
diff --git
a/i18n/zh-CN/docusaurus-plugin-content-docs/current/lakehouse/metastores/hive-metastore.md
b/i18n/zh-CN/docusaurus-plugin-content-docs/current/lakehouse/metastores/hive-metastore.md
index 1145dc5ee47..492da956f75 100644
---
a/i18n/zh-CN/docusaurus-plugin-content-docs/current/lakehouse/metastores/hive-metastore.md
+++
b/i18n/zh-CN/docusaurus-plugin-content-docs/current/lakehouse/metastores/hive-metastore.md
@@ -227,6 +227,18 @@ Kerberos 详细配置参考 Kerberos 认证。
);
```
+## HMS 访问端口要求
+
+说明：Doris 访问 HMS 最少需保证以下端口连通。
+
+| 服务 | 端口用途 | 默认端口 | 协议 |
+|----------------|-------------------|------|--------------|
+| Hive Metastore | Thrift（元数据访问） | 9083 | TCP |
+
+注意：
+- 端口可能被 `hive-site.xml`自定义，请以实际配置为准。
+- 当启用 Kerberos 认证时，需要保证 Doris 到 Kerberos KDC 的网络连通。KDC 默认监听 TCP 88
端口，如有自定义请以实际配置为准。
+
## 常见问题 FAQ
- Q1: hive-site.xml 是必须的吗？
diff --git
a/i18n/zh-CN/docusaurus-plugin-content-docs/current/lakehouse/storages/hdfs.md
b/i18n/zh-CN/docusaurus-plugin-content-docs/current/lakehouse/storages/hdfs.md
index 780903fa97b..c61171ae7d8 100644
---
a/i18n/zh-CN/docusaurus-plugin-content-docs/current/lakehouse/storages/hdfs.md
+++
b/i18n/zh-CN/docusaurus-plugin-content-docs/current/lakehouse/storages/hdfs.md
@@ -184,6 +184,21 @@ HDFS Client 提供了 Hedged Read 功能。该功能可以在一个读请求超
总之，合理配置 `dfs.client.socket-timeout` 参数，可以在提高 I/O 响应速度的同时，确保系统的稳定性和可靠性。
+## HDFS 访问端口要求（仅 NameNode 与 DataNode）
+
+说明：Doris 访问 HDFS 最少需保证以下端口连通。
+
+| 服务 | 端口用途 | 默认端口 | 协议 |
+|----------|------------------|----------|--------------|
+| NameNode | RPC（客户端／元数据访问） | 8020 | TCP |
+| DataNode | 数据传输（Block 读写） | 9866 | TCP |
+
+
+注意：
+- 端口可能被 `core-site.xml`／`hdfs-site.xml` 自定义，请以实际配置为准。
+- 当启用 Kerberos 认证时，需要保证 Doris 到 Kerberos KDC 的网络连通。KDC 默认监听 TCP 88
端口，如有自定义请以实际配置为准。
+
+
## 调试 HDFS
Hadoop 环境配置复杂，某些情况下可能出现无法连通、访问性能不佳等问题。这里提供一些第三方工具帮助用户快速排查连通性问题和基础的性能问题。
diff --git
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/lakehouse/metastores/hive-metastore.md
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/lakehouse/metastores/hive-metastore.md
index 1145dc5ee47..0879aaa5c17 100644
---
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/lakehouse/metastores/hive-metastore.md
+++
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/lakehouse/metastores/hive-metastore.md
@@ -226,6 +226,17 @@ Kerberos 详细配置参考 Kerberos 认证。
'oss.endpoint' = 'oss-cn-beijing.aliyuncs.com'
);
```
+## HMS 访问端口要求
+
+说明：Doris 访问 HMS 最少需保证以下端口连通。
+
+| 服务 | 端口用途 | 默认端口 | 协议 |
+|----------------|-------------------|------|--------------|
+| Hive Metastore | Thrift（元数据访问） | 9083 | TCP |
+
+注意：
+- 端口可能被 `hive-site.xml`自定义，请以实际配置为准。
+- 当启用 Kerberos 认证时，需要保证 Doris 到 Kerberos KDC 的网络连通。KDC 默认监听 TCP 88
端口，如有自定义请以实际配置为准。
## 常见问题 FAQ
diff --git
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/lakehouse/storages/hdfs.md
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/lakehouse/storages/hdfs.md
index 780903fa97b..3e0f89335e0 100644
---
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/lakehouse/storages/hdfs.md
+++
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/lakehouse/storages/hdfs.md
@@ -184,6 +184,20 @@ HDFS Client 提供了 Hedged Read 功能。该功能可以在一个读请求超
总之，合理配置 `dfs.client.socket-timeout` 参数，可以在提高 I/O 响应速度的同时，确保系统的稳定性和可靠性。
+## HDFS 访问端口要求（仅 NameNode 与 DataNode）
+
+说明：Doris 访问 HDFS 最少需保证以下端口连通。
+
+| 服务 | 端口用途 | 默认端口 | 协议 |
+|----------|------------------|----------|--------------|
+| NameNode | RPC（客户端／元数据访问） | 8020 | TCP |
+| DataNode | 数据传输（Block 读写） | 9866 | TCP |
+
+
+注意：
+- 端口可能被 `core-site.xml`／`hdfs-site.xml` 自定义，请以实际配置为准。
+- 当启用 Kerberos 认证时，需要保证 Doris 到 Kerberos KDC 的网络连通。KDC 默认监听 TCP 88
端口，如有自定义请以实际配置为准。
+
## 调试 HDFS
Hadoop 环境配置复杂，某些情况下可能出现无法连通、访问性能不佳等问题。这里提供一些第三方工具帮助用户快速排查连通性问题和基础的性能问题。
diff --git
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.x/lakehouse/metastores/hive-metastore.md
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.x/lakehouse/metastores/hive-metastore.md
index 1145dc5ee47..0879aaa5c17 100644
---
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.x/lakehouse/metastores/hive-metastore.md
+++
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.x/lakehouse/metastores/hive-metastore.md
@@ -226,6 +226,17 @@ Kerberos 详细配置参考 Kerberos 认证。
'oss.endpoint' = 'oss-cn-beijing.aliyuncs.com'
);
```
+## HMS 访问端口要求
+
+说明：Doris 访问 HMS 最少需保证以下端口连通。
+
+| 服务 | 端口用途 | 默认端口 | 协议 |
+|----------------|-------------------|------|--------------|
+| Hive Metastore | Thrift（元数据访问） | 9083 | TCP |
+
+注意：
+- 端口可能被 `hive-site.xml`自定义，请以实际配置为准。
+- 当启用 Kerberos 认证时，需要保证 Doris 到 Kerberos KDC 的网络连通。KDC 默认监听 TCP 88
端口，如有自定义请以实际配置为准。
## 常见问题 FAQ
diff --git
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.x/lakehouse/storages/hdfs.md
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.x/lakehouse/storages/hdfs.md
index 780903fa97b..3e0f89335e0 100644
---
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.x/lakehouse/storages/hdfs.md
+++
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.x/lakehouse/storages/hdfs.md
@@ -184,6 +184,20 @@ HDFS Client 提供了 Hedged Read 功能。该功能可以在一个读请求超
总之，合理配置 `dfs.client.socket-timeout` 参数，可以在提高 I/O 响应速度的同时，确保系统的稳定性和可靠性。
+## HDFS 访问端口要求（仅 NameNode 与 DataNode）
+
+说明：Doris 访问 HDFS 最少需保证以下端口连通。
+
+| 服务 | 端口用途 | 默认端口 | 协议 |
+|----------|------------------|----------|--------------|
+| NameNode | RPC（客户端／元数据访问） | 8020 | TCP |
+| DataNode | 数据传输（Block 读写） | 9866 | TCP |
+
+
+注意：
+- 端口可能被 `core-site.xml`／`hdfs-site.xml` 自定义，请以实际配置为准。
+- 当启用 Kerberos 认证时，需要保证 Doris 到 Kerberos KDC 的网络连通。KDC 默认监听 TCP 88
端口，如有自定义请以实际配置为准。
+
## 调试 HDFS
Hadoop 环境配置复杂，某些情况下可能出现无法连通、访问性能不佳等问题。这里提供一些第三方工具帮助用户快速排查连通性问题和基础的性能问题。
diff --git
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/lakehouse/metastores/hive-metastore.md
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/lakehouse/metastores/hive-metastore.md
index 1145dc5ee47..0879aaa5c17 100644
---
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/lakehouse/metastores/hive-metastore.md
+++
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/lakehouse/metastores/hive-metastore.md
@@ -226,6 +226,17 @@ Kerberos 详细配置参考 Kerberos 认证。
'oss.endpoint' = 'oss-cn-beijing.aliyuncs.com'
);
```
+## HMS 访问端口要求
+
+说明：Doris 访问 HMS 最少需保证以下端口连通。
+
+| 服务 | 端口用途 | 默认端口 | 协议 |
+|----------------|-------------------|------|--------------|
+| Hive Metastore | Thrift（元数据访问） | 9083 | TCP |
+
+注意：
+- 端口可能被 `hive-site.xml`自定义，请以实际配置为准。
+- 当启用 Kerberos 认证时，需要保证 Doris 到 Kerberos KDC 的网络连通。KDC 默认监听 TCP 88
端口，如有自定义请以实际配置为准。
## 常见问题 FAQ
diff --git
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/lakehouse/storages/hdfs.md
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/lakehouse/storages/hdfs.md
index 780903fa97b..3e0f89335e0 100644
---
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/lakehouse/storages/hdfs.md
+++
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/lakehouse/storages/hdfs.md
@@ -184,6 +184,20 @@ HDFS Client 提供了 Hedged Read 功能。该功能可以在一个读请求超
总之，合理配置 `dfs.client.socket-timeout` 参数，可以在提高 I/O 响应速度的同时，确保系统的稳定性和可靠性。
+## HDFS 访问端口要求（仅 NameNode 与 DataNode）
+
+说明：Doris 访问 HDFS 最少需保证以下端口连通。
+
+| 服务 | 端口用途 | 默认端口 | 协议 |
+|----------|------------------|----------|--------------|
+| NameNode | RPC（客户端／元数据访问） | 8020 | TCP |
+| DataNode | 数据传输（Block 读写） | 9866 | TCP |
+
+
+注意：
+- 端口可能被 `core-site.xml`／`hdfs-site.xml` 自定义，请以实际配置为准。
+- 当启用 Kerberos 认证时，需要保证 Doris 到 Kerberos KDC 的网络连通。KDC 默认监听 TCP 88
端口，如有自定义请以实际配置为准。
+
## 调试 HDFS
Hadoop 环境配置复杂，某些情况下可能出现无法连通、访问性能不佳等问题。这里提供一些第三方工具帮助用户快速排查连通性问题和基础的性能问题。
diff --git a/versioned_docs/version-2.1/lakehouse/metastores/hive-metastore.md
b/versioned_docs/version-2.1/lakehouse/metastores/hive-metastore.md
index 5abefd52081..971d1f87249 100644
--- a/versioned_docs/version-2.1/lakehouse/metastores/hive-metastore.md
+++ b/versioned_docs/version-2.1/lakehouse/metastores/hive-metastore.md
@@ -226,6 +226,17 @@ The following parameters are specific to each Catalog
type, in addition to the c
'oss.endpoint' = 'oss-cn-beijing.aliyuncs.com'
);
```
+## HMS Access Port Requirements
+
+Doris requires at least the following ports to be open to access HMS:
+
+| Service | Port Purpose | Default Port | Protocol |
+|----------------|-----------------------|--------------|----------|
+| Hive Metastore | Thrift (metadata access) | 9083 | TCP |
+
+Notes:
+- Ports may be customized in `hive-site.xml`. Always follow your actual
configuration.
+- When Kerberos authentication is enabled, ensure network connectivity from
Doris to the Kerberos KDC. The KDC listens on TCP port 88 by default, unless
customized in your KDC configuration.
## Frequently Asked Questions (FAQ)
diff --git a/versioned_docs/version-2.1/lakehouse/storages/hdfs.md
b/versioned_docs/version-2.1/lakehouse/storages/hdfs.md
index 6e214cc85ba..a3128702453 100644
--- a/versioned_docs/version-2.1/lakehouse/storages/hdfs.md
+++ b/versioned_docs/version-2.1/lakehouse/storages/hdfs.md
@@ -184,6 +184,20 @@ Note:
In summary, properly configuring the `dfs.client.socket-timeout` parameter can
improve I/O response speed while ensuring system stability and reliability.
+## HDFS Access Port Requirements (NameNode \& DataNode only)
+
+Doris requires the following ports to be open to access HDFS:
+
+| Service | Port Purpose | Default Port | Protocol|
+|-----------|-------------------------------|--------------|---------|
+| NameNode | RPC (client/metadata access) | 8020 |TCP |
+| DataNode | Data transfer (block I/O) | 9866 |TCP |
+
+Notes:
+- Ports may be customized in `core-site.xml` \& `hdfs-site.xml`. Use actual
configs.
+- When Kerberos authentication is enabled, Doris must also be able to reach
the Kerberos KDC service. The KDC listens on TCP port 88 by default, but the
actual port should follow your KDC configuration.
+
+
## Debugging HDFS
Hadoop environment configuration is complex, and in some cases, connectivity
issues and poor access performance may occur. Here are some third-party tools
to help users quickly troubleshoot connectivity issues and basic performance
problems.
diff --git a/versioned_docs/version-3.x/lakehouse/metastores/hive-metastore.md
b/versioned_docs/version-3.x/lakehouse/metastores/hive-metastore.md
index 5abefd52081..971d1f87249 100644
--- a/versioned_docs/version-3.x/lakehouse/metastores/hive-metastore.md
+++ b/versioned_docs/version-3.x/lakehouse/metastores/hive-metastore.md
@@ -226,6 +226,17 @@ The following parameters are specific to each Catalog
type, in addition to the c
'oss.endpoint' = 'oss-cn-beijing.aliyuncs.com'
);
```
+## HMS Access Port Requirements
+
+Doris requires at least the following ports to be open to access HMS:
+
+| Service | Port Purpose | Default Port | Protocol |
+|----------------|-----------------------|--------------|----------|
+| Hive Metastore | Thrift (metadata access) | 9083 | TCP |
+
+Notes:
+- Ports may be customized in `hive-site.xml`. Always follow your actual
configuration.
+- When Kerberos authentication is enabled, ensure network connectivity from
Doris to the Kerberos KDC. The KDC listens on TCP port 88 by default, unless
customized in your KDC configuration.
## Frequently Asked Questions (FAQ)
diff --git a/versioned_docs/version-3.x/lakehouse/storages/hdfs.md
b/versioned_docs/version-3.x/lakehouse/storages/hdfs.md
index 6e214cc85ba..a122dc1d70d 100644
--- a/versioned_docs/version-3.x/lakehouse/storages/hdfs.md
+++ b/versioned_docs/version-3.x/lakehouse/storages/hdfs.md
@@ -184,6 +184,19 @@ Note:
In summary, properly configuring the `dfs.client.socket-timeout` parameter can
improve I/O response speed while ensuring system stability and reliability.
+## HDFS Access Port Requirements (NameNode \& DataNode only)
+
+Doris requires the following ports to be open to access HDFS:
+
+| Service | Port Purpose | Default Port | Protocol|
+|-----------|-------------------------------|--------------|---------|
+| NameNode | RPC (client/metadata access) | 8020 |TCP |
+| DataNode | Data transfer (block I/O) | 9866 |TCP |
+
+Notes:
+- Ports may be customized in `core-site.xml` \& `hdfs-site.xml`. Use actual
configs.
+- When Kerberos authentication is enabled, Doris must also be able to reach
the Kerberos KDC service. The KDC listens on TCP port 88 by default, but the
actual port should follow your KDC configuration.
+
## Debugging HDFS
Hadoop environment configuration is complex, and in some cases, connectivity
issues and poor access performance may occur. Here are some third-party tools
to help users quickly troubleshoot connectivity issues and basic performance
problems.
diff --git a/versioned_docs/version-4.x/lakehouse/metastores/hive-metastore.md
b/versioned_docs/version-4.x/lakehouse/metastores/hive-metastore.md
index 5abefd52081..971d1f87249 100644
--- a/versioned_docs/version-4.x/lakehouse/metastores/hive-metastore.md
+++ b/versioned_docs/version-4.x/lakehouse/metastores/hive-metastore.md
@@ -226,6 +226,17 @@ The following parameters are specific to each Catalog
type, in addition to the c
'oss.endpoint' = 'oss-cn-beijing.aliyuncs.com'
);
```
+## HMS Access Port Requirements
+
+Doris requires at least the following ports to be open to access HMS:
+
+| Service | Port Purpose | Default Port | Protocol |
+|----------------|-----------------------|--------------|----------|
+| Hive Metastore | Thrift (metadata access) | 9083 | TCP |
+
+Notes:
+- Ports may be customized in `hive-site.xml`. Always follow your actual
configuration.
+- When Kerberos authentication is enabled, ensure network connectivity from
Doris to the Kerberos KDC. The KDC listens on TCP port 88 by default, unless
customized in your KDC configuration.
## Frequently Asked Questions (FAQ)
diff --git a/versioned_docs/version-4.x/lakehouse/storages/hdfs.md
b/versioned_docs/version-4.x/lakehouse/storages/hdfs.md
index 6e214cc85ba..a122dc1d70d 100644
--- a/versioned_docs/version-4.x/lakehouse/storages/hdfs.md
+++ b/versioned_docs/version-4.x/lakehouse/storages/hdfs.md
@@ -184,6 +184,19 @@ Note:
In summary, properly configuring the `dfs.client.socket-timeout` parameter can
improve I/O response speed while ensuring system stability and reliability.
+## HDFS Access Port Requirements (NameNode \& DataNode only)
+
+Doris requires the following ports to be open to access HDFS:
+
+| Service | Port Purpose | Default Port | Protocol|
+|-----------|-------------------------------|--------------|---------|
+| NameNode | RPC (client/metadata access) | 8020 |TCP |
+| DataNode | Data transfer (block I/O) | 9866 |TCP |
+
+Notes:
+- Ports may be customized in `core-site.xml` \& `hdfs-site.xml`. Use actual
configs.
+- When Kerberos authentication is enabled, Doris must also be able to reach
the Kerberos KDC service. The KDC listens on TCP port 88 by default, but the
actual port should follow your KDC configuration.
+
## Debugging HDFS
Hadoop environment configuration is complex, and in some cases, connectivity
issues and poor access performance may occur. Here are some third-party tools
to help users quickly troubleshoot connectivity issues and basic performance
problems.
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
