使用安装包部署

先决条件

除了 TDengine TSDB-Enterprise 以外，TDengine IDMP 的运行还需要满足以下先决条件：

1. Python: 3.10-3.12 版本
2. Java: 21 及以上版本
3. glibc: 2.25 及以上版本

安装

请根据您的操作系统类型，选择合适的安装方式，安装 TDengine IDMP。以下是不同安装方式的详细步骤：

tar.gz 安装

1. 从 TDengine 产品下载中心的 TDengine IDMP 页面下载获得最新的 .tar.gz 安装包
2. 执行以下命令，解压并安装，请将 <version> 替换为实际版本号

   tar zxvf tdengine-idmp-enterprise-<version>-linux-generic.tar.gz
   cd tdengine-idmp-enterprise-<version>
   ./install.sh
   

3. TDengine IDMP 的默认安装路径为 /usr/local/taos/idmp, 安装成功后，可以看到终端展示 “TDengine IDMP has been installed successfully!”.
4. 可以通过以下命令查看更多安装选项

   ./install.sh -h
   

deb 安装

1. 从 TDengine 产品下载中心的 TDengine IDMP 页面下载获得最新的 .deb 安装包
2. 执行以下命令，安装 deb 包，请将 <version> 替换为实际版本号

   dpkg -i tdengine-idmp-enterprise-<version>-linux-generic.deb
   

3. TDengine IDMP 的默认安装路径为 /usr/local/taos/idmp, 安装成功后，可以看到终端展示 “TDengine IDMP has been installed successfully!”.

rpm 安装

1. 从 TDengine 产品下载中心的 TDengine IDMP 页面下载获得最新的 .rpm 安装包
2. 执行以下命令，安装 rpm 包，请将 <version> 替换为实际版本号

   rpm -ivh --nodeps tdengine-idmp-enterprise-<version>-linux-generic.rpm
   

3. TDengine IDMP 的默认安装路径为 /usr/local/taos/idmp, 安装成功后，可以看到终端展示 “TDengine IDMP has been installed successfully!”.

macOS 安装

1. 从 TDengine 产品下载中心的 TDengine IDMP 页面下载获得最新的 macOS 安装包 (.pkg)
2. 双击安装包，按照提示完成安装
3. TDengine IDMP 的默认安装路径为 /usr/local/taos/idmp

注意事项

IDMP 的正常运行，依赖指定版本的 Python 和 Java 环境。在安装过程中，安装脚本会对依赖进行检查。常见错误如下，以 Java 为例：

1. 安装过程中，如果遇到以下错误 “Java Version 21+ is required, but not found at: …”, 应该如何解决？

   • Java 没有安装，请安装 Java 21 或更高版本。
   • Java 已安装，但安装程序没有找到，可以通过创建软链接的方式来解决，例如：ln -s /path/to/your-java-executable /usr/local/bin/java.

2. 安装过程中，如果遇到以下错误 “Java Version 21+ is required, but version X is found at: …”, 应该如何解决？

   • Java 版本过低，请安装 Java 21 或更高版本。
   • 满足要求的 Java 已安装，但安装程序没有找到，可以通过创建软链接的方式来解决，例如：ln -s /path/to/your-java-executable /usr/local/bin/java, 如果系统中存在多个 Java 版本，请注意 PATH 的优先级。在以上报错信息中，会打印 PATH 的搜索路径，请您确保满足要求的 Java 可执行文件在 PATH 中的优先级最高。

配置

TDengine IDMP 依赖 TDengine TSDB-Enterprise 3.3.7.0+. 在启动 TDengine IDMP 之前，请配置 TDengine TSDB-Enterprise 连接。用编辑器打开 TDengine IDMP 的配置文件，默认位于 /usr/local/taos/idmp/config/application.yml。在 tda.default-connection 下，配置 TDengine TSDB-Enterprise 的连接信息，示例如下：

tda:
   default-connection:
      enable: true
      auth-type: UserPassword # can be set to UserPassword or Token
      url: http://192.168.1.100:6041
      username: root
      password: taosdata

其中：

• auth-type: 认证方式，支持 UserPassword 和 Token 两种方式，默认为方式 UserPassword
• url: 为 TDengine TSDB-Enterprise 中 taosAdapter 组件的 IP 地址和端口号，端口号默认为 6041
• username 和 password: 为 TDengine TSDB-Enterprise 的用户名和密码，默认为 root 和 taosdata

完成以上配置后，就可以启动 TDengine IDMP 服务了。

启动

Linux 系统

安装完成后，您可以使用 svc-tdengine-idmp 命令来启动 TDengine IDMP 的服务进程。

sudo svc-tdengine-idmp start

您也可以用 svc-tdengine-idmp 的其他命令来查看服务状态、停止服务等操作，例如：

sudo svc-tdengine-idmp status # 查看服务状态
sudo svc-tdengine-idmp stop   # 停止服务

您还可以直接使用 systemctl 命令，手动管理这些服务，以 tdengine-idmp 服务为例：

sudo systemctl start tdengine-idmp
sudo systemctl stop tdengine-idmp
sudo systemctl status tdengine-idmp
sudo systemctl restart tdengine-idmp

提示：

• 执行 systemctl 和 svc-tdengine-idmp 命令时，需要 root 权限，对于非 root 用户，请在命令前添加 sudo。

macOS 系统

安装完成后，您可以使用 svc-tdengine-idmp 命令来启动 TDengine IDMP 的服务进程。

sudo svc-tdengine-idmp start

您也可以用 svc-tdengine-idmp 的其他命令来查看服务状态、停止服务等操作：

sudo svc-tdengine-idmp status
sudo svc-tdengine-idmp stop

如果想手动管理这些服务，可以使用以下命令，以下示例使用 tdengine-idmp:

sudo launchctl start com.taosdata.tdengine-idmp
sudo launchctl stop com.taosdata.tdengine-idmp
sudo launchctl list | grep tdengine-idmp
sudo launchctl print system/com.taosdata.tdengine-idmp

提示

• launchctl 命令管理 com.taosdata.tdengine-idmp 需要管理员权限，务必在前面加 sudo 来增强安全性。
• sudo launchctl list | grep tdengine-idmp 指令返回的第一列是 tdengine-idmp 启动的 java 程序的 PID, 若为 - 则说明 tdengine-idmp 服务未运行。
• 如果服务异常，请查看系统日志 launchd.log 或者 /usr/local/taos/idmp/logs 目录下的日志，获取更多信息。

TDengine IDMP 正常启动后，包括以下三个服务：

• tdengine-idmp-h2：用于存储 TDengine IDMP 的元数据和配置。
• tdengine-idmp-chat：用于处理 AI 相关的任务和分析。
• tdengine-idmp：核心服务，负责管理和提供数据访问。

卸载

1. 在 Linux/macOS 系统，可以通过如下命令卸载 TDengine IDMP 服务：

rmtdengine-idmp -e yes

如果期望保留数据、日志和配置等，可以执行：

rmtdengine-idmp -e no

2. 在 Linux 系统，如果是通过 rpm 方式安装，请使用如下命令卸载：

rpm -e tdengine-idmp

3. 在 Linux 系统，如果是通过 deb 方式安装，请使用如下命令卸载：

dpkg -r tdengine-idmp

关于 TDengine

TDengine 是一款专为物联网、工业互联网等场景设计并优化的大数据平台，其核心模块是高性能、集群开源、云原生、极简的时序数据库。

它能安全高效地将大量设备每天产生的高达 TB 甚至 PB 级的数据进行汇聚、存储、分析和分发，并提供 AI 智能体对数据进行预测与异常检测，提供实时的商业洞察。