配置文件：
- EMQ 配置文件: /etc/emqttd/emq.conf
- 插件配置文件: /etc/emqttd/plugins/*.conf
日志文件
- 日志文件目录: /var/log/emqttd
数据文件
- 数据文件目录：/var/lib/emqttd/
启动停止
- systemctl start|stop|restart emqttd.service
控制台调试模式启动，检查emqttd是否可正常启动:
cd emqttd && ./bin/emqttd console
CTRL+c关闭控制台。
守护进程模式启动:
./bin/emqttd start
启动日志输出在log/emqttd_sasl.log文件。
emqttd消息服务器进程状态查询:
./bin/emqttd_ctl status
正常运行状态，查询命令返回:
$ ./bin/emqttd_ctl status Node 'emqttd@127.0.0.1' is started emqttd 1.1 is running
emqttd消息服务器提供了状态监控URL:
http://localhost:8083/status
停止服务器:
./bin/emqttd stop
启用用户名密码：
关闭匿名验证：
修改etc/emq.conf
## Allow Anonymous authentication mqtt.allow_anonymous = false
启用 emq_auth_username 插件:
启用 emq_auth_username 插件(不启用则mqtt.allow_anonymous = false不生效):
emqttd_ctl plugins load emq_auth_username
添加用户：
emqttd_ctl users add xxx xxxxxx
也可以通过修改plugins/emq_auth_clientid.conf的方式。
TCP服务端口占用
emqttd消息服务器默认占用的TCP端口包括:
| 1883 | MQTT协议端口 |
| 8883 | MQTT(SSL)端口 |
| 8083 | MQTT(WebSocket), HTTP API端口 |
| 18083 | Dashboard管理控制台端口 |
emqttd占用的上述端口，可通过etc/emqttd.config配置文件的listeners段落设置:
{listeners, [
{mqtt, 1883, [
...
]},
{mqtts, 8883, [
...
]},
%% HTTP and WebSocket Listener
{http, 8083, [
...
]}
]},
通过注释或删除相关段落，可禁用相关TCP服务启动。
18083端口是Web管理控制占用，该端口由emqttd_dashboard插件启用。
控制台URL: http:://localhost:18083/ ，默认登录用户名: admin, 密码: public。
快速设置
emqttd消息服务器主要配置文件:
| etc/vm.args | Erlang VM的启动参数设置 |
| etc/emqttd.config | emqttd消息服务器参数设置 |
etc/vm.args中两个重要的启动参数:
| +P | Erlang虚拟机允许的最大进程数，emqttd一个连接会消耗2个Erlang进程 |
| +Q | Erlang虚拟机允许的最大Port数量，emqttd一个连接消耗1个Port |
注解
Erlang的Port非TCP端口，可以理解为文件句柄。
+P 参数值 > 最大允许连接数 * 2
+Q 参数值 > 最大允许连接数
警告
实际连接数量超过Erlang虚拟机参数设置，会引起emqttd消息服务器宕机!
etc/emqttd.config文件listeners段落设置最大允许连接数:
{listeners, [
{mqtt, 1883, [
%% TCP Acceptor池设置
{acceptors, 16},
%% 最大允许连接数设置
{max_clients, 8192},
...
]},
emqttd消息服务器详细设置，请参见文档: config
/etc/init.d/emqttd
#!/bin/sh
#
# emqttd Startup script for emqttd.
#
# chkconfig: 2345 90 10
# description: emqttd is mqtt broker.
# source function library
. /etc/rc.d/init.d/functions
# export HOME=/root
start() {
echo "starting emqttd..."
cd /opt/emqttd && ./bin/emqttd start
}
stop() {
echo "stopping emqttd..."
cd /opt/emqttd && ./bin/emqttd stop
}
restart() {
stop
start
}
case "$1" in
start)
start
;;
stop)
stop
;;
restart)
restart
;;
*)
echo $"Usage: $0 {start|stop}"
RETVAL=2
esac
chkconfig:
chmod +x /etc/init.d/emqttd
chkconfig --add emqttd
chkconfig --list
boot test:
service emqttd start
注解
## erlexec: HOME must be set uncomment ‘# export HOME=/root’ if “HOME must be set” error.