# 启动 EMQX

后台启动 EMQX

$ emqx start
EMQX v4.0.0 is started successfully!
1
2

systemctl 启动

$ sudo systemctl start emqx
EMQX v4.0.0 is started successfully!
1
2

service 启动

$ sudo service emqx start
EMQX v4.0.0 is started successfully!
1
2

提示

如果你使用的是 EMQX Enterprise 则需要导入 License 才能使用,导入步骤见下文启动 EMQX Enterprise

通过 ZIP 压缩包安装的 EMQX 不支持通过 systemctl 和 service 启动。

4.2-rc.1 版本后,EMQX 开源版新加入遥测功能,启动前请详细了解

# 查看 EMQX 的状态

EMQX 正常启动:

$ emqx_ctl status
Node 'emqx@127.0.0.1' is started
emqx 4.0.0 is running
1
2
3

EMQX 未能正常启动:

$ emqx_ctl status
Node 'emqx@127.0.0.1' not responding to pings。
1
2

你可以查看 logs 下的日志文件并确认是否属于 常见错误

# 启动 EMQX Enterprise

EMQX Enterprise 需要 License 文件才能正常启动,EMQX 可以略过这一步。

# 申请试用 License

# 放置 License

  • 替换默认证书目录下的 License 文件(etc/emqx.lic),当然你也可以选择变更证书文件的读取路径,修改 etc/emqx.conf 文件中的 license.file,并确保 License 文件位于更新后的读取路径且 EMQX Enterprise 拥有读取权限,然后启动 EMQX Enterprise。EMQX Enterprise 的启动方式与 EMQX 相同,见下文。

  • 如果正在运行的EMQX企业集群需要更新许可证文件,可以使用emqx_ctl license reload [path of the license file]命令直接更新许可证文件,而无需重启任何节点。 需要注意的是,emqx_ctl license reload命令加载的证书将应用于整个EMQX集群,它将被保存在每个节点的licenses子目录下的EMQX的数据目录中(即:data/licenses/emqx.lic)。 即使节点重新启动,这个新的许可证文件也会被加载和应用。