专业版IM服务软件包
1. 野火专业版IM发布邮件
专业版IM服务软件包一般都是通过邮件发送给客户端。在邮件上会写明绑定的地址、有效期和下载链接。如下图所示:
2. 野火IM发布软件包
从邮件里得到的链接下载后得到一个压缩包,解压后目录如下:
README.md
为专业版IM服务的说明手册。im-server.deb
和im-server.rpm
为deb系和redhat系的安装包。wildfirechat.tar.gz
为野火IM的压缩包。wildfirechat.tar.gz.md5
为野火IM的压缩包的md5值,用来校验压缩包文件是否损坏。
安装包和压缩包内容实质都是一样的。你可以选择使用安装包安装,用sytemctl控制程序的启动和停止。也可以用压缩包解压用命令行启动和关闭,都是可以的。
3. 压缩包里的内容
安装包和压缩包内容实质都是一样的。后面章节介绍运行时,你就能看到安装后的service和压缩包解压的目录完全一样,只不过是配置位置不同。这里先讲一下压缩包的内容。
把wildfirechat.tar.gz
解压,得到如下目录
arm64_epoll_lib
,arm64架构epoll native库。epoll库是平台相关的,默认带有x86 native库,如果是arm64平台上运行野火IM专业版,需要把此目录下的jar包拷贝到lib目录下。其他平台需要关闭epoll功能,或者自行寻找对应netty的native库。bin
,野火IM服务启动和停止脚本。checker
,是个测试server api的jar包,可以在部署之后运行测试一遍服务。目录下有使用说明。config
,是野火IM配置目录,下面有多个配置。docker
,包含Dockerfile
文件,可以编译成docker镜像,使用docker来运行。lib
,包括所有的jar包。machinecode
,在以机器授权码授权时,需要使用此目录下的工具获取机器码,一般客户可以忽略此目录。migrate
,数据库脚本,包含Mysql,Dameng,Kingbase,Shentong,PostgreSQL等。国产数据库需要手动执行脚本,如果是升级需要手动执行升级的SQL。其他数据库会自动执行(IM服务包含flyway,可以自动执行初始化和升级)。nginx
,是使用nginx的配置示例和说明。stress_test
,专业版IM服务的压力测试工具和使用说明。systemd
,是如何配置为linux service方式。skt
,Secret key tools,配置文件中密码加解密的说明(2024.10.13后添加)。
4. 配置文件目录说明
在上图的config目录下,存放野火的配置文件,包括如下:
c3p0-config.xml
,数据库的配置文件。git.properties
,IM服务的git信息,在解决问题时需要把此信息提供给野火,也是在/api/version
命令中看到的大部分内容。hazelcast.xml
,IM服务内部使用了hazelcast作为内存缓存。当集群部署时需要修改配置文件让所有IM服务节点缓存建立成集群。另外也可以优化缓存配置,使其更适合自己的场景。log4j2.xml
,日志的配置,默认日志是异步写,如果查找问题需要改成同步写。wildfirechat.conf
,野火IM服务的主要配置文件,关于IM服务的大部分配置都在这个文件里。wildfirechat.license
,野火专业版IM服务的授权文件,一般情况下不需要动,这个文件是和整个软件包绑定的,不能不同版本之间互相拷贝使用。