远程集成

HTTP Integrations
(HTTP, Sigfox, ThingPark, OceanConnect and
T-Mobile IoT CDP)

执行以下命令拉取镜像：

docker pull thingsboard/tb-pe-http-integration:4.3.0.1PE

执行以下命令创建集成日志卷 (799 is the user id of ThingsBoard non-root docker user):

mkdir -p ~/.tb-pe-http-integration-logs && sudo chown -R 799:799 ~/.tb-pe-http-integration-logs

执行以下命令运行集成：

docker run -it -p 8082:8082 -v ~/.tb-pe-http-integration-logs:/var/log/tb-http-integration \
-e "RPC_HOST=thingsboard.cloud" -e "RPC_PORT=9090" \
-e "INTEGRATION_ROUTING_KEY=YOUR_ROUTING_KEY"  -e "INTEGRATION_SECRET=YOUR_SECRET" \
--name my-tb-pe-http-integration --restart always thingsboard/tb-pe-http-integration:4.3.0.1PE

其中：

thingsboard.cloud - 您的 ThingsBoard PE 实例的主机名；
9090 - 您的 ThingsBoard PE 实例的端口，通过 thingsboard.yml 中的 INTEGRATIONS_RPC_PORT 环境变量配置；
YOUR_ROUTING_KEY - 占位符，替换为在于 ThingsBoard 中创建远程集成时获取的集成密钥；
YOUR_SECRET - 占位符，替换为在于 ThingsBoard 中创建远程集成时获取的集成密钥；
docker run - 运行此容器；
-it - 附加到显示当前 ThingsBoard 进程输出的终端会话；
-v ~/.tb-pe-http-integration-logs:/var/log/tb-http-integration - 将主机目录 ~/.tb-pe-http-integration-logs 挂载到 ThingsBoard 日志目录；
--name tb-pe-http-integration - 容器的本地友好名称；
--restart always - 系统重启或故障后自动启动 ThingsBoard 集成；
thingsboard/tb-pe-http-integration:4.3.0.1PE - Docker 镜像。

执行此命令后可在以下位置查看日志 ~/.tb-pe-http-integration-logs。您应能看到一些带有最新从服务器接收的集成配置的 INFO 日志消息。

重新连接、停止和启动命令

要重新连接到终端（查看 ThingsBoard 日志）请运行：

docker attach tb-pe-http-integration

停止容器：

docker stop tb-pe-http-integration

启动容器：

docker start tb-pe-http-integration

执行以下命令拉取镜像：

docker pull thingsboard/tb-pe-mqtt-integration:4.3.0.1PE

执行以下命令创建集成日志卷 (799 is the user id of ThingsBoard non-root docker user):

mkdir -p ~/.tb-pe-mqtt-integration-logs && sudo chown -R 799:799 ~/.tb-pe-mqtt-integration-logs

执行以下命令运行集成：

docker run -it -v ~/.tb-pe-mqtt-integration-logs:/var/log/tb-mqtt-integration \
-e "RPC_HOST=thingsboard.cloud" -e "RPC_PORT=9090" \
-e "INTEGRATION_ROUTING_KEY=YOUR_ROUTING_KEY"  -e "INTEGRATION_SECRET=YOUR_SECRET" \
--name my-tb-pe-mqtt-integration --restart always thingsboard/tb-pe-mqtt-integration:4.3.0.1PE

其中：

thingsboard.cloud - 您的 ThingsBoard PE 实例的主机名；
9090 - 您的 ThingsBoard PE 实例的端口，通过 thingsboard.yml 中的 INTEGRATIONS_RPC_PORT 环境变量配置；
YOUR_ROUTING_KEY - 占位符，替换为在于 ThingsBoard 中创建远程集成时获取的集成密钥；
YOUR_SECRET - 占位符，替换为在于 ThingsBoard 中创建远程集成时获取的集成密钥；
docker run - 运行此容器；
-it - 附加到显示当前 ThingsBoard 进程输出的终端会话；
-v ~/.tb-pe-mqtt-integration-logs:/var/log/tb-mqtt-integration - 将主机目录 ~/.tb-pe-mqtt-integration-logs 挂载到 ThingsBoard 日志目录；
--name tb-pe-mqtt-integration - 容器的本地友好名称；
--restart always - 系统重启或故障后自动启动 ThingsBoard 集成；
thingsboard/tb-pe-mqtt-integration:4.3.0.1PE - Docker 镜像。

执行此命令后可在以下位置查看日志 ~/.tb-pe-mqtt-integration-logs。您应能看到一些带有最新从服务器接收的集成配置的 INFO 日志消息。

重新连接、停止和启动命令

要重新连接到终端（查看 ThingsBoard 日志）请运行：

docker attach tb-pe-mqtt-integration

停止容器：

docker stop tb-pe-mqtt-integration

启动容器：

docker start tb-pe-mqtt-integration

执行以下命令拉取镜像：

docker pull thingsboard/tb-pe-aws-integration:4.3.0.1PE

执行以下命令创建集成日志卷 (799 is the user id of ThingsBoard non-root docker user):

mkdir -p ~/.tb-pe-aws-integration-logs && sudo chown -R 799:799 ~/.tb-pe-aws-integration-logs

执行以下命令运行集成：

docker run -it -v ~/.tb-pe-aws-integration-logs:/var/log/tb-aws-integration \
-e "RPC_HOST=thingsboard.cloud" -e "RPC_PORT=9090" \
-e "INTEGRATION_ROUTING_KEY=YOUR_ROUTING_KEY"  -e "INTEGRATION_SECRET=YOUR_SECRET" \
--name my-tb-pe-aws-integration --restart always thingsboard/tb-pe-aws-integration:4.3.0.1PE

其中：

thingsboard.cloud - 您的 ThingsBoard PE 实例的主机名；
9090 - 您的 ThingsBoard PE 实例的端口，通过 thingsboard.yml 中的 INTEGRATIONS_RPC_PORT 环境变量配置；
YOUR_ROUTING_KEY - 占位符，替换为在于 ThingsBoard 中创建远程集成时获取的集成密钥；
YOUR_SECRET - 占位符，替换为在于 ThingsBoard 中创建远程集成时获取的集成密钥；
docker run - 运行此容器；
-it - 附加到显示当前 ThingsBoard 进程输出的终端会话；
-v ~/.tb-pe-aws-integration-logs:/var/log/tb-aws-integration - 将主机目录 ~/.tb-pe-aws-integration-logs 挂载到 ThingsBoard 日志目录；
--name tb-pe-aws-integration - 容器的本地友好名称；
--restart always - 系统重启或故障后自动启动 ThingsBoard 集成；
thingsboard/tb-pe-aws-integration:4.3.0.1PE - Docker 镜像。

执行此命令后可在以下位置查看日志 ~/.tb-pe-aws-integration-logs。您应能看到一些带有最新从服务器接收的集成配置的 INFO 日志消息。

重新连接、停止和启动命令

要重新连接到终端（查看 ThingsBoard 日志）请运行：

docker attach tb-pe-aws-integration

停止容器：

docker stop tb-pe-aws-integration

启动容器：

docker start tb-pe-aws-integration

执行以下命令拉取镜像：

docker pull thingsboard/tb-pe-azure-integration:4.3.0.1PE

执行以下命令创建集成日志卷 (799 is the user id of ThingsBoard non-root docker user):

mkdir -p ~/.tb-pe-azure-integration-logs && sudo chown -R 799:799 ~/.tb-pe-azure-integration-logs

执行以下命令运行集成：

docker run -it -v ~/.tb-pe-azure-integration-logs:/var/log/tb-azure-integration \
-e "RPC_HOST=thingsboard.cloud" -e "RPC_PORT=9090" \
-e "INTEGRATION_ROUTING_KEY=YOUR_ROUTING_KEY"  -e "INTEGRATION_SECRET=YOUR_SECRET" \
--name my-tb-pe-azure-integration --restart always thingsboard/tb-pe-azure-integration:4.3.0.1PE

其中：

thingsboard.cloud - 您的 ThingsBoard PE 实例的主机名；
9090 - 您的 ThingsBoard PE 实例的端口，通过 thingsboard.yml 中的 INTEGRATIONS_RPC_PORT 环境变量配置；
YOUR_ROUTING_KEY - 占位符，替换为在于 ThingsBoard 中创建远程集成时获取的集成密钥；
YOUR_SECRET - 占位符，替换为在于 ThingsBoard 中创建远程集成时获取的集成密钥；
docker run - 运行此容器；
-it - 附加到显示当前 ThingsBoard 进程输出的终端会话；
-v ~/.tb-pe-azure-integration-logs:/var/log/tb-azure-integration - 将主机目录 ~/.tb-pe-azure-integration-logs 挂载到 ThingsBoard 日志目录；
--name tb-pe-azure-integration - 容器的本地友好名称；
--restart always - 系统重启或故障后自动启动 ThingsBoard 集成；
thingsboard/tb-pe-azure-integration:4.3.0.1PE - Docker 镜像。

执行此命令后可在以下位置查看日志 ~/.tb-pe-azure-integration-logs。您应能看到一些带有最新从服务器接收的集成配置的 INFO 日志消息。

重新连接、停止和启动命令

要重新连接到终端（查看 ThingsBoard 日志）请运行：

docker attach tb-pe-azure-integration

停止容器：

docker stop tb-pe-azure-integration

启动容器：

docker start tb-pe-azure-integration

执行以下命令拉取镜像：

docker pull thingsboard/tb-pe-opc-ua-integration:4.3.0.1PE

执行以下命令创建集成日志卷（799 为 ThingsBoard 非 root Docker 用户 ID）：

mkdir -p ~/.tb-pe-opc-ua-integration-logs && sudo chown -R 799:799 ~/.tb-pe-opc-ua-integration-logs

执行以下命令运行集成：

docker run -it -v ~/.tb-pe-opc-ua-integration-logs:/var/log/tb-opc-ua-integration \
-e "RPC_HOST=thingsboard.cloud" -e "RPC_PORT=9090" \
-e "INTEGRATION_ROUTING_KEY=YOUR_ROUTING_KEY"  -e "INTEGRATION_SECRET=YOUR_SECRET" \
--name my-tb-pe-opc-ua-integration --restart always thingsboard/tb-pe-opc-ua-integration:4.3.0.1PE

其中：

thingsboard.cloud - 您的 ThingsBoard PE 实例的主机名；
9090 - 您的 ThingsBoard PE 实例的端口，通过 thingsboard.yml 中的 INTEGRATIONS_RPC_PORT 环境变量配置；
YOUR_ROUTING_KEY - 占位符，替换为在于 ThingsBoard 中创建远程集成时获取的集成密钥；
YOUR_SECRET - 占位符，替换为在于 ThingsBoard 中创建远程集成时获取的集成密钥；
docker run - 运行此容器；
-it - 附加到显示当前 ThingsBoard 进程输出的终端会话；
-v ~/.tb-pe-opc-ua-integration-logs:/var/log/tb-opc-ua-integration - 将主机目录 ~/.tb-pe-opc-ua-integration-logs 挂载到 ThingsBoard 日志目录；
--name tb-pe-opc-ua-integration - 容器的本地友好名称；
--restart always - 系统重启或故障后自动启动 ThingsBoard 集成；
thingsboard/tb-pe-opc-ua-integration:4.3.0.1PE - Docker 镜像。

执行此命令后可在以下位置查看日志 ~/.tb-pe-opc-ua-integration-logs。您应能看到一些带有最新从服务器接收的集成配置的 INFO 日志消息。

重新连接、停止和启动命令

要重新连接到终端（查看 ThingsBoard 日志）请运行：

docker attach tb-pe-opc-ua-integration

停止容器：

docker stop tb-pe-opc-ua-integration

启动容器：

docker start tb-pe-opc-ua-integration

执行以下命令拉取镜像：

docker pull thingsboard/tb-pe-tcp-udp-integration:4.3.0.1PE

执行以下命令创建集成日志卷 (799 is the user id of ThingsBoard non-root docker user):

mkdir -p ~/.tb-pe-tcp-udp-integration-logs && sudo chown -R 799:799 ~/.tb-pe-tcp-udp-integration-logs

执行以下命令运行集成：

docker run -it -p 10560:10560 -v ~/.tb-pe-tcp-udp-integration-logs:/var/log/tb-tcp-udp-integration  \
-e "RPC_HOST=thingsboard.cloud" -e "RPC_PORT=9090" \
-e "INTEGRATION_ROUTING_KEY=YOUR_ROUTING_KEY"  -e "INTEGRATION_SECRET=YOUR_SECRET" \
--name my-tb-pe-tcp-udp-integration --restart always thingsboard/tb-pe-tcp-udp-integration:4.3.0.1PE

其中：

thingsboard.cloud - 您的 ThingsBoard PE 实例的主机名；
9090 - 您的 ThingsBoard PE 实例的端口，通过 thingsboard.yml 中的 INTEGRATIONS_RPC_PORT 环境变量配置；
YOUR_ROUTING_KEY - 占位符，替换为在于 ThingsBoard 中创建远程集成时获取的集成密钥；
YOUR_SECRET - 占位符，替换为在于 ThingsBoard 中创建远程集成时获取的集成密钥；
docker run - 运行此容器；
-it - 附加到显示当前 ThingsBoard 进程输出的终端会话；
-p 10560:10560 - 将本地端口 10560 映射到集成的内部端口 10560。若为 UDP 端口，在末尾添加 /udp，如 -p 11560:11560/udp；
-v ~/.tb-pe-tcp-udp-integration-logs:/var/log/tb-tcp-udp-integration - 将主机目录 ~/.tb-pe-tcp-udp-integration-logs 挂载到 ThingsBoard 日志目录；
--name tb-pe-tcp-udp-integration - 容器的本地友好名称；
--restart always - 系统重启或故障后自动启动 ThingsBoard 集成；
thingsboard/tb-pe-tcp-udp-integration:4.3.0.1PE - Docker 镜像。

执行此命令后可在以下位置查看日志 ~/.tb-pe-tcp-udp-integration-logs。您应能看到一些带有最新从服务器接收的集成配置的 INFO 日志消息。

重新连接、停止和启动命令

要重新连接到终端（查看 ThingsBoard 日志）请运行：

docker attach tb-pe-tcp-udp-integration

停止容器：

docker stop tb-pe-tcp-udp-integration

启动容器：

docker start tb-pe-tcp-udp-integration

执行以下命令拉取镜像：

docker pull thingsboard/tb-pe-coap-integration:4.3.0.1PE

执行以下命令创建集成日志卷 (799 is the user id of ThingsBoard non-root docker user):

mkdir -p ~/.tb-pe-coap-integration-logs && sudo chown -R 799:799 ~/.tb-pe-coap-integration-logs

执行以下命令运行集成：

docker run -it -p 5683:5683/udp -v ~/.tb-pe-coap-integration-logs:/var/log/tb-coap-integration  \
-e "RPC_HOST=eu.thingsboard.cloud" -e "RPC_PORT=9090" \
-e "INTEGRATION_ROUTING_KEY=YOUR_ROUTING_KEY"  -e "INTEGRATION_SECRET=YOUR_SECRET" \
--name my-tb-pe-coap-integration --restart always thingsboard/tb-pe-coap-integration:4.3.0.1PE

其中：

eu.thingsboard.cloud - 您的 ThingsBoard PE 实例的主机名；
9090 - 您的 ThingsBoard PE 实例的端口，通过 thingsboard.yml 中的 INTEGRATIONS_RPC_PORT 环境变量配置；
YOUR_ROUTING_KEY - 占位符，替换为在于 ThingsBoard 中创建远程集成时获取的集成密钥；
YOUR_SECRET - 占位符，替换为在于 ThingsBoard 中创建远程集成时获取的集成密钥；
docker run - 运行此容器；
-it - 附加到显示当前 ThingsBoard 进程输出的终端会话；
-p 5683:5683/udp - 将本地 UDP 端口 5683 映射到集成的内部 UDP 端口 5683；
-v ~/.tb-pe-coap-integration-logs:/var/log/tb-coap-integration - 将主机目录 ~/.tb-pe-coap-integration-logs 挂载到 ThingsBoard 日志目录；
--name tb-pe-coap-integration - 容器的本地友好名称；
--restart always - 系统重启或故障后自动启动 ThingsBoard 集成；
thingsboard/tb-pe-coap-integration:4.3.0.1PE - Docker 镜像。

执行此命令后可在以下位置查看日志 ~/.tb-pe-coap-integration-logs。您应能看到一些带有最新从服务器接收的集成配置的 INFO 日志消息。

重新连接、停止和启动命令

要重新连接到终端（查看 ThingsBoard 日志）请运行：

docker attach tb-pe-coap-integration

停止容器：

docker stop tb-pe-coap-integration

启动容器：

docker start tb-pe-coap-integration

高级配置

下方配置 yml 文件列出了可用的配置参数、对应的环境变量及其默认值。例如，集成在调试消息中使用的默认客户端 ID 为 “remote”，可通过设置 “RPC_CLIENT_ID” 环境变量修改。

server:
  # Server bind address
  address: "${HTTP_BIND_ADDRESS:0.0.0.0}"
  # Server bind port
  port: "${HTTP_BIND_PORT:8082}"

integration:
  routingKey: "${INTEGRATION_ROUTING_KEY:PUT_YOUR_ROUTING_KEY_HERE}"
  secret: "${INTEGRATION_SECRET:PUT_YOUR_SECRET_HERE}"
  # Allows connection to the localhost resources. For example, local MQTT broker, etc.
  allow_local_network_hosts: "${INTEGRATION_ALLOW_LOCAL_NETWORK_HOSTS:true}"
  statistics:
    # Enable/disable integration statistics
    enabled: "${INTEGRATION_STATISTICS_ENABLED:true}"
    # Send statistics interval. Dfault value is once per hour
    persist_frequency: "${INTEGRATION_STATISTICS_PERSIST_FREQUENCY:3600000}"

storage:
  # Location of the folder to store data files
  data_folder_path: "${INTEGRATION_STORAGE_DATA_FOLDER_PATH:./}"
  # Max amount of data files to maintain
  max_file_count: "${INTEGRATION_STORAGE_MAX_FILE_COUNT:100}"
  # Max records per data file
  max_records_per_file: "${INTEGRATION_STORAGE_MAX_RECORDS_PER_FILE:30}"
  # Max records between persistence of data file
  max_records_between_fsync: "${INTEGRATION_STORAGE_MAX_RECORDS_BETWEEN_FSYNC:100}"
  # Size of the upload chunk
  max_read_records_count: "${INTEGRATION_STORAGE_MAX_READ_RECORDS_COUNT:50}"
  # Sleep interval while no new records
  no_read_records_sleep: "${INTEGRATION_STORAGE_NO_READ_RECORDS_SLEEP:1000}"

executors:
  # Size of the thread pool to handle incoming messages and tasks
  thread_pool_size: "${EXECUTORS_SIZE:1}"
  # Timeout to reconnect to ThingsBoard
  reconnect_timeout: "${EXECUTORS_RECONNECT_TIMEOUT:3000}" # in milliseconds

rpc:
  # Host of the ThingsBoard server
  host: "${RPC_HOST:thingsboard.cloud}"
  # Port of the ThingsBoard server
  port: "${RPC_PORT:9090}"
  # No reply timeout
  timeout: "${RPC_TIMEOUT:5}" # Timeout in seconds for channel termination
  # ID of the RPC client
  client_id: "${RPC_CLIENT_ID:remote}"
  ssl:
    # SSL enabled/disabled
    enabled: "${RPC_SSL_ENABLED:false}"
    # SSL certificate
    cert: "${RPC_SSL_CERT:roots.pem}"

js:
  evaluator: "${JS_EVALUATOR:local}"
  # Built-in JVM JavaScript environment properties
  local:
    # Use Sandboxed (secured) JVM JavaScript environment
    use_js_sandbox: "${USE_LOCAL_JS_SANDBOX:true}"
    # Specify thread pool size for JavaScript sandbox resource monitor
    monitor_thread_pool_size: "${LOCAL_JS_SANDBOX_MONITOR_THREAD_POOL_SIZE:4}"
    # Maximum CPU time in milliseconds allowed for script execution
    max_cpu_time: "${LOCAL_JS_SANDBOX_MAX_CPU_TIME:5000}"
    # Maximum allowed JavaScript execution errors before JavaScript will be blacklisted
    max_errors: "${LOCAL_JS_SANDBOX_MAX_ERRORS:3}"

service:
  type: "${TB_SERVICE_TYPE:tb-integration}"

故障排查

注意若出现与 DNS 相关的错误，例如：

127.0.1.1:53: cannot unmarshal DNS message

可将系统配置为使用 Google 公共 DNS 服务器。请参阅对应的 Linux 和 Mac OS 说明。

Windows上的Docker

安装Windows版Docker Toolbox
选择要安装的集成

MQTT Integrations
(MQTT, AWS IoT, IBM Watson, The Things Network)

HTTP Integrations
(HTTP, Sigfox, ThingPark, OceanConnect and
T-Mobile IoT CDP)

Windows 用户应使用 Docker 托管卷存储远程集成日志。在执行 docker run 命令前创建 Docker 卷（如 tb-http-integration-logs）：打开「Docker Quickstart Terminal」，执行以下命令创建卷：

docker volume create tb-pe-http-integration-logs

执行以下命令直接运行此 Docker 容器：

docker run -it -v tb-pe-http-integration-logs:/var/log/tb-http-integration `
-e "RPC_HOST=thingsboard.cloud" -e "RPC_PORT=9090" `
-e "INTEGRATION_ROUTING_KEY=YOUR_ROUTING_KEY"  -e "INTEGRATION_SECRET=YOUR_SECRET" `
--name my-tb-pe-http-integration --restart always thingsboard/tb-pe-http-integration:4.3.0.1PE

其中：

thingsboard.cloud - 您的 ThingsBoard PE 实例的主机名；
9090 - 您的 ThingsBoard PE 实例的端口，通过 thingsboard.yml 中的 INTEGRATIONS_RPC_PORT 环境变量配置；
YOUR_ROUTING_KEY - 占位符，替换为在于 ThingsBoard 中创建远程集成时获取的集成密钥；
YOUR_SECRET - 占位符，替换为在于 ThingsBoard 中创建远程集成时获取的集成密钥；
docker run - 运行此容器；
-it - 附加到显示当前 ThingsBoard 进程输出的终端会话；
-v tb-pe-http-integration-logs:/var/log/tb-http-integration - 将卷 tb-pe-http-integration-logs 挂载到 ThingsBoard 日志目录；
--name tb-pe-http-integration - 容器的本地友好名称；
--restart always - 系统重启或故障后自动启动 ThingsBoard 集成；
thingsboard/tb-pe-http-integration:4.3.0.1PE - Docker 镜像。

执行此命令后可在卷对应位置查看日志。您应能看到一些带有最新从服务器接收的集成配置的 INFO 日志消息。

重新连接、停止和启动命令

要重新连接到终端（查看 ThingsBoard 日志）请运行：

docker attach tb-pe-http-integration

停止容器：

docker stop tb-pe-http-integration

启动容器：

docker start tb-pe-http-integration

Windows 用户应使用 Docker 托管卷存储远程集成日志。在执行 docker run 命令前创建 Docker 卷（如 tb-mqtt-integration-logs）：打开「Docker Quickstart Terminal」，执行以下命令创建卷：

docker volume create tb-pe-mqtt-integration-logs

执行以下命令直接运行此 Docker 容器：

docker run -it -v tb-pe-mqtt-integration-logs:/var/log/tb-mqtt-integration `
-e "RPC_HOST=thingsboard.cloud" -e "RPC_PORT=9090" `
-e "INTEGRATION_ROUTING_KEY=YOUR_ROUTING_KEY"  -e "INTEGRATION_SECRET=YOUR_SECRET" `
--name my-tb-pe-mqtt-integration --restart always thingsboard/tb-pe-mqtt-integration:4.3.0.1PE

其中：

thingsboard.cloud - 您的 ThingsBoard PE 实例的主机名；
9090 - 您的 ThingsBoard PE 实例的端口，通过 thingsboard.yml 中的 INTEGRATIONS_RPC_PORT 环境变量配置；
YOUR_ROUTING_KEY - 占位符，替换为在于 ThingsBoard 中创建远程集成时获取的集成密钥；
YOUR_SECRET - 占位符，替换为在于 ThingsBoard 中创建远程集成时获取的集成密钥；
docker run - 运行此容器；
-it - 附加到显示当前 ThingsBoard 进程输出的终端会话；
-v tb-pe-mqtt-integration-logs:/var/log/tb-mqtt-integration - 将卷 tb-pe-mqtt-integration-logs 挂载到 ThingsBoard 日志目录；
--name tb-pe-mqtt-integration - 容器的本地友好名称；
--restart always - 系统重启或故障后自动启动 ThingsBoard 集成；
thingsboard/tb-pe-mqtt-integration:4.3.0.1PE - Docker 镜像。

执行此命令后可在卷对应位置查看日志。您应能看到一些带有最新从服务器接收的集成配置的 INFO 日志消息。

重新连接、停止和启动命令

要重新连接到终端（查看 ThingsBoard 日志）请运行：

docker attach tb-pe-mqtt-integration

停止容器：

docker stop tb-pe-mqtt-integration

启动容器：

docker start tb-pe-mqtt-integration

Windows 用户应使用 Docker 托管卷存储远程集成日志。在执行 docker run 命令前创建 Docker 卷（如 tb-aws-integration-logs）：打开「Docker Quickstart Terminal」，执行以下命令创建卷：

docker volume create tb-pe-aws-integration-logs

执行以下命令直接运行此 Docker 容器：

docker run -it -v tb-pe-aws-integration-logs:/var/log/tb-aws-integration `
-e "RPC_HOST=thingsboard.cloud" -e "RPC_PORT=9090" `
-e "INTEGRATION_ROUTING_KEY=YOUR_ROUTING_KEY"  -e "INTEGRATION_SECRET=YOUR_SECRET" `
--name my-tb-pe-aws-integration --restart always thingsboard/tb-pe-aws-integration:4.3.0.1PE

其中：

thingsboard.cloud - 您的 ThingsBoard PE 实例的主机名；
9090 - 您的 ThingsBoard PE 实例的端口，通过 thingsboard.yml 中的 INTEGRATIONS_RPC_PORT 环境变量配置；
YOUR_ROUTING_KEY - 占位符，替换为在于 ThingsBoard 中创建远程集成时获取的集成密钥；
YOUR_SECRET - 占位符，替换为在于 ThingsBoard 中创建远程集成时获取的集成密钥；
docker run - 运行此容器；
-it - 附加到显示当前 ThingsBoard 进程输出的终端会话；
-v tb-pe-aws-integration-logs:/var/log/tb-aws-integration - 将卷 tb-pe-aws-integration-logs 挂载到 ThingsBoard 日志目录；
--name tb-pe-aws-integration - 容器的本地友好名称；
--restart always - 系统重启或故障后自动启动 ThingsBoard 集成；
thingsboard/tb-pe-aws-integration:4.3.0.1PE - Docker 镜像。

执行此命令后可在卷对应位置查看日志。您应能看到一些带有最新从服务器接收的集成配置的 INFO 日志消息。

重新连接、停止和启动命令

要重新连接到终端（查看 ThingsBoard 日志）请运行：

docker attach tb-pe-aws-integration

停止容器：

docker stop tb-pe-aws-integration

启动容器：

docker start tb-pe-aws-integration

Windows 用户应使用 Docker 托管卷存储远程集成日志。在执行 docker run 命令前创建 Docker 卷（如 tb-azure-integration-logs）：打开「Docker Quickstart Terminal」，执行以下命令创建卷：

docker volume create tb-pe-azure-integration-logs

执行以下命令运行此 Docker：

docker run -it -v tb-pe-azure-integration-logs:/var/log/tb-azure-integration `
-e "RPC_HOST=thingsboard.cloud" -e "RPC_PORT=9090" `
-e "INTEGRATION_ROUTING_KEY=YOUR_ROUTING_KEY"  -e "INTEGRATION_SECRET=YOUR_SECRET" `
--name my-tb-pe-azure-integration --restart always thingsboard/tb-pe-azure-integration:4.3.0.1PE

其中：

thingsboard.cloud - 您的 ThingsBoard PE 实例的主机名；
9090 - 您的 ThingsBoard PE 实例的端口，通过 thingsboard.yml 中的 INTEGRATIONS_RPC_PORT 环境变量配置；
YOUR_ROUTING_KEY - 占位符，替换为在于 ThingsBoard 中创建远程集成时获取的集成密钥；
YOUR_SECRET - 占位符，替换为在于 ThingsBoard 中创建远程集成时获取的集成密钥；
docker run - 运行此容器；
-it - 附加到显示当前 ThingsBoard 进程输出的终端会话；
-v tb-pe-azure-integration-logs:/var/log/tb-azure-integration - 将卷 tb-pe-azure-integration-logs 挂载到 ThingsBoard 日志目录；
--name tb-pe-azure-integration - 容器的本地友好名称；
--restart always - 系统重启或故障后自动启动 ThingsBoard 集成；
thingsboard/tb-pe-azure-integration:4.3.0.1PE - Docker 镜像。

执行此命令后可在卷对应位置查看日志。您应能看到一些带有最新从服务器接收的集成配置的 INFO 日志消息。

重新连接、停止和启动命令

要重新连接到终端（查看 ThingsBoard 日志）请运行：

docker attach tb-pe-azure-integration

停止容器：

docker stop tb-pe-azure-integration

启动容器：

docker start tb-pe-azure-integration

Windows 用户应使用 Docker 托管卷存储远程集成日志。在执行 docker run 命令前创建 Docker 卷（如 tb-opc-ua-integration-logs）：打开「Docker Quickstart Terminal」，执行以下命令创建卷：

docker volume create tb-pe-opc-ua-integration-logs

执行以下命令运行此 Docker：

docker run -it -v tb-pe-opc-ua-integration-logs:/var/log/tb-opc-ua-integration `
-e "RPC_HOST=thingsboard.cloud" -e "RPC_PORT=9090" `
-e "INTEGRATION_ROUTING_KEY=YOUR_ROUTING_KEY"  -e "INTEGRATION_SECRET=YOUR_SECRET" `
--name my-tb-pe-opc-ua-integration --restart always thingsboard/tb-pe-opc-ua-integration:4.3.0.1PE

其中：

thingsboard.cloud - 您的 ThingsBoard PE 实例的主机名；
9090 - 您的 ThingsBoard PE 实例的端口，通过 thingsboard.yml 中的 INTEGRATIONS_RPC_PORT 环境变量配置；
YOUR_ROUTING_KEY - 占位符，替换为在于 ThingsBoard 中创建远程集成时获取的集成密钥；
YOUR_SECRET - 占位符，替换为在于 ThingsBoard 中创建远程集成时获取的集成密钥；
docker run - 运行此容器；
-it - 附加到显示当前 ThingsBoard 进程输出的终端会话；
-v tb-pe-opc-ua-integration-logs:/var/log/tb-opc-ua-integration - 将卷 tb-pe-opc-ua-integration-logs 挂载到 ThingsBoard 日志目录；
--name tb-pe-opc-ua-integration - 容器的本地友好名称；
--restart always - 系统重启或故障后自动启动 ThingsBoard 集成；
thingsboard/tb-pe-opc-ua-integration:4.3.0.1PE - Docker 镜像。

执行此命令后可在卷对应位置查看日志。您应能看到一些带有最新从服务器接收的集成配置的 INFO 日志消息。

重新连接、停止和启动命令

要重新连接到终端（查看 ThingsBoard 日志）请运行：

docker attach tb-pe-opc-ua-integration

停止容器：

docker stop tb-pe-opc-ua-integration

启动容器：

docker start tb-pe-opc-ua-integration

Windows 用户应使用 Docker 托管卷存储远程集成日志。在执行 docker run 命令前创建 Docker 卷（如 tb-tcp-udp-integration-logs）：打开「Docker Quickstart Terminal」，执行以下命令创建卷：

docker volume create tb-pe-tcp-udp-integration-logs

执行以下命令运行此 Docker：

docker run -it -p 10560:10560 -v tb-pe-tcp-udp-integration-logs:/var/log/tb-tcp-udp-integration `
-e "RPC_HOST=thingsboard.cloud" -e "RPC_PORT=9090" `
-e "INTEGRATION_ROUTING_KEY=YOUR_ROUTING_KEY"  -e "INTEGRATION_SECRET=YOUR_SECRET" `
--name my-tb-pe-tcp-udp-integration --restart always thingsboard/tb-pe-tcp-udp-integration:4.3.0.1PE

其中：

thingsboard.cloud - 您的 ThingsBoard PE 实例的主机名；
9090 - 您的 ThingsBoard PE 实例的端口，通过 thingsboard.yml 中的 INTEGRATIONS_RPC_PORT 环境变量配置；
YOUR_ROUTING_KEY - 占位符，替换为在于 ThingsBoard 中创建远程集成时获取的集成密钥；
YOUR_SECRET - 占位符，替换为在于 ThingsBoard 中创建远程集成时获取的集成密钥；
docker run - 运行此容器；
-it - 附加到显示当前 ThingsBoard 进程输出的终端会话；
-p 10560:10560 - 将本地端口 10560 映射到集成的内部端口 10560；
-v tb-pe-tcp-udp-integration-logs:/var/log/tb-tcp-udp-integration - 将卷 tb-pe-tcp-udp-integration-logs 挂载到 ThingsBoard 日志目录；
--name tb-pe-tcp-udp-integration - 容器的本地友好名称；
--restart always - 系统重启或故障后自动启动 ThingsBoard 集成；
thingsboard/tb-pe-tcp-udp-integration:4.3.0.1PE - Docker 镜像。

执行此命令后可在卷对应位置查看日志。您应能看到一些带有最新从服务器接收的集成配置的 INFO 日志消息。

重新连接、停止和启动命令

要重新连接到终端（查看 ThingsBoard 日志）请运行：

docker attach tb-pe-tcp-udp-integration

停止容器：

docker stop tb-pe-tcp-udp-integration

启动容器：

docker start tb-pe-tcp-udp-integration

Windows 用户应使用 Docker 托管卷存储远程集成日志。在执行 docker run 命令前创建 Docker 卷（如 tb-coap-integration-logs）：打开「Docker Quickstart Terminal」，执行以下命令创建卷：

docker volume create tb-pe-coap-integration-logs

执行以下命令运行此 Docker：

docker run -it -p 5683:5683/udp -v tb-pe-coap-integration-logs:/var/log/tb-coap-integration `
-e "RPC_HOST=thingsboard.cloud" -e "RPC_PORT=9090" `
-e "INTEGRATION_ROUTING_KEY=YOUR_ROUTING_KEY"  -e "INTEGRATION_SECRET=YOUR_SECRET" `
--name my-tb-pe-coap-integration --restart always thingsboard/tb-pe-coap-integration:4.3.0.1PE

其中：

thingsboard.cloud - 您的 ThingsBoard PE 实例的主机名；
9090 - 您的 ThingsBoard PE 实例的端口，通过 thingsboard.yml 中的 INTEGRATIONS_RPC_PORT 环境变量配置；
YOUR_ROUTING_KEY - 占位符，替换为在于 ThingsBoard 中创建远程集成时获取的集成密钥；
YOUR_SECRET - 占位符，替换为在于 ThingsBoard 中创建远程集成时获取的集成密钥；
docker run - 运行此容器；
-it - 附加到显示当前 ThingsBoard 进程输出的终端会话；
-p 5683:5683/udp - 将本地 UDP 端口 5683 映射到集成的内部 UDP 端口 5683；
-v tb-pe-coap-integration-logs:/var/log/tb-coap-integration - 将卷 tb-pe-coap-integration-logs 挂载到 ThingsBoard 日志目录；
--name tb-pe-coap-integration - 容器的本地友好名称；
--restart always - 系统重启或故障后自动启动 ThingsBoard 集成；
thingsboard/tb-pe-coap-integration:4.3.0.1PE - Docker 镜像。

执行此命令后可在卷对应位置查看日志。您应能看到一些带有最新从服务器接收的集成配置的 INFO 日志消息。

重新连接、停止和启动命令

要重新连接到终端（查看 ThingsBoard 日志）请运行：

docker attach tb-pe-coap-integration

停止容器：

docker stop tb-pe-coap-integration

启动容器：

docker start tb-pe-coap-integration

高级配置

server:
  # Server bind address
  address: "${HTTP_BIND_ADDRESS:0.0.0.0}"
  # Server bind port
  port: "${HTTP_BIND_PORT:8082}"

integration:
  routingKey: "${INTEGRATION_ROUTING_KEY:PUT_YOUR_ROUTING_KEY_HERE}"
  secret: "${INTEGRATION_SECRET:PUT_YOUR_SECRET_HERE}"
  # Allows connection to the localhost resources. For example, local MQTT broker, etc.
  allow_local_network_hosts: "${INTEGRATION_ALLOW_LOCAL_NETWORK_HOSTS:true}"
  statistics:
    # Enable/disable integration statistics
    enabled: "${INTEGRATION_STATISTICS_ENABLED:true}"
    # Send statistics interval. Dfault value is once per hour
    persist_frequency: "${INTEGRATION_STATISTICS_PERSIST_FREQUENCY:3600000}"

storage:
  # Location of the folder to store data files
  data_folder_path: "${INTEGRATION_STORAGE_DATA_FOLDER_PATH:./}"
  # Max amount of data files to maintain
  max_file_count: "${INTEGRATION_STORAGE_MAX_FILE_COUNT:100}"
  # Max records per data file
  max_records_per_file: "${INTEGRATION_STORAGE_MAX_RECORDS_PER_FILE:30}"
  # Max records between persistence of data file
  max_records_between_fsync: "${INTEGRATION_STORAGE_MAX_RECORDS_BETWEEN_FSYNC:100}"
  # Size of the upload chunk
  max_read_records_count: "${INTEGRATION_STORAGE_MAX_READ_RECORDS_COUNT:50}"
  # Sleep interval while no new records
  no_read_records_sleep: "${INTEGRATION_STORAGE_NO_READ_RECORDS_SLEEP:1000}"

executors:
  # Size of the thread pool to handle incoming messages and tasks
  thread_pool_size: "${EXECUTORS_SIZE:1}"
  # Timeout to reconnect to ThingsBoard
  reconnect_timeout: "${EXECUTORS_RECONNECT_TIMEOUT:3000}" # in milliseconds

rpc:
  # Host of the ThingsBoard server
  host: "${RPC_HOST:thingsboard.cloud}"
  # Port of the ThingsBoard server
  port: "${RPC_PORT:9090}"
  # No reply timeout
  timeout: "${RPC_TIMEOUT:5}" # Timeout in seconds for channel termination
  # ID of the RPC client
  client_id: "${RPC_CLIENT_ID:remote}"
  ssl:
    # SSL enabled/disabled
    enabled: "${RPC_SSL_ENABLED:false}"
    # SSL certificate
    cert: "${RPC_SSL_CERT:roots.pem}"

js:
  evaluator: "${JS_EVALUATOR:local}"
  # Built-in JVM JavaScript environment properties
  local:
    # Use Sandboxed (secured) JVM JavaScript environment
    use_js_sandbox: "${USE_LOCAL_JS_SANDBOX:true}"
    # Specify thread pool size for JavaScript sandbox resource monitor
    monitor_thread_pool_size: "${LOCAL_JS_SANDBOX_MONITOR_THREAD_POOL_SIZE:4}"
    # Maximum CPU time in milliseconds allowed for script execution
    max_cpu_time: "${LOCAL_JS_SANDBOX_MAX_CPU_TIME:5000}"
    # Maximum allowed JavaScript execution errors before JavaScript will be blacklisted
    max_errors: "${LOCAL_JS_SANDBOX_MAX_ERRORS:3}"

service:
  type: "${TB_SERVICE_TYPE:tb-integration}"

故障排查

注意若出现与 DNS 相关的错误，例如：

127.0.1.1:53: cannot unmarshal DNS message

可将系统配置为使用 Google 公共 DNS 服务器。

Ubuntu服务器

安装Java 17 (OpenJDK)

ThingsBoard 服务运行在 Java 17 上。请按以下说明安装 OpenJDK 17：

sudo apt update && sudo apt install openjdk-17-jdk-headless

将您的操作系统配置为默认使用 OpenJDK 17。您可以通过运行以下命令来配置默认版本：

sudo update-alternatives --config java

要检查系统上已安装的 Java 版本，请使用以下命令：

java -version

预期输出为：

openjdk version "17.x.xx" 
OpenJDK Runtime Environment (...)
OpenJDK 64-Bit Server VM (...)

选择要安装的集成包

MQTT Integrations
(MQTT, AWS IoT, IBM Watson, The Things Network)

HTTP Integrations
(HTTP, Sigfox, ThingPark, OceanConnect and
T-Mobile IoT CDP)

下载安装包：

wget https://dist.thingsboard.io/tb-http-integration-4.3.0.1pe.deb

安装集成作为服务：

sudo dpkg -i tb-http-integration-4.3.0.1pe.deb

使用以下命令打开文件进行编辑：

sudo nano /etc/tb-http-integration/conf/tb-http-integration.conf

找到以下配置块：

# UNCOMMENT NEXT LINES AND PUT YOUR CONNECTION PARAMETERS:
# export RPC_HOST=thingsboard.cloud
# export RPC_PORT=9090
# export INTEGRATION_ROUTING_KEY=YOUR_INTEGRATION_KEY
# export INTEGRATION_SECRET=YOUR_INTEGRATION_SECRET

填入您的配置参数。请不要忘记取消 export 语句的注释。参见以下示例：

# UNCOMMENT NEXT LINES AND PUT YOUR CONNECTION PARAMETERS:
export RPC_HOST=thingsboard.cloud
export RPC_PORT=9090
export INTEGRATION_ROUTING_KEY=b75**************************34d
export INTEGRATION_SECRET=vna**************mik

执行以下命令以启动集成：

sudo service tb-http-integration start

高级配置

可在 yml 配置文件中查找其他配置参数。

使用以下命令打开文件进行编辑：

sudo nano /etc/tb-http-integration/conf/tb-http-integration.conf

执行此命令后可在以下位置查看日志 /var/log/tb-http-integration/. 您应能看到来自服务器的部分 INFO 日志信息，其中包含最新的集成配置。

下载安装包：

wget https://dist.thingsboard.io/tb-mqtt-integration-4.3.0.1pe.deb

安装集成作为服务：

sudo dpkg -i tb-mqtt-integration-4.3.0.1pe.deb

使用以下命令打开文件进行编辑：

sudo nano /etc/tb-mqtt-integration/conf/tb-mqtt-integration.conf

找到以下配置块：

# UNCOMMENT NEXT LINES AND PUT YOUR CONNECTION PARAMETERS:
# export RPC_HOST=thingsboard.cloud
# export RPC_PORT=9090
# export INTEGRATION_ROUTING_KEY=YOUR_INTEGRATION_KEY
# export INTEGRATION_SECRET=YOUR_INTEGRATION_SECRET

填入您的配置参数。请不要忘记取消 export 语句的注释。参见以下示例：

# UNCOMMENT NEXT LINES AND PUT YOUR CONNECTION PARAMETERS:
export RPC_HOST=thingsboard.cloud
export RPC_PORT=9090
export INTEGRATION_ROUTING_KEY=b75**************************34d
export INTEGRATION_SECRET=vna**************mik

执行以下命令以启动集成：

sudo service tb-mqtt-integration start

高级配置

可在 yml 配置文件中查找其他配置参数。

使用以下命令打开文件进行编辑：

sudo nano /etc/tb-mqtt-integration/conf/tb-mqtt-integration.conf

执行此命令后可在以下位置查看日志 /var/log/tb-mqtt-integration/. 您应能看到来自服务器的部分 INFO 日志信息，其中包含最新的集成配置。

下载安装包：

wget https://dist.thingsboard.io/tb-aws-integration-4.3.0.1pe.deb

安装集成作为服务：

sudo dpkg -i tb-aws-integration-4.3.0.1pe.deb

使用以下命令打开文件进行编辑：

sudo nano /etc/tb-aws-integration/conf/tb-aws-integration.conf

找到以下配置块：

# UNCOMMENT NEXT LINES AND PUT YOUR CONNECTION PARAMETERS:
# export RPC_HOST=thingsboard.cloud
# export RPC_PORT=9090
# export INTEGRATION_ROUTING_KEY=YOUR_INTEGRATION_KEY
# export INTEGRATION_SECRET=YOUR_INTEGRATION_SECRET

填入您的配置参数。请不要忘记取消 export 语句的注释。参见以下示例：

# UNCOMMENT NEXT LINES AND PUT YOUR CONNECTION PARAMETERS:
export RPC_HOST=thingsboard.cloud
export RPC_PORT=9090
export INTEGRATION_ROUTING_KEY=b75**************************34d
export INTEGRATION_SECRET=vna**************mik

执行以下命令以启动集成：

sudo service tb-aws-integration start

高级配置

可在 yml 配置文件中查找其他配置参数。

使用以下命令打开文件进行编辑：

sudo nano /etc/tb-aws-integration/conf/tb-aws-integration.conf

执行此命令后可在以下位置查看日志 /var/log/tb-aws-integration/. 您应能看到来自服务器的部分 INFO 日志信息，其中包含最新的集成配置。

下载安装包：

wget https://dist.thingsboard.io/tb-azure-integration-4.3.0.1pe.deb

安装集成作为服务：

sudo dpkg -i tb-azure-integration-4.3.0.1pe.deb

使用以下命令打开文件进行编辑：

sudo nano /etc/tb-azure-integration/conf/tb-azure-integration.conf

找到以下配置块：

# UNCOMMENT NEXT LINES AND PUT YOUR CONNECTION PARAMETERS:
# export RPC_HOST=thingsboard.cloud
# export RPC_PORT=9090
# export INTEGRATION_ROUTING_KEY=YOUR_INTEGRATION_KEY
# export INTEGRATION_SECRET=YOUR_INTEGRATION_SECRET

填入您的配置参数。请不要忘记取消 export 语句的注释。参见以下示例：

# UNCOMMENT NEXT LINES AND PUT YOUR CONNECTION PARAMETERS:
export RPC_HOST=thingsboard.cloud
export RPC_PORT=9090
export INTEGRATION_ROUTING_KEY=b75**************************34d
export INTEGRATION_SECRET=vna**************mik

执行以下命令以启动集成：

sudo service tb-azure-integration start

高级配置

可在 yml 配置文件中查找其他配置参数。

使用以下命令打开文件进行编辑：

sudo nano /etc/tb-azure-integration/conf/tb-azure-integration.conf

执行此命令后可在以下位置查看日志 /var/log/tb-azure-integration/. 您应能看到来自服务器的部分 INFO 日志信息，其中包含最新的集成配置。

下载安装包：

wget https://dist.thingsboard.io/tb-opc-ua-integration-4.3.0.1pe.deb

安装集成作为服务：

sudo dpkg -i tb-opc-ua-integration-4.3.0.1pe.deb

使用以下命令打开文件进行编辑：

sudo nano /etc/tb-opc-ua-integration/conf/tb-opc-ua-integration.conf

找到以下配置块：

# UNCOMMENT NEXT LINES AND PUT YOUR CONNECTION PARAMETERS:
# export RPC_HOST=thingsboard.cloud
# export RPC_PORT=9090
# export INTEGRATION_ROUTING_KEY=YOUR_INTEGRATION_KEY
# export INTEGRATION_SECRET=YOUR_INTEGRATION_SECRET

填入您的配置参数。请不要忘记取消 export 语句的注释。参见以下示例：

# UNCOMMENT NEXT LINES AND PUT YOUR CONNECTION PARAMETERS:
export RPC_HOST=thingsboard.cloud
export RPC_PORT=9090
export INTEGRATION_ROUTING_KEY=b75**************************34d
export INTEGRATION_SECRET=vna**************mik

执行以下命令以启动集成：

sudo service tb-opc-ua-integration start

高级配置

可在 yml 配置文件中查找其他配置参数。

使用以下命令打开文件进行编辑：

sudo nano /etc/tb-opc-ua-integration/conf/tb-opc-ua-integration.conf

执行此命令后可在以下位置查看日志 /var/log/tb-opc-ua-integration/. 您应能看到来自服务器的部分 INFO 日志信息，其中包含最新的集成配置。

下载安装包：

wget https://dist.thingsboard.io/tb-tcp-udp-integration-4.3.0.1pe.deb

安装集成作为服务：

sudo dpkg -i tb-tcp-udp-integration-4.3.0.1pe.deb

使用以下命令打开文件进行编辑：

sudo nano /etc/tb-tcp-udp-integration/conf/tb-tcp-udp-integration.conf

找到以下配置块：

# UNCOMMENT NEXT LINES AND PUT YOUR CONNECTION PARAMETERS:
# export RPC_HOST=thingsboard.cloud
# export RPC_PORT=9090
# export INTEGRATION_ROUTING_KEY=YOUR_INTEGRATION_KEY
# export INTEGRATION_SECRET=YOUR_INTEGRATION_SECRET

填入您的配置参数。请不要忘记取消 export 语句的注释。参见以下示例：

# UNCOMMENT NEXT LINES AND PUT YOUR CONNECTION PARAMETERS:
export RPC_HOST=thingsboard.cloud
export RPC_PORT=9090
export INTEGRATION_ROUTING_KEY=b75**************************34d
export INTEGRATION_SECRET=vna**************mik

执行以下命令以启动集成：

sudo service tb-tcp-udp-integration start

高级配置

可在 yml 配置文件中查找其他配置参数。

使用以下命令打开文件进行编辑：

sudo nano /etc/tb-tcp-udp-integration/conf/tb-tcp-udp-integration.conf

执行此命令后可在以下位置查看日志 /var/log/tb-tcp-udp-integration/. 您应能看到来自服务器的部分 INFO 日志信息，其中包含最新的集成配置。

下载安装包：

wget https://dist.thingsboard.io/tb-coap-integration-4.3.0.1pe.deb

安装集成作为服务：

sudo dpkg -i tb-coap-integration-4.3.0.1pe.deb

使用以下命令打开文件进行编辑：

sudo nano /etc/tb-coap-integration/conf/tb-coap-integration.conf

找到以下配置块：

# UNCOMMENT NEXT LINES AND PUT YOUR CONNECTION PARAMETERS:
# export RPC_HOST=thingsboard.cloud
# export RPC_PORT=9090
# export INTEGRATION_ROUTING_KEY=YOUR_INTEGRATION_KEY
# export INTEGRATION_SECRET=YOUR_INTEGRATION_SECRET

填入您的配置参数。请不要忘记取消 export 语句的注释。参见以下示例：

# UNCOMMENT NEXT LINES AND PUT YOUR CONNECTION PARAMETERS:
export RPC_HOST=thingsboard.cloud
export RPC_PORT=9090
export INTEGRATION_ROUTING_KEY=b75**************************34d
export INTEGRATION_SECRET=vna**************mik

执行以下命令以启动集成：

sudo service tb-coap-integration start

高级配置

可在 yml 配置文件中查找其他配置参数。

使用以下命令打开文件进行编辑：

sudo nano /etc/tb-coap-integration/conf/tb-coap-integration.conf

执行此命令后可在以下位置查看日志 /var/log/tb-coap-integration/. 您应能看到来自服务器的部分 INFO 日志信息，其中包含最新的集成配置。

CentOS/RHEL服务器

安装Java 17 (OpenJDK)

ThingsBoard 服务运行在 Java 17 上。请按以下说明安装 OpenJDK 17：

sudo dnf install java-17-openjdk-headless

请勿忘记将您的操作系统配置为默认使用 OpenJDK 17。您可以使用以下命令配置默认版本：

sudo update-alternatives --config java

您可以使用以下命令检查安装：

java -version

预期命令输出为：

openjdk version "17.x.xx"
OpenJDK Runtime Environment (...)
OpenJDK 64-Bit Server VM (build ...)

选择要安装的集成包

MQTT Integrations
(MQTT, AWS IoT, IBM Watson, The Things Network)