安装Open Horizon代理(Agent)

虚拟机(VM)环境准备

建议您准备符合以下要求的虚拟机(VM)：

• 大于等于4GB内存
• 至少20GB储存空间
• Ubuntu Server 18.04 LTS

依赖环境

如果未安装Docker或安装的版本早于18.06.01，请安装最新版本的Docker：

curl -fsSL get.docker.com | sh

下载和安装示例

创建一个用于存放安装包的文件夹(目录可依据自己偏好更改)：

~$ mkdir -p pkgs

进入创建的文件夹:

~$ cd pkgs/

下载最新版的代理安装文件:

~/pkgs$ wget https://github.com/open-horizon/anax/releases/latest/download/horizon-agent-linux-deb-amd64.tar.gz

解压缩到当前文件夹:

~/pkgs$ tar -zxf horizon-agent-linux-deb-amd64.tar.gz

安装Horizon代理(Agent)和命令工具(CLI):

~/pkgs$ apt-get install -yqf ~/pkgs/horizon*.deb

验证代理是否正在运行：

hzn version
hzn exchange version
hzn node list

上述指令的输出应该与以下类似（版本号和URL可能不同）：

$ hzn version
Horizon CLI version: 2.23.29
Horizon Agent version: 2.23.29
$ hzn exchange version
1.116.0
$ hzn node list
{
      "id": "",
      "organization": null,
      "pattern": null,
      "name": null,
      "token_last_valid_time": "",
      "token_valid": null,
      "ha": null,
      "configstate": {
         "state": "unconfigured",
         "last_update_time": ""
      },
      "configuration": {
         "exchange_api": "https://9.30.210.34:8443/ec-exchange/v1/",
         "exchange_version": "1.116.0",
         "required_minimum_exchange_version": "1.116.0",
         "preferred_exchange_version": "1.116.0",
         "mms_api": "https://9.30.210.34:8443/ec-css",
         "architecture": "amd64",
         "horizon_version": "2.23.29"
      },
      "connectivity": {
         "firmware.bluehorizon.network": true,
         "images.bluehorizon.network": true
      }
   }

其他指令,如查看代理服务运行状态:

systemctl status horizon.service

注册代理

以使用helloworld policy为例子

首先获取示例policy的json文件:

wget https://raw.githubusercontent.com/open-horizon/examples/master/edge/services/helloworld/horizon/node.policy.json

注册agent所需修改的配置信息都在/etc/default/horizon里。需要配置的有HZN_EXCHANGE_URL，HZN_FSS_CSSURL，HZN_DEVICE_ID， 虽然HZN_AGENT_PORT=8510为默认配置，但可以自行依据需求修改。在修改配置前可以通过http://<YOUR MGMT HUB IP>:3090/v1测试是否能正常访问exchange以免因防火墙等问题 导致无法将agent注册到mgmt hub。

HZN_EXCHANGE_URL=http://<YOUR MGMT HUB IP>:3090/v1 (exchange service default port is 3090)
HZN_FSS_CSSURL=http://<YOUR MGMT HUB IP>:9443/ (FSS_CSS service default port is 9443)
HZN_MGMT_HUB_CERT_PATH=
HZN_DEVICE_ID=node100
HZN_AGENT_PORT=8510

保存agent配制后重启agent服务:

sudo systemctl restart horizon.service

使用hzn register命令注册agent,有关此命令的详细使用和相关参数可以通过hzn register --help查看。

Demo:
hzn register -o myorg -u "admin:QxnPaBtN9yTvbW1SbhttSlBBRUXkek" -n "node100:dHFkIE9CObNRczbjSBx4YGj5hKAGk3" --policy node.policy.json -s ibm.helloworld --serviceorg IBM -t 100

Template:
$HZN register -o $EXCHANGE_USER_ORG -u "admin:$EXCHANGE_USER_ADMIN_PW" -n "$HZN_DEVICE_ID:$HZN_DEVICE_TOKEN" --policy node.policy.json -s ibm.helloworld --serviceorg $EXCHANGE_SYSTEM_ORG -t 100