第 3 章 Sun Java System Instant Messaging 7 2005Q4 发行说明

版本 7 2005Q4

本发行说明包含发行 Sun Java^TM System Instant Messaging 7 2005Q4 时提供的重要信息。文中说明了新增功能和增强功能、已知问题和限制以及其他信息。在使用 Instant Messaging 7 2005Q4 前，请先阅读本文档。

为确保实现 Instant Messaging 的最佳部署，您应当从 http://sunsolve.sun.com/下载此产品版本的最新修补程序。

本发行说明的最新版本可以在 Sun Java System http://docs.sun.com/找到。在安装和设置软件前请选取该 Web 站点，以后定期查看最新发行说明和产品文档。本发行说明包含以下几个部分：

• 发行说明修订历史记录

• 关于 Instant Messaging 7 2005Q4

• 此发行版的新增功能

• 要求

• 安装说明

• 兼容性问题

• 文档更新

• 此发行版中修复的错误

• 已知问题和限制

• 配置 Instant Messaging 以获得高可用性（仅 Solaris）

• 可再分发的文件

本文档引用了第三方 URL 以提供其他相关信息。

Sun 对本文档提及的第三方 Web 站点的可用性不承担任何责任。对于此类站点或资源中的（或通过它们获得的）任何内容、广告、产品或其他资料，Sun 并不表示认可，也不承担任何责任。对于因使用或依靠此类站点或资源中的（或通过它们获得的）任何内容、产品或服务而造成的或连带产生的实际或名义损坏或损失，Sun 概不负责，也不承担任何责任。

发行说明修订历史记录

关于 Instant Messaging 7 2005Q4

Sun Java System Instant Messaging 提供了安全可靠的扩展实时通讯，使用户团体可以即时、安全地交流与合作。它将即时通讯功能与会议、警报、新闻、轮询和文件传输相结合，从而创建了一个丰富的合作环境。它支持使用 LDAP、Sun Java System Access Manager 或 Sun Java System Portal Server 管理的现有团体。

此发行版的新增功能

本部分包括以下主题：

• 安装

• 新增功能

安装

Instant Messaging 安装指南已经废止。如果您是第一次安装 Instant Messaging 7 2005Q4，请参见《Sun Java Enterprise System 安装指南》以获取安装指导。如果您是从先前版本的 Instant Messaging 进行升级，请参见《Sun Java Enterprise System 升级指南》。

如果您结合使用 Access Manager 和 Instant Messaging，您需要使用 Java Enterprise System 安装程序安装“传统（版本 6.x 样式）”Access Manager。此版本的 Instant Messaging 与“领域（版本 7.x 样式）”Access Manager 不兼容。

新增功能

本部分介绍了此发行版 Instant Messaging 的以下新增功能：

使用 Sun^TM Cluster 时的故障转移支持（仅限 Solaris）

此发行版 Instant Messaging 提供了使用 Sun Cluster 时对 Solaris 的故障转移支持。它增加了 Instant Messaging 的可用性并提供了对软件和硬件故障的监视和恢复。

请参见配置 Instant Messaging 以获得高可用性（仅 Solaris）获取有关该功能的更多信息。

要求

本部分列出了安装 Instant Messaging 软件的要求。在安装前，确保您已经满足最低硬件和操作系统要求。服务器和客户机均支持 JRE 1.4。另外，在安装前请选取所有产品修补程序。

有关 Sun Java System Instant Messaging 必需的修补程序的当前列表，请转至 http://sunsolve.sun.com，然后选择 "Patches" 或 "Patch Portal"。找到 Sun Java System Instant Messaging 的链接。由于系统修补程序的要求发生变化并且 Java Enterprise System 组件的修补程序已经可用，因此将通过 SunSolve 提供更新，最初是以建议的修补程序簇形式提供。

以下部分介绍了此发行版的 Instant Messaging 软件对硬件和软件的要求：

• 服务器操作系统要求

• 服务器软件要求

• 服务器硬件要求

• 客户机操作系统要求

• 客户机软件要求

• 客户机硬件要求

服务器操作系统要求

此发行版的 Sun Java System Instant Messaging 支持以下平台：

• Solaris^TM 8 (5.8) 操作系统 (Solaris OS)（SPARC® 平台版）

• Solaris^TM 9 (5.9) 操作系统（SPARC® 平台版、x86 平台版和 Opteron 平台版）

• Solaris^TM 10 操作系统（SPARC® 平台版、x86 平台版和 Opteron 平台版）

• Red Hat Enterprise Linux AS 2.1 和 AS 3.0。

建议的 Solaris^TM 修补程序列表可以在 http://sunsolve.sun.com上找到。

服务器软件要求

此版本的 Instant Messaging 与以下版本的其他服务器软件兼容：

• Sun Java System Access Manager 7 2005Q4

• Sun Java System Application Server Enterprise Edition 8 2005Q4

• Sun Java System Calendar Server 6 2005Q4

• Sun Java System Directory Server 5 2005Q4

• Sun Java System Messaging Server 6 2005Q4

• Sun Java System Portal Server 6 2005Q4

• Sun Java System Web Server 6.1 2005Q4 SP5

服务器硬件要求

安装 Instant Messaging 的最低硬件要求如下：

• 大约有 300 MB 的空闲磁盘空间可用于该软件。

• 每个用户大约有 5K 的磁盘空间。

• 至少 256 MB 的 RAM。需要的 RAM 大小取决于并发客户机的连接数以及服务器与多路复用器是否部署在同一主机上。

客户机操作系统要求

此发行版支持以下客户机平台：

• Solaris^TM 8, 9 和 10

• Microsoft Windows 98, ME, NT (SP 6a), 2000 和 XP

• Mac OS X（版本不低于 10.1）

• Red Hat Linux（版本不低于 7.2）

客户机软件要求

在 Windows 上，您可以使用浏览器的 Java Plug-in 从以下浏览器运行即时通讯程序：

• Netscape^TM（版本不低于 4.79）

• Mozilla^TM（版本不低于 1.2）

• Internet Explorer（版本不低于 5.5）

如果客户机已安装 Java 1.4 或更新版本，则不要求额外使用 Java Plug-in 或 Java Web Start。Netscape Navigator v7 和 Mozilla 浏览器的最新版本包括 Java v1.4 或更高版本。Internet Explorer 不包括 Java 的最新版本。如果您使用装有 Java 1.4 的客户机时遇到问题，请升级到 5.0。JDK^TM 5.0 包括在 Sun Java System Instant Messaging 中。

如果客户机没有安装 Java v1.4 或更高版本，您需要安装 Java Web Start。您可以从 http://java.sun.com/j2se 下载并安装 Java v1.4。

您可以从 http://java.sun.com/products/javawebstart 下载并安装 Java Web Start。

HTML 链接可以通过即时通讯程序进行交换并且可以通过单击它们从信使中激活。激活链接后，信使将调用浏览器。表 3–2 列出了支持的操作系统和浏览器组合。

客户机硬件要求

即时通讯程序在大多数平台上使用 20 MB 到 40 MB 之间的内存。您应当通过包括客户机上使用的其他应用程序（包括操作系统）的要求来估计内存要求。在大多数情况下，建议至少准备 128 MB RAM 以便顺利运行即时通讯程序和其他应用程序。 使用内存密集操作系统时，这个数字要求更高。

安装说明

如果您选择在配置 Instant Messaging 时使用 Sun Java System Access Manager 来存储策略，则会创建以下类似策略：

• 能够执行即时消息传送和在线状态服务

• 能够更改您自己的 Instant Messaging 设置

• 能够管理 Instant Messaging 会议室

兼容性问题

表 3–3 列出了 Instant Messaging 7 2005Q4 与先前版本间已知的不兼容问题。

文档更新

本部分介绍了有关以下部分所述文档中的更改和错误的信息：

• 文档集

• 管理指南

• 联机帮助

文档集

Instant Messaging 的 2005Q4 发行版使用以下版本的管理指南：

《Sun Java System Instant Messaging 7 2005Q1 管理指南》

管理指南

本部分列出了《Sun Java System Instant Messaging 7 2005Q1 管理指南》的以下更改。

• 在 HA 环境中启动、停止和刷新组件

• 用于部署 Access Manager 的其他安装后步骤

• 将 iim_agent.enable 参数更改为默认值

• 配置即时通讯程序的日历弹出式提醒

• 从 iim.conf 中删除的参数

• 为 Java Plug-in 启用即时通讯程序归档控制组件

• 更改 HTML applet 页面和 pluginLaunch.jsp 文件

• 为 Java Plug-in 启用即时通讯程序归档控制

• 将归档的消息存储在非默认的 Portal Server 搜索数据库中

• 配置服务器以允许新用户注册

• 其他用于 XMPP 流量的日志参数

• Instant Messaging 的高可用性

在 HA 环境中启动、停止和刷新组件

不要在 Sun Cluster 的 HA 环境中使用 imadmin start、imadmin stop 或 imadmin refresh 命令。应使用 Sun Cluster 管理实用程序。

用于部署 Access Manager 的其他安装后步骤

（问题编号：6189148）如果在与 Instant Messaging 服务器不同的主机上安装 Access Manager，您需要在运行 configure 实用程序后将 imServices_* 文件从 Instant Messaging 服务器主机手动复制到 Access Manager 主机。

要执行此操作：

1. 在 Instant Messaging 服务器主机上找到 imService_*.properties 文件。默认情况下，这些文件位于 /opt/SUNWiim/lib/（对于 Solaris）和 /opt/sun/im/lib/（对于 Linux）下。

2. 将这些文件复制到 Access Manager 主机的 locale 目录下。默认情况下，该目录为 /opt/SUNWam/locale（对于 Solaris）和 /opt/sun/identity/locale（对于 Linux）。

将 iim_agent.enable 参数更改为默认值

（问题编号：5102072）在此发行版中，iim_agent.enable 参数的默认值已更改为 False。该更改没有反映在管理指南中。

配置即时通讯程序的日历弹出式提醒

过程“配置 Instant Messaging 服务器”的步骤 1 错误。不存在名为 SUNWiimag 的软件包。跳过该步骤。

从 iim.conf 中删除的参数

不再支持 iim_server.msg_archive.auto 配置参数，尽管它错误地包括在管理指南的参数列表中。

为 Java Plug-in 启用即时通讯程序归档控制组件

（问题编号：6244099）管理指南中所介绍的为 Java Plug-in 启用即时通讯程序归档控制组件的过程错误。请使用更改 HTML applet 页面和 pluginLaunch.jsp 文件中介绍的过程。

更改 HTML applet 页面和 pluginLaunch.jsp 文件

如果使用 Java Plug-in 启动即时通讯程序，请执行以下步骤以在即时通讯程序中启用即时通讯程序归档控制功能。

为 Java Plug-in 启用即时通讯程序归档控制

步骤

1. 转至即时通讯程序文档根目录，然后找到 im.html 和 imssl.html 文件

   默认情况下，这些文件安装在以下位置：

   /etc/opt/SUNWps/desktop/default/IMProvider

2. 在文本编辑器中打开 .html 文件。

3. 根据要求添加或编辑以下行：

   <PARAM NAME="archive_control" VALUE="true" /> <EMBED archive_control=true;/>

将归档的消息存储在非默认的 Portal Server 搜索数据库中

在此过程中发生错误。具体而言，以下目录：

/etc/opt/SUNWps/desktop/default/IMProvider/

应该是：

/etc/opt/SUNWps/desktop/default_locale/IMProvider/

例如

/etc/opt/SUNWps/desktop/default_ja/IMProvider/

配置服务器以允许新用户注册

此管理指南中没有完整介绍新用户注册功能。除了自定义即时通讯程序外，您还需要将服务器配置为允许新用户注册。

要执行此操作，您需要向 iim.conf 中添加四个配置参数，然后刷新服务器配置。表 3–4 介绍了配置参数。

配置服务器以允许新用户注册

步骤

1. 在文本编辑器中打开 iim.conf。

2. 添加表 3–4 中所述的配置参数和相应的值。

3. 保存并关闭 iim.conf。

4. 使用 imadmin 命令行实用程序刷新服务器配置。

   imadmin refresh server

   ---

   注意 –

   不要在 Sun Cluster 的 HA 环境中使用 imadmin start、imadmin stop 或 imadmin refresh 命令。应使用 Sun Cluster 管理实用程序。

   ---

其他用于 XMPP 流量的日志参数

（问题编号：5070998）已向此发行版中添加了其他未存档的日志参数以收集单独日志文件中的 XMPP 消息。

配置服务器以创建 XMPP 消息日志

步骤

1. 打开 iim.conf。

   默认情况下，iim.conf 文件安装在配置目录中，如下所示：

   • 对于 Solaris：

     /etc/opt/SUNWiim/default/config/iim.conf

   • 对于 Linux：

     /etc/opt/sun/im/default/config/iim.conf

   如果已经创建多个 Instant Messaging 实例，则 /default 目录的名称会依实例的不同而不同。

2. 通过删除注释字符启用下面的行：

   iim.log4j.config=log4j.conf

   如果行不存在，则添加该行。

3. 保存并关闭 iim.conf。

4. 创建名为 log4j.conf 的文件并将其保存到配置目录中。

5. 向 log4j.conf 添加以下内容：

   log4j.logger.xmppd=INFO, A1 # DEFAULT TO RollingFileAppender log4j.appender.A1=org.apache.log4j.RollingFileAppender log4j.appender.A1.file=${logdir}/xmppd.log log4j.appender.A1.append=true log4j.appender.A1.maxBackupIndex=7 log4j.appender.A1.maxFileSize=5mb # More example appenders.. # Straight to console.. # log4j.appender.A1=org.apache.log4j.ConsoleAppender # log4j.appender.A1.ImmediateFlush=true # Rollover at midnight.. # log4j.appender.A1=org.apache.log4j.DailyRollingFileAppender # log4j.appender.A1.DatePattern='.'yyyy-MM-dd # log4j.appender.A1.file=${logdir}/xmppd.log # log4j.appender.A1.ImmediateFlush=true # log4j.appender.A1.append=true # Send to SMTP.. # log4j.appender.A1=org.apache.log4j.SMTPAppender # PATTERN LAYOUT AND OPTIONS # DEFAULT TO PatternLayout log4j.appender.A1.layout=org.apache.log4j.PatternLayout # For full dates.. log4j.appender.A1.layout.ConversionPattern=[%d{DATE}] %-5p %c [%t] %m%n # IM traditional output format.. #log4j.appender.A1.layout.ConversionPattern=%d{HH:mm:ss,SSS} %-5p %c [%t] %m%n # More example layouts # XMLLayout for chainsaw consumption # log4j.appender.A1.layout=org.apache.log4j.xml.XMLLayout # TTCCLayout for NDC information # log4j.appender.A1.layout=org.apache.log4j.xml.TTCCLayout # log4j.appender.A1.layout.DateFormat=ISO8601 # log4j.appender.A1.layout.TimeZoneID=GMT-8:00 # log4j.appender.A1.layout.CategoryPrefixing=false # log4j.appender.A1.layout.ThreadPrinting=false # log4j.appender.A1.layout.ContextPrinting=false # Now we list logger/appender/layout for the other default loggers, but # only the defaults.. log4j.logger.iim_wd=ERROR, A2 log4j.appender.A2=org.apache.log4j.RollingFileAppender log4j.appender.A2.file=${logdir}/iim_wd.log log4j.appender.A2.append=true log4j.appender.A2.maxBackupIndex=7 log4j.appender.A2.maxFileSize=5mb log4j.appender.A2.layout=org.apache.log4j.PatternLayout log4j.appender.A2.layout.ConversionPattern=[%d{DATE}] %-5p %c [%t] %m%n # For separate xmpp traffic log, disabled by default. log4j.logger.xmppd.xfer=DEBUG, A3 #log4j.appender.A3=org.apache.log4j.varia.NullAppender # Select next block instead of previous line to enable separate transfer log log4j.appender.A3=org.apache.log4j.RollingFileAppender # log4j.appender.A3.file=${logdir}/xfer.log # log4j.appender.A3.append=true # log4j.appender.A3.maxBackupIndex=7 # log4j.appender.A3.maxFileSize=5mb # log4j.appender.A3.layout=org.apache.log4j.PatternLayout # # Note, simpler default output than above 3 loggers: # log4j.appender.A3.layout.ConversionPattern=[%d{DATE}] %-5p %c [%t] %m%n log4j.logger.agent-calendar=ERROR, A4 log4j.appender.A4=org.apache.log4j.RollingFileAppender log4j.appender.A4.file=${logdir}/agent-calendar.log log4j.appender.A4.append=true log4j.appender.A4.maxBackupIndex=7 log4j.appender.A4.maxFileSize=5mb log4j.appender.A4.layout=org.apache.log4j.PatternLayout log4j.appender.A4.layout.ConversionPattern=[%d{DATE}] %-5p %c [%t] %m%n log4j.logger.net.outer_planes.jso.BasicStream=OFF, A5 log4j.appender.A5=org.apache.log4j.RollingFileAppender log4j.appender.A5.file=${logdir}/jso.log log4j.appender.A5.append=true log4j.appender.A5.maxBackupIndex=7 log4j.appender.A5.maxFileSize=5mb log4j.appender.A5.layout=org.apache.log4j.PatternLayout log4j.appender.A5.layout.ConversionPattern=[%d{DATE}] %-5p %c [%t] %m%n

6. 保存并关闭 log4j.conf。

7. 刷新服务器：

   imadmin refresh server

   ---

   注意 –

   不要在 Sun Cluster 的 HA 环境中使用 imadmin start、imadmin stop 或 imadmin refresh 命令。应使用 Sun Cluster 管理实用程序。

   ---

禁用单独的 XMPP 日志文件创建

禁用单独的日志文件创建不会阻止 XMPP 消息写入服务器日志。

步骤

1. 打开 log4j.conf。

2. 注释下面的行：

   log4j.logger.xmppd.xfer=DEBUG, A3

Instant Messaging 的高可用性

关于此功能的介绍可以在配置 Instant Messaging 以获得高可用性（仅 Solaris）中获得。

联机帮助

以下信息在产品联机帮助和快速参考中均未介绍。

启动屏幕

启动屏幕启动即时通讯程序。如果您使用的是 Java Web Start，请按屏幕中间的“启动”按钮。如果您使用的是 Java Plug-in（仅用于 Windows 用户），请单击屏幕上方的 "Java Plug-in" 按钮。“联机帮助”和“快速参考”按钮显示最终用户的产品帮助信息。

此发行版中修复的错误

表 3–5 介绍了此 Instant Messaging 7 2005Q4 发行版中修复的问题。

已知问题和限制

本部分包括 Instant Messaging 7 2005Q4 发行时存在的更多重要已知问题列表。

经常发布修补程序更新。如果安装或使用 Instant Messaging 时遇到问题，请联系 Sun 技术支持人员询问是否可以提供对此问题的修复。另外，您也可以访问 http://sunsolve.sun.com/获取修补程序。

表 3–6 列出了已知问题和限制。

WARNING: Cannot parse rpm files
by running "/bin/rpm -qp --queryformat

CollaborationSessionFactory factory=new
CollaborationSessionFactory("com.iplanet.im.client.api.iIMSessionFactory");

com.sun.im.service.xmpp.session.keepaliveinterval

配置 Instant Messaging 以获得高可用性（仅 Solaris）

配置 Instant Messaging 以获得高可用性 (high availability, HA) 提供了对软件和硬件故障的监视和恢复。高可用性功能是作为故障转移数据服务（而不是可伸缩服务）实现的，并且仅在 Solaris 上支持。本部分介绍了使用 Sun Cluster 软件的 Instant Messaging HA 配置。有关 Sun Cluster 提供的数据服务的详细信息，请参见HA 相关的文档。

它在以下部分中介绍了如何配置 Instant Messaging HA 服务：

• Instant Messaging HA 概述

• 为 Instant Messaging 设置 HA

• 停止、启动和重新启动 Instant Messaging HA 服务

• 管理用于 Instant Messaging 的 HA RTR 文件

• 为 Instant Messaging 删除 HA

• HA 相关的文档

Instant Messaging HA 概述

使用带有 Instant Messaging 的 Sun Cluster 创建高可用的部署。本部分提供了有关 HA 要求、本章示例中使用的术语和您在以下部分中配置 HA 时所需权限的信息：

在开始前，您应当熟悉一般的 HA 概念，特别是 Sun Cluster 软件。有关详细信息，请参见HA 相关的文档。

HA 配置软件要求

Instant Messaging HA 配置要求的软件显示在表 3–7 中。

HA 配置权限要求

要安装并配置 Instant Messaging HA 配置，请以超级用户 (root) 身份登录或成为超级用户并指定用于查看发送到 /dev/console 的消息的控制台或窗口。

HA 配置术语和核对表

表 3–8 介绍了在本章的示例中使用的变量术语，以用作配置示例。此外，在配置用于 Instant Messaging 的 HA 前，您还需要收集信息。在配置过程中，将提示您输入这些信息。结合使用该核对表和《Sun Java System Instant Messaging 7 2005Q1 管理指南》第 1 章中的核对表。

为 Instant Messaging 设置 HA

以下是安装和配置带有两个节点的 Instant Messaging HA 配置的必要步骤的高层列表：

• 选择用于配置文件和二进制文件的本地或共享磁盘

• 准备群集中的每一个节点

• 选择安装目录 (im_svr_base)

• 安装 Instant Messaging 产品和软件包

• 配置 HA 环境

• 配置逻辑主机

• 注册并激活存储资源

• 注册资源类型并创建资源

• 验证 Instant Messaging HA 配置

• Instant Messaging HA 配置的故障排除

选择用于配置文件和二进制文件的本地或共享磁盘

在开始前，您需要确定以下哪个部署最适合您的需要。在两个环境中，共享组件在群集中的每个节点上都是本地安装。此外，在两个环境中，运行时文件都是安装在共享磁盘上。

• 使用本地磁盘存储配置文件和二进制文件。该设置的好处是由于可以在 Instant Messaging 脱机的节点上升级，因此升级 Instant Messaging 需要的停机时间最少。坏处在于您需要确保在群集的所有节点上存在 Instant Messaging 的相同配置和版本。

  此外，如果选择该选项，您需要确定 Instant Messaging 数据服务联机时您是否要使用 HAStoragePlus 从每个节点的共享磁盘安装文件系统，或者您是否准备将群集文件系统用于全局运行时文件。

• 使用共享磁盘存储配置文件和二进制文件。该设置更容易执行，但您需要在升级前关闭群集中所有节点上的 Instant Messaging。

准备群集中的每一个节点

在群集中的每一个节点上，您需要创建组件运行所位于的 Instant Messaging 运行时用户和组。群集中所有节点上的 UID 和 GID 数字必须相同。

• 运行时用户 ID。Instant Messaging 服务器运行所位于的用户名。该名称不应当是 root。默认值为 inetuser。

• 运行时组 ID。Instant Messaging 服务器运行所位于的组。默认值为 inetgroup。

  尽管 configure 实用程序可以为您创建这些名称，您也可以在运行配置程序前像本章中介绍的为每个节点准备的部分那样创建它们。此外，根据您要使用本地磁盘还是共享磁盘，您可能在某个节点上无法运行 configure，而必须手动创建运行时用户和组 ID。

  以下文件中必须存在运行时用户和组 ID 名称：

• inetuser 或您选择的名称，位于群集中所有节点上的 /etc/passwd 中

• inetgroup 或您选择的名称，位于群集中所有节点上的 /etc/group 中

有关说明，请参见《Sun Java System Instant Messaging 7 2005Q1 管理指南》。有关用户和组的详细信息，请参阅您的操作系统文档。

选择安装目录 (im_svr_base)

对于 Instant Messaging，Java Enterprise System 安装程序使用 Solaris 上的 /opt/SUNWiim 作为默认安装目录 (im_svr_base)。但是，如果您使用共享磁盘存储配置文件和二进制文件，则必须指定全局（共享）安装目录。例如/global/im/opt/SUNWiim。

如果您使用的是本地磁盘，则可以将 Instant Messaging 安装到默认目录。但是，您应当在节点中的每一台计算机上将 Instant Messaging 安装到相同的目录。

安装 Instant Messaging 产品和软件包

您使用 Sun Java Enterprise System 安装程序安装产品和软件包。有关安装程序的详细信息，请参阅《Sun Java Enterprise System 2005Q4 安装指南》。

表 3–9 列出了多节点群集配置所要求的产品或软件包。

配置 HA 环境

您需要执行的步骤根据您使用的是本地磁盘还是共享磁盘存储配置文件和二进制文件而不同。

如果您使用本地磁盘存储配置文件和二进制文件，请执行以下两个过程中的步骤：

• 使用本地磁盘存储配置文件和二进制文件以在节点 1 上配置 HA

• 使用本地磁盘存储配置文件和二进制文件以在节点 n 上配置 HA

如果您使用共享磁盘存储配置文件和二进制文件，请执行以下两个过程中的步骤：

• 使用共享磁盘存储配置文件和二进制文件以在节点 1 配置 HA

• 使用共享磁盘存储配置文件和二进制文件以在节点 n 上配置 HA

使用本地磁盘存储配置文件和二进制文件以在节点 1 上配置 HA

开始之前

填写《Sun Java System Instant Messaging 7 2005Q1 管理指南》第 1 章中的核对表和表 3–8，并准备好您的答案。

步骤

1. 使用 Java Enterprise System 安装程序安装产品和软件包。

   有关选择安装目录的具体说明，请参见选择安装目录 (im_svr_base)。

   有关 HA 要求的产品和软件包的列表，请参见表 3–9。有关具体说明，请参阅《Sun Java Enterprise System 2005Q4 安装指南》。

2. 如果您使用 HAStoragePlus 安装运行时文件，请将共享磁盘安装到本地目录，否则请跳到步骤 3。

   例如

   1. 如果安装点不存在，请创建安装点 (/local/im/im_runtime_base/)。

      当在步骤 4 的配置过程中提示时，请您将此目录 (/local/im/im_runtime_base/) 指定为 Instant Messaging 服务器运行时文件目录。

   2. 使用 mount 命令在 /local/im/im_runtime_base 安装磁盘。

3. 运行 configure 实用程序。

   有关说明，请参见《Sun Java System Instant Messaging 7 2005Q1 管理指南》。

4. 如果提示您输入 Instant Messaging 服务器运行时文件目录，请输入以下一项：

   • 如果您使用的是 HAStoragePlus 安装运行时文件，请输入 /local/im/im_runtime_base/。

   • 如果使用的是群集文件系统安装运行时文件，请输入 /global/im/im_runtime_base/。其中，/global/im 是群集文件系统中的全局目录。

5. 当提示输入 Instant Messaging 主机名时，请输入逻辑主机。

   选择接受逻辑主机，即使 configure 实用程序无法连接到指定的主机。在您运行 configure 实用程序时，逻辑主机资源可能脱机。

6. 请不要选择在配置后或在系统启动时启动 Instant Messaging。

   在 HA 配置中，为使 Instant Messaging 正常工作，Instant Messaging 服务也要求逻辑主机已联机。

7. 如果您使用 HAStoragePlus 安装运行时文件，请卸载共享磁盘。

使用本地磁盘存储配置文件和二进制文件以在节点 n 上配置 HA

开始之前

请确保您已经如上一过程中介绍的那样完成了节点 1 上的 HA 配置（使用本地磁盘存储配置文件和二进制文件以在节点 1 上配置 HA）。

准备好您关于《Sun Java System Instant Messaging 7 2005Q1 管理指南》第 1 章中的核对表和表 3–8 的答案。

步骤

1. 使用 Java Enterprise System 安装程序安装产品和软件包。

   对群集中每个后继节点，选择与您在节点 1 上安装 Instant Messaging 时使用的相同路径。有关具体说明，请参见选择安装目录 (im_svr_base)。

   有关 HA 要求的产品和软件包的列表，请参见表 3–9。有关具体说明，请参阅《Sun Java Enterprise System 2005Q4 安装指南》。

2. 运行 configure 实用程序。

   有关说明，请参见《Sun Java System Instant Messaging 7 2005Q1 管理指南》的第 1 章。

3. 当提示输入 Instant Messaging 服务器运行时文件目录时，请输入与您提供给节点 1 的相同的值。

4. 当提示输入 Instant Messaging 主机名时，请输入与您提供给节点 1 的相同的逻辑主机。

   选择接受逻辑主机，即使 configure 实用程序无法连接到指定的主机。在您运行 configure 实用程序时，逻辑主机资源可能脱机。

5. 当提示输入用户和组时，请输入与您提供给节点 1 的相同的值。

6. 请不要选择在配置后或在系统启动时启动 Instant Messaging。

   在 HA 配置中，为使 Instant Messaging 正常工作，Instant Messaging 服务也要求逻辑主机已联机。

使用共享磁盘存储配置文件和二进制文件以在节点 1 配置 HA

开始之前

填写《Sun Java System Instant Messaging 7 2005Q1 管理指南》第 1 章中的核对表和表 3–8，并准备好您的答案。

如果您使用共享磁盘存储配置文件和二进制文件，则必须使用群集文件系统，而不要用 HAStoragePlus。

步骤

1. 使用 Java Enterprise System 安装程序在群集文件系统中的目录上安装产品和软件包。

   安装 Instant Messaging 时，您必须指定默认目录以外的目录。有关具体说明，请参见选择安装目录 (im_svr_base)。

   有关 HA 要求的产品和软件包的列表，请参见表 3–9。有关具体说明，请参阅《Sun Java Enterprise System 2005Q4 安装指南》。

2. 从 /etc/opt/SUNWiim 创建指向 /global/im/etc/opt/SUNWiim 的软链接。

3. 从您安装了 Instant Messaging 的全局目录 (/global/im/im_svr_base/configure) 运行 configure 实用程序。

   有关说明，请参见《Sun Java System Instant Messaging 7 2005Q1 管理指南》的第 1 章。

4. 当提示输入 Instant Messaging 服务器运行时文件目录时，请输入 /global/im/im_runtime_base 的值。

5. 当提示输入 Instant Messaging 主机名时，请输入逻辑主机。

   选择接受逻辑主机，即使 configure 实用程序无法连接到指定的主机。在您运行 configure 实用程序时，逻辑主机资源可能脱机。

6. 请不要选择在配置后或在系统启动时启动 Instant Messaging。

   在 HA 配置中，为使 Instant Messaging 正常工作，Instant Messaging 服务也要求逻辑主机已联机。

使用共享磁盘存储配置文件和二进制文件以在节点 n 上配置 HA

开始之前

请确保您已经如上一过程中介绍的那样完成了节点 1 上的 HA 配置（使用共享磁盘存储配置文件和二进制文件以在节点 1 配置 HA）。

准备好您关于《Sun Java System Instant Messaging 7 2005Q1 管理指南》第 1 章中的核对表和表 3–8 的答案。

步骤

1. 从 /etc/opt/SUNWiim 创建指向 /global/im/etc/opt/SUNWiim 的软链接。

2. 为资源类型注册 (resource type registration, RTR) 文件创建软链接：

   ln -s /global/im/ im_svr_base/cluster/SUNW.iim \ /usr/cluster/lib/rgm/rtreg/SUNW.iim

配置逻辑主机

启动 Instant Messaging 前，您需要创建资源组、添加逻辑主机并将资源组联机。

使用逻辑主机配置资源组

步骤

1. 创建名为 im_resource_group 的 Instant Messaging 故障转移资源组：

   # scrgadm -a -g im_resource_group -h im-node-2,im-node-1

2. 向资源组添加逻辑主机名 im_logical_host。

   Instant Messaging 将侦听该主机名。

   # scrgadm -a -L -g im_resource_group -l im_logical_host

3. 将资源组联机：

   # scswitch -Z -g im_resource_group

注册并激活存储资源

在将 Instant Messaging 数据服务联机前，您需要按照本部分的介绍注册并激活存储资源。

注册并启用存储资源

步骤

1. 注册存储资源。

   如果您结合使用全局文件系统 (global file system, GFS) 和 HAStoragePlus，请将安装点设置为 FileSystemMountPoints 属性的值。例如

   # scrgadm -a -j im_resource_group_store -g im_resource_group -t SUNW.HAStorage \ -x FileSystemMountPoints=/global/ im -x AffinityOn=True

   否则，将安装点设置为 ServicePaths 属性的值。例如

   # scrgadm -a -j im-resource-group-store -g im-resource-group -t SUNW.HAStorage \ -x ServicePaths=/global/im -x AffinityOn=True

2. 启用存储资源：

   # scswitch -e -j im_resource_group_store

注册资源类型并创建资源

在启动 HA Instant Messaging 服务器或多路复用器前，您需要使用 Sun Cluster 注册资源类型 SUNWiimsc 并创建资源。

注册资源类型并创建资源

步骤

1. 注册资源类型。

   # scrgadm -a -t SUNW.iim

2. 创建资源。

   在一行中输入以下命令：

   # scrgadm -a -j im_resource -g im_resource_group -t SUNW.iim -x Confdir_list=/global/im/ im_resource_group -y Resource_dependencies=im_resource_group_store -y Port_list=80/tcp

3. 启用资源：

   # scswitch -e -j im_resource

4. 启动 Instant Messaging 组件。

   ---

   注意 –

   不要在 Sun Cluster 的 HA 环境中使用 imadmin start、imadmin stop 或 imadmin refresh 命令。应使用 Sun Cluster 管理实用程序。

   ---

验证 Instant Messaging HA 配置

启动 Instant Messaging 后，您需要按照本部分的介绍验证 HA 配置。

验证用于 Instant Messaging 的 HA 配置

步骤

1. 检查所有要求的进程是否都在运行。

2. 将服务转移到备份节点以确保高可用性。

   例如，如果服务正在 im_node_1 上运行，则发出以下命令将服务转移到 im_node_2。

   # scswitch -z -g im_resource_group -h im_node_2

3. 检查所有要求的进程是否都在 im_node_2 上启动。

Instant Messaging HA 配置的故障排除

为帮助故障排除，错误消息将写入错误日志。这些日志由 syslog 功能控制。有关使用日志功能的信息，请参阅HA 相关的文档和 syslog.conf 的手册页。

停止、启动和重新启动 Instant Messaging HA 服务

要启动和停止 Instant Messaging HA 服务，请使用 Sun Cluster 的 scswitch 命令。

不要在 Sun Cluster 的 HA 环境中使用 imadmin start、imadmin stop 或 imadmin refresh 命令。应使用 Sun Cluster 管理实用程序。

有关 Sun Cluster scswitch 命令的详细信息，请参阅《Sun Cluster Reference Manual for Solaris OS》。

启动 Instant Messaging HA 服务

步骤

在命令行键入以下命令：

# scswitch -e -j im_resource

停止 Instant Messaging HA 服务

步骤

在命令行键入以下命令：

# scswitch -n -j im_resource

重新启动 Instant Messaging HA 服务

步骤

在命令行键入以下命令：

# scswitch -R -j im_resource

管理用于 Instant Messaging 的 HA RTR 文件

资源类型注册 (RTR) 文件是 ASCII 文本文件，它描述了在资源组管理器 (Resource Group Manager, RGM) 的控制下高可用的资源类型。RTR 文件通过 scrgadm 命令将资源类型注册到群集配置中以用作输入文件。Instant Messaging RTR 文件 (SUNW.iim) 是您在 HA 配置期间安装 SUNWiimsc 软件包时创建的。

本部分提供了有关在以下部分中管理该文件的信息：

• Instant Messaging RTR 文件参数

• 自定义 Instant Messaging 的 RTR 文件

Instant Messaging RTR 文件参数

下表列出了 Instant Messaging 特定的 Instant Messaging RTR 文件 (SUNW.iim) 中的扩展属性。

自定义 Instant Messaging 的 RTR 文件

您可以修改 Instant Messaging RTR 文件 (SUNW.iim) 中的几个扩展属性的值以配置您的 HA 环境。扩展属性是资源类型特定的属性。这些属性由同种类型的每个资源继承。Instant Messaging 扩展属性在Instant Messaging RTR 文件参数中介绍。

有关资源类型注册文件的内容和关于自定义扩展属性的值的说明，请参见《Sun Cluster Reference Manual for Solaris OS》中的 rt_reg 和 property_attributes 文档。

为 Instant Messaging 删除 HA

为了从 HA 环境中删除 Instant Messaging，您需要按照本部分的介绍删除 Instant Messaging 群集代理 SUNWiimsc。

为 Instant Messaging 删除 HA

开始之前

按照本过程中的介绍删除 SUNWiimsc 软件包后，您对 RTR 文件 SUNW.iim 所做的任何自定义都会丢失。如果您想在以后恢复它们，您需要在删除 SUNWiimsc 软件包前创建 SUNW.iim 的备份。

步骤

1. 关闭 Instant Messaging 数据服务：

   scswitch -F -g im_resource_group

2. 禁用 Instant Messaging 资源组 (im_resource_group) 中的所有资源：

   # scswitch -n -j im_resource # scswitch -n -j im_logical_host # scswitch -n -j im_resource_group_store

3. 从 Instant Messaging 资源组中删除资源：

   # scrgadm -r -j im_resource # scrgadm -r -j im_logical_host # scrgadm -r -j im_resource_group_store

4. 删除 Instant Messaging 资源组：

   # scrgadm -r -g im_resource_group

5. 删除 Instant Messaging 资源类型：

   # scrgadm -r -t SUNW.iim

6. 使用 Java Enterprise System 安装程序或手动删除 SUNWiimsc 软件包，如下所示：

   pkgrm SUNWiimsc

   删除软件包后，您对 RTR 文件所做的任何自定义都会丢失。

7. 如果您使用共享目录存储配置文件和二进制文件，请删除 HA 配置过程中创建的任何软链接。

   在节点 1 上：

   rm /etc/opt/SUNWiim

   在所有其他节点上：

   rm /usr/cluster/lib/rgm/rtreg/SUNW.iim

HA 相关的文档

• 《Sun Java System Instant Messaging 7 2005Q1 管理指南》

• 《Sun Java Enterprise System 2005Q4 技术概述》

• 《Sun Java Enterprise System 2005Q4 Installation Guide for UNIX》介绍了 Java Enterprise System 安装程序（及卸载程序）和支持的安装方案。

• 《Sun Java Enterprise System 2005Q4 Release Notes》提供了有关 Sun Java Enterprise System 产品的最新信息。

• 《Sun Cluster Concepts Guide for Solaris OS》提供了有关 Sun Cluster 软件、数据服务和术语资源类型、资源及资源组的一般背景信息。

• 《Sun Cluster Data Services Planning and Administration Guide for Solaris OS》提供了关于规划和管理数据服务的一般信息。

• 《Sun Cluster System Administration Guide for Solaris OS》提供了用于执行 Sun Cluster 配置的软件程序。

• 《Sun Cluster Reference Manual for Solaris OS》介绍了 Sun Cluster 软件可用的命令和实用程序，包括 SUNWscman 和 SUNWccon 软件包中特有的命令。

• 《Sun Java System Communications Services 6 2005Q4 Deployment Planning Guide》提供了关于如何在 Instant Messaging 中实现 HA 的更多信息。

可再分发的文件

Sun Java System Instant Messaging 7 2005Q4 不包括您可以再分发的任何文件。