| Sun ONE Message Queue 3.0.1 SP2 安装指南 |
第 2 章
Solaris 安装本章介绍关于 Solaris 安装的以下主题：
硬件和软件要求Solaris™ 开发系统（SPARC™ Platform Edition）至少应该满足下表给出的最低要求。
表 2-1 针对 Solaris 平台的硬件和软件要求
组件
要求
操作系统
Solaris 8 或 Solaris 9（SPARC 平台）。
Solaris 9 update 4 或更高版本（SPARC 和 x86 平台）。注意：要确保 MQ 进行正确操作，您应安装所需的适用于 Java 2 的 Solaris 修补程序。有关修补程序的最新信息以及下载推荐的和所需的修补程序，请参见：
CPU
构建于 TCP/IP 网络的 Sun Ultra™ 1（或兼容的）工作台。
RAM
128 MB
硬盘空间
压缩的安装文件大约为 6 MB。
另外，用来解压缩安装文件的临时工作目录需要 8 MB 空间。
安装的产品大约需要 8 MB 的硬盘空间，但是，如果代理在本地存储持久性消息，MQ 将需要更多空间。
Java 2 Standard Edition (J2SE)
有关 Solaris 支持的 Java Runtime Environment (JRE) 和 Java Software Development Kit (JDK) 版本，请参见表 1-1。
发行时，MQ 软件分发 CD 包含所需的 JRE 版本。
在 Solaris 上安装 MQ可以通过从 Sun ONE 的 Web 站点下载来安装 MQ 产品，也可以从产品 CD-ROM 安装。有关详细信息，请参见下面相应的小节。
从 Web 进行安装
下面说明如何从 Sun ONE 的 Web 站点下载 MQ 产品以及如何在 Solaris 上安装此产品。
要在 Solaris 平台上从 Web 安装 MQ
- 请从 Web 站点上将 MQ 产品下载到一个空的临时工作目录中。
- 运行命令脚本：
sh imq3_0_1-edition-solsparc.sh
其中 edition 可以取以下值之一：plt 或 ent，这取决于您安装的是 Platform Edition 还是 Enterprise Edition。
此命令将显示产品许可协议的第一个页面。
- 阅读产品许可协议。要安装和使用此产品，必须接受许可协议。
- 要显示整个许可协议，且每次只显示一个页面，请不断地按空格键。当到达许可协议结尾时，程序将提示您接受许可协议。
- 解压缩以下归档文件：
/bin/zcat imq3_0_1-edition-solsparc.tar.Z | tar xvfp -
将创建一个新目录 imq3_0_1-pkgs。
- 更改目录：
cd imq3_0_1-pkgs
- 成为 root 用户：
su root
- 确定系统上已经安装哪些 MQ 共享软件包（如果有）。
要查看此类软件包列表，请键入：
pkginfo SUNWaclg SUNWjaf SUNWjhrt SUNWjmail SUNWxsrt
显示的列表列出了已安装的软件包以及无法找到的软件包。
- 运行 pkgadd 命令来安装有关软件包：
pkgadd -d ./
pkgadd 实用程序列出了目录中可以安装的所有软件包（请参见表 2-2）。出现提示时，请指明要安装的软件包。（请勿安装步骤 8 中找到的任何共享软件包。）
pkgadd 实用程序将安装您指定的软件包（可能需要其它信息），最后会返回原始提示，并显示可以安装的软件包列表。
表 2-3 给出了不同的使用方案所需的软件包：
- 键入 q 退出。
- 退出 root shell。
- 备份临时工作目录中的 imq3_0_1-edition-solsparc.sh 文件。
此文件是您的逻辑介质。可以像处理其它安装介质一样处理此文件。在一个安全的位置保留一份副本，以防遇到需要重新安装该产品的情况（例如系统故障）。
- 清除临时工作目录中的所有剩余文件。
从 CD-ROM 进行安装
下面说明如何在 Solaris 上从 CD-ROM 安装 MQ 产品。
要在 Solaris 上从 CD-ROM 安装 MQ
- 以 root 用户身份登录或更改为超级用户。
例如，在命令提示符下键入以下内容：
su root
然后键入您的超级用户密码。
- 将 MQ CD 插入您的 CD-ROM 驱动器。
如果您的计算机正在运行 Volume Manager™ 软件，则 CD-ROM 将自动安装到 /cdrom/messagequeue3_0_1 目录。
如果您的计算机没有运行 Volume Manager：
打开并阅读（使用您喜欢的文本编辑器）LICENSE 文件，该文件位于 CD 的 solaris/ 目录中。
- 转到 CD 中含有安装软件包的目录。例如，键入：
cd /cdrom/messagequeue3_0_1/solaris/imq3_0_1-pkgs
根据产品版本的不同，此目录的内容有所不同。
- 运行 pkgadd 命令来安装有关软件包：
pkgadd -d ./
pkgadd 实用程序列出了目录中可以安装的所有软件包。出现提示时，请指明要安装的软件包（请参见表 2-2）。
- 当返回 pkgadd 提示时，键入 q 退出。
- 退出 root shell。
将 MQ 配置成自动启动如果您希望将代理（MQ 消息服务器）设置成自动启动，则需要成为 root 用户并编辑以下配置文件：
/etc/imq/imqbrokerd.conf
表 2-4 中显示了您可以在此配置文件中设置的启动属性：
表 2-4 代理启动配置属性
属性名称
说明
AUTOSTART
指定 (YES/NO) 代理是否在引导时自动启动。默认值：NO
ARGS
指定传送给代理启动命令的命令行选项和变量。要获得 imqbrokerd 命令行选项的列表和说明，请参见《MQ 管理员指南》。（例如 -name brokerName）
RESTART
指定 (YES/NO) 代理异常退出时是否自动重新启动。默认值：YES
要检查启动更改是否正确（无需引导系统），您可以作为 root 用户在“调试”模式下明确地运行 MQ 初始化脚本 (S52imq)：
env DEBUG=1 /etc/rc3.d/S52imq start
为 MQ 配置 Java 运行时启动时，代理（MQ 消息服务器）将检查是否具有所需的 Java 运行时版本 (JDK/JRE 1.4)。
需要安装正确的 JDK/JRE 来运行 MQ。有关 MQ 支持的 JDK/JRE 版本的详细信息，请参见表 1-1。
有多种方法配置或设置代理所用的 JRE。下面的列表按优先级顺序列出了这些方法：
要查明为什么代理拾取特定的 JDK/JRE，您可以使用以下命令启动该代理：
imqbrokerd -verbose
升级版本MQ 有两个版本，如产品版本中所述。
要从 Platform Edition 升级到 Enterprise Edition，您需要安装 Enterprise Edition 许可证。此安装不会覆写已安装的 MQ 模块，而且不会修改 MQ 消息传送系统的配置。
要安装 Enterprise Edition 许可证，仅需要 Enterprise Edition 中的 SUNWiqlen 软件包。运行安装命令脚本、解压缩文件归档和解压缩归档文件后，SUNWiqlen 软件包将自动放在 imq3_0_1-pkgs目录中（Web 安装）或放在 solaris/imq3_0_1-pkgs 目录中（CD-ROM 安装）。
要在 Solaris 上升级到 Enterprise Edition
- 停止所有运行的代理。
imqcmd shutdown bkr -u name -p password [-b hostName:port]
- 执行从 Web 进行安装中的步骤 1 至步骤 6 或从 CD-ROM 进行安装中的步骤 1 至步骤 3。
- 安装完成后，添加 SUNWiqlen 软件包：
pkgadd -d .SUNWiqlen
- 通过运行以下命令验证 Enterprise Edition 许可证是否可用：
imqbrokerd -license
如何继续阅读 README 和 MQ 发行说明文件。
有关 Sun ONE Message Queue 概念的概述、编写和编译客户机应用程序的简短介绍，请参见《MQ 开发者指南》。
有关配置代理和管理 MQ 消息传送系统的详细信息，请参见《MQ 管理员指南》。
有关编写客户机应用程序时使用的类及成员的信息，请参见 /usr/share/javadoc/imq 目录中的 API 文档。
要卸载产品，请参见下一节。
从 Solaris 上卸载 MQ下面说明如何卸载 MQ。
要从 Solaris 上删除 MQ
- 停止所有运行的客户机应用程序。
- 停止所有运行的代理。
imqcmd shutdown bkr -u name -p password [-b hostName:port]
- 除非您希望保留动态代理数据，否则请删除每个代理实例关联的所有数据文件。
imqbrokerd -name brokerName -remove instance
- 如果您希望保留 MQ 文本文件用户系统信息库和 MQ 访问控制文件，请在删除 MQ 软件包之前将以下文件复制到安全的位置（在重新安装或升级 MQ 后可以恢复这些软件包）：
/etc/imq/passwd
/etc/imq/accesscontrol.properties
- 确定安装有哪些 MQ 软件包。
要使用 pkginfo 查看系统上安装的 MQ 软件包列表，请键入：
pkginfo | grep SUNWiq
显示的列表中不显示您系统上由 MQ 安装的共享软件包（SUNWaclg、SUNWjaf、SUNWjhrt、SUNWjmail 和 SUNWxsrt）。除非您更新到 MQ 的更高版本（并用更新的版本替代这些共享软件包），否则建议不要删除共享软件包。
- 通过键入以下内容成为 root 用户：
su root
出现提示时，键入您的 root 密码。
- 删除使用 pkgadd 安装的 MQ 软件包。
执行以下命令：
pkgrm packageName
其中，packageName 是使用 pkgadd 安装的任意 MQ 软件包或共享软件包。要删除多个软件包，软件包名称之间用空格分隔。
因为其它产品可能在使用 MQ 软件包，所以删除它们时要慎重。删除之前，pkgrm 命令将给出警告，指出其它产品可能需要此软件包。
- 出现提示时，键入 y 确认您的删除请求。
