add lsof issue to FAQ

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

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

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.
 

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

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

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

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.
 

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

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号端口。
 

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 集群启停

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号端口。
 

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