程序安装 (Installation)

    注解

    产品部署建议 Linux、FreeBSD 服务器，不推荐 Windows 服务器。

    EMQ 2.0 消息服务器每个版本会发布 Ubuntu、CentOS、FreeBSD、Mac OS X、Windows 平台程序包与 Docker 镜像。

    下载地址:

    RPM 包安装

    EMQ Linux RPM 程序包:

    安装包命名由平台、版本、操纵系统位数组成，例如: emqttd-centos7-v2.0_x86_64.rpm

    CentOS、RedHat 操作系统下，推荐 RPM 包安装。RPM 包安装后可通过操作系统，直接管理启停 EMQ 服务。

    注解

    Erlang/OTP R19 依赖 lksctp-tools 库

    配置文件

    EMQ 配置文件: /etc/emqttd/emq.conf，插件配置文件: /etc/emqttd/plugins/*.conf。

    日志文件

    日志文件目录: /var/log/emqttd

    数据文件目录：/var/lib/emqttd/

    启动停止

    1. systemctl start|stop|restart emqttd.service

    DEB 包安装

    EMQ Linux DEB 程序包:

    安装包命名由平台、版本、操纵系统位数组成，例如: emqttd-debian7-v2.0_amd64.deb

    Debian、Ubuntu 操作系统下，推荐 DEB 包安装。DEB 包安装后可通过操作系统，直接管理启停 EMQ 服务。

    1. sudo dpkg -i emqttd-ubuntu16.04_v2.0_amd64.deb

    注解

    Erlang/OTP R19依赖lksctp-tools库

    1. apt-get install lksctp-tools

    配置文件

    EMQ 配置文件: /etc/emqttd/emq.conf，插件配置文件: /etc/emqttd/plugins/*.conf。

    日志文件目录: /var/log/emqttd

    数据文件

    数据文件目录：/var/lib/emqttd/

    启动停止

    1. service emqttd start|stop|restart

    Linux 通用包安装

    EMQ Linux 通用程序包:

    安装包命名由平台、版本组成，例如: emqttd-macosx-v2.0.zip

    CentOS 平台为例，下载安装过程:

    1. unzip emqttd-centos7-v2.0.zip

    控制台调试模式启动，检查 EMQ 是否可正常启动:

    1. cd emqttd && ./bin/emqttd console

    EMQ 消息服务器如启动正常，控制台输出:

    1. starting emqttd on node 'emqttd@127.0.0.1'
    2. emqttd ctl is starting...[ok]
    3. emqttd router is starting...[ok]
    4. emqttd pubsub is starting...[ok]
    5. emqttd stats is starting...[ok]
    6. emqttd metrics is starting...[ok]
    7. emqttd pooler is starting...[ok]
    8. emqttd trace is starting...[ok]
    9. emqttd client manager is starting...[ok]
    10. emqttd session manager is starting...[ok]
    11. emqttd session supervisor is starting...[ok]
    12. emqttd wsclient supervisor is starting...[ok]
    13. emqttd broker is starting...[ok]
    14. emqttd alarm is starting...[ok]
    15. emqttd mod supervisor is starting...[ok]
    16. emqttd bridge supervisor is starting...[ok]
    18. emqttd system monitor is starting...[ok]
    19. dashboard:http listen on 0.0.0.0:18083 with 2 acceptors.
    20. mqtt:tcp listen on 0.0.0.0:1883 with 8 acceptors.
    21. mqtt:ssl listen on 0.0.0.0:8883 with 4 acceptors.
    22. mqtt:ws listen on 0.0.0.0:8083 with 4 acceptors.
    23. Erlang MQTT Broker 2.0 is running now

    CTRL+c 关闭控制台。守护进程模式启动:

    1. ./bin/emqttd start

    启动错误日志将输出在 log/ 目录。

    EMQ 消息服务器进程状态查询:

    1. ./bin/emqttd_ctl status

    正常运行状态，查询命令返回:

    EMQ 消息服务器提供了状态监控 URL

    1. http://localhost:8080/status

    停止服务器:

    1. ./bin/emqttd stop

    EMQ FreeBSD 程序包下载: https://www.emqx.io/downloads/v2/latest/emqttd-freebsd.zip

    FreeBSD 平台安装过程与Linux相同。

    Mac OS X 系统安装

    Mac 下开发调试 MQTT 应用，可直接下载安装: 

    1. ## Console log. Enum: off, file, console, both
    2. log.console = both
    4. ## Console log level. Enum: debug, info, notice, warning, error, critical, alert, emergency
    5. log.console.level = debug
    6. ## Console log file
    7. log.console.file = log/console.log

    EMQ 在 Mac 平台下安装启动过程与 Linux 相同。

    Windows 服务器安装

    Windows 平台程序包下载: https://www.emqx.io/downloads/v2/latest/emqttd-windows10.zip

    程序包下载解压后，打开 Windows 命令行窗口，cd 到程序目录。

    控制台模式启动:

    1. bin\emqttd console

    如启动成功，会弹出控制台窗口。

    关闭控制台窗口，停止emqttd进程，准备注册 Windows 服务。

    警告

    EMQ-2.0 暂不支持服务注册

    EMQ 注册为 Windows 服务:

    1. bin\emqttd install

    EMQ 服务启动:

    1. bin\emqttd start

    EMQ 服务停止:

    1. bin\emqttd stop

    EMQ 服务卸载:

    1. bin\emqttd uninstall

    Docker 镜像安装

    EMQ 2.0 Docker 镜像下载:

    解压 emqttd-docker 镜像包:

    加载镜像:

    1. docker load < emqttd-docker-v2.0

    启动容器:

    停止容器:

    1. docker stop emq20

    开启容器:

    1. docker start emq20

    进入 Docker 控制台:

    1. docker exec -it emq20 /bin/sh

    EMQ 消息服务器基于 Erlang/OTP 平台开发，项目托管的 GitHub 管理维护，源码编译依赖 Erlang 环境和 git 客户端。

    注解

    EMQ R2.3+ 依赖 Erlang R20+ 版本

    Erlang 安装: http://www.erlang.org/

    Git 客户端:

    Ubuntu 平台可通过 apt-get 命令安装，CentOS/RedHat 平台可通过 yum 命令安装，Mac 下可通过 brew 包管理命令安装，Windows 下… :(

    编译环境准备好之后，clone 代码开始编译:

    1. git clone https://github.com/emqtt/emq-relx.git
    3. cd emq-relx && make
    5. cd _rel/emqttd && ./bin/emqttd console

    编译成功后，可执行程序包在目录:

    1. _rel/emqttd

    控制台启动编译的 EMQ 程序包:

    1. cd _rel/emqttd && ./bin/emqttd console

    Windows 源码编译安装

    Erlang 安装: http://www.erlang.org/

    MSYS2 安装:

    MSYS2 安装完成后，根据 MSYS2 中的 pacman 包管理工具安装 Git、 Make 工具软件:

    1. pacman -S git make

    编译环境准备之后，clone 代码开始编译:

    1. git clone -b windows https://github.com/emqtt/emqttd-relx.git
    3. cd emqttd-relx && make
    5. cd _rel/emqttd && ./bin/emqttd console

    编译成功后，可执行程序包在目录:

    1. _rel/emqttd

    控制台启动编译的 EMQ 程序包:

    1. cd _rel/emqttd && ./bin/emqttd console

    TCP 服务端口占用

    EMQ 2.0 占用的上述端口，可通过 etc/emq.conf 配置文件的 ‘listener’ 段落设置:

    通过注释或删除相关段落，可禁用相关 TCP 服务启动。

    18083端口是 Web 管理控制占用，该端口由 emq_dashboard 插件启用。

    控制台 URL: ，默认登录用户名: admin, 密码: public。

    快速设置

    EMQ 消息服务器主要配置文件:

    etc/emq.conf 中两个重要的虚拟机启动参数:

    注解

    Erlang 的 Port 非 TCP 端口，可以理解为文件句柄。

    node.process_limit = 参数值 > 最大允许连接数 * 2

    node.max_ports = 参数值 > 最大允许连接数

    警告

    实际连接数量超过 Erlang 虚拟机参数设置，会引起 EMQ 消息服务器宕机!

    etc/emq.conf 配置文件的 listener 段落设置最大允许连接数:

    1. listener.tcp.external = 0.0.0.0:1883
    3. listener.tcp.external.acceptors = 8

    EMQ 2.0 消息服务器详细设置，请参见文档: config

    注解

    ## erlexec: HOME must be set uncomment ‘# export HOME=/root’ if “HOME must be set” error.