# EMQ X 企业版安装

EMQ X 消息服务器可跨平台运行在 Linux、FreeBSD、macOS、Windows 或 openSUSE 服务器上。

WARNING

产品部署建议 Linux 服务器,不推荐 Windows 服务器。

# EMQ X License 文件获取

联系商务或登陆 https://emqx.io 注册账号获取免费的试用 License 文件

# EMQ X 程序包下载

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

下载地址: https://www.emqx.com/zh/downloads?product=enterprise (opens new window)

# CentOS

  • CentOS6.X
  • CentOS7.X

# 使用储存库安装 EMQ X

  1. 删除旧的 EMQ X
$ sudo yum remove emqx emqx-edge emqx-ee
1
  1. 安装所需要的依赖包
$ sudo yum install -y yum-utils device-mapper-persistent-data lvm2
1
  1. 使用以下命令设置存储库,以 CentOS7 为例
$ sudo yum-config-manager --add-repo https://repos.emqx.io/emqx-ee/redhat/centos/7/emqx-ee.repo
1
  1. 安装最新版本的 EMQ X
$ sudo yum install emqx-ee
1

TIP

如果提示接受 GPG 密钥,请确认密钥符合 fc84 1ba6 3775 5ca8 487b 1e3c c0b4 0946 3e64 0d53,如果符合,则接受该指纹。

  1. 安装特定版本的 EMQ X

    1. 查询可用版本

      $ yum list emqx-ee --showduplicates | sort -r
      
      emqx-ee.x86_64                    4.0.0-1.el7                     emqx-ee-stable
      
      1
      2
      3
    2. 根据第二列中的版本字符串安装特定版本,例如 4.0.0

      $ sudo yum install emqx-ee-4.0.0
      
      1
  2. 导入License文件:

    $ cp /path/to/emqx.lic /etc/emqx/emqx.lic
    
    1
  3. 启动 EMQ X

    • 直接启动

      $ emqx start
      emqx v4.0.0 is started successfully!
      
      $ emqx_ctl status
      Node 'emqx@127.0.0.1' is started
      emqx 4.0.0 is running
      
      1
      2
      3
      4
      5
      6
    • systemctl 启动

      $ sudo systemctl start emqx
      
      1
    • service 启动

      $ sudo service emqx start
      
      1

# 使用 rpm 包安装 EMQ X

  1. 通过 emqx.io (opens new window) 选择 CentOS 版本,然后下载要安装的 EMQ X 版本的 rpm 包。

  2. 安装 EMQ X

    $ sudo rpm -ivh emqx-ee-centos7-v4.0.0.x86_64.rpm
    
    1
  3. 导入License文件:

    $ cp /path/to/emqx.lic /etc/emqx/emqx.lic
    
    1
  4. 启动 EMQ X

    • 直接启动

      $ emqx start
      emqx  is started successfully!
      
      $ emqx_ctl status
      Node 'emqx@127.0.0.1' is started
      emqx 4.0.0 is running
      
      1
      2
      3
      4
      5
      6
    • systemctl 启动

      $ sudo systemctl start emqx
      
      1
    • service 启动

      $ sudo service emqx start
      
      1

# 使用 zip 包安装 EMQ X

  1. 通过 emqx.io (opens new window) 选择 Centos 版本,然后下载要安装的 EMQ X 版本的 zip 包。

  2. 解压程序包

    $ unzip emqx-ee-centos7-v4.0.0.zip
    
    1
  3. 导入License文件:

    $ cp /path/to/emqx.lic /path/to/emqx/etc/emqx.lic
    
    1
  4. 启动 EMQ X

    $ ./bin/emqx start
    emqx v4.0.0 is started successfully!
    
    $ ./bin/emqx_ctl status
    Node 'emqx@127.0.0.1' is started
    emqx 4.0.0 is running
    
    1
    2
    3
    4
    5
    6

# Ubuntu

  • Bionic 18.04 (LTS)
  • Xenial 16.04 (LTS)
  • Trusty 14.04 (LTS)
  • Precise 12.04 (LTS)

# 使用储存库安装 EMQ X

  1. 删除旧的 EMQ X
$ sudo apt remove emqx emqx-edge emqx-ee
1
  1. 安装所需要的依赖包
$ sudo apt update && sudo apt install -y \
    apt-transport-https \
    ca-certificates \
    curl \
    gnupg-agent \
    software-properties-common
1
2
3
4
5
6
  1. 添加 EMQ X 的官方 GPG 密钥
$ curl -fsSL https://repos.emqx.io/gpg.pub | sudo apt-key add -
1

验证密钥

$ 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>
1
2
3
4
5
  1. 添加 EMQ X 存储库。
$ sudo add-apt-repository \
    "deb [arch=amd64] https://repos.emqx.io/emqx-ee/deb/ubuntu/ \
    $(lsb_release -cs) \
    stable"
1
2
3
4
  1. 更新 apt 包索引
$ sudo apt update
1
  1. 安装最新版本的 EMQ X
$ sudo apt install emqx-ee
1
  1. 安装特定版本的 EMQ X

    1. 查询可用版本
    $ sudo apt-cache madison emqx-ee
    
    emqx-ee |      4.0.0 | https://repos.emqx.io/emqx-ee/deb/ubuntu bionic/stable amd64 Packages
    
    1
    2
    3
    1. 使用第二列中的版本字符串安装特定版本,例如
    $ sudo apt install emqx-ee=4.0.0
    
    1
  2. 导入License文件:

    $ cp /path/to/emqx.lic /etc/emqx/emqx.lic
    
    1
  3. 启动 EMQ X

    • 直接启动
    $ emqx start
    emqx v4.0.0 is started successfully!
    
    $ emqx_ctl status
    Node 'emqx@127.0.0.1' is started
    emqx 4.0.0 is running
    
    1
    2
    3
    4
    5
    6
    • systemctl 启动
    $ sudo systemctl start emqx
    
    1
    • service 启动
    $ sudo service emqx start
    
    1

# 使用 deb 包安装 EMQ X

  1. 通过 emqx.io (opens new window) 选择 Ubuntu 版本,然后下载要安装的 EMQ X 版本的 deb 包。

  2. 安装 EMQ X

# for ubuntu
$ sudo apt install ./emqx-ee-ubuntu18.04-v3.1.0_amd64.deb
# for debian
$ sudo dpkg -i emqx-ee-ubuntu18.04-v3.1.0_amd64.deb
1
2
3
4
  1. 导入License文件:
$ cp /path/to/emqx.lic /etc/emqx/emqx.lic
1
  1. 启动 EMQ X
  • 直接启动
$ emqx start
emqx  is started successfully!

$ emqx_ctl status
Node 'emqx@127.0.0.1' is started
emqx 4.0.0 is running
1
2
3
4
5
6
  • systemctl 启动
$ sudo systemctl start emqx
1
  • service 启动
$ sudo service emqx start
1

# 使用 zip 包安装 EMQ X

  1. 通过 emqx.io (opens new window) 选择 Ubuntu 版本,然后下载要安装的 EMQ X 版本的 zip 包。

  2. 解压程序包

$ unzip emqx-ee-ubuntu18.04-v4.0.0.zip
1
  1. 导入License文件:
$ cp /path/to/emqx.lic /path/to/emqx/etc/emqx.lic
1
  1. 启动 EMQ X
$ ./bin/emqx start
emqx v4.0.0 is started successfully!

$ ./bin/emqx_ctl status
Node 'emqx@127.0.0.1' is started
emqx 4.0.0 is running
1
2
3
4
5
6

# Debian

  • Stretch (Debian 9)
  • Jessie (Debian 8)

# 使用储存库安装 EMQ X

  1. 删除旧的 EMQ X
$ sudo apt remove emqx emqx-edge emqx-ee
1
  1. 安装所需要的依赖包
$ sudo apt update && sudo apt install -y \
    apt-transport-https \
    ca-certificates \
    curl \
    gnupg-agent \
    software-properties-common
1
2
3
4
5
6
  1. 添加 EMQ X 的官方 GPG 密钥
$ curl -fsSL https://repos.emqx.io/gpg.pub | sudo apt-key add -
1

验证密钥

$ 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>
1
2
3
4
5
  1. 设置 EMQ X 存储库。
$ sudo add-apt-repository \
    "deb [arch=amd64] https://repos.emqx.io/emqx-ee-ce/deb/debian/ \
    $(lsb_release -cs) \
    stable"
1
2
3
4
  1. 更新 apt 包索引
$ sudo apt update
1
  1. 安装最新版本的 EMQ X
$ sudo apt install emqx-ee
1
  1. 安装特定版本的 EMQ X

    1. 查询可用版本

      $ sudo apt-cache madison emqx-ee
      
      emqx-ee |      4.0.0 | https://repos.emqx.io/emqx-ee/deb/ubuntu bionic/stable amd64 Packages
      
      1
      2
      3
    2. 使用第二列中的版本字符串安装特定版本,例如

      $ sudo apt install emqx-ee=4.0.0
      
      1
  2. 导入License文件:

    $ cp /path/to/emqx.lic /etc/emqx/emqx.lic
    
    1
  3. 启动 EMQ X

    • 直接启动
    $ emqx start
    emqx v4.0.0 is started successfully!
    
    $ emqx_ctl status
    Node 'emqx@127.0.0.1' is started
    emqx 4.0.0 is running
    
    1
    2
    3
    4
    5
    6
    • systemctl 启动
    $ sudo systemctl start emqx
    
    1
    • service 启动
    $ sudo service emqx start
    
    1

# 使用 deb 包安装 EMQ X

  1. 通过 emqx.io (opens new window) 选择 Debian 版本,然后下载要安装的 EMQ X 版本的 deb 包。

  2. 安装 EMQ X

    # for ubuntu
    $ sudo apt install ./emqx-ee-debian9-v3.1.0_amd64.deb
    
    # for debian 
    # 首先确保已安装 libodbc 
    $ sudo dpkg -i emqx-ee-debian9-v3.1.0_amd64.deb
    
    1
    2
    3
    4
    5
    6
  3. 导入License文件:

    $ cp /path/to/emqx.lic /etc/emqx/emqx.lic
    
    1
  4. 启动 EMQ X

    • 直接启动

      $ emqx start
      emqx v4.0.0 is started successfully!
      
      $ emqx_ctl status
      Node 'emqx@127.0.0.1' is started
      emqx 4.0.0 is running
      
      1
      2
      3
      4
      5
      6
    • systemctl 启动

      $ sudo systemctl start emqx
      
      1
    • service 启动

      $ sudo service emqx start
      
      1

# 使用 zip 包安装 EMQ X

  1. 通过 emqx.io (opens new window) 选择 Debian 版本,然后下载要安装的 EMQ X 版本的 zip 包。

  2. 解压程序包

    $ unzip emqx-ee-debian9-v4.0.0.zip
    
    1
  3. 导入License文件:

    $ cp /path/to/emqx.lic /path/to/emqx/etc/emqx.lic
    
    1
  4. 启动 EMQ X

    $ ./bin/emqx start
    emqx v4.0.0 is started successfully!
    
    $ ./bin/emqx_ctl status
    Node 'emqx@127.0.0.1' is started
    emqx 4.0.0 is running
    
    1
    2
    3
    4
    5
    6

# macOS

# 使用 ZIP 包安装 EMQ X

  1. 通过 emqx.io (opens new window) ,选择 EMQ X 版本,然后下载要安装的 zip 包。

  2. 解压压缩包

    $ unzip emqx-ee-macos-v4.0.0.zip
    
    1
  3. 导入License文件:

    $ cp /path/to/emqx.lic /path/to/emqx/etc/emqx.li
    
    1
  4. 启动 EMQ X

    $ ./bin/emqx start
    emqx v4.0.0 is started successfully!
    
    $ ./bin/emqx_ctl status
    Node 'emqx@127.0.0.1' is started
    emqx 4.0.0 is running
    
    1
    2
    3
    4
    5
    6

# Windows

  1. 通过 emqx.io (opens new window) 下载 .zip 包。

  2. 解压压缩包

  3. 导入License文件:

    $ cp /path/to/emqx.lic /path/to/emqx/etc/emqx.lic
    
    1
  4. 打开 Windows 命令行窗口,cd 到程序目录, 启动 EMQ X。

    cd /path/to/emqx/bin
    emqx start
    
    1
    2

# openSUSE

  • openSUSE leap

# 使用储存库安装 EMQ X

  1. 删除旧的 EMQ X

    $ sudo zypper remove emqx emqx-edge emqx-ee
    
    1
  2. 下载 GPG 公钥并导入。

    $ curl -L -o /tmp/gpg.pub https://repos.emqx.io/gpg.pub
    $ sudo rpmkeys --import /tmp/gpg.pub
    
    1
    2
  3. 添加储存库地址

    $ sudo zypper ar -f -c https://repos.emqx.io/emqx-ee/redhat/opensuse/leap/stable emqx-ee
    
    1
  4. 安装最新版本的 EMQ X

    $ sudo zypper in emqx-ee
    
    1
  5. 安装特定版本的 EMQ X

    1. 查询可用版本

      $ sudo zypper pa emqx-ee
      
      Loading repository data...
      Reading installed packages...
      S | Repository | Name    | Version | Arch
      --+------------+---------+---------+-------
        | emqx-ee    | emqx-ee | 4.0.0-1 | x86_64
      
      1
      2
      3
      4
      5
      6
      7
    2. 使用 Version 安装特定版本,例如

      $ sudo zypper in emqx-ee-4.0.0
      
      1
  6. 导入License文件:

    $ cp /path/to/emqx.lic /etc/emqx/emqx.lic
    
    1
  7. 启动 EMQ X

    • 直接启动

      $ emqx start
      emqx v4.0.0 is started successfully!
      
      $ emqx_ctl status
      Node 'emqx@127.0.0.1' is started
      emqx 4.0.0 is running
      
      1
      2
      3
      4
      5
      6
    • systemctl 启动

      $ sudo systemctl start emqx
      
      1
    • service 启动

      $ sudo service emqx start
      
      1

# 使用 rpm 包安装 EMQ X

  1. 通过 emqx.io (opens new window) 选择 openSUSE,然后下载要安装的 EMQ X 版本的 rpm 包。

  2. 安装 EMQ X,将下面的路径更改为您下载 EMQ X 软件包的路径。

    $ sudo rpm -ivh emqx-ee-opensuse-v4.0.0.x86_64.rpm
    
    1
  3. 导入License文件:

    $ cp /path/to/emqx.lic /etc/emqx/emqx.lic
    
    1
  4. 启动 EMQ X

    • 直接启动

      $ emqx start
      emqx v4.0.0 is started successfully!
      
      $ emqx_ctl status
      Node 'emqx@127.0.0.1' is started
      emqx 4.0.0 is running
      
      1
      2
      3
      4
      5
      6
    • systemctl 启动

      $ sudo systemctl start emqx
      
      1
    • service 启动

      $ sudo service emqx start
      
      1

# 使用 zip 包安装 EMQ X

  1. 通过 emqx.io (opens new window) 选择 openSUSE,然后下载要安装的 EMQ X 版本的 zip 包。

  2. 解压压缩包

    $ unzip emqx-ee-opensuse-v4.0.0.zip
    
    1
  3. 导入License文件:

    $ cp /path/to/emqx.lic /path/to/emqx/etc/emqx.lic
    
    1
  4. 启动 EMQ X

    $ ./bin/emqx start
    emqx v4.0.0 is started successfully!
    
    $ ./bin/emqx_ctl status
    Node 'emqx@127.0.0.1' is started
    emqx 4.0.0 is running
    
    1
    2
    3
    4
    5
    6

# FreeBSD

  • FreeBSD 12

# 使用 zip 包安装 EMQ X

  1. 通过 emqx.io (opens new window) 选择 FreeBSD,然后下载要安装的 EMQ X 版本的 zip 包。

  2. 解压压缩包

    $ unzip emqx-ee-freebsd12-v4.0.0.zip
    
    1
  3. 导入License文件:

    $ cp /path/to/emqx.lic /path/to/emqx/etc/emqx.lic
    
    1
  4. 启动 EMQ X

    $ ./bin/emqx start
    emqx v4.0.0 is started successfully!
    
    $ ./bin/emqx_ctl status
    Node 'emqx@127.0.0.1' is started
    emqx 4.0.0 is running
    
    1
    2
    3
    4
    5
    6

# Docker

  1. 获取 docker 镜像
$ docker pull emqx/emqx-ee:v4.0.0
1
$ wget -O emqx-ee-docker-v4.0.0.zip https://www.emqx.com/en/downloads/enterprise/v4.0.0/emqx-ee-docker-v4.0.0-amd64.zip
$ unzip emqx-ee-docker.zip
$ docker load < emqx-ee-docker-v4.0.0
1
2
3
  1. 启动 docker 容器
$ docker run -d -\
    -name emqx-ee \
    -p 1883:1883 \
    -p 8083:8083 \
    -p 8883:8883 \
    -p 8084:8084 \
    -p 18083:18083 \
    -v /path/to/emqx.lic:/opt/emqx/etc/emqx.lic
    emqx/emqx-ee:v4.0.0
1
2
3
4
5
6
7
8
9

更多关于 EMQ X Docker 的信息请查看 Docker Hub (opens new window)