使用安装包部署

先决条件

注意

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

TDengine IDMP 的运行需要以下基础依赖：

1. Python: 3.12 版本
2. Java: 21 及以上版本
3. glibc: 2.25 及以上版本
4. TDengine TSDB-Enterprise: 3.3.7.0 及以上版本
5. 可用的 SMTP 邮件服务（当无法访问 Internet 时，需要在内网部署）
6. 正确的时区，关于时区的设置，请参考操作系统的用户手册

安装

请根据您的操作系统类型，选择合适的安装方式，安装 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 的配置文件，默认位于 :

• Linux/macOS: /usr/local/taos/idmp/config/application.yml
• Windows: C:\TDengine\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

完整配置参考

如需查看完整的 IDMP 配置文件说明，请参考：TDengine IDMP 配置文件参考

完成以上配置后，就可以启动 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 目录下的日志，获取更多信息。

Windows 系统

安装完成后，TDengine IDMP 的三个服务会自动注册为 Windows 服务，但默认不会自动启动。您可以使用以下命令启动服务。

使用批处理脚本启动（推荐）：

C:\TDengine\idmp\bin\start-tdengine-idmp.bat

使用 Windows 服务管理器：

1. 按 Win + R，输入 services.msc 打开服务管理器
2. 找到以下三个服务并依次启动：
   • tdengine-idmp-h2
   • tdengine-idmp-chat
   • tdengine-idmp

使用 sc 命令：

sc.exe start tdengine-idmp-h2
sc.exe start tdengine-idmp-chat
sc.exe start tdengine-idmp

查看服务状态：

或使用 sc 命令：

sc.exe query tdengine-idmp-h2
sc.exe query tdengine-idmp-chat
sc.exe query tdengine-idmp

停止服务：

C:\TDengine\idmp\bin\stop-tdengine-idmp.bat

或使用 sc 命令：

sc.exe stop tdengine-idmp
sc.exe stop tdengine-idmp-chat
sc.exe stop tdengine-idmp-h2

信息

• 执行批处理脚本时需要管理员权限。如果遇到权限问题，请右键点击脚本文件，选择"以管理员身份运行"。
• 服务的启动顺序很重要：必须先启动 tdengine-idmp-h2 和 tdengine-idmp-chat，最后启动 tdengine-idmp。
• 如果服务异常，请查看 C:\TDengine\log 目录下的日志文件，或使用事件查看器查看 Windows 系统日志。

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

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

卸载

Linux/macOS 系统

可以通过如下命令卸载 TDengine IDMP 服务：

rmidmp -e yes

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

rmidmp -e no

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

rpm -e tdengine-idmp

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

dpkg -r tdengine-idmp

Windows 系统

在 Windows 系统上卸载 TDengine IDMP：

直接双击运行 C:\TDengine\idmp\unins000.exe，按照卸载向导完成卸载。

升级说明

TDengine IDMP 推荐使用安装脚本进行升级。安装脚本会自动检测现有安装环境，并根据实际情况选择升级模式，确保用户数据和配置文件安全。具体说明如下：

• 升级模式自动检测：安装脚本会自动判断是否为升级安装。
• 数据与配置保护：在升级模式下，安装脚本不会覆盖或修改以下目录及其内容：

Linux/macOS

• data/idmp：用户数据目录
• idmp/venv：Python 虚拟环境
• idmp/config：配置文件目录
• logs：日志目录

Windows

• data\idmp：用户数据目录
• idmp\venv：Python 虚拟环境
• idmp\config：配置文件目录
• logs：日志目录

• 仅更新程序文件：升级时仅更新核心程序文件和依赖，确保新版本功能可用，用户数据和配置保持不变。
• 首次安装：如果是首次安装，则会完整初始化所有目录和文件。

信息

建议始终通过官方安装脚本进行升级操作。如需手动备份数据和配置，可在升级前备份上述目录。升级完成后，建议检查服务状态和日志，确保升级成功。