********************
配置 TDengine 数据库
********************

.. _taos_config:

Zeus IoT 将 zabbix 历史数据实时同步到 TDengine 数据库中。利用 TDengine 时序数据库高效的特性，有效避免 zabbix 历史数据过大导致服务卡顿。


安装 TDengine 数据库
--------------------



获取 TDengine 数据库
^^^^^^^^^^^^^^^^^^^

可通过 `涛思官网 <https://www.taosdata.com/en/getting-started/>`_ 获取安装包

.. note::

  zeus-iot 默认使用 **RESTful connector** 连接涛思数据库。

安装 TDengine 数据库
^^^^^^^^^^^^^^^^^^^^

- **Centos/Redhat 安装**

  .. code-block:: bash

    rpm -ivh TDengine-server-2.2.0.2-Linux-x64.rpm

- **Ubuntu/Debain 安装**

  .. code-block:: bash

    dpkg -i TDengine-server-2.2.0.2-Linux-x64.deb

.. note::
  
  这里只介绍单机版涛思安装部署，安装时是以交互式安装，只需按回车。如要安装集群版涛思需要查阅 `涛思官网文档 <https://www.taosdata.com/en/documentation/>`_

- **启动 taos**

  .. code-block:: bash

    systemctl start taosd

- **创建 zeus_data 数据库**

  .. code-block:: bash

    # linux 命令行登录taos 

    $ taos

    # 创建 zeus_data 数据库

    taos> create database zeus_data;


启用 zabbix 导出功能
---------------------

- 开启导出功能

  修改 zabbix-server.conf 配置文件，如下：

  .. image:: /_static/images/doc/zh/install_guide/zabbix03.png
    :width: 800px

  - ExportDir=/data/zabbix_history 配置导出目录
  - ExportFileSize=1G 配置导出文件的大小
  - ExportType=history 配置导出的数据表


  创建导出的目录并重启 zabbix-server 使配置生效

  .. code-block:: bash

    mkdir -p /data/zabbix_history

    systemctl restart zabbix-server

- 数据同步配置
  
  编辑 application.yml 配置文件开启同步功能。

  .. code-block:: bash

    vim ./zeus-iot-bin/conf/application.yml
    ...
    # ndjson file read realtime
    server-transfer:
      selector: ${ZS_SERVER_TRANSFER:default}
      default:
        name: ${ZS_TRANSFER_NAME:zeus-transfer}
        pattern: ${ZS_TRANSFER_PATTERN:/data/zabbix_history/history-history-syncer-[0-9]{1}.ndjson}    ## /data/zabbix_history 与上面 zabbix 配置的导出目录相同
        fileMaxWait: ${ZS_TRANSFER_FILE_MAXWAIT:30}
    ...

  .. image:: /_static/images/doc/zh/install_guide/zeusiot01.png
    :width: 800px

修改 zeus-iot 数据库连接
--------------------------

.. code-block:: bash

  # 停止 zeus-iot 服务

  ./zeus-iot-bin/bin/stop.sh

  # 修改数据连接配置如下

  vim ./zeus-iot-bin/conf/application.yml
  
  ...
  # tdengine storage realtime
  storage:
  selector: ${ZS_STORAGE:tdengine}
  tdengine:
    url: ${ZS_STORAGE_TDENGINE_URL:jdbc:TAOS://127.0.0.1:6030/zeus_data} # TDEngine jdbcUrl
    user: ${ZS_STORAGE_TDENGINE_USER:root}
    password: ${ZS_STORAGE_TDENGINE_PASSWORD:taosdata}
  ...
  
  # 启动 zeus-iot 服务

  ./zeus-iot-bin/bin/startup.sh


.. note::

    系统启动日志在 ``zeus-iot-bin/logs`` 目录下，文件名分别为 ``webapp-console.log`` 和 ``zeus-iot-server.log``