系统要求
- Stretch (Raspbian 9)
- Jessie (Raspbian 8)
安装 EMQ X Edge
您可以根据需要以不同方式安装 EMQ X Edge :
- 设置 EMQ X Edge 的镜像库并从中进行安装,以便于安装和升级任务。
- 手动下载软件包并安装。
使用镜像库安装 EMQ X Edge
在新主机上首次安装 EMQ X Edge 之前,需要设置 EMQ X Edge 镜像库。之后可以从镜像库安装和更新 EMQ X Edge 。
设置镜像库
1.更新 apt
包索引:
$ sudo apt update
2.安装必要的软件:
$ sudo apt install -y \
apt-transport-https \
ca-certificates \
curl \
gnupg-agent \
software-properties-common
3.添加 EMQ X Edge 的官方 GPG 密钥:
$ curl -fsSL https://repos.emqx.io/gpg.pub | sudo apt-key add -
验证密钥
$ sudo apt-key fingerprint 3E640D53
pub rsa2048 2019-04-10 [SC]
FC84 1BA6 3775 5CA8 487B 1E3C C0B4 0946 3E64 0D53
uid [ unknown] emqx team <support@emqx.io>
4.使用以下命令设置 stable 镜像库。要添加 unstable 的镜像库,请在以下命令中的单词 stable 之后添加单词 unstable。
$ sudo add-apt-repository \
"deb [arch=armhf] https://repos.emqx.io/emqx-edge/deb/raspbian/ \
$(lsb_release -cs) \
stable"
安装 EMQ X Edge
-
1.更新
apt
包索引:$ sudo apt update
2.安装最新版本的 EMQ X Edge ,或者转到下一步安装特定版本:
$ sudo apt install emqx
如果启用了多个 EMQ X Edge 镜像库,则在
apt install
或apt update
命令中未指定版本的情况下将始终安装尽可能高的版本,这可能不适合稳定性需求。3.要安装特定版本的 EMQ X Edge ,需要列出可用版本,然后选择并安装:
查询可用版本
$ sudo apt-cache madison emqx emqx | 3.1-rc.1 | https://repos.emqx.io/emqx-edge/deb/raspbian stretch/unstable armhf Packages emqx | 3.1-beta.3 | https://repos.emqx.io/emqx-edge/deb/raspbian stretch/unstable armhf Packages emqx | 3.1-beta.2 | https://repos.emqx.io/emqx-edge/deb/raspbian stretch/unstable armhf Packages emqx | 3.1-beta.1 | https://repos.emqx.io/emqx-edge/deb/raspbian stretch/unstable armhf Packages emqx | 3.1.0 | https://repos.emqx.io/emqx-edge/deb/raspbian stretch/stable armhf Packages emqx | 3.0.1 | https://repos.emqx.io/emqx-edge/deb/raspbian stretch/stable armhf Packages
使用第二列中的版本字符串安装特定版本,例如
3.1.0
$ sudo apt install emqx=3.1.0
4.启动 EMQ X Edge
$ emqx start emqx 3.1 is started successfully! $ emqx_ctl status Node 'emqx@127.0.0.1' is started emqx v3.1.0 is running
5.EMQ X 启动成功,如何使用请参考官方文档https://developer.emqx.io/docs/broker/v3/cn/getstarted.html)
使用安装包安装 EMQ X Edge
如果无法使用 EMQ X Edge 的镜像库来安装 EMQ X Edge ,则可以下载 .deb
文件或 .zip
文件并手动安装。
从 .deb
文件安装
1.转到 emqx.io
或 github,选择 Raspbian 版本,然后下载要安装的 EMQ X Edge 版本的 .deb
文件。
2.安装 EMQ X Edge ,将下面的路径更改为下载 EMQ X Edge 软件包的路径。
$sudo dpkg -i /path/to/emqx-raspbian9-v3.1.0_armhf.deb
3.启动 EMQ X Edge
$ emqx start
emqx 3.1 is started successfully!
$ emqx_ctl status
Node 'emqx@127.0.0.1' is started
emqx v3.1.0 is running
4.EMQ X 启动成功,如何使用请参考官方文档https://developer.emqx.io/docs/broker/v3/cn/getstarted.html)
从 .zip
文件安装
1.转到 emqx.io
或 github,选择Raspbian版本,然后下载要安装的 EMQ X Edge 版本的 .zip
文件。
2.解压压缩包,将下面的路径更改为下载 EMQ X Edge 软件包的路径。
$ unzip /path/to/emqx-raspbian9-v3.1.0.zip
3.启动 EMQ X Edge
$ cd emqx
$ ./bin/emqx start
emqx 3.1 is started successfully!
$ ./bin/emqx_ctl status
Node 'emqx@127.0.0.1' is started
emqx v3.1.0 is running
4.EMQ X 启动成功,如何使用请参考官方文档