CTR-700 版 TeamViewer IoT

Highlighted
发布自 TeamViewer员工
TeamViewer员工

CTR-700 版 TeamViewer IoT

TeamViewer IoT 代理

TeamViewer IoT 代理是一款软件,可用于远程访问连接的
设备,并提供外部 CMI(=控制与监控接口),可用于
将传感器数据推送至 TeamViewer IoT Cloud。

开始使用

下载

您可下载最新版 sysWORXX CTR-700 软件包,请访问 :https://download.teamviewer-iot.com/sysworxx/1.1.1238/armv7/teamviewer-sysworxx_1.1.1238_armhf.deb

安装

在您已从
TeamViewer IoT 实验室页面下载 teamviewer-sysworxx_[...]_armhf.deb 软件包后,即可使用

$ dpkg -i teamviewer-sysworxx_[...]_armhf.deb

安装代理

部署指南

您需要将 teamviewer-iot-agent 分配至您的 TeamViewer 账户,以便访问。若您目前没有 TeamViewer 账户,您可导航至 TeamViewer IoT 仪表板创建一个账户:https://teamviewer-iot.com/


启动代理

代理中包含命令行用户界面;所有命令都带有 teamviewer-iot-agent 前缀。

您需要手动启动代理,运行

$ [sudo] teamviewer-iot-agent start

,并遵照屏幕上的说明。然后,会提示您输入 TeamViewer 账户凭据。在完成部署后,会将设备分配到您的账户,并添加至您的 TeamViewer 联系人列表中。您的设备将被自动添加至 TeamViewer IoT Cloud 中:https://teamviewer-iot.com/


在多个 CTR-700 上启动代理

若您要在多个 CTR-700 上启动代理,可遵照下述步骤。请确保在设备上运行 avahi-daemon,并安装下列软件包:

libavahi-client3, libavahi-common3, libavahi-common-data

CTR-700 设备必须与您的 TeamViewer 桌面客户端处于相同的 LAN 中:

1.运行命令:

$ ssh [user@]hostname '[sudo] teamviewer-iot-agent start -y -nw'

注意-y 指您直接接收 TeamViewer IoT EULA

2.在 TeamViewer 桌面客户端的计算机和&联系人列表中,点击 添加项目 图标。

3.选择附近联系人和设备。LAN 中安装 TeamViewer 的所有设备列表将显示。

4.在列表中找到设备主机名。

5.双击设备主机名,会将设备分配到
您的账户。

6.双击计算机和&联系人列表中的条目,建立
连接


信息

在您调用

$ [sudo] teamviewer-iot-agent info

时,可获取关于代理当前状态的信息

输出类似于:

/*******************************************/ 软件包版本:1.1.8 TeamViewer Id:设备被分配到:状态:在线系统监控状况监控:激活 /*******************************************/


Remote AppControl

注意:目前,仅可使用最近的 Windows TeamViewer 桌面客户端  https://www.teamviewer.com/en/download/windows/ 打开 Remote AppControl 会话。

在启动代理并完成设备的分配后,您可双击 TeamViewer 桌面客户端的计算机和&联系人列表中的设备条目建立连接。

默认情况下,当服务器运行时,代理通过端口 1880(NoDead 编辑器)连接到 Web 服务器。若您要进行更改,可使用下列命令:

$ teamviewer-iot-agent configure set WebControlPort <PORT_NUMBER> $ teamviewer-iot-agent restart

在 AppControl 窗口中还包含导航面板,您可使用下列命令激活或禁用(0 表示禁用,1 表示启用):

$ teamviewer-iot-agent configure set WebControlNavigationPanel [0|1] $ teamviewer-iot-agent restart


远程终端

teamviewer-iot-agent 提供用于访问设备的远程终端。默认情况下,此项禁用。您可通过下列命令激活或禁用此功能

激活:

$ teamviewer-iot-agent configure set EnableRemoteShell 1 $ teamviewer-iot-agent restart

禁用:

$ teamviewer-iot-agent configure set EnableRemoteShell 0 $ teamviewer-iot-agent restart


监控

teamviewer-iot-agent 附带外部 CMI(控制与监控接口),可用于将传感器数据推送至 TeamViewer IoT Cloud。

云连接

默认情况下,启用向 TeamViewer IoT Cloud 报告数据的功能。您可通过运行下列命令,禁用连接:

$ teamviewer-iot-agent disable monitoring

如要启用云报告功能,可调用

$ teamviewer-iot-agent enable monitoring -i

注意:此命令不会禁用 API,因其可能用于其他用途,仅防止将传感器数据传输至 TeamViewer IoT Cloud 中。


系统健康状况监控

teamviewer-iot-agent 附带预配置的显示器,用于监控 IoT 设备的系统健康状况。

如要激活此显示器,您需要运行下列命令:

$ teamviewer-iot-agent start systemhealth

启动后,代理需要一段时间(最长 5 分钟)将数据发送至仪表板。

如要停用此显示器,可调用下列命令:

$ teamviewer-iot-agent stop systemhealth

如要禁用此显示器,您需要运行下列命令:

$ teamviewer-iot-agent disable monitoring -s
远程客户端

默认情况下,TeamViewer IoT 代理仅允许连接本地主机;如要启用远程连接:

1.启用远程连接,以允许非本地主机设备创建客户端。

$ teamviewer-iot-agent enable remoteClientProvision

2.生成可信证书,从您的远程设备创建客户端

请参考:https://download.teamviewer-iot.com/docs/agentapi/index.html

注意:用设备主机名称替换本地主机名,并在发布/订阅示例中运行 TeamViewer IoT 代理

3.在客户端创建完毕后,禁用远程客户端部署,以防网络上其他主机的未授权访问。禁用远程客户端部署后,仅允许远程主机基于证书进行安全访问。

$ teamviewer-iot-agent disable remoteClientProvision

4.启用客户端的远程数据,安全连接至 TeamViewer IoT 代理,以发送数据

$ teamviewer-iot-agent enable remoteData

5.从您的远程设备安全注册指标,并将数据推送至 TeamViewer IoT 代理

请参考:https://download.teamviewer-iot.com/docs/agentapi/index.html

注意:用设备主机名称替换本地主机名,并在发布/订阅示例中运行 TeamViewer IoT 代理

6.如要部署其他远程客户端,可启用远程客户端部署

$ teamviewer-iot-agent enable remoteClientProvision

注意:出于安全考虑,在 不需要时

,要禁用远程客户端部署

7.出于安全考虑,当不再需要远程连接,以供客户端发送数据时,要禁用远程数据

$ teamviewer-iot-agent disable remoteData

8.出于安全考虑,当不再需要远程连接,以供客户端执行部署或发送数据时,要禁用所有远程连接

$ teamviewer-iot-agent disable remoteClients


更新

只需使用您的首选软件包管理器(apt-get 或 aptitude 或 ...),更新软件包即可。在更新后,您必须检查代理是否运行

$ [sudo] teamviewer-iot-agent info

若未运行,则调用

$ [sudo] teamviewer-iot-agent start


帮助

如需了解关于 IoT 代理及您如何使用 IoT 代理的更多信息,可调用

$ man teamviewer-iot-agent


错误

### 在启动系统健康状况显示器后,仪表板上不会显示传感器或指标。

在首次启动后,需要稍等片刻,直至数据传送到仪表板。请至少等待 5 分钟,然后重新加载仪表板。若依然未显示关于传感器或指标的信息,您可调用

$ teamviewer-iot-agent reset systemhealth

此命令用于将系统健康状况显示器的配置恢复为出厂设置,并触发传感器部署。


作者

TeamViewer GmbH
https://www.teamviewer.com/en/support/contact

许可证

若您要使用此款软件,必须同意 TeamViewer IoT 最终用户许可协议

中所述之条款