EMQX 企业版安装

    联系商务或登陆 注册账号获取免费的试用 License 文件

    EMQX 程序包下载

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

    下载地址:

    • CentOS 7 (EL7)
    • CentOS 8 (EL8)

    1. 访问emqx.com (opens new window) 选择 CentOS 版本，然后下载要安装的 EMQX 版本的 rpm 包。

    2. 安装 EMQX

    3. 导入License文件:

    4. 启动 EMQX

      • 直接启动

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

      • systemctl 启动

        1. $ sudo systemctl start emqx

      • service 启动

        1. $ sudo service emqx start

    使用 zip 包安装 EMQX

    注意

    ZIP包适用于测试和热更，如果不知道如何手动安装所有可能的运行时依赖，请勿在生产环境中使用

    1. 通过 emqx.com安装 - 图2 (opens new window) 选择 Centos 版本，然后下载要安装的 EMQX 版本的 zip 包。

    2. 解压程序包

      1. $ unzip emqx-ee-centos7-v4.0.0.zip
      1. $ cp /path/to/emqx.lic /path/to/emqx/etc/emqx.lic

    4. 启动 EMQX

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

    Ubuntu

    • Bionic 18.04 (LTS)
    • Xenial 16.04 (LTS)

    使用 deb 包安装 EMQX

    1. 通过 选择 Ubuntu 版本，然后下载要安装的 EMQX 版本的 deb 包。

    2. 安装 EMQX

    1. # for ubuntu
    2. $ sudo apt install ./emqx-ee-ubuntu18.04-v3.1.0_amd64.deb
    3. # for debian
    4. $ sudo dpkg -i emqx-ee-ubuntu18.04-v3.1.0_amd64.deb
    1. 导入License文件:
    1. $ cp /path/to/emqx.lic /etc/emqx/emqx.lic
    1. 启动 EMQX
    • 直接启动
    1. $ emqx start
    2. emqx  is started successfully!
    4. $ emqx_ctl status
    5. Node 'emqx@127.0.0.1' is started
    6. emqx 4.0.0 is running
    • systemctl 启动
    1. $ sudo systemctl start emqx
    • service 启动

    注意

    ZIP包适用于测试和热更，如果不知道如何手动安装所有可能的运行时依赖，请勿在生产环境中使用

    1. 通过 选择 Ubuntu 版本，然后下载要安装的 EMQX 版本的 zip 包。

    2. 解压程序包

    1. $ unzip emqx-ee-ubuntu18.04-v4.0.0.zip
    1. $ cp /path/to/emqx.lic /path/to/emqx/etc/emqx.lic
    1. 启动 EMQX
    1. $ ./bin/emqx start
    2. emqx v4.0.0 is started successfully!
    4. $ ./bin/emqx_ctl status
    5. Node 'emqx@127.0.0.1' is started
    6. emqx 4.0.0 is running
    • Debian 9
    • Debian 10

    使用 deb 包安装 EMQX

    1. 通过 emqx.com (opens new window) 选择 Debian 版本，然后下载要安装的 EMQX 版本的 deb 包。

    2. 安装 EMQX

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

    3. 导入License文件:

      1. $ cp /path/to/emqx.lic /etc/emqx/emqx.lic

    4. 启动 EMQX

      • 直接启动

        1. $ emqx start
        2. emqx v4.0.0 is started successfully!
        4. $ emqx_ctl status
        5. Node 'emqx@127.0.0.1' is started

      • systemctl 启动

        1. $ sudo systemctl start emqx

      • service 启动

        1. $ sudo service emqx start

    使用 zip 包安装 EMQX

    ZIP包适用于测试和热更，如果不知道如何手动安装所有可能的运行时依赖，请勿在生产环境中使用

    1. 通过 emqx.com安装 - 图6 (opens new window) 选择 Debian 版本，然后下载要安装的 EMQX 版本的 zip 包。

    2. 解压程序包

      1. $ unzip emqx-ee-debian9-v4.0.0.zip

    3. 导入License文件:

      1. $ cp /path/to/emqx.lic /path/to/emqx/etc/emqx.lic

    4. 启动 EMQX

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

    macOS

    1. 通过 ，选择 EMQX 版本，然后下载要安装的 zip 包。

    2. 解压压缩包

    3. 导入License文件:

      1. $ cp /path/to/emqx.lic /path/to/emqx/etc/emqx.li

    4. 启动 EMQX

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

    注意

    由于 emqx 将数据存储在 data/mnesia/<节点名> 目录，所以在使用容器启动 emqx 的时候， 必须使用 hostname 或者 FQDN 来组建 emqx 的节点名。否则数据存储目录将发生切换，导致数据丢失。

    启动单个容器

    1. 获取 docker 镜像
    1. $ docker pull emqx/emqx-ee:v4.0.0
    1. 启动 docker 容器
    1. $ docker run -d \
    2.     --name emqx-ee \
    3.     -p 8081:8081 \
    4.     -p 1883:1883 \
    5.     -p 8083:8083 \
    6.     -p 8883:8883 \
    7.     -p 8084:8084 \
    8.     -p 18083:18083 \
    9.     -v /path/to/emqx.lic:/opt/emqx/etc/emqx.lic \
    10.     emqx/emqx-ee:v4.0.0

    更多关于 EMQX Docker 的信息请查看

    使用 docker-compose 创建一个简单的静态集群

    1. 创建 docker-compose.yaml 文件

      1. version: '3'
      2. services:
      3.   emqx1:
      4.     image: emqx/emqx-ee:v4.0.0
      5.     environment:
      6.     - "EMQX_NAME=emqx"
      7.     - "EMQX_HOST=node1.emqx.io"
      8.     - "EMQX_CLUSTER__DISCOVERY=static"
      9.     - "EMQX_CLUSTER__STATIC__SEEDS=emqx@node1.emqx.io, emqx@node2.emqx.io"
      10.     volumes:
      11.         - ./tmp/emqx.lic:/opt/emqx/etc/emqx.lic
      12.     healthcheck:
      13.       test: ["CMD", "/opt/emqx/bin/emqx_ctl", "status"]
      14.       interval: 5s
      15.       timeout: 25s
      16.       retries: 5
      17.     networks:
      19.         aliases:
      20.         - node1.emqx.io
      22.   emqx2:
      23.     image: emqx/emqx-ee:v4.0.0
      24.     environment:
      25.     - "EMQX_NAME=emqx"
      26.     - "EMQX_HOST=node2.emqx.io"
      27.     - "EMQX_CLUSTER__DISCOVERY=static"
      28.     - "EMQX_CLUSTER__STATIC__SEEDS=emqx@node1.emqx.io, emqx@node2.emqx.io"
      29.     volumes:
      30.         - ./tmp/emqx.lic:/opt/emqx/etc/emqx.lic
      31.     healthcheck:
      32.       test: ["CMD", "/opt/emqx/bin/emqx_ctl", "status"]
      33.       interval: 5s
      34.       timeout: 25s
      35.       retries: 5
      36.     networks:
      37.       emqx-bridge:
      38.         aliases:
      39.         - node2.emqx.io
      41. networks:
      42.   emqx-bridge:
      43.     driver: bridge

    2. 启动 docker-compose 集群

      1. $ docker-compose -p my_emqx up -d
      1. $ docker exec -it my_emqx_emqx1_1 sh -c "emqx_ctl cluster status"
      2. Cluster status: #{running_nodes => ['emqx@node1.emqx.io','emqx@node2.emqx.io'],
      3.                   stopped_nodes => []}

    关于 EMQX 企业版容器的更多信息，请参看

    使用 Helm 安装 EMQX 集群 (K8S、K3S)

    1. 添加 helm 仓库
    1. $ helm repo add emqx https://repos.emqx.io/charts
    2. $ helm repo update
    1. 查询 EMQX 仓库
    1. helm search repo emqx
    2. NAME         CHART VERSION APP VERSION DESCRIPTION
    3. emqx/emqx    v4.0.0        v4.0.0      A Helm chart for EMQX
    4. emqx/emqx-ee v4.0.0        v4.0.0      A Helm chart for EMQX
    5. emqx/kuiper  0.1.1         0.1.1       A lightweight IoT edge analytic software
    1. 启动 EMQX 集群
    1. $ helm install my-emqx emqx/emqx-ee
    1. 查看 EMQX 集群状态
    1. $ kubectl get pods
    2. NAME       READY  STATUS             RESTARTS  AGE
    3. my-emqx-0  1/1     Running   0          56s
    4. my-emqx-1  1/1     Running   0          40s
    5. my-emqx-2  1/1     Running   0          21s
    7. $ kubectl exec -it my-emqx-0 -- emqx_ctl cluster status
    8. Cluster status: #{running_nodes =>
    9.                       ['my-emqx@my-emqx-0.my-emqx-headless.default.svc.cluster.local',
    10.                        'my-emqx@my-emqx-1.my-emqx-headless.default.svc.cluster.local',
    11.                        'my-emqx@my-emqx-2.my-emqx-headless.default.svc.cluster.local'],