麒麟Server部署东方通TongLINK/Q：从零到生产就绪的完整指南

1. 麒麟Server与TongLINK/Q基础认知

国产化技术栈的崛起让越来越多的企业开始关注麒麟操作系统与东方通中间件的组合方案。作为国产消息中间件的代表产品，TongLINK/Q（简称TLQ）在金融、政务等领域已有大量成功案例。我去年参与某省级政务云项目时，就曾完整实施过这套技术组合，实测下来稳定性完全不输国际主流产品。

麒麟Server SP3作为国产操作系统的旗舰版本，其安全增强特性与TLQ的国产化适配形成了完美互补。这里需要特别说明的是，TLQ8.1版本对麒麟系统的兼容性经过了官方认证，包括内存管理、文件系统交互等底层模块都做了深度优化。在实际部署前，建议先检查系统版本是否匹配：

cat /etc/kylin-release

如果输出显示"Kylin Linux Advanced Server release V10 SP3"，说明系统版本符合要求。遇到过有团队在SP2系统上强行安装TLQ8.1，结果消息堆积功能出现异常，后来升级系统才解决。

2. 从零开始的环境准备

2.1 系统基础配置

麒麟Server默认的安全策略比较严格，我们需要先调整几个关键参数。首先是SELinux状态检查，建议设置为permissive模式：

setenforce 0 sed -i 's/SELINUX=enforcing/SELINUX=permissive/g' /etc/selinux/config

其次是防火墙配置，TLQ需要开放多个端口（后面会具体说明），可以先临时关闭防火墙测试：

systemctl stop firewalld

但生产环境绝对不要这样操作！我吃过亏——有次测试环境没问题就直接上生产，结果被安全团队通报。正确做法是用firewall-cmd放行特定端口，等全部调试完成后再统一配置。

2.2 依赖组件安装

TLQ运行需要一些基础库支持，麒麟的软件源可能缺少部分组件。这里分享我的私有源配置方法：

cat > /etc/yum.repos.d/base.repo <<EOF [base] name=Kylin Linux Advanced Server - Base baseurl=http://archive.kylinos.cn/kylin/KYLIN-ALL/10.1/os/adv/lic/base/$basearch/ gpgcheck=0 enabled=1 EOF

然后安装必要依赖：

yum install -y glibc-devel libstdc++ openssl-devel

有个坑要注意：麒麟系统的glibc版本可能较高，如果遇到"version GLIBCXX_3.4.20 not found"错误，需要手动降级libstdc++库。

3. TLQ核心服务部署实战

3.1 软件包解压与安装

官方提供的安装包通常是tar.gz格式，我习惯将其集中存放在/opt目录下管理：

mkdir -p /opt/tlq/package cd /opt/tlq/package tar -zxvf Install_TLQ_Standard_Linux2.6.32_x86_64_8.1.17.0.tar.gz -C /usr/local/tlq/

这里有个细节：解压后的目录结构可能因版本不同而有差异。8.1.17版本会生成TLQ8目录，而早期版本可能是TongLINKQ。一定要确认实际路径，否则后续配置会出错。

3.2 环境变量配置

TLQ依赖的环境变量配置脚本setp需要特别注意执行方式：

cd /usr/local/tlq/TLQ8/ . ./setp

那两个点之间的空格很容易被忽略！我有次排查了两小时才发现是这里少了空格导致变量未生效。验证是否成功可以执行：

echo $TLQ_HOME

3.3 License文件处理

东方通的license机制比较特殊，必须满足以下条件：

• 文件名必须为license.dat
• 需要放置在/usr/local/tlq/TLQ8/license目录
• 文件权限需设为644

遇到过license失效的情况，后来发现是文件编码问题。建议用dos2unix工具转换：

yum install -y dos2unix dos2unix /usr/local/tlq/TLQ8/license/license.dat

4. 生产级系统服务配置

4.1 Systemd服务文件编写

原始文章给的模板基本可用，但我优化了几个关键点：

[Unit] Description=TongLINK/Q Message Server After=network.target remote-fs.target Requires=network-online.target [Service] Type=forking Environment=TLQ_HOME=/usr/local/tlq/TLQ8 ExecStartPre=/bin/bash -c 'until ping -c1 8.8.8.8; do sleep 1; done' ExecStart=/bin/bash -c '. ${TLQ_HOME}/setp && ${TLQ_HOME}/bin/tlq && ${TLQ_HOME}/bin/tlqremote' ExecStop=/bin/bash -c '. ${TLQ_HOME}/setp && ${TLQ_HOME}/bin/tlq -cstop -y' Restart=on-failure RestartSec=30s LimitNOFILE=65536 [Install] WantedBy=multi-user.target

主要改进：

1. 增加了网络依赖检测
2. 添加了进程重启机制
3. 调整了文件描述符限制
4. 使用环境变量避免硬编码

4.2 服务管理技巧

启动服务后，这几个命令组合特别实用：

# 实时查看日志 journalctl -u tlq.service -f # 检查端口监听 ss -tulnp | grep tlq # 测试消息通路 /usr/local/tlq/TLQ8/bin/tlqtest -h localhost -p 8008

遇到过服务能启动但端口未监听的情况，最后发现是麒麟系统的安全模块拦截了。这时候需要检查：

ausearch -m avc -ts recent

5. 管理控制台深度配置

5.1 JDK环境适配

虽然麒麟自带OpenJDK，但TLQ控制台对JDK版本比较敏感。推荐用以下方式验证：

java -version 2>&1 | grep -E '1.8.0|11.0'

如果版本不符，可以这样安装Oracle JDK：

rpm -ivh jdk-8u361-linux-x64.rpm alternatives --config java

环境变量配置要注意作用域。我更喜欢用户级配置：

cat >> ~/.bashrc <<EOF export JAVA_HOME=/usr/java/jdk1.8.0_361-amd64 export PATH=\$JAVA_HOME/bin:\$PATH EOF

5.2 控制台服务优化

控制台的启动脚本需要调整几个关键参数：

vim /usr/local/tlqmcs/TLQ8.1_ManageConsole/bin/setenv.sh

修改以下内容：

• JAVA_OPTS 增加内存设置：-Xms2g -Xmx4g
• 添加GC参数：-XX:+UseG1GC
• 设置时区：-Duser.timezone=Asia/Shanghai

生产环境一定要改默认密码！有次安全扫描发现我们用了默认密码，被通报批评。修改方法：

-- 登录控制台后执行 UPDATE TLQ_USER SET PASSWORD=md5('新密码') WHERE USERNAME='admin';

6. 安全加固与监控

6.1 网络层防护

TLQ的端口开放策略需要精细控制：

• 服务端口：默认8008（TCP）
• 管理端口：默认8020（TCP）
• 集群通信端口：默认8018（TCP）

建议用firewalld设置精细规则：

firewall-cmd --permanent --add-rich-rule='rule family="ipv4" source address="10.0.1.0/24" port port="8008" protocol="tcp" accept' firewall-cmd --reload

6.2 日志监控方案

TLQ的日志分散在多个位置，我整理的关键路径：

• 服务日志：/usr/local/tlq/TLQ8/log/tlq.log
• 控制台日志：/usr/local/tlqmcs/TLQ8.1_ManageConsole/logs/server.log
• Systemd日志：journalctl -u tlq.service

推荐用logrotate做日志轮转：

cat > /etc/logrotate.d/tlq <<EOF /usr/local/tlq/TLQ8/log/*.log { daily missingok rotate 30 compress delaycompress notifempty create 640 tlq tlq sharedscripts postrotate systemctl kill -s HUP tlq.service endscript } EOF

7. 常见故障排查指南

7.1 服务启动失败

先检查基础依赖：

ldd /usr/local/tlq/TLQ8/bin/tlq | grep "not found"

再验证环境变量：

env | grep TLQ

最后检查license：

md5sum /usr/local/tlq/TLQ8/license/license.dat

7.2 控制台访问异常

常见问题排查步骤：

1. 确认端口监听：netstat -tlnp | grep java
2. 检查防火墙：firewall-cmd --list-all
3. 验证JDBC连接：telnet 数据库IP 端口
4. 查看OOM日志：grep -i "outofmemory" console.log

遇到过控制台突然卡顿的情况，后来发现是JVM内存泄漏。用jcmd分析后解决了：

jcmd <pid> GC.heap_dump /tmp/tlqmc.hprof