MQTT開源軟件之EMQ安裝篇
時間：2018-09-29 來源：未知
程序安裝 (Installation)
EMQ 2.0 消息服務器可跨平臺運行在 Linux、FreeBSD、Mac OS X 或 Windows 服務器上。
EMQ 2.0 程序包下載
EMQ 2.0 消息服務器每個版本會發(fā)布 Ubuntu、CentOS、FreeBSD、Mac OS X、Windows 平臺程序包與 Docker 鏡像。
下載地址: //emqtt.com/downloads
RPM 包安裝
EMQ Linux RPM 程序包:
CentOS6.8 //emqtt.com/downloads/latest/centos6-rpm CentOS7//emqtt.com/downloads/latest/centos7-rpm
安裝包命名由平臺、版本、操縱系統(tǒng)位數組成，例如: emqttd-centos7-v2.0_x86_64.rpm
CentOS、RedHat 操作系統(tǒng)下，推薦 RPM 包安裝。RPM 包安裝后可通過操作系統(tǒng)，直接管理啟停 EMQ 服務。
RPM 安裝
rpm -ivh --force emqttd-centos7-v2.1.2-1.el7.centos.x86_64.rpm
Erlang/OTP R19 依賴 lksctp-tools 庫
yum install lksctp-tools
配置文件
EMQ 配置文件: /etc/emqttd/emq.conf，插件配置文件: /etc/emqttd/plugins/*.conf。
日志文件 日志文件目錄: /var/log/emqttd
數據文件 數據文件目錄：/var/lib/emqttd/
啟動停止
systemctl start|stop|restart emqttd.service
DEB 包安裝
EMQ Linux DEB 程序包:
Ubuntu12.04 //emqtt.com/downloads/latest/ubuntu12_04-deb Ubuntu14.04//emqtt.com/downloads/latest/ubuntu14_04-deb Ubuntu16.04//emqtt.com/downloads/latest/ubuntu16_04-deb Debian7//emqtt.com/downloads/latest/debian7-deb Debian8//emqtt.com/downloads/latest/debian7-deb 安裝包命名由平臺、版本、操縱系統(tǒng)位數組成，例如: emqttd-debian7-v2.0_amd64.deb
Debian、Ubuntu 操作系統(tǒng)下，推薦 DEB 包安裝。DEB 包安裝后可通過操作系統(tǒng)，直接管理啟停 EMQ 服務。
sudo dpkg -i emqttd-ubuntu16.04_v2.0_amd64.deb
Erlang/OTP R19依賴lksctp-tools庫
apt-get install lksctp-tools
配置文件 EMQ 配置文件: /etc/emqttd/emq.conf，插件配置文件: /etc/emqttd/plugins/*.conf。
日志文件 日志文件目錄: /var/log/emqttd
數據文件 數據文件目錄：/var/lib/emqttd/
啟動停止
service emqttd start|stop|restart
Linux 通用包安裝
EMQ Linux 通用程序包:
Ubuntu12.04 //emqtt.com/downloads/latest/ubuntu12_04 Ubuntu14.04//emqtt.com/downloads/latest/ubuntu14_04 Ubuntu16.04//emqtt.com/downloads/latest/ubuntu16_04 CentOS6.8//emqtt.com/downloads/latest/centos6 CentOS7//emqtt.com/downloads/latest/centos7 Debian7//emqtt.com/downloads/latest/debian7 Debian8//emqtt.com/downloads/latest/debian7 FreeBSD//emqtt.com/downloads/latest/freebsd 安裝包命名由平臺、版本組成，例如: emqttd-macosx-v2.0.zip
CentOS 平臺為例，下載安裝過程:
unzip emqttd-centos7-v2.0.zip
控制臺調試模式啟動，檢查 EMQ 是否可正常啟動:
cd emqttd && ./bin/emqttd console
EMQ 消息服務器如啟動正常，控制臺輸出:
starting emqttd on node 'emqttd@127.0.0.1'
emqttd ctl is starting...[ok]
emqttd hook is starting...[ok]
emqttd router is starting...[ok]
emqttd pubsub is starting...[ok]
emqttd stats is starting...[ok]
emqttd metrics is starting...[ok]
emqttd pooler is starting...[ok]
emqttd trace is starting...[ok]
emqttd client manager is starting...[ok]
emqttd session manager is starting...[ok]
emqttd session supervisor is starting...[ok]
emqttd wsclient supervisor is starting...[ok]
emqttd broker is starting...[ok]
emqttd alarm is starting...[ok]
emqttd mod supervisor is starting...[ok]
emqttd bridge supervisor is starting...[ok]
emqttd access control is starting...[ok]
emqttd system monitor is starting...[ok]
dashboard:http listen on 0.0.0.0:18083 with 2 acceptors.
mqtt:tcp listen on 0.0.0.0:1883 with 8 acceptors.
mqtt:ssl listen on 0.0.0.0:8883 with 4 acceptors.
mqtt:ws listen on 0.0.0.0:8083 with 4 acceptors.
Erlang MQTT Broker 2.0 is running now
CTRL+c 關閉控制臺。守護進程模式啟動:
./bin/emqttd start
啟動錯誤日志將輸出在 log/ 目錄。
EMQ 消息服務器進程狀態(tài)查詢:
./bin/emqttd_ctl status
正常運行狀態(tài)，查詢命令返回:
$ ./bin/emqttd_ctl status
Node 'emqttd@127.0.0.1' is started
emqttd 2.0 is running
EMQ 消息服務器提供了狀態(tài)監(jiān)控 URL
//localhost:8083/status 停止服務器:
./bin/emqttd stop
FreeBSD 服務器安裝
EMQ FreeBSD 程序包下載: //emqtt.com/downloads/latest/freebsd
FreeBSD 平臺安裝過程與Linux相同。
Mac OS X 系統(tǒng)安裝 Mac 下開發(fā)調試 MQTT 應用，可直接下載安裝://emqtt.com/downloads/latest/macosx
配置文件 ‘etc/emq.conf’ log 段落打開 debug 日志，控制臺可以查看收發(fā) MQTT 報文詳細:
EMQ 在 Mac 平臺下安裝啟動過程與 Linux 相同。
Windows 服務器安裝 Windows 平臺程序包下載://emqtt.com/downloads/latest/windows10
程序包下載解壓后，打開 Windows 命令行窗口，cd 到程序目錄。
控制臺模式啟動:
bin\emqttd console
如啟動成功，會彈出控制臺窗口。
關閉控制臺窗口，停止emqttd進程，準備注冊 Windows 服務。
警告
EMQ-2.0 暫不支持服務注冊 EMQ 注冊為 Windows 服務:
bin\emqttd install
EMQ 服務啟動:
bin\emqttd start
EMQ 服務停止:
bin\emqttd stop
EMQ 服務卸載:
bin\emqttd uninstall
Docker 鏡像安裝
EMQ 2.0 Docker 鏡像下載: //emqtt.com/downloads/latest/docker
解壓 emqttd-docker 鏡像包:
unzip emqttd-docker-v2.0.zip
加載鏡像:
docker load < emqttd-docker-v2.0
啟動容器:
docker run -tid --name emq20 -p 1883:1883 -p 8083:8083 -p 8883:8883 -p 8084:8084 -p 18083:18083 emqttd-docker-v2.0
停止容器:
docker stop emq20
開啟容器:
docker start emq20
進入 Docker 控制臺:
docker exec -it emq20 /bin/sh
源碼編譯安裝
EMQ 消息服務器基于 Erlang/OTP 平臺開發(fā)，項目托管的 GitHub 管理維護，源碼編譯依賴 Erlang 環(huán)境和 git 客戶端。
Erlang 安裝: //www.erlang.org/
Git 客戶端: //www.git-scm.com/
Ubuntu 平臺可通過 apt-get 命令安裝，CentOS/RedHat 平臺可通過 yum 命令安裝，Mac 下可通過 brew 包管理命令安裝，Windows 下... :(
編譯環(huán)境準備好之后，clone 代碼開始編譯:
git clone https://github.com/emqtt/emq-relx.git
cd emq-relx && make
cd _rel/emqttd && ./bin/emqttd console
編譯成功后，可執(zhí)行程序包在目錄:
_rel/emqttd 控制臺啟動編譯的 EMQ 程序包:
cd _rel/emqttd && ./bin/emqttd console
Windows 源碼編譯安裝
Erlang 安裝: //www.erlang.org/
MSYS2 安裝: //www.msys2.org/
MSYS2 安裝完成后，根據 MSYS2 中的 pacman 包管理工具安裝 Git、 Make 工具軟件:
pacman -S git make
編譯環(huán)境準備之后，clone 代碼開始編譯:
git clone -b windows https://github.com/emqtt/emqttd-relx.git
cd emqttd-relx && make
cd _rel/emqttd && ./bin/emqttd console
編譯成功后，可執(zhí)行程序包在目錄:
_rel/emqttd 控制臺啟動編譯的 EMQ 程序包:
cd _rel/emqttd && ./bin/emqttd console
TCP 服務端口占用 EMQ 2.0 消息服務器默認占用的 TCP 端口包括:
1883 MQTT 協(xié)議端口
8883 MQTT/SSL 端口
8083 MQTT/WebSocket 端口
8080 HTTP API 端口
18083 Dashboard 管理控制臺端口
EMQ 2.0 占用的上述端口，可通過 etc/emq.conf 配置文件的 ‘listener’ 段落設置:
## TCP Listener: 1883, 127.0.0.1:1883, ::1:1883
listener.tcp.external = 0.0.0.0:1883
## SSL Listener: 8883, 127.0.0.1:8883, ::1:8883
listener.ssl.external = 8883
## External MQTT/WebSocket Listener
listener.ws.external = 8083
## HTTP Management API Listener
listener.api.mgmt = 127.0.0.1:8080
通過注釋或刪除相關段落，可禁用相關 TCP 服務啟動。
18083端口是 Web 管理控制占用，該端口由 emq_dashboard 插件啟用。
控制臺 URL: http:://localhost:18083/ ，默認登錄用戶名: admin, 密碼: public。
快速設置 EMQ 消息服務器主要配置文件:
etc/emq.conf EMQ 消息服務器參數設置 etc/plugins/*.conf EMQ 插件配置文件 etc/emq.conf 中兩個重要的虛擬機啟動參數:
node.process_limit Erlang 虛擬機允許的大進程數，EMQ 一個連接會消耗2個Erlang進程 node.max_ports Erlang 虛擬機允許的大 Port 數量，EMQ 一個連接消耗1個 Port 注解
Erlang 的 Port 非 TCP 端口，可以理解為文件句柄。 node.process_limit = 參數值 > 大允許連接數 * 2
node.max_ports = 參數值 > 大允許連接數
警告
實際連接數量超過 Erlang 虛擬機參數設置，會引起 EMQ 消息服務器宕機! etc/emq.conf 配置文件的 listener 段落設置大允許連接數:
listener.tcp.external = 0.0.0.0:1883
listener.tcp.external.acceptors = 8
listener.tcp.external.max_clients = 1024 EMQ 2.0 消息服務器詳細設置，請參見文檔: config
