# 启动 EMQ X

后台启动 EMQ X

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

systemctl 启动

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

service 启动

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

TIP

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

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

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

# 查看 EMQ X 的状态

EMQ X 正常启动:

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

EMQ X 未能正常启动:

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

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

# 启动 EMQ X Enterprise

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

# 申请试用 License

# 放置 License

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

  • 如果是正在运行的 EMQ X Enterprise 需要更新 License 文件,那么可以使用 emqx_ctl license reload [license 文件所在路径] 命令直接更新 License 文件,无需重启 EMQ X Enterprise。

WARNING

emqx_ctl license reload 命令加载的证书仅在 EMQ X Enterprise 本次运行期间生效,如果需要永久更新 License 证书的路径,依然需要替换旧证书或修改配置文件。