Sun ONE Message Queue 3.0.1 SP2 安装指南 |
第 1 章
简介本章全面介绍如何安装 MQ 产品。包括以下主题:
产品版本Sun ONE Message Queue 产品有两个版本:Platform Edition 和 Enterprise Edition,每个版本对应于不同的许可功能,如下所述。(要将 MQ 从一个版本升级到另一个版本,请参见《MQ 安装指南》中的说明。)
Platform Edition
此版本可以从 Sun 的 Web 站点免费下载,并且还捆绑有最新的 Sun ONE Application Server 平台。Platform Edition 对每个 MQ 消息服务所支持的 JMS 客户机连接的数量没有限制。它附带两个许可证,如下所述:
- 基本许可证。此许可证提供基本的 JMS 支持(它是 JMS 的全权提供者),但是不具有某些企业功能,例如负荷平衡(多代理消息服务)、HTTP/HTTPS 连接、安全连接服务、可伸缩连接功能以及多队列传送策略。此许可证没有期限限制,因此可用于要求不太严格的生产环境。
- 90 天试用企业许可证。此许可证具有基本许可证所没有的全部企业功能,例如支持多代理消息服务、HTTP/HTTPS 连接、安全连接服务、可伸缩连接功能以及多队列传送策略。但是,此许可证的期限限制为 90 天,因此,此许可证适用于评估本产品 Enterprise Edition 所提供的企业功能(请参见 Enterprise Edition)。
Enterprise Edition
此版本用于在生产环境中部署和运行消息传送应用程序。它支持多代理消息服务、HTTP/HTTPS 连接、安全连接服务、可伸缩连接功能以及多队列传送策略。您还可以使用 Enterprise Edition 进行开发、调试,并可以装入测试消息传送应用程序和组件。Enterprise Edition 对许可证没有期限限制,对多代理消息服务中的代理数量也没有限制,但对所支持的 CPU 数量有限制。
支持的平台和产品MQ Solaris、Linux 和 Windows 操作系统和平台可以支持 3.0.1 SP2。是否受支持还取决于其它技术,如下表所示。虽然也可以使用其它版本或供应商实现,但是因为它们未经 Sun Microsystems 测试,因此不受支持。
表 1-1 MQ 3.0.1 产品支持列表
平台/产品
用于
支持的平台/产品版本1
Java Runtime Environment (JRE)
(仅适用于 Sun Microsystems 的各种产品版本)MQ 代理(消息服务器)和 MQ 管理工具
JDK/JRE 1.4.1_03:
JDK/JRE 1.4.1:
Java Software Development Kit (JDK), Standard Edition
(仅适用于 Sun Microsystems 的各种产品版本)JMS 客户机开发
(仅 JDK 1.4.1_03 支持 SOAP 消息传送客户机)
版本 1.4.1_032:
版本 1.3.1_053:
版本 1.2.2_08:不支持,但可以使用(用于无法升级到更高版本的情况)
LDAP Directory Server
MQ 用户系统信息库和被管理对象支持
Sun ONE Directory Server 版本 5.1
Web Server
HTTP 和 HTTPS 支持
Sun ONE Web Server, Enterprise Edition 6.0 SP4
数据库
插入持久性支持
Cloudscape(版本 3.0)
Oracle 8i(版本 8.1.7)和 Oracle 9i(版本 9.0.1)
JNDI
被管理对象支持
1 有关所支持版本的任何更新信息,请参见 MQ 发行说明
2 可以从以下位置下载此 JDK:http://java.sun.com/j2se/1.4/index.html
3 可以从以下位置下载此 JDK:http://java.sun.com/j2se/1.3/index.html
MQ 软件模块下表介绍了 MQ 产品包含的所有软件模块(有关它们的安装位置,请参见表 1-2)。
从 Web 和 CD-ROM 进行安装您可以通过从 Sun ONE 的 Web 站点下载来安装 MQ 3.0.1 SP2 产品,也可以从 CD-ROM 安装该产品。有关详细说明,请参见下面章节中针对各个平台的说明。
安装的目录结构下面的安装映像反映的是完全 Solaris 安装(所有软件包)或完全(“典型”)Windows 安装。如果您执行部分安装,相应的映像可能会不同。
表 1-3 安装的目录结构
文件和目录
(Solaris)文件和目录(Windows 和 Linux)1
内容
COPYRIGHT(不安装)
./COPYRIGHT
版权文本文件
LICENSE(不安装)
./LICENSE
许可证文本文件
README(不安装)
./README
README 文本文件
/usr/bin 目录
./bin 目录
包含代理 (imqbrokerd) 和以下 MQ 管理工具的可执行文件:
在 Windows 中,上面这些文件的文件扩展名为 .bat。此目录中还包含用来安装和卸载作为 Windows 服务的代理的实用程序 (imqsvcadmin) 以及其它可执行文件 (imqbrokersvc)。
/usr/share/lib 目录
./lib 目录
包含支持 MQ 客户机运行时的文件:
/*jar 包含用来编译和运行 JMS 客户机应用程序的 jar 文件。
/usr/share/lib/imq 目录
./lib 目录
包含用来支持 MQ 工具和进程的文件:
/ext/*jar 位置用来放置插入持久性功能所需的 jar 文件
/props 子目录包含代理的默认配置文件
/help 子目录包含 MQ 帮助文件
/images
/etc/imq 目录
./etc 目录
包含许可证文件、与安全性相关的文件(例如密码文件、访问控制文件和文本文件用户系统信息库)和(仅适用于 Solaris)可用来自动启动的 rc 脚本配置文件
/var/imq 目录
./var 目录
MQ 的工作存储目录
/instances 子目录,将包含配置文件、日志文件和为每个代理实例存储的基于文件的持久性数据
/usr/share/javadoc/imq 目录
./javadoc 目录
包含以 Javadoc (HTML) 分发的 MQ 和 JMS API 文档
/usr/demo/imq 目录
./demo 目录
客户机实例应用程序的源代码及其运行说明
./jre 目录
JRE 1.4 文件(仅适用于 Windows)
从版本 2.0 升级MQ 3.0.1 SP2 与 MQ 3.0.1 和 MQ 3.0.1 SP1 完全兼容,并且从 MQ 3.0.1 或 MQ 3.0.1 SP1 升级到 MQ 3.0.1 SP2 时,无需更改代理配置、被管理对象、管理工具和客户机应用程序。
但 MQ 3.0.1 的各个版本通常与 iMQ 2.0 不兼容,这主要是因为 MQ 3.0.1 的各个版本更改了使用的内部数据和外部数据。因此,强烈建议您在安装 MQ 3.0.1 的任何版本之前卸载 iMQ 2.0,且不要尝试在 iMQ 2.0 上安装 MQ 3.0.1。
卸载 iMQ 2.0
如果您运行的是 iMQ 2.0 Service Pack 1,则应该首先按照《Service Pack 安装指南》中的卸载说明卸载 Service Pack,然后再按照《iMQ 2.0 安装指南》中的卸载说明卸载 iMQ 2.0。
卸载操作不会删除 iMQ 2.0 IMQ_VARHOME 目录。此目录(在 Solaris 和 Linux 操作系统上默认为 /var/opt/SUNWjmq,在 Windows 系统上默认为 c:\Program files\iPlanetMessageQueue2.0\var)包含瞬态文件和与安全性相关的文件(请参见表 1-4)。这些数据中的一部分与 MQ 3.0.1 兼容,并且可以按照下一节中的说明进行保留。
兼容与不兼容
由于改善功能时进行了一些更改,因此 MQ 3.0.1 的各个版本通常与 iMQ 2.0 不兼容。特别是,从 iMQ 2.0 升级到 MQ 3.0.1 SP2 时,可能有许多问题需要考虑:
代理兼容性
由于更改了代理属性和持久性存储架构,因此 MQ 3.0.1 代理不会与 iMQ 2.0 代理进行互操作。但是,如表 1-4 中所示,部分 iMQ 2.0 数据与 MQ 3.0.1 兼容,并且能够在升级到 MQ 3.0.1 时保留这些数据。从 iMQ 2.0 升级到 MQ 3.0.1 时,您应当考虑以下问题:
- 将 iMQ 2.0 config.properties 文件复制到其它位置,并且在大多数情况下,需要在配置 MQ 3.0.1 代理时考虑这些文件包含的属性设置。
- 任何持久性 iMQ 2.0 数据(消息、目标、长期订阅)均不能重复使用。特别是,您需要在 MQ 3.0.1 代理中重新创建 iMQ 2.0 目标。
- 安装完 MQ 3.0.1 之后,可以继续使用 iMQ 2.0 用户系统信息库以及访问控制属性文件。MQ 3.0.1 安装程序不会覆写这些文件。您需要将这些文件移到 MQ 3.0 中的相应位置(请参见《MQ 管理员指南》中的附录 C)。
被管理对象的兼容性
MQ 3.0.1 管理的对象增添了新属性,并且 iMQ 2.0 属性已经被重新命名。所以,从 iMQ 2.0 升级到 MQ 3.0.1 时,您应当考虑以下问题:
- 可以使用在 iMQ 2.0 中创建的对象存储和被管理对象;但最好在安装完 MQ 3.0.1 之后升级被管理对象。在执行更新操作时,管理控制台 (imqadmin) 和 ObjectManager 命令行实用程序 (imqobjmgr) 将把 iMQ 2.0 管理的对象转换为 MQ 3.0.1 管理的对象。
- MQ 3.0.1 客户机运行时将查找 iMQ 2.0 管理的对象,并通过将其转换为本地 MQ 3.0.1 管理的对象来将其实例化,但是这不会将对象存储中的 iMQ 2.0 管理的对象转换为 MQ 3.0.1 管理的对象。
- 需要重写将被管理对象(即依赖于 JMS 提供者的对象)直接实例化的 JMS 客户机(应用程序和/或组件),以适应新的被管理对象属性名称(有关被管理对象属性的信息,请参见《MQ 开发者指南》中的第 4 章和附录 A)。
- 需要重写启动 JMS 客户机的脚本和使用命令行选项设置被管理对象属性值的脚本,以适应新的被管理对象属性名称(有关被管理对象属性的信息,请参见《MQ 开发者指南》中的第 4 章和附录 A)。
管理工具的兼容性
由于重命名了许多文件和目录(特别是将字符串“jmq”替换为“imq”),因此所有 MQ 3.0.1 命令行实用程序、代理属性、被管理对象属性和内部文件名均已更改。所以,从 iMQ 2.0 升级到 MQ 3.0.1 时,您应当考虑以下问题:
- 需要编辑所有使用命令行实用程序(imqbrokerd、imqcmd 和 imqobjmgr 等)的脚本,以将旧命令替换为新命名的命令。请特别注意,jmqbroker 命令现在为 imqbrokerd。
- 管理控制台 (imqadmin) 使您可以同时管理多个代理和/或对象存储,并保存显示在屏幕左侧导航窗格中的管理的实体列表。因此,每次启动控制台时都将重新显示管理的实体列表。对于 MQ 3.0.1,存储 iMQ 2.0 管理控制台的用户设置的目录的名称已经更改。从 iMQ 2.0 升级到 MQ 3.0.1 时,如果你希望保留旧的控制台设置,则需要将存储 brokerlist.properties 和 objstorelist.properties 文件的目录名称由 user.home/.jmq/admin 更改为 user.home/.imq/admin,其中 user.home 是 Java 系统属性。
客户机的兼容性
从 iMQ 2.0 升级到 MQ 3.0.1 时,您应当考虑以下问题:
如何继续当您要在特定平台上安装 MQ 时,请参见针对您的平台(Solaris、Linux 或 Windows)的相应章节。每章包含硬件和软件要求、安装步骤和其它相关说明,例如如何升级版本以及安装之后如何继续进行操作。