Sun Java System Communications Services 2005Q4 发行说明

文档更新

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

文档集

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

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

管理指南

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

在 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 主机。

要执行此操作：

在 Instant Messaging 服务器主机上找到 imService_*.properties 文件。默认情况下，这些文件位于 /opt/SUNWiim/lib/（对于 Solaris）和 /opt/sun/im/lib/（对于 Linux）下。
将这些文件复制到 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 启用即时通讯程序归档控制

步骤

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

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

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

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

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

<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 介绍了配置参数。

表 3–4 新用户注册服务器配置参数


参数	描述
`iim.register.enable`	如果是 `TRUE`，则服务器允许新的 Instant Messaging 最终用户使用即时通讯程序自行注册（将自己添加到目录）。
`iim_ldap.register.enable`	如果是 `TRUE`，则服务器允许新的 Instant Messaging 最终用户使用即时通讯程序自行注册（将自己添加到目录）。
`iim_ldap.register.basedn`	如果启用了自行注册，则该参数的值为存储个人条目的 LDAP 目录中的位置 DN。例如 `"ou=people,dc=siroe,dc=com"`
`iim_ldap.register.domain`	新用户将添加到的域。例如 `directory.siroe.com`

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

步骤

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

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

保存并关闭 iim.conf。

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

imadmin refresh server

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

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

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

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

步骤

打开 iim.conf。

默认情况下，iim.conf 文件安装在配置目录中，如下所示：
- 对于 Solaris：
  
  /etc/opt/SUNWiim/default/config/iim.conf
- 对于 Linux：
  
  /etc/opt/sun/im/default/config/iim.conf
如果已经创建多个 Instant Messaging 实例，则 /default 目录的名称会依实例的不同而不同。

通过删除注释字符启用下面的行：
iim.log4j.config=log4j.conf
如果行不存在，则添加该行。

保存并关闭 iim.conf。

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

向 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

保存并关闭 log4j.conf。

刷新服务器：
imadmin refresh server
注意 –
不要在 Sun Cluster 的 HA 环境中使用 imadmin start、imadmin stop 或 imadmin refresh 命令。应使用 Sun Cluster 管理实用程序。

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

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

步骤

打开 log4j.conf。

注释下面的行：
log4j.logger.xmppd.xfer=DEBUG, A3

Instant Messaging 的高可用性

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

联机帮助

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

启动屏幕

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

文档更新

文档集

管理指南

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

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

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

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

从 iim.conf 中删除的参数

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

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

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

步骤

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

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

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

步骤

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

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

步骤

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

步骤

Instant Messaging 的高可用性

联机帮助

启动屏幕

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

从 `iim.conf` 中删除的参数

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