This is an automated email from the ASF dual-hosted git repository.
critas pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/iotdb-docs.git
The following commit(s) were added to refs/heads/main by this push:
new 762d195d add lsof issue to FAQ (#985)
762d195d is described below
commit 762d195d1a19cd86b0dec5b6089e3d41d198becf
Author: leto-b <[email protected]>
AuthorDate: Fri Jan 30 10:39:29 2026 +0800
add lsof issue to FAQ (#985)
---
.../Environment-Requirements.md | 2 +
.../Master/Table/FAQ/Frequently-asked-questions.md | 50 ++++++++++++++++++++
.../Environment-Requirements.md | 1 +
.../Master/Tree/FAQ/Frequently-asked-questions.md | 49 ++++++++++++++++++++
.../Environment-Requirements.md | 2 +
.../latest-Table/FAQ/Frequently-asked-questions.md | 50 ++++++++++++++++++++
.../Environment-Requirements.md | 1 +
.../latest/FAQ/Frequently-asked-questions.md | 49 ++++++++++++++++++++
.../Environment-Requirements.md | 1 +
.../Master/Table/FAQ/Frequently-asked-questions.md | 53 ++++++++++++++++++++++
.../Environment-Requirements.md | 1 +
.../Master/Tree/FAQ/Frequently-asked-questions.md | 51 +++++++++++++++++++++
.../Environment-Requirements.md | 1 +
.../latest-Table/FAQ/Frequently-asked-questions.md | 53 ++++++++++++++++++++++
.../Environment-Requirements.md | 1 +
.../latest/FAQ/Frequently-asked-questions.md | 51 +++++++++++++++++++++
16 files changed, 416 insertions(+)
diff --git
a/src/UserGuide/Master/Table/Deployment-and-Maintenance/Environment-Requirements.md
b/src/UserGuide/Master/Table/Deployment-and-Maintenance/Environment-Requirements.md
index 590baa13..85555c59 100644
---
a/src/UserGuide/Master/Table/Deployment-and-Maintenance/Environment-Requirements.md
+++
b/src/UserGuide/Master/Table/Deployment-and-Maintenance/Environment-Requirements.md
@@ -149,6 +149,8 @@ Recommended disk partitioning is as follows:
lsof -i:10720 or netstat -tunp | grep 10720
# If the command outputs anything, the port is occupied.
```
+ If you encounter lsof-related errors (e.g., command not found or version
incompatibility) after running the command, refer to [lsof Troubleshooting
Guide](../FAQ/Frequently-asked-questions.md#_1-8-resolving-lsof-issues-in-iotdb-deployment).
+
- Cluster Deployment Tool Ports: When using the cluster management tool
`opskit` for installation and deployment, ensure the SSH remote connection
service is configured and port 22 is open.
```Bash
yum install openssh-server # Install SSH service
diff --git a/src/UserGuide/Master/Table/FAQ/Frequently-asked-questions.md
b/src/UserGuide/Master/Table/FAQ/Frequently-asked-questions.md
index 13d7450a..fa73bc65 100644
--- a/src/UserGuide/Master/Table/FAQ/Frequently-asked-questions.md
+++ b/src/UserGuide/Master/Table/FAQ/Frequently-asked-questions.md
@@ -130,6 +130,56 @@ Some possible improvement items:
It is an internal error introduced by Ratis 2.4.1 dependency, and we can
safely ignore this exception as it will
not affect normal operations. We will fix this message in the incoming
releases.
+### 1.8 Resolving lsof Issues in IoTDB Deployment
+
+Encountering lsof-related errors when deploying IoTDB (e.g., missing command,
version incompatibility)? How to properly install, verify, or uninstall lsof?
+
+Follow the steps below (requires root privileges, recommended to use `sudo`):
+
+1. Back up problematic version (if already exists)
+```bash
+sudo mv /bin/lsof /bin/lsof.bak 2>/dev/null || true
+```
+
+2. Install specified lsof version
+
+- Download the RPM package matching your OS version (example for CentOS 7/RHEL
7):
+ ```bash
+ sudo rpm -ivh lsof-4.87-6.el7.x86_64.rpm
+ ```
+
+ > **Tips**:
+ > - Select the correct RPM package based on your system version (e.g., `el8`
for CentOS 8).
+ > - If `lsof` was previously installed via `yum/dnf`, uninstall first: `sudo
yum remove lsof`.
+
+3. Verify installation
+```bash
+lsof -v # Expected output: version number (e.g., revision 4.87)
+```
+
+4. Fix command path issues (if encountering `-bash: /bin/lsof: No such file or
directory`)
+```bash
+which lsof # Check actual installation path (example output:
/usr/sbin/lsof)
+sudo ln -sf $(which lsof) /bin/lsof # Create symbolic link to standard path
+```
+
+5. Uninstall lsof (if needed)
+- For RPM-installed versions:
+ ```bash
+ sudo rpm -e lsof
+ ```
+- For YUM/DNF-installed versions:
+ ```bash
+ sudo yum remove lsof # CentOS/RHEL 7
+ sudo dnf remove lsof # CentOS/RHEL 8+
+ ```
+
+Notes:
+- **Ensure the RPM package is from a reliable source** before proceeding to
avoid security risks.
+- **Adjust paths based on `which lsof` output** – do not copy example paths
directly.
+- **Back up critical configurations** before performing operations in a
production environment.
+
+
## 2. FAQ for Cluster Setup
### 2.1 Cluster StartUp and Stop
diff --git
a/src/UserGuide/Master/Tree/Deployment-and-Maintenance/Environment-Requirements.md
b/src/UserGuide/Master/Tree/Deployment-and-Maintenance/Environment-Requirements.md
index 69dcd665..a909bec8 100644
---
a/src/UserGuide/Master/Tree/Deployment-and-Maintenance/Environment-Requirements.md
+++
b/src/UserGuide/Master/Tree/Deployment-and-Maintenance/Environment-Requirements.md
@@ -141,6 +141,7 @@ lsof -i:10710 or netstat -tunp | grep 10710
lsof -i:10720 or netstat -tunp | grep 10720
# If the command outputs, the port is occupied.
```
+If you encounter lsof-related errors (e.g., command not found or version
incompatibility) after running the command, refer to [lsof Troubleshooting
Guide](../FAQ/Frequently-asked-questions.md#_1-11-resolving-lsof-issues-in-iotdb-deployment).
(2) Checking the port occupied by the cluster deployment tool: When using the
cluster management tool opskit to install and deploy the cluster, enable the
SSH remote connection service configuration and open port 22.
diff --git a/src/UserGuide/Master/Tree/FAQ/Frequently-asked-questions.md
b/src/UserGuide/Master/Tree/FAQ/Frequently-asked-questions.md
index abb80ab9..e319dee2 100644
--- a/src/UserGuide/Master/Tree/FAQ/Frequently-asked-questions.md
+++ b/src/UserGuide/Master/Tree/FAQ/Frequently-asked-questions.md
@@ -179,6 +179,55 @@ Some possible improvement items:
It is an internal error introduced by Ratis 2.4.1 dependency, and we can
safely ignore this exception as it will
not affect normal operations. We will fix this message in the incoming
releases.
+### 1.11 Resolving lsof Issues in IoTDB Deployment
+
+Encountering lsof-related errors when deploying IoTDB (e.g., missing command,
version incompatibility)? How to properly install, verify, or uninstall lsof?
+
+Follow the steps below (requires root privileges, recommended to use `sudo`):
+
+1. Back up problematic version (if already exists)
+```bash
+sudo mv /bin/lsof /bin/lsof.bak 2>/dev/null || true
+```
+
+2. Install specified lsof version
+
+- Download the RPM package matching your OS version (example for CentOS 7/RHEL
7):
+ ```bash
+ sudo rpm -ivh lsof-4.87-6.el7.x86_64.rpm
+ ```
+
+ > **Tips**:
+ > - Select the correct RPM package based on your system version (e.g., `el8`
for CentOS 8).
+ > - If `lsof` was previously installed via `yum/dnf`, uninstall first: `sudo
yum remove lsof`.
+
+3. Verify installation
+```bash
+lsof -v # Expected output: version number (e.g., revision 4.87)
+```
+
+4. Fix command path issues (if encountering `-bash: /bin/lsof: No such file or
directory`)
+```bash
+which lsof # Check actual installation path (example output:
/usr/sbin/lsof)
+sudo ln -sf $(which lsof) /bin/lsof # Create symbolic link to standard path
+```
+
+5. Uninstall lsof (if needed)
+- For RPM-installed versions:
+ ```bash
+ sudo rpm -e lsof
+ ```
+- For YUM/DNF-installed versions:
+ ```bash
+ sudo yum remove lsof # CentOS/RHEL 7
+ sudo dnf remove lsof # CentOS/RHEL 8+
+ ```
+
+Notes:
+- **Ensure the RPM package is from a reliable source** before proceeding to
avoid security risks.
+- **Adjust paths based on `which lsof` output** – do not copy example paths
directly.
+- **Back up critical configurations** before performing operations in a
production environment.
+
## 2. FAQ for Cluster Setup
### 2.1 Cluster StartUp and Stop
diff --git
a/src/UserGuide/latest-Table/Deployment-and-Maintenance/Environment-Requirements.md
b/src/UserGuide/latest-Table/Deployment-and-Maintenance/Environment-Requirements.md
index 590baa13..85555c59 100644
---
a/src/UserGuide/latest-Table/Deployment-and-Maintenance/Environment-Requirements.md
+++
b/src/UserGuide/latest-Table/Deployment-and-Maintenance/Environment-Requirements.md
@@ -149,6 +149,8 @@ Recommended disk partitioning is as follows:
lsof -i:10720 or netstat -tunp | grep 10720
# If the command outputs anything, the port is occupied.
```
+ If you encounter lsof-related errors (e.g., command not found or version
incompatibility) after running the command, refer to [lsof Troubleshooting
Guide](../FAQ/Frequently-asked-questions.md#_1-8-resolving-lsof-issues-in-iotdb-deployment).
+
- Cluster Deployment Tool Ports: When using the cluster management tool
`opskit` for installation and deployment, ensure the SSH remote connection
service is configured and port 22 is open.
```Bash
yum install openssh-server # Install SSH service
diff --git a/src/UserGuide/latest-Table/FAQ/Frequently-asked-questions.md
b/src/UserGuide/latest-Table/FAQ/Frequently-asked-questions.md
index 13d7450a..fa73bc65 100644
--- a/src/UserGuide/latest-Table/FAQ/Frequently-asked-questions.md
+++ b/src/UserGuide/latest-Table/FAQ/Frequently-asked-questions.md
@@ -130,6 +130,56 @@ Some possible improvement items:
It is an internal error introduced by Ratis 2.4.1 dependency, and we can
safely ignore this exception as it will
not affect normal operations. We will fix this message in the incoming
releases.
+### 1.8 Resolving lsof Issues in IoTDB Deployment
+
+Encountering lsof-related errors when deploying IoTDB (e.g., missing command,
version incompatibility)? How to properly install, verify, or uninstall lsof?
+
+Follow the steps below (requires root privileges, recommended to use `sudo`):
+
+1. Back up problematic version (if already exists)
+```bash
+sudo mv /bin/lsof /bin/lsof.bak 2>/dev/null || true
+```
+
+2. Install specified lsof version
+
+- Download the RPM package matching your OS version (example for CentOS 7/RHEL
7):
+ ```bash
+ sudo rpm -ivh lsof-4.87-6.el7.x86_64.rpm
+ ```
+
+ > **Tips**:
+ > - Select the correct RPM package based on your system version (e.g., `el8`
for CentOS 8).
+ > - If `lsof` was previously installed via `yum/dnf`, uninstall first: `sudo
yum remove lsof`.
+
+3. Verify installation
+```bash
+lsof -v # Expected output: version number (e.g., revision 4.87)
+```
+
+4. Fix command path issues (if encountering `-bash: /bin/lsof: No such file or
directory`)
+```bash
+which lsof # Check actual installation path (example output:
/usr/sbin/lsof)
+sudo ln -sf $(which lsof) /bin/lsof # Create symbolic link to standard path
+```
+
+5. Uninstall lsof (if needed)
+- For RPM-installed versions:
+ ```bash
+ sudo rpm -e lsof
+ ```
+- For YUM/DNF-installed versions:
+ ```bash
+ sudo yum remove lsof # CentOS/RHEL 7
+ sudo dnf remove lsof # CentOS/RHEL 8+
+ ```
+
+Notes:
+- **Ensure the RPM package is from a reliable source** before proceeding to
avoid security risks.
+- **Adjust paths based on `which lsof` output** – do not copy example paths
directly.
+- **Back up critical configurations** before performing operations in a
production environment.
+
+
## 2. FAQ for Cluster Setup
### 2.1 Cluster StartUp and Stop
diff --git
a/src/UserGuide/latest/Deployment-and-Maintenance/Environment-Requirements.md
b/src/UserGuide/latest/Deployment-and-Maintenance/Environment-Requirements.md
index 69dcd665..a909bec8 100644
---
a/src/UserGuide/latest/Deployment-and-Maintenance/Environment-Requirements.md
+++
b/src/UserGuide/latest/Deployment-and-Maintenance/Environment-Requirements.md
@@ -141,6 +141,7 @@ lsof -i:10710 or netstat -tunp | grep 10710
lsof -i:10720 or netstat -tunp | grep 10720
# If the command outputs, the port is occupied.
```
+If you encounter lsof-related errors (e.g., command not found or version
incompatibility) after running the command, refer to [lsof Troubleshooting
Guide](../FAQ/Frequently-asked-questions.md#_1-11-resolving-lsof-issues-in-iotdb-deployment).
(2) Checking the port occupied by the cluster deployment tool: When using the
cluster management tool opskit to install and deploy the cluster, enable the
SSH remote connection service configuration and open port 22.
diff --git a/src/UserGuide/latest/FAQ/Frequently-asked-questions.md
b/src/UserGuide/latest/FAQ/Frequently-asked-questions.md
index abb80ab9..e319dee2 100644
--- a/src/UserGuide/latest/FAQ/Frequently-asked-questions.md
+++ b/src/UserGuide/latest/FAQ/Frequently-asked-questions.md
@@ -179,6 +179,55 @@ Some possible improvement items:
It is an internal error introduced by Ratis 2.4.1 dependency, and we can
safely ignore this exception as it will
not affect normal operations. We will fix this message in the incoming
releases.
+### 1.11 Resolving lsof Issues in IoTDB Deployment
+
+Encountering lsof-related errors when deploying IoTDB (e.g., missing command,
version incompatibility)? How to properly install, verify, or uninstall lsof?
+
+Follow the steps below (requires root privileges, recommended to use `sudo`):
+
+1. Back up problematic version (if already exists)
+```bash
+sudo mv /bin/lsof /bin/lsof.bak 2>/dev/null || true
+```
+
+2. Install specified lsof version
+
+- Download the RPM package matching your OS version (example for CentOS 7/RHEL
7):
+ ```bash
+ sudo rpm -ivh lsof-4.87-6.el7.x86_64.rpm
+ ```
+
+ > **Tips**:
+ > - Select the correct RPM package based on your system version (e.g., `el8`
for CentOS 8).
+ > - If `lsof` was previously installed via `yum/dnf`, uninstall first: `sudo
yum remove lsof`.
+
+3. Verify installation
+```bash
+lsof -v # Expected output: version number (e.g., revision 4.87)
+```
+
+4. Fix command path issues (if encountering `-bash: /bin/lsof: No such file or
directory`)
+```bash
+which lsof # Check actual installation path (example output:
/usr/sbin/lsof)
+sudo ln -sf $(which lsof) /bin/lsof # Create symbolic link to standard path
+```
+
+5. Uninstall lsof (if needed)
+- For RPM-installed versions:
+ ```bash
+ sudo rpm -e lsof
+ ```
+- For YUM/DNF-installed versions:
+ ```bash
+ sudo yum remove lsof # CentOS/RHEL 7
+ sudo dnf remove lsof # CentOS/RHEL 8+
+ ```
+
+Notes:
+- **Ensure the RPM package is from a reliable source** before proceeding to
avoid security risks.
+- **Adjust paths based on `which lsof` output** – do not copy example paths
directly.
+- **Back up critical configurations** before performing operations in a
production environment.
+
## 2. FAQ for Cluster Setup
### 2.1 Cluster StartUp and Stop
diff --git
a/src/zh/UserGuide/Master/Table/Deployment-and-Maintenance/Environment-Requirements.md
b/src/zh/UserGuide/Master/Table/Deployment-and-Maintenance/Environment-Requirements.md
index a72108a4..d48ad448 100644
---
a/src/zh/UserGuide/Master/Table/Deployment-and-Maintenance/Environment-Requirements.md
+++
b/src/zh/UserGuide/Master/Table/Deployment-and-Maintenance/Environment-Requirements.md
@@ -153,6 +153,7 @@ lsof -i:10710 或 netstat -tunp | grep 10710
lsof -i:10720 或 netstat -tunp | grep 10720
#如果命令有输出，则表示该端口已被占用。
```
+若执行命令后提示 lsof 相关错误（如命令缺失、版本不兼容等），可参考[lsof
异常处理方式](../FAQ/Frequently-asked-questions.md#_1-8-部署-IoTDB-时提示-lsof-相关错误-如命令缺失-版本不兼容等-如何正确安装-验证或卸载-lsof)
（2）集群部署工具占用端口的检查：使用集群管理工具opskit安装部署集群时，需打开SSH远程连接服务配置，并开放22号端口。
diff --git a/src/zh/UserGuide/Master/Table/FAQ/Frequently-asked-questions.md
b/src/zh/UserGuide/Master/Table/FAQ/Frequently-asked-questions.md
index 0f78db15..59eace3c 100644
--- a/src/zh/UserGuide/Master/Table/FAQ/Frequently-asked-questions.md
+++ b/src/zh/UserGuide/Master/Table/FAQ/Frequently-asked-questions.md
@@ -130,6 +130,59 @@ datanode_memory_proportion参数控制分给查询的内存，chunk_timeseriesme
- 添加 align by device，会按照device顺序进行输出，内存占用会降低至单device级别。
+### 1.8 部署 IoTDB 时提示 lsof 相关错误（如命令缺失、版本不兼容等），如何正确安装、验证或卸载 lsof？
+
+请按以下步骤操作（需 root 权限，建议使用 `sudo`）：
+
+1. 备份异常版本（如已存在）
+
+```bash
+sudo mv /bin/lsof /bin/lsof.bak 2>/dev/null || true
+```
+
+2. 安装指定版本 lsof
+
+- 下载与操作系统匹配的 RPM 包（示例为 CentOS 7/RHEL 7）：
+
+ ```bash
+ sudo rpm -ivh lsof-4.87-6.el7.x86_64.rpm
+ ```
+
+ > 提示：
+ > 请根据实际系统版本选择对应 RPM 包（如 el8 用于 CentOS 8）。
+ > 若系统已通过 `yum/dnf` 安装过 lsof，建议先卸载：`sudo yum remove lsof`。
+
+3. 验证安装
+
+```bash
+lsof -v # 正常应输出版本号（如 revision 4.87）
+```
+
+4. 修复命令路径问题（如遇 `-bash: /bin/lsof: 没有那个文件或目录`）
+
+```bash
+which lsof # 查看实际安装路径（示例输出：/usr/sbin/lsof）
+sudo ln -sf $(which lsof) /bin/lsof # 自动创建软链接至标准路径
+```
+
+5. 卸载 lsof（如需）
+
+- RPM 方式安装：
+ ```bash
+ sudo rpm -e lsof
+ ```
+- YUM/DNF 方式安装：
+ ```bash
+ sudo yum remove lsof # CentOS/RHEL 7
+ sudo dnf remove lsof # CentOS/RHEL 8+
+ ```
+
+注意：
+* 操作前请确认 RPM 包来源可靠，避免安全风险。
+* 路径处理请以 `which lsof` 实际输出为准，勿直接复制示例路径。
+* 生产环境操作前建议备份关键配置。
+
+
## 2. 分布式部署 FAQ
### 2.1 集群启停
diff --git
a/src/zh/UserGuide/Master/Tree/Deployment-and-Maintenance/Environment-Requirements.md
b/src/zh/UserGuide/Master/Tree/Deployment-and-Maintenance/Environment-Requirements.md
index 81b41af2..f753cde3 100644
---
a/src/zh/UserGuide/Master/Tree/Deployment-and-Maintenance/Environment-Requirements.md
+++
b/src/zh/UserGuide/Master/Tree/Deployment-and-Maintenance/Environment-Requirements.md
@@ -153,6 +153,7 @@ lsof -i:10710 或 netstat -tunp | grep 10710
lsof -i:10720 或 netstat -tunp | grep 10720
#如果命令有输出，则表示该端口已被占用。
```
+若执行命令后提示 lsof 相关错误（如命令缺失、版本不兼容等），可参考[lsof
异常处理方式](../FAQ/Frequently-asked-questions.md#_1-11-部署-IoTDB-时提示-lsof-相关错误-如命令缺失-版本不兼容等-如何正确安装-验证或卸载-lsof)
（2）集群部署工具占用端口的检查：使用集群管理工具opskit安装部署集群时，需打开SSH远程连接服务配置，并开放22号端口。
diff --git a/src/zh/UserGuide/Master/Tree/FAQ/Frequently-asked-questions.md
b/src/zh/UserGuide/Master/Tree/FAQ/Frequently-asked-questions.md
index 6fd50cc9..4b06ddcc 100644
--- a/src/zh/UserGuide/Master/Tree/FAQ/Frequently-asked-questions.md
+++ b/src/zh/UserGuide/Master/Tree/FAQ/Frequently-asked-questions.md
@@ -178,6 +178,57 @@ datanode_memory_proportion参数控制分给查询的内存，chunk_timeseriesme
- 给查询语句添加 slimit 限制，也是减少查询时间序列的一种方案。
- 添加 align by device，会按照device顺序进行输出，内存占用会降低至单device级别。
+### 1.11 部署 IoTDB 时提示 lsof 相关错误（如命令缺失、版本不兼容等），如何正确安装、验证或卸载 lsof？
+
+请按以下步骤操作（需 root 权限，建议使用 `sudo`）：
+
+1. 备份异常版本（如已存在）
+
+```bash
+sudo mv /bin/lsof /bin/lsof.bak 2>/dev/null || true
+```
+
+2. 安装指定版本 lsof
+
+- 下载与操作系统匹配的 RPM 包（示例为 CentOS 7/RHEL 7）：
+
+ ```bash
+ sudo rpm -ivh lsof-4.87-6.el7.x86_64.rpm
+ ```
+
+ > 提示：
+ > 请根据实际系统版本选择对应 RPM 包（如 el8 用于 CentOS 8）。
+ > 若系统已通过 `yum/dnf` 安装过 lsof，建议先卸载：`sudo yum remove lsof`。
+
+3. 验证安装
+
+```bash
+lsof -v # 正常应输出版本号（如 revision 4.87）
+```
+
+4. 修复命令路径问题（如遇 `-bash: /bin/lsof: 没有那个文件或目录`）
+
+```bash
+which lsof # 查看实际安装路径（示例输出：/usr/sbin/lsof）
+sudo ln -sf $(which lsof) /bin/lsof # 自动创建软链接至标准路径
+```
+
+5. 卸载 lsof（如需）
+
+- RPM 方式安装：
+ ```bash
+ sudo rpm -e lsof
+ ```
+- YUM/DNF 方式安装：
+ ```bash
+ sudo yum remove lsof # CentOS/RHEL 7
+ sudo dnf remove lsof # CentOS/RHEL 8+
+ ```
+
+注意：
+* 操作前请确认 RPM 包来源可靠，避免安全风险。
+* 路径处理请以 `which lsof` 实际输出为准，勿直接复制示例路径。
+* 生产环境操作前建议备份关键配置。
## 2. 分布式部署 FAQ
diff --git
a/src/zh/UserGuide/latest-Table/Deployment-and-Maintenance/Environment-Requirements.md
b/src/zh/UserGuide/latest-Table/Deployment-and-Maintenance/Environment-Requirements.md
index a72108a4..d48ad448 100644
---
a/src/zh/UserGuide/latest-Table/Deployment-and-Maintenance/Environment-Requirements.md
+++
b/src/zh/UserGuide/latest-Table/Deployment-and-Maintenance/Environment-Requirements.md
@@ -153,6 +153,7 @@ lsof -i:10710 或 netstat -tunp | grep 10710
lsof -i:10720 或 netstat -tunp | grep 10720
#如果命令有输出，则表示该端口已被占用。
```
+若执行命令后提示 lsof 相关错误（如命令缺失、版本不兼容等），可参考[lsof
异常处理方式](../FAQ/Frequently-asked-questions.md#_1-8-部署-IoTDB-时提示-lsof-相关错误-如命令缺失-版本不兼容等-如何正确安装-验证或卸载-lsof)
（2）集群部署工具占用端口的检查：使用集群管理工具opskit安装部署集群时，需打开SSH远程连接服务配置，并开放22号端口。
diff --git a/src/zh/UserGuide/latest-Table/FAQ/Frequently-asked-questions.md
b/src/zh/UserGuide/latest-Table/FAQ/Frequently-asked-questions.md
index 0f78db15..59eace3c 100644
--- a/src/zh/UserGuide/latest-Table/FAQ/Frequently-asked-questions.md
+++ b/src/zh/UserGuide/latest-Table/FAQ/Frequently-asked-questions.md
@@ -130,6 +130,59 @@ datanode_memory_proportion参数控制分给查询的内存，chunk_timeseriesme
- 添加 align by device，会按照device顺序进行输出，内存占用会降低至单device级别。
+### 1.8 部署 IoTDB 时提示 lsof 相关错误（如命令缺失、版本不兼容等），如何正确安装、验证或卸载 lsof？
+
+请按以下步骤操作（需 root 权限，建议使用 `sudo`）：
+
+1. 备份异常版本（如已存在）
+
+```bash
+sudo mv /bin/lsof /bin/lsof.bak 2>/dev/null || true
+```
+
+2. 安装指定版本 lsof
+
+- 下载与操作系统匹配的 RPM 包（示例为 CentOS 7/RHEL 7）：
+
+ ```bash
+ sudo rpm -ivh lsof-4.87-6.el7.x86_64.rpm
+ ```
+
+ > 提示：
+ > 请根据实际系统版本选择对应 RPM 包（如 el8 用于 CentOS 8）。
+ > 若系统已通过 `yum/dnf` 安装过 lsof，建议先卸载：`sudo yum remove lsof`。
+
+3. 验证安装
+
+```bash
+lsof -v # 正常应输出版本号（如 revision 4.87）
+```
+
+4. 修复命令路径问题（如遇 `-bash: /bin/lsof: 没有那个文件或目录`）
+
+```bash
+which lsof # 查看实际安装路径（示例输出：/usr/sbin/lsof）
+sudo ln -sf $(which lsof) /bin/lsof # 自动创建软链接至标准路径
+```
+
+5. 卸载 lsof（如需）
+
+- RPM 方式安装：
+ ```bash
+ sudo rpm -e lsof
+ ```
+- YUM/DNF 方式安装：
+ ```bash
+ sudo yum remove lsof # CentOS/RHEL 7
+ sudo dnf remove lsof # CentOS/RHEL 8+
+ ```
+
+注意：
+* 操作前请确认 RPM 包来源可靠，避免安全风险。
+* 路径处理请以 `which lsof` 实际输出为准，勿直接复制示例路径。
+* 生产环境操作前建议备份关键配置。
+
+
## 2. 分布式部署 FAQ
### 2.1 集群启停
diff --git
a/src/zh/UserGuide/latest/Deployment-and-Maintenance/Environment-Requirements.md
b/src/zh/UserGuide/latest/Deployment-and-Maintenance/Environment-Requirements.md
index 81b41af2..f753cde3 100644
---
a/src/zh/UserGuide/latest/Deployment-and-Maintenance/Environment-Requirements.md
+++
b/src/zh/UserGuide/latest/Deployment-and-Maintenance/Environment-Requirements.md
@@ -153,6 +153,7 @@ lsof -i:10710 或 netstat -tunp | grep 10710
lsof -i:10720 或 netstat -tunp | grep 10720
#如果命令有输出，则表示该端口已被占用。
```
+若执行命令后提示 lsof 相关错误（如命令缺失、版本不兼容等），可参考[lsof
异常处理方式](../FAQ/Frequently-asked-questions.md#_1-11-部署-IoTDB-时提示-lsof-相关错误-如命令缺失-版本不兼容等-如何正确安装-验证或卸载-lsof)
（2）集群部署工具占用端口的检查：使用集群管理工具opskit安装部署集群时，需打开SSH远程连接服务配置，并开放22号端口。
diff --git a/src/zh/UserGuide/latest/FAQ/Frequently-asked-questions.md
b/src/zh/UserGuide/latest/FAQ/Frequently-asked-questions.md
index 6fd50cc9..4b06ddcc 100644
--- a/src/zh/UserGuide/latest/FAQ/Frequently-asked-questions.md
+++ b/src/zh/UserGuide/latest/FAQ/Frequently-asked-questions.md
@@ -178,6 +178,57 @@ datanode_memory_proportion参数控制分给查询的内存，chunk_timeseriesme
- 给查询语句添加 slimit 限制，也是减少查询时间序列的一种方案。
- 添加 align by device，会按照device顺序进行输出，内存占用会降低至单device级别。
+### 1.11 部署 IoTDB 时提示 lsof 相关错误（如命令缺失、版本不兼容等），如何正确安装、验证或卸载 lsof？
+
+请按以下步骤操作（需 root 权限，建议使用 `sudo`）：
+
+1. 备份异常版本（如已存在）
+
+```bash
+sudo mv /bin/lsof /bin/lsof.bak 2>/dev/null || true
+```
+
+2. 安装指定版本 lsof
+
+- 下载与操作系统匹配的 RPM 包（示例为 CentOS 7/RHEL 7）：
+
+ ```bash
+ sudo rpm -ivh lsof-4.87-6.el7.x86_64.rpm
+ ```
+
+ > 提示：
+ > 请根据实际系统版本选择对应 RPM 包（如 el8 用于 CentOS 8）。
+ > 若系统已通过 `yum/dnf` 安装过 lsof，建议先卸载：`sudo yum remove lsof`。
+
+3. 验证安装
+
+```bash
+lsof -v # 正常应输出版本号（如 revision 4.87）
+```
+
+4. 修复命令路径问题（如遇 `-bash: /bin/lsof: 没有那个文件或目录`）
+
+```bash
+which lsof # 查看实际安装路径（示例输出：/usr/sbin/lsof）
+sudo ln -sf $(which lsof) /bin/lsof # 自动创建软链接至标准路径
+```
+
+5. 卸载 lsof（如需）
+
+- RPM 方式安装：
+ ```bash
+ sudo rpm -e lsof
+ ```
+- YUM/DNF 方式安装：
+ ```bash
+ sudo yum remove lsof # CentOS/RHEL 7
+ sudo dnf remove lsof # CentOS/RHEL 8+
+ ```
+
+注意：
+* 操作前请确认 RPM 包来源可靠，避免安全风险。
+* 路径处理请以 `which lsof` 实际输出为准，勿直接复制示例路径。
+* 生产环境操作前建议备份关键配置。
## 2. 分布式部署 FAQ
