Raspbian 安裝 EMQ X 服務器指南

系統要求

• 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. 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 啓動成功，如何使用請參考官方文檔

---

更多信息請訪問咱們的官網 emqx.io，或關注咱們的開源項目 github.com/emqx/emqx ，詳細文檔請訪問 官方文檔。