V5.0.X版本 EMQX安装、卸载 以及使用

回到目录    回到末尾

  EMQX为大规模分布式物联网 MQTT 消息服务器。提供高效可靠连接海量物联网设备，实时处理分发消息与事件流数据，助力构建关键业务的物联网平台与应用。

• 此次以V5.0.9版本进行演示，分别用rpm和tar.gz2种方式进行安装、卸载进行演示
• 演示系统版本：CentOS 7.9.2009 x86_64
• 官网地址：EMQX: 大规模分布式物联网 MQTT 消息服务器

一、卸载

1. 停止 EMQX Broker服务：emqx stop
   
2. 查看状态，确认已停止服务：systemctl status emqx
   
3. 卸载：取决于安装方式：
   （1）如果你带有yum，可以直接执行命令：yum remove emqx
   （2）如果是rpm包，则执行命令：rpm -e emqx
   （3）如果是tar包安装，直接删除 EMQX 目录即可 rm -rf emqx目录
   
4. 验证是否已经卸载完成：systemctl status emqx

回到目录    回到末尾

二、下载安装

2.1 下载

1. 下载链接：emqx官网 - 版本下载
2. 选择合适的版本下载：

希望使用rpm安装的，下载.rpm后缀的安装包；使用tar方式安装的，下载tar.gz安装包。

2.2 安装

  安装有2种方式：rpm安装和tar安装

2.2.1 rpm安装

1. 安装：
   （1）如果你带有yum，可以直接执行命令：yum install 安装包.rpm
   （2）如果是rpm包，则执行命令：rpm -ivh 安装包.rpm --force --nodeps

#示例
rpm -ivh emqx-5.0.9-el7-amd64.rpm --force --nodeps

2. 启动emqx：

#执行命令
systemctl start emqx
# 或者
emqx start

3. 查看启动状态：systemctl status emqx
   

2.2.2 tar安装

这种方式启动和停止比较麻烦，不建议使用

1. 创建目录：mkdir -p emqx && tar -zxvf 安装包.tar.gz -C emqx

#示例
mkdir -p emqx && tar -zxvf emqx-5.0.11-el7-amd64.tar.gz -C emqx

2. 直接启动：./emqx/bin/emqx start
3. 查看状态：bin/emqx_ctl status
4. 停止 EMQX Broker：./bin/emqx stop

回到目录    回到末尾

2.3 测试启动

  启动后，打开浏览器:http://IP:18083/
登录：

默认账号：admin
默认密码：public

如果访问不了，查看机器防火墙是否打开，该端口是否开放：

• 查看状态： systemctl status firewalld # active (running) 即是开启状态
• 查看已开放端口命令：firewall-cmd --list-all
  如果端口18083未开放：
  （1）新增开放端口：firewall-cmd --zone=public --add-port=18083/tcp --permanent
  （2）刷新加载：firewall-cmd --reload

三、安装和启动过程中遇到的问题及解决方案

3.1 启动失败 - openssl not found

根据提示，我们查看启动失败日志:/usr/bin/emqx console

接着我们查看官网-对应常见错误，找到对应的解决办法:

详情参考：openssl升级安装

3.2 启动失败 - cookie

从waring中可粗略获取的信息为：在服务器配置文件(emqx.conf)中的cookie配置项出现问题：

根据提示修改emqx的配置文件emqx.conf：

修改的值可以用户自定义：

最后，重启服务器和emqx。
其他配置问题请查询官方文档：EMQX配置文件语法

3.3 其他问题

1. 检查防火墙设置，确定防火墙正确打开，且对应的端口是开放的。emqx监听的端口参照配置文件(emqx.conf)中的配置。
2. 检查日志文件：在emqx的安装目录下，可以找到logs目录，里面记录了日志文件，如果启动失败了，可以查看日志中的错误信息，帮助确定问题。
3. 重启服务器和emqx.

回到目录    回到末尾

四、EMQX使用

1. 启动emqx：systemctl start emqx
2. 查看启动状态：systemctl status emqx
3. 停止emqx：systemctl stop emqx
4. emqx创建规则引擎写入TDengine库过程详细

4.1 创建资源

4.2 创建规则

4.3 创建web连接测试

回到目录    回到末尾