使用安装包部署

先决条件

注意

TDengine IDMP 依赖 TDengine TSDB-Enterprise 3.3.7.0+, 在安装 TDengine IDMP 前，请确保您已安装并启动了 TDengine TSDB-Enterprise 服务。

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

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

安装

请根据您的操作系统类型，选择合适的安装方式，安装 TDengine IDMP。详见通过安装包快速体验。

常见错误

IDMP 的正常运行，依赖指定版本的 Java 和 Python 环境。在安装过程中，安装脚本会检查 Java 和 Python 是否已安装，版本是否满足要求，还会创建 Python 的虚拟环境并安装相关的依赖。常见错误如下：

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 中的优先级最高。
3. 安装过程中，如果遇到以下错误 "Failed to install TDengine IDMP dependencies from /usr/local/taos/idmp/chat/requirements.txt", 应该如何解决？
   • IDMP 安装过程中，需要访问互联网，以安装 AI 相关的 Python 依赖，请确保您的系统已连接互联网。
   • 网络连接正常的情况下，请确保 PyPI 仓库可以正常访问。在国内的网络中，建议配置 PyPI 镜像源来加速下载，例如：清华大学的 PyPI 镜像源，具体命令如下：pip config set global.index-url https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple
   • 更详细的安装日志，请参考：/tmp/tdengine-chat-dep-install.log

配置

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 服务：

rmidmp -e yes

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

rmidmp -e no

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

rpm -e tdengine-idmp

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

dpkg -r tdengine-idmp