麒麟Server部署东方通TongLINK/Q：从安装到系统服务配置全流程

1. 麒麟Server环境准备与TongLINK/Q安装国产化操作系统麒麟Server SP3 2403作为底层平台搭配东方通TongLINK/Q消息中间件是当前企业级应用的热门组合。我最近刚在客户生产环境完成这套部署实测稳定性相当不错。先说说硬件配置建议至少4核CPU、8GB内存和100GB存储空间这个配置能支撑中小规模的业务消息流转。安装前的准备工作有几个关键点确认系统版本执行cat /etc/kylin-release查看是否为SP3 2403版本关闭SELinux修改/etc/selinux/config中SELINUXdisabled检查防火墙建议临时关闭或放行后续要用到的8020、8999等端口安装包解压有个小技巧麒麟Server默认的/usr/local目录权限较严格建议先用mkdir -p /usr/local/tlq创建目录再用chown -R youruser:yourgroup /usr/local/tlq赋权。解压命令里的-C参数容易漏掉正确的完整命令应该是tar -zxvf Install_TLQ_Standard_Linux2.6.32_x86_64_8.1.17.0.tar.gz -C /usr/local/tlq/2. 环境变量配置与License处理环境变量配置是第一个容易踩坑的地方。东方通的setp脚本需要特别注意两点执行时必须用.命令加载环境变量写成. ./setp注意两个点之间的空格必须在tlq安装目录下执行否则会报路径错误License文件处理我吃过亏必须严格命名为license.dat且放在/usr/local/tlq/TLQ8/license/目录下。遇到过有人把文件后缀写成.txt或者放错目录导致服务启动失败。验证license是否生效可以执行tlq -v正常会显示版本信息和license有效期。有个实用技巧把环境变量配置写入/etc/profile.d/tlq.sh这样所有用户都能继承这些配置。文件内容示例export TLQ_HOME/usr/local/tlq/TLQ8 export PATH$TLQ_HOME/bin:$PATH3. 服务启动与Systemd配置手动启动服务很简单直接执行tlq和tlqremote就行。但生产环境建议配置为systemd服务方便管理。创建/etc/systemd/system/tlq.service时要注意几个细节Type必须设为forking因为tlq会派生守护进程ExecStart里要用bash -c整合多条命令确保环境变量加载After要包含network.target避免网络未就绪导致启动失败完整的service文件配置示例[Unit] DescriptionTongLINK/Q Message Server Afternetwork.target [Service] Typeforking ExecStart/bin/bash -c . /usr/local/tlq/TLQ8/setp tlq tlqremote ExecStop/bin/bash -c . /usr/local/tlq/TLQ8/setp tlq -cstop -y Restarton-failure [Install] WantedBymulti-user.target配置完成后记得执行systemctl daemon-reload。测试时建议先用journalctl -u tlq -f实时查看日志确认没有报错再设置开机启动。4. 管理控制台部署实战管理控制台需要JDK1.8环境麒麟Server虽然预装了OpenJDK但最好确认下版本java -version解压管理控制台时要注意默认端口8020可能被占用如果冲突可以修改/usr/local/tlqmcs/TLQ8.1_ManageConsole/conf/server.xml中的端口号。启动方式有两种调试阶段用./startserver.sh前台运行方便看日志生产环境用./startservernohup.sh后台运行控制台的systemd服务配置有个特殊点ExecStop需要等待较长时间建议增加TimeoutStopSec配置[Service] TimeoutStopSec30 ExecStop/usr/local/tlqmcs/TLQ8.1_ManageConsole/bin/stopserver.sh5. 常见问题排查与优化建议部署完成后可能会遇到几个典型问题控制台无法登录检查TLQ8.1_ManageConsole/logs/server.log常见原因是密码文件权限问题服务启动超时适当调整systemd的TimeoutStartSec参数消息堆积修改/usr/local/tlq/TLQ8/config/server.cfg中的队列配置性能优化建议调整JVM参数在startservernohup.sh中增加-Xms2g -Xmx4g开启磁盘缓存修改server.cfg中disk_cache_size参数定期清理日志配置logrotate管理/usr/local/tlq/TLQ8/logs/下的日志文件最后提醒下安全加固措施修改默认admin密码限制控制台访问IP定期备份/usr/local/tlq/TLQ8/config目录下的配置文件