本部分介绍了有关以下部分所述文档中的更改和错误的信息:
Instant Messaging 的 2005Q4 发行版使用以下版本的管理指南:
《Sun Java System Instant Messaging 7 2005Q1 管理指南》
本部分列出了《Sun Java System Instant Messaging 7 2005Q1 管理指南》的以下更改。
不要在 Sun Cluster 的 HA 环境中使用 imadmin start、imadmin stop 或 imadmin refresh 命令。应使用 Sun Cluster 管理实用程序。
(问题编号: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)。
(问题编号:5102072)在此发行版中,iim_agent.enable 参数的默认值已更改为 False。该更改没有反映在管理指南中。
过程“配置 Instant Messaging 服务器”的步骤 1 错误。不存在名为 SUNWiimag 的软件包。跳过该步骤。
不再支持 iim_server.msg_archive.auto 配置参数,尽管它错误地包括在管理指南的参数列表中。
(问题编号:6244099)管理指南中所介绍的为 Java Plug-in 启用即时通讯程序归档控制组件的过程错误。请使用更改 HTML applet 页面和 pluginLaunch.jsp 文件中介绍的过程。
如果使用 Java Plug-in 启动即时通讯程序,请执行以下步骤以在即时通讯程序中启用即时通讯程序归档控制功能。
转至即时通讯程序文档根目录,然后找到 im.html 和 imssl.html 文件
默认情况下,这些文件安装在以下位置:
/etc/opt/SUNWps/desktop/default/IMProvider
在文本编辑器中打开 .html 文件。
根据要求添加或编辑以下行:
<PARAM NAME="archive_control" VALUE="true" /> <EMBED archive_control=true;/> |
在此过程中发生错误。具体而言,以下目录:
/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 管理实用程序。
(问题编号:5070998)已向此发行版中添加了其他未存档的日志参数以收集单独日志文件中的 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 消息写入服务器日志。
关于此功能的介绍可以在配置 Instant Messaging 以获得高可用性(仅 Solaris)中获得。
以下信息在产品联机帮助和快速参考中均未介绍。
启动屏幕启动即时通讯程序。如果您使用的是 Java Web Start,请按屏幕中间的“启动”按钮。如果您使用的是 Java Plug-in(仅用于 Windows 用户),请单击屏幕上方的 "Java Plug-in" 按钮。“联机帮助”和“快速参考”按钮显示最终用户的产品帮助信息。