企业官网建设流程全解析

简介：面向 Linux 运维、中间件实施与服务器管理人员，这份 IBM WebSphere MQ V7.0.1 for Linux on x86-64 多语言安装包，提供了在 x86-64 架构上离线部署企业级消息中间件的完整组件集，能够解决典型安装介质分散、依赖组件不易获取的问题。包内共 420 个文件，压缩后约 465MB，核心为 27 个 RPM 安装包，同时包含 64 个 so 动态库、39 个 jar 组件、62 个 properties 配置文件，以及多语言本地化资源、字体、HTML 文档、配置模板和运维脚本，覆盖服务端运行、Java 开发调试、密钥管理与 TLS 安全通信等场景。已有 155 人学习下载，适合需要搭建 IBM MQ 队列管理器、排查安装依赖顺序或规划高可用消息通信方案的技术人员。通过该安装包可快速获得 MQSeriesServer、MQSeriesJava、MQSeriesKeyMan、MQSeriesEclipseSDK33 等模块，并配合描述中的安装运维说明，完成队列管理器创建、服务启动、连接验证与密钥配置。整体目录结构清晰，适合企业环境离线批量部署、版本基线固化与后续安全审计。

1. 为什么还在关注 V7.0.1 的 x86-64 安装包

CZ4VEML 这个介质标识对应的就是 WebSphere MQ V7.0.1 for Linux on x86-64 Multilingual，一套 2010 年前后发布的 IBM 企业级消息中间件安装包。它还能被搜索到，不是因为版本新，而是因为大量银行、物流和制造业系统至今仍把队列管理器跑在 RHEL 5/6 兼容环境下，新维护的机器反而要逆向适配老客户端。标题里的 Multilingual 意味着安装时可以选择中、日、英等多语言环境，但代价是安装介质的 RPM 结构比单语言版本更绕，很多人卡在“装上了但队列管理器起不来”这一格。这篇文章直接把安装、建队列、客户端连接和排错串成一条可复现的路径，适合中间件运维、系统管理员和需要接老版 MQ 的 Java 开发阅读。

2. 安装介质准备与 RPM 包映射

2.1 CZ4VEML 介质里到底有什么

WebSphere MQ V7.0.1 for Linux on x86-64 的安装介质是一组 RPM 包，而不是单个可执行文件。多语言版本（Multilingual）会把语言包和运行时拆开，安装时不要看到mqm开头的包就全部装上，否则容易把不必要的语言支持带进生产环境。常见做法是先挂载介质，用mount -o loop查看内部结构，再按需安装。

下面是一张常见的包映射表，以 64 位 RPM 为例，实际介质中版本号后缀会略有差异。

安装前先确认架构。V7.0.1 for Linux on x86-64 只能跑在 x86_64 内核上，用uname -m查一下，输出x86_64再继续。不要试图在 32 位系统上强制rpm -ivh --force，会直接损坏 RPM 数据库。

2.2 安装前检查：glibc、libstdc++ 和用户组

老版本 MQ 对操作系统的 glibc 符号有硬性依赖。我一般会在安装前把下面这段检查跑一遍，避免装到一半才发现缺库：

uname -m cat /etc/redhat-release rpm -q glibc libstdc++ libgcc rpm -q compat-libstdc++-33 || true

逻辑说明：第一行看架构，第二行看发行版版本，第三行查运行时库，最后一行只看兼容库是否存在，失败也不中断。WebSphere MQ V7.0.1 在 RHEL 6.x 上安装时，libstdc++.so.6必须存在，否则strmqm启动会直接报error while loading shared libraries。如果输出里缺库，用yum install glibc libstdc++补上，RHEL 5 环境需要额外配本地 yum 源。

安装 MQ 需要mqm用户和mqm组。RPM 包在安装时会自动创建，但手动预建更可控。下面的命令把用户和组固定下来，并把当前用户加入mqm组，方便后续执行管理命令：

groupadd -g 1001 mqm useradd -u 1001 -g mqm -c "MQ runtime user" -s /bin/bash -d /var/mqm mqm usermod -a -G mqm $USER

这里把 UID/GID 固定为 1001，便于在备份恢复时保持一致，生产环境一定要记录下这两个数字。如果系统里已经存在 UID 1001，就换一个不冲突的值，但后续所有 MQ 文件属主都要对应。

2.3 多语言安装：先接受许可，再装语言包

多语言版本比单语言版本多一步：必须先接受许可，否则语言包里的消息文件不会正确注册。在解压介质后，执行：

cd /mnt/mq701 ./mqlicense.sh -accept

参数说明：-accept表示自动接受 IBM 许可证，适合无人值守安装。脚本运行时会检查 X11 图形环境，如果你是通过 SSH 登录的，加上-text_only参数强制文本模式。接受完许可后，陆续安装运行时和服务端：

rpm -ivh MQSeriesRuntime-7.0.1*.x86_64.rpm rpm -ivh MQSeriesServer-7.0.1*.x86_64.rpm rpm -ivh MQSeriesSamples-7.0.1*.x86_64.rpm rpm -ivh MQSeriesMsg_zh_CN-7.0.1*.x86_64.rpm

安装顺序上，Runtime 必须在 Server 前，语言包放在最后。RPM 之间存在依赖关系，rpm -ivh会自动检查，如果提示failed dependencies，多半是运行时先没装好。安装完成后，用rpm -qa | grep MQSeries列出已安装包，确认MQSeriesServer确实存在。别忘了把/opt/mqm/bin加进 PATH：

echo 'export PATH=$PATH:/opt/mqm/bin' >> /etc/profile.d/mqm.sh echo 'export MANPATH=$MANPATH:/opt/mqm/man' >> /etc/profile.d/mqm.sh source /etc/profile.d/mqm.sh

这里把环境变量写进/etc/profile.d/mqm.sh，对所有登录用户生效。注意 V7.0.1 在安装过程中不会自动生成这个文件，不要依赖默认安装逻辑。

3. 队列管理器与队列的最小落地配置

3.1 用 crtmqmq 创建队列管理器的参数选择

安装完成后，第一件事是创建队列管理器。V7.0.1 的默认队列管理器数据目录是/var/mqm/qmgrs，可通过/var/mqm/mqm.ini里的DefaultPrefix修改。创建时最常用的参数是-q和-p：

crtmqm -q QM1 -p 1414 QM1

-q表示启用队列管理器属性（queue manager），允许运行时动态调整某些参数；-p指定默认监听端口 1414。这里队列管理器名也叫 QM1，单机构环境下没问题。如果生产环境是多队列管理器并存，建议把端口拆开，例如crtmqm -q QM_PAY -p 1415 QM_PAY。

创建完不自动启动，需要手动执行：

strmqm QM1

strmqm启动过程会检查 IPC 资源，包括共享内存、信号量和消息队列。如果系统参数设置过小，启动会报AMQ6234之类的错误，随后在/var/mqm/qmgrs/QM1/errors下生成 FDC 文件。遇到时用ipcs -l查看当前内核限制，再用sysctl调整kernel.sem和kernel.shmmax，但改完通常需要重启 MQ 实例才生效。

3.2 用 runmqsc 定义监听器、队列和通道

队列管理器启动后，进入 MQSC 交互模式定义资源。下面脚本是生产上最常见的最小集：

runmqsc QM1

然后在 MQSC 提示符下输入：

DEFINE LISTENER('L01') TRPTYPE(TCP) PORT(1414) CONTROL(QMGR) START LISTENER('L01') DEFINE QLOCAL('Q.REQ') DEFPSIST(YES) MAXDEPTH(50000) DEFINE CHANNEL('S01') CHLTYPE(SVRCONN) TRPTYPE(TCP) MCAUSER('mqm') ALTER QMGR CHLAUTH(DISABLED) DEFINE CHANNEL('CL01') CHLTYPE(CLNTCONN) TRPTYPE(TCP) CONNAME('127.0.0.1(1414)') QMNAME('QM1') END

参数说明：监听器L01的CONTROL(QMGR)让监听器随队列管理器启停，省去每次手工启动；DEFPSIST(YES)保证消息在队列管理器重启后不丢失；MAXDEPTH(50000)是队列最大深度，超出后会停止写入；SVRCONN通道用于本地或远程客户端连接，MCAUSER('mqm')把通道身份固定为 mqm 用户；CHLAUTH(DISABLED)只在测试环境关闭通道认证，生产环境不建议这样写，第 4 章会讲安全做法。

队列和通道定义完成后，用DISPLAY QLOCAL('Q.REQ')查看队列状态，DISPLAY CHANNEL('S01')检查通道是否处于 RUNNING。如果通道状态显示INACTIVE，多半是监听器没起来，返回上一步确认。

3.3 文件权限与 SELinux 对消息落盘的影响

WebSphere MQ 运行时对/var/mqm的权限非常敏感。V7.0.1 安装完成后，管理员经常遇到AMQ5014（无法访问消息文件），原因就是/var/mqm目录被chown给了错误用户。标准权限是：

chown -R mqm:mqm /var/mqm chmod -R 775 /var/mqm find /var/mqm -type d -exec chmod 2775 {} \;

最后一条命令给目录打上 setgid 位，保证新创建的子目录继承mqm组，避免存储过程或外部脚本创建文件时属主混乱。RHEL 6 默认开启 SELinux，如果sestatus显示 enforcing，MQ 会报权限错误，临时验证可以：

setenforce 0 strmqm QM1

如果setenforce 0后队列管理器能启动，说明是 SELinux 策略问题。常规做法不是关 SELinux，而是用audit2allow生成自定义模块。不过考虑到 V7.0.1 年代较早，很多生产环境为兼容中间件直接选择了 permissive 模式，这个决定是否可接受，取决于你所在公司的安全基线。

3.4 必须记住的一批 runmqsc 参数

这些参数在 MQSC 里都是可在线修改的。比如想把队列深度改大，不需要重建队列，直接ALTER QLOCAL('Q.REQ') MAXDEPTH(100000)，修改即时生效。V7.0.1 对MAXMSGL的限制是 100MB，超过这个值必须启用分段消息。

4. 客户端连接与多语言编码的真实坑位

4.1 连接通道认证：从 CHLAUTH 到 MCAUSER

V7.0 引入 CHLAUTH 后，SVRCONN 通道不再是不设防的。默认情况下，从非本地 IP 发起的连接会被拒绝，日志里出现AMQ9777。如果你在 3.2 节里执行了ALTER QMGR CHLAUTH(DISABLED)，那只是权宜之计。生产环境我一般这样配：

ALTER QMGR CHLAUTH(ENABLED) DEFINE CHLAUTH('S01') CHLTYPE(SVRCONN) BLOCKADDR('*') ACTION(REPLACE) RULE(1) DEFINE CHLAUTH('S01') CHLTYPE(SVRCONN) BLOCKADDR('10.10.0.*') ACTION(ADD) RULE(2) ALTER CHANNEL('S01') CHLTYPE(SVRCONN) MCAUSER('mqm')

逻辑说明：第一条规则把S01通道的所有地址拉黑，第二条规则放行10.10.0.0/24网段，最后把通道的用户改为 mqm。这样即使连接者声明自己是 root，也拿不到 mqm 权限。注意 V7.0.1 的 CHLAUTH 规则匹配顺序是规则编号从小到大，RULE(1)和RULE(2)的顺序不能倒。配置完成后用DISPLAY CHLAUTH('S01') ALL检查。

4.2 JMS 连接前的 JDK 版本选择

V7.0.1 的 JMS 客户端对 Java 版本有兼容边界。我在测试环境遇到最多的问题是用了较新的 JDK，连接时抛ClassNotFoundException: com.ibm.mq.MQException，这是因为安装介质里的com.ibm.mq.jar只认老 Java 反射方式。常见做法是安装 JDK 6 或 JDK 7，如果必须用 JDK 8，就换成 MQ V7.5 以上的客户端包。V7.0.1 的监听端口测试用下面的 Java 代码最省事：

import com.ibm.mq.MQQueueManager; import com.ibm.mq.MQQueue; import com.ibm.mq.MQMessage; public class MQPut { public static void main(String[] args) throws Exception { MQQueueManager qmgr = new MQQueueManager("QM1"); MQQueue queue = qmgr.accessQueue("Q.REQ", 2); MQMessage msg = new MQMessage(); msg.writeUTF("hello from linux x86-64"); queue.put(msg); queue.close(); qmgr.disconnect(); System.out.println("put ok"); } }

MQQueueManager构造器默认从mqm.ini中读取连接信息，所以本地测试时不需要写 hostname。accessQueue的第二个参数2代表MQOO_OUTPUT，只写不读。编译前把/opt/mqm/java/lib/com.ibm.mq.jar加进 classpath：

export CLASSPATH=/opt/mqm/java/lib/com.ibm.mq.jar:/opt/mqm/java/lib/com.ibm.mqjms.jar javac MQPut.java java MQPut

如果编译报错，先检查/opt/mqm/java/lib里有没有com.ibm.mq.jar，这个文件在只装 Server 包时不一定会出现，需要补装MQSeriesJava相关 RPM。

4.3 CCSID：多语言版本最容易翻车的消息编码

多语言包的坑通常在连接成功后表现，而不是连接失败。客户端默认 CCSID 是 819（ISO-8859-1），队列管理器默认是 1381（GB2312）或 1208（UTF-8），消息经MQMessage.writeUTF写入时，字符编码和字节序列不一致，接收方就出现乱码。V7.0.1 的连接代码里需要显式指定编码：

msg.characterSet = 1208;

或者在 JMS 连接工厂里设置：

cf.setIntProperty("CCSID", 1208);

这样消息体的字节按 UTF-8 处理。如果负责人要求消息在 WebSphere MQ Explorer 里也能正常浏览，队列定义里的CCSID属性要和客户端一致，定义时可加CCSID(1208)。不过要注意，老系统如果沿用 1381，跨版本改变编码会导致既有消费程序乱码，这种调整要先和业务方确认。

4.4 连接失败时先看这组命令

当客户端报2035 MQRC_NOT_AUTHORIZED或2059 MQRC_Q_MGR_NAME_ERROR时，不要急着改代码。在 MQ 服务器上按顺序排查：

dspmq -m QM1 echo "DISPLAY CHS('S01') ALL" | runmqsc QM1 ping -c 2 127.0.0.1 netstat -an | grep 1414

dspmq看队列管理器是否运行；DISPLAY CHS看通道状态；netstat确认监听端口已打开。V7.0.1 端口默认只绑到localhost的情况很常见，如果是远端连接，查看监听器定义是否用了PORT(1414)但没指定BIND(NOTFIXED)，必要时重建监听器加BIND(NOTFIXED)允许外部网络访问。

5. 安装后的快速验证与日志定位技巧

5.1 一行命令确认版本和补丁级别

用dspmqver -i只能看安装版本，看队列管理器实际运行的补丁级别要用下面的方式：

/opt/mqm/bin/dspmqver -v /opt/mqm/bin/dspmq -m QM1

dspmqver -v输出的Version字段如果带7.0.1.13之类的后缀，说明打了修复包。如果版本号不带补丁号，而strmqm日志里出现已知 bug 告警，就该考虑升级包。V7.0.1 的补丁包以MQSeriesFixPack命名，安装后需要重新运行mqlicense.sh确认许可。

5.2 日志和 FDC 文件的快速定位路径

队列管理器启动失败或运行时异常，首先看/var/mqm/qmgrs/QM1/errors下的三个文件：AMQERR01.LOG、AMQERR02.LOG和AMQERR03.LOG。这些日志轮换到 03 后会自动覆盖，无法扩容，所以要定期归档。定位故障时用grep -i error AMQERR*.LOG，把错误码（如AMQ6234）和 FDC 文件名关联起来。FDC 文件一般以AMQ开头，后缀是.FDC，里面包含进程栈和系统参数快照，适合提交给 IBM 支持前查看。

5.3 用 dmpmqcfg 把配置做成可恢复脚本

生产环境维护老版本 MQ，最怕现场变更后没留档。V7.0.1 提供了dmpmqcfg命令，可以把队列管理器定义导出成 MQSC 脚本：

dmpmqcfg -m QM1 -a > /backup/QM1_config.mqsc

-a表示导出全部对象。导出脚本后，用runmqsc QM1 < /backup/QM1_config.mqsc可以在新环境里全量恢复。注意导出文件里可能包含ALTER QMGR CHLAUTH(DISABLED)这类安全设置，重新执行前要逐行核对。配合/var/mqm/qmgrs/QM1下的qm.ini一起备份，能覆盖队列管理器级别和日志级别的所有参数。

5.4 让 V7.0.1 在新内核上稳定工作

如果新装系统是 RHEL 7 以上内核，V7.0.1 会偶尔出现信号量分配问题。建议在/etc/sysctl.conf里显式设置：

kernel.sem = 250 32000 100 128 kernel.shmmax = 68719476736 kernel.shmall = 16777216

设置完成后sysctl -p生效。这些值不是随意拍的，shmmax对应 MQ 日志缓冲和消息缓冲的总上限，sem最后一个参数表示信号量集合数量，至少要大于队列管理器数加线程池上限。如果启动时仍报AMQ5591，检查/var/mqm所在文件系统是否开启了大页内存，cat /proc/meminfo | grep HugePages出现非零数值时，需要为 mq 进程预留足够剩余内存，或者临时关闭大页分配。整个调优过程围绕“数据不丢、队列不堵”进行，改完参数务必在业务低峰期重启队列管理器验证。

本文还有配套的精品资源，点击获取