Sun ONE logo      上一个      目录      下一个     

Sun ONE Message Queue 3.0.1 SP2 安装指南

第 3 章
Linux 安装

本章介绍关于 Linux 安装的以下主题：

硬件和软件要求

Linux 开发系统至少应该满足下表给出的最低要求。

表 3-1 针对 Linux 平台的硬件和软件要求 

组件

要求

操作系统

Red Hat Advanced Server 2.1 Update 2

CPU

Intel Pentium 2（或兼容的处理器）

RAM

256 MB

硬盘空间

包含该产品的 zip 文件大约为 9 MB。

安装的产品大约需要 8 MB 的硬盘空间，但是，如果代理在本地存储持久性消息，MQ 将需要更多空间。

Java 2 Standard Edition (J2SE)

有关 Linux 支持的 Java Runtime Environment (JRE) 和 Java Software Development Kit (JDK) 版本，请参见表 1-1。

发行时，MQ 软件分发 CD 包含所需的 JRE 版本。

在 Linux 上安装 MQ

可以通过从 Sun ONE 的 Web 站点下载来安装 Sun ONE Message Queue 产品，也可以从产品 CD-ROM 安装。有关说明，请参见下面相应的小节。

注意

如果从 MQ 3.0 或 MQ 3.0.1 版本进行升级，建议您首先按照具体 MQ 版本的安装指南中的说明来卸载 MQ 软件，然后再安装 MQ 3.0.1 SP2。

查找并删除早期的 MQ 版本

因为 MQ 是与其它产品（Sun ONE Application Server 7.0 或者别的产品）一起安装的，所以您应该检查系统上是否已经安装了 MQ，并在安装 MQ 3.0.1 SP2 之前将其卸载。

如果您发现系统上已经安装了 MQ 的早期版本，则需要决定是否要保留任何与安全性相关的数据（文本文件用户系统信息库、访问控制文件等）。如果要保留，则需要在卸载 MQ 之前将这些文件复制到安全的位置。

根据版本不同，MQ 可能是使用 tar 文件或 Red Hat Package Manager (RPM) 进行安装的。因此，要检查已安装的版本，需要检查这两者。建议您首先检查 RPM 安装，然后再检查 tar 文件安装。

查找并删除 MQ RPM（仅适用于 3.0.1 SP1 或更高版本）

    要查找并删除使用 RPM 安装的 MQ 早期版本
  1. 输入以下命令：

    2. rpm -qa | grep imq

    如果找到，将所有 RPM 的版本号嵌入到 RPM 名称中。如果没有找到，继续查找并删除基于 tar 安装的 MQ 版本。

    注意

    对于 MQ 3.0.1 SP2，在卸载 MQ 3.0.1 SP2 之前，您需要将早期版本的实例数据和与安全性相关的文件手动备份到安全的位置（如果希望保留这些数据和文件）。

  2. 如果找到任何 MQ RPM，请备份早期版本的实例数据和与安全性相关的文件，并删除该产品，方法如下：
    1. 将以下文件复制到安全位置：

      2. IMQ_HOME/etc/passwd
      IMQ_HOME/etc/accesscontrol.properties

      安装 MQ 3.0.1 SP2 之后可以恢复这些文件。

    2. 删除安装的现有 MQ 软件。

      3. rpm -e RPMName

查找并删除基于 tar 安装的 MQ 版本

    要查找并删除基于 tar 安装的早期 MQ 版本
  1. 查看系统上是否存在默认的 MQ 安装目录 (/opt/imq/bin)。

    2. 如果存在，继续进行步骤 2。

    如果不存在，MQ 可能安装在默认位置以外的其它地方。如果您不记得安装目录，请搜索 MQ imqbrokerd 可执行文件并注意它的根安装目录。继续步骤 2。

    注意

    对于 MQ 3.0.1 SP2，在卸载 MQ 3.0.1 SP2 之前，您需要将以前版本的实例数据和与安全性相关的文件手动备份到安全的位置（如果希望保留这些数据和文件）。

    如果不存在 MQ 早期版本，请按照从 Web 进行安装或从 CD-ROM 进行安装中的说明来安装 MQ。

  2. 如果在默认位置 (/opt/imq/bin) 中找到 MQ 早期版本，备份早期版本的实例数据和与安全性相关的文件并删除该产品，方法如下：
    1. 将以下文件复制到安全位置：

      2. IMQ_HOME/etc/passwd
      IMQ_HOME/etc/accesscontrol.properties

      安装 MQ 3.0.1 SP2 之后可以恢复这些文件。

    2. 删除 /opt/imq/ 目录及其所有内容。

      3. rm -rf /opt/imq

从 Web 进行安装

下面说明如何从 Sun ONE 的 Web 站点下载 MQ 产品以及如何在 Linux 上安装此产品。

    要在 Linux 平台上从 Web 安装 MQ
  1. 接受 MQ 产品下载站点的许可协议。
  2. 将 MQ 产品分发文件从 Web 站点下载到一个空的临时下载目录 (temp_directory) 中。

    3. 下载文件是：imq3_0_1-edition-linx86.zip

    其中 edition 可以取以下值之一：plt 或 ent，这取决于您安装的是 Platform Edition 还是 Enterprise Edition。

  3. 转到 temp_directory 并解压缩分发文件。

    4. unzip imq3_0_1-edition-linx86.zip

    unzip 命令将分发文件放在临时目录中：LICENSE、README、THIRDPARTYLICENSEREADME 和 COPYRIGHT 文件；以及一个包含以下 RPM 的 rpms 目录：

    imq-3.0.1-03.i386.rpm
    （Platform Edition 和 Enterprise Edition 都包含）

    imq-ent-3.0.1-03.i386.rpm
    （仅 Enterprise Edition 包含）

  4. 以 root 用户身份登录或更改为超级用户。

    5. 例如，在命令提示符下键入以下内容：

    su root

    出现提示时，键入您的 root 密码。

  5. 安装相应的 RPM：

    6. rpm -ivh rpms/imq-3.0.1-03.i386.rpm
    （Platform Edition 和 Enterprise Edition 都包含）

    rpm -ivh rpms/imq-ent-3.0.1-03.i386.rpm
    （仅 Enterprise Edition 包含）

    将创建 /opt/imq 目录及其内容，并将文件放置在其它位置（请参见安装的目录结构）。

  6. 备份临时工作目录中的 imq3_0_1-edition-linx86.zip 文件。

    7. 此文件是您的逻辑介质。可以像处理其它安装介质一样处理此文件。在一个安全的位置保留一份副本，以防遇到需要重新安装该产品的情况（例如系统故障）。

  7. 清除临时工作目录中的所有剩余文件。

    8. 注意

    对于任何原先存在的代理实例来说，创建该实例的用户拥有实例数据。因此，安装完成后，请确保以对 /var/imq/instances/instanceName 目录具有特权的拥有者身份来运行任何 MQ 代理实例（使用 -name instanceName 选项）。这也适用于默认代理实例（名为 imqbroker）。

从 CD-ROM 进行安装

下面说明如何在 Linux 上从 CD-ROM 安装 MQ 产品。

    要在 Linux 上从 CD-ROM 安装 MQ
  1. 将 Sun ONE Message Queue CD 插入 CD-ROM 驱动器并进行安装。

    2. mount /mnt/cdrom

    根据使用的 Linux 版本不同，此命令可能会不同。请查看系统上的 mount 手册页。

  2. 转到 CD 上含有 MQ 分发的目录：

    3. cd /mnt/cdrom/linux

    根据 MQ 产品版本的不同，此目录的内容有所不同。

  3. 以 root 用户身份登录或更改为超级用户。

    4. 例如，在命令提示符下键入以下内容：

    su root

    出现提示时，键入您的 root 密码。

  4. 安装相应的 RPM：

    5. rpm -ivh rpms/imq-3.0.1-03.i386.rpm
    （Platform Edition 和 Enterprise Edition 都包含）

    rpm -ivh rpms/imq-ent-3.0.1-03.i386.rpm
    （仅 Enterprise Edition 包含）

    将创建 /opt/imq 目录及其内容，并将文件放置在其它位置（请参见安装的目录结构）。

为 MQ 配置 Java 运行时

启动时，代理（MQ 消息服务器）将检查是否具有所需的 Java 运行时版本 (JDK/JRE 1.4)。

需要安装正确的 JDK/JRE 来运行 MQ。有关 MQ 支持的 JDK/JRE 版本的详细信息，请参见表 1-1。

有多种方法配置或设置代理所用的 JRE。下面的列表按优先级顺序列出了这些方法：

  1. 使用 imqbrokerd -javahome 或 -jrehome 命令行选项分别传入 JDK 和 JRE（如果同时传入，命令行中最后列出的一项将具有优先权）。
  2. 在 IMQ_JAVAHOME 环境变量中设置 JDK 或 JRE。
  3. 让代理使用已安装的 JDK/JRE。代理将拾取系统上安装的最新 JDK/JRE 版本（高于 1.4.1，低于 2.0）。

    4. JDK 位于 /usr/java/j2sdk1.x.x，

    JRE 位于 /usr/java/j2re1.x.x

要查明为什么代理拾取特定的 JDK/JRE，您可以使用以下命令启动该代理：

imqbrokerd -verbose

从 Platform Edition 升级到 Enterprise Edition

MQ 有两个版本，如产品版本中所述。

要从 Platform Edition 升级到 Enterprise Edition，您需要首先购买 Enterprise Edition，然后按照下面的步骤进行安装（分发软件中仅包含 Enterprise Edition 许可证）。许可证的安装不会覆写已安装的 MQ 3.0.1 SP2 模块，而且不会修改 MQ 消息传送系统的配置。

要安装 Enterprise Edition 许可证，您仅需解压缩 Enterprise Edition 中包含的许可证文件并将其放入 MQ 安装目录。

    要在 Linux 上升级到 Enterprise Edition
  1. 停止所有运行的代理。

    2. imqcmd shutdown bkr -u name -p password [-b hostName:port]

  2. 执行从 Web 进行安装中的步骤 1 至步骤 4 或从 CD-ROM 进行安装中的步骤 1 至步骤 3。
  3. 安装 MQ Enterprise Edition RPM。

    4. rpm -ivh rpms/imq-ent-3.0.1-03.i386.rpm

    这会将 Enterprise Edition 许可证安装到相应的 MQ 目录中。

  4. 通过运行以下命令验证 Enterprise Edition 许可证是否可用：

    5. imqbrokerd -license

如何继续

阅读 README 和 MQ 发行说明文件。

有关 Sun ONE Message Queue 概念的概述、编写和编译客户机应用程序的简短介绍，请参见《MQ 开发者指南》。

有关配置代理和管理 MQ 消息传送系统的详细信息，请参见《MQ 管理员指南》。

有关编写客户机应用程序时使用的类及成员的信息，请参见 /opt/imq/javadoc 目录中的 API 文档。

要卸载产品，请参见下一节。

从 Linux 上卸载 MQ

下面说明如何从 Linux 上卸载 MQ。

    要从 Linux 上删除 MQ
  1. 停止所有运行的客户机应用程序。
  2. 停止所有运行的代理。

    3. imqcmd shutdown bkr -u name -p password [-b hostName:port]

  3. 除非您希望保留每个代理实例关联的动态数据、MQ 文本文件用户系统信息库和 MQ 访问控制文件，否则请使用以下命令删除这些数据。

    4. imqbrokerd -name instanceName -remove instance

  4. 成为 root 用户：

    5. su root

  5. 删除 MQ 产品。

    6. 按以下顺序执行下面的命令：

    rpm -e imq-ent

    （仅适用于 Enterprise Edition）

    rpm -e imq

    （适用于 Platform Edition 和 Enterprise Edition）



上一个      目录      下一个     

版权所有 2003 Sun Microsystems, Inc.。保留所有权利。