通过安装包快速体验

TDengine IDMP 提供了丰富的功能，本文档将带领您通过安装包完成 TDengine IDMP 的安装和启动。在导入示例场景数据后，即可轻松体验元素浏览、AI 面板生成和 AI 分析等功能。

安装

TDengine IDMP 支持多种安装、部署方式，在不同的操作系统和架构下，都能够体验其强大的功能带来的便利。对操作系统和架构的支持，详见部署规划。

TDengine IDMP 的运行还需要满足以下先决条件：

• Python: 3.12 版本
• Java: 21 及以上版本
• glibc: 2.25 及以上版本

除此以外，TDengine IDMP 依赖 TDengine TSDB-Enterprise 3.3.7.0 及以上版本。在安装 TDengine IDMP 前，请确保您已安装并启动了 TDengine TSDB-Enterprise 服务。如果尚未安装，请参考：使用安装包快速体验 TDengine TSDB。如果您期望体验时序数据预测的功能，则需要安装 TDgpt, 请参考：安装包部署 TDgpt.

Linux - tar.gz 安装

1. 请点击以下链接获取最新版本的 tar.gz 安装包。请在弹出的对话框中，填写您的邮箱地址，我们会将下载链接发送到您的邮箱。
   下载 TDengine

   输入您的电子邮箱以接收下载链接

   同意涛思数据通过此邮件地址联系我

   请勾选同意，便于我们通过邮件发送安装包给您。
2. 执行以下命令，解压并安装：

   tar zxvf tdengine-idmp-enterprise-1.0.3.2-linux-generic.tar.gz
   cd tdengine-idmp-enterprise-1.0.3.2
   ./install.sh

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

   ./install.sh -h

Debian/Ubuntu - deb 安装

1.从列表中下载获得最新 .deb 安装包。请在弹出的对话框中，填写您的邮箱地址，我们会将下载链接发送到您的邮箱。

下载 TDengine

输入您的电子邮箱以接收下载链接

同意涛思数据通过此邮件地址联系我

请勾选同意，便于我们通过邮件发送安装包给您。

1. 执行以下命令，安装 deb 包：

   dpkg -i tdengine-idmp-enterprise-1.0.3.2-linux-generic.deb

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

CentOS/RHEL - rpm 安装

1. 请点击以下链接获取最新版本的.rpm 安装包。请在弹出的对话框中，填写您的邮箱地址，我们会将下载链接发送到您的邮箱。
   下载 TDengine

   输入您的电子邮箱以接收下载链接

   同意涛思数据通过此邮件地址联系我

   请勾选同意，便于我们通过邮件发送安装包给您。
2. 执行以下命令，安装 rpm 包：

   rpm -ivh --nodeps tdengine-idmp-enterprise-1.0.3.2-linux-generic.rpm

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

macOS 安装

1. 请点击以下链接获取最新版本的 macOS 安装包。请在弹出的对话框中，填写您的邮箱地址，我们会将下载链接发送到您的邮箱。
   下载 TDengine

   输入您的电子邮箱以接收下载链接

   同意涛思数据通过此邮件地址联系我

   请勾选同意，便于我们通过邮件发送安装包给您。
2. 双击安装包，按照提示完成安装。
3. TDengine IDMP 的默认安装路径为 /usr/local/taos/idmp。

如果安装过程中遇到错误，请参考安装过程的常见错误及解决方案。

启动

以下步骤将演示如何启动 TDengine IDMP.

1. 配置 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
2. 测试 TDengine TSDB-Enterprise 连接：在终端中，可以使用 curl 命令测试 TDengine TSDB-Enterprise 连接的连通性，示例如下：

   curl --request POST \
     --user root:taosdata \
     --url http://192.168.1.100:6041/rest/sql \
     --data 'show databases;'

   如果连接成功，您将看到 TDengine TSDB-Enterprise 的数据库列表。
3. 启动 TDengine IDMP 服务：

   svc-tdengine-idmp start

至此，TDengine IDMP 服务已成功启动。您可以在浏览器输入以下地址访问：http://ip:6042, 请将 ip 替换为真实的主机 IP 地址，如果在本地运行，则可以直接访问 http://localhost:6042。

关于服务启动、停止更详细的操作指南，请您参考使用安装包部署章节。为了简化安装包的部署，您还可以使用我们提供的 Ansible Playbook 来完成安装和配置，具体步骤请参考使用 Ansible Playbook 部署章节。

激活

1. 首次访问时，您需要激活服务。在填写“邮箱”和“组织”后，点击“获取激活码”按钮，系统会向您填写的邮箱发送一封激活邮件，输入邮件中的激活码后，点击“激活”按钮，即可完成激活，您将获得 15 天的免费试用期。为了方便 AI 相关功能的体验，IDMP 安装后预置了 DeepSeek 的 API key, 有效期 3 天。到期后，请在 TDengine IDMP 的“管理后台 - 连接”更新您的 API key。
2. 激活码验证通过后，会弹出“隐私配置”对话框，您可以根据需求选择信息采集项，采集的信息将帮助我们改进产品，您的业务及生产数据绝不会被采集，配置完成后，请点击“同意”按钮。

提示

如果您未在邮箱中收到验证码，请检查您邮箱中的垃圾邮件文件夹，或尝试重新获取验证码。

配置用户信息

1. 激活产品后，将进入用户信息配置页面。
2. 请根据系统提示，填写您的姓名和手机号。
3. 请设置系统的登录密码。
4. 密码验证通过后，就完成了用户信息的配置，点击“继续”，将自动跳转到加载示例场景页面。

加载示例场景

为了帮助您快速上手，TDengine IDMP 内置了以下七大示例场景，您可以通过加载这些示例数据来体验系统的强大功能。

1. 公共事业：智能电表、智能水表
2. 卷烟制丝场景：卷烟厂制丝工艺
3. 车辆场景：物流企业车辆管理
4. 光伏场景：光伏发电站发电量监测
5. 油井场景：油田的油井产量监测
6. 污水处理场景：污水处理厂曝气工艺
7. 新能源集控场景：新能源集控中心监控

在以下示例中，我们将选用“公共事业”场景的数据进行演示：请您选中“公共事业”场景，然后点击“确认”按钮，系统会自动加载该场景的数据。加载过程可能需要几分钟的时间，请您耐心等待。

查看元素信息

加载示例场景后，您将进入 TDengine IDMP 的主 Web 界面，默认来到的是“元素浏览器”页面。您可以在这里查看和管理导入的元素信息。

1. 在侧边栏中选择“元素”，当“公共事业”场景加载完成后，即可查看其下具体的元素信息；
2. 在“公共事业”场景下，包含北京、河北、河南及其地级市或区县的电表、水表信息，您可以点击左侧的树形结构浏览不同的地理位置；
3. 选择北京-朝阳-三元桥街道-em-10这个元素，其代表的是北京市朝阳区三元桥街道编号为 10 的电表 (electricity meter)，点击顶部面包屑导航栏中的下拉列表，选择“通用”，查看其通用信息，可以看到其描述；在下拉列表中，选择“属性”，查看其属性信息，可以看到电流、电压等物理量属性。

体验 AI 生成面板

在 TDengine IDMP 中，最强大的功能之一是通过 AI 进行数据面板的自动生成。

1. 选择北京-朝阳-三元桥街道-em-10这个元素，点击顶部面包屑导航栏中的下拉列表，选择“面板”。
2. 如果“AI 推荐”已开启，即可在“面板”页面，查看到 AI 推荐的数据面板，点击“+ 更多推荐”按钮，系统会自动生成更多的面板供您选择。
3. 除此以外，您还可以在推荐面板下方的对话框中，以自然语言的方式告诉 AI 您想要的面板，例如：智能电表 em-10 过去 24 小时每分钟电压和电流的变化，以折线图的方式展示，然后点击“问我一下”按钮，AI 会自动生成您期望的面板。

体验 AI 分析

在 TDengine IDMP 中，AI 分析功能可以帮助您实时地感知数据的变化，当数据发生异常时，系统会自动产生相关的事件，并触发告警通知。

1. 选择北京-朝阳-三元桥街道-em-10这个元素，点击顶部面包屑导航栏中的下拉列表，选择“分析”。
2. 如果“AI 推荐”已开启，即可在“分析”页面，查看到 AI 推荐的问题，点击推荐问题右侧的“换一换”按钮，系统会自动更新推荐的问题。
3. 如果您对某个问题感兴趣，可以直接点击该问题的链接，进入分析创建页面，在这里，您可以对 AI 创建的分析进行进一步的配置和调整，确认后，点击“保存”按钮。
4. 除了使用 AI 推荐的分析以外，您还可以在推荐问题右侧的文本框中，以自然语言的方式告诉 AI 您想要分析的问题， 例如：智能电表 em-10 的功率波动超过±20% 持续 30 分钟，产生“警告”级别的告警，并计算波动幅度，然后点击回车，AI 就会自动生成您期望的分析。

下一步

至此，我们已经通过导入示例数据体验了查看元素信息和 AI 自动成功面板以及分析的功能。接下来，您可以深入了解 TDengine IDMP 的更多功能和最佳实践，以便更好地利用其强大的数据管理和分析能力。