Sun Java logo     上一页      目录      索引      下一页     

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

第 5 章
管理 Instant Messenger

本章以下各节说明如何自定义和管理 Instant Messenger:


配置 Instant Messenger

调用和运行 Instant Messenger 有两种方法:

使用 Java Web Start     在此配置中,Instant Messenger 作为应用程序从 Java Web Start 启动。一旦启动 Instant Messenger,就不再需要浏览器。

使用 Java Plug-in     在此配置中,Instant Messenger 作为 Java applet 运行。要保持 Instant Messenger 会话处于活动状态,启动 applet 的浏览器窗口必须保持打开状态,且不能用于定位其他任何 URL。

有关如何配置能够启用 Instant Messenger 的 Java 软件的更多信息,参见第 2 章“设置和启动 Instant Messenger”


调用 Instant Messenger

您可以通过下列方式调用 Instant Messenger:

要调用 Instant Messenger

使用下列 URL 调用 Instant Messenger。

http://webserver:webserverport/path/filename

在此 URL 中,

webserver

指定安装 Instant Messenger 资源的 Web 容器的名称。

webserverport

(可选)指定 Web 容器端口。默认值为 80

path

(可选)指定安装客户机文件的目录。如果在安装时选择默认值,则存储客户机文件时无需指定子目录。

filename

指定要使用的 Instant Messenger 文件:

index.html - 此文件随产品提供。该文件包含用于启动 Java Web Start 和 Java Plug-in 版 Instant Messenger 的链接 im.jnlpim.html

im.jnlp - jnlp 文件只启动 Java Web Start 版 Instant Messenger。

im.html - 此页面只启动 Instant Messenger 的 Java Plug-in 版。

您还可以执行下列任务:


更改代码库

代码库是 Instant Messenger 从中访问资源的 URL,包括初始下载 Instant Messaging 客户机的开始页面。该 URL 在安装后配置过程中定义,此时将通过 configure 实用程序部署资源文件。如果更改用于访问 Instant Messenger 资源(包括 Web 容器端口号)的 URL 中的任何部分,则需要更新代码库。

如果在已经部署资源文件后想要更改代码库,则需要进行以下操作:

    要更改资源模板中的代码库


更改 Web 容器端口

如果更改用于访问 Instant Messenger 资源(包括 Web 容器端口号)的 URL 中的任何部分,则需要更新代码库。有关说明,参见更改代码库


自定义 Instant Messenger

Instant Messenger 可以自定义。可以根据组织的特定要求自定义 HTML 和 JNLP 文件。如果要为您的部署自定义资源文件,则应运行 configure 实用程序(如果在安装后尚未进行此操作),自定义文件,然后重新部署资源文件。需要先运行 configure,因为 configure 实用程序将创建某些您可以自定义的索引及 .jnlp 文件。(有关部署说明,参见重新部署资源文件。)

可以通过下列方式自定义 Instant Messenger,使之符合要求:

本节说明在自定义 Instant Messenger 时您可以修改的 Instant Messaging 服务器文件。所有可自定义的文件都位于 html 目录中。例如,在 Solaris 上,HTML 文件位于资源目录中。


Instant Messenger 资源文件

Instant Messenger 资源文件位于被称作资源目录的目录中。

表 5-1 包含资源目录 (im_svr_base/html) 中 Instant Messenger 文件的列表。它还包含这些文件的说明和自定义信息。在资源目录内,语言环境子目录通常在目录路径中以 lang 表示,但在具体情况下用语言缩写来表示,例如 en_USjpfr_FR

表 5-1 Instant Messenger 文件 

文件

说明

是否可以自定义?

lang/im.html

启动 Java Plug-in 版 Instant Messenger 的初始页面。

可以。

im.html.template

im.html 的模板版本。

不可以。此文件供安装程序用来生成 im.html 文件。

imdesktop.jar

客户机 jar 文件,由 im.htmlim.jnlp 文件下载。

不可以。

lang/im.jnlp

用于启动 Java Web Start 版 Instant Messenger 的 jnlp 文件。

可以。

im.jnlp.template

im.jnlp 的模板版本。

不可以。

imjni.jar

客户机 jar 文件,由 im.htmlim.jnlp 下载。

不可以。

messenger.jar

主客户机 jar 文件,由 im.html 或 im.jnlp 下载。

不可以

icalendar.jar

用于处理日历提醒的 icalendar 分析器。

不可以

imnet.jar

客户机 jar 文件,由 im.htmlim.jnlp 下载。

不可以。

lang/imbrand.jar

此文件包含可自定义的属性、样式表、图像、背景和音频文件。

可以

lang/imssl.html

启动 Java Plug-in 版 Instant Messenger 的初始页面。用于在客户机和多路复用器之间运行 SSL。

可以。

imssl.html.template

imssl.html 的模板版本

不可以。

lang/imssl.jnlp

此文件可启动 Java Web Start 版 Instant Messenger。此文件用于在客户机和多路复用器之间运行 SSL。

可以。

imssl.jnlp.template

imssl.jnlp 文件的模板版本。

不可以。

jnlpLaunch.jsp

如果最终用户已经登录 Sun Java System Access Manager,则此文件可用于执行单点登录和使用 Java Web Start 启动 Instant Messenger。

可以

pluginLaunch.jsp

如果最终用户已经登录 Sun Java System Access Manager,则此文件可用于执行单点登录和使用 Java Plug-in 启动 Instant Messenger。

可以

index.html

LDAP 部署的欢迎页面。它包含到 im.htmlim.jnlp 的链接,以及到 windows.htmsolaris.htmquickref.htm 的文档链接。您可以根据站点的要求自定义此页。

可以。

index.html.template

index.html 的模板版本。

不可以。

lang/imhelp/SunONE.jpg

quickref.htmsolaris.htmwindows.htm 使用的图像。

可以替换。

quickref.html

solaris.html

windows.html

位于 lang/imhelp/ 中,它们提供 Instant Messenger 入门文档。

可以。

lang/imhelp

Instant Messenger 联机帮助目录。

不可以。

imwebex.jar

 

 

msgrinstall.jar

 

 

自定义 index.html 和 im.html 文件(仅限 LDAP 部署)

Instant Messenger 可让您修改 index.htmlim.html 文件的“静态”部分,以产生完全自定义的用户界面。这些 HTML 文件包含文本和说明文本格式制作及处理方式的标记。标记由指定标题格式、缩进、字体大小和字体样式的一组标签实现。

以下是一些可以修改的页面元素:

index.html 文件可启动 Instant Messenger applet 和 Java Web Start 应用程序。如果运行的是 Instant Messenger applet,请修改 im.html 文件。im.html 文件被 index.html 调用,自身可以调用 Instant Messenger applet。im.html 文件在安装期间生成,其中包含指向多路复用器的 applet 参数。


参数 "<PARAM NAME="server" VALUE="servername">" 用于表示 im.html 文件中的 Instant Messaging 多路复用器及其端口。如果更改 iim_mux.listenport 参数的默认值,则需要将 servername 值更改为 host.domain:port


使用 Sun Java System Access Manager SSO 启动 Instant Messenger

要通过 Sun Java System Access Manager 的单点登录 (SSO) 来启动 Instant Messenger 客户机,请使用 IMLaunch.jsp。该文件位于资源目录中。

必须要配置 Sun Java System Access Manager 和 Instant Messenger 客户机使其使用相同的 Web 容器以启用 SSO。

要启动 Instant Messaging 服务器,请在浏览器中输入下列内容:

codebase/IMLaunch.jsp?server=multiplexor-hostname:muliplexor-port

codebase/IMLaunch.jsp?server=www.example.com:5222

其中,

codebase 是用于下载 Instant Messenger 资源的代码库。例如,http://www.example.com.

multiplexor-hostname 是多路复用器的名称。例如,http://www.company22.com。

muliplexor-port 是多路复用器侦听外来客户机请求所在的端口号。例如,5222

IMLaunch.jsp 用于通过 Java Web Start 或 Java 插件启动 Instant Messenger。

自定义应用程序 (Java Web Start)

如果使用 Java Web Start 运行 Instant Messenger,则可通过修改 im.jnlpimres.jnlpimres.jar 文件来自定义用户界面。以下是可以对这些 HTML 文件所做的修改:

imbrand.jar 的内容列表

表 5-3 列出 imbrand.jar 文件中的文件及其说明。imbrand.jar 文件包含可用于自定义 Instant Messenger 的图像和音频文件。

表 5-3 imbrand.jar 内容 

文件名

说明

配置文件

brand.properties

 

chat-styles.css

 

图释

emo_alarm.png

以图形表示报警情绪

emo_angel.png

以图形表示天使般情绪

emo_angry.png

以图形表示愤怒情绪。

emo_balloons.png

一束气球的图示。

emo_beermug.png

一杯啤酒的图示。

emo_cake.png

一块生日蛋糕的图示。

emo_calendar.png

一份日历的图示。

emo_canworms.png

一罐蠕虫的图示。

emo_clown.png

小丑头形的图示。

emo_cool.png

以图形表示酷情绪。

emo_dead.png

以图形表示死亡。

emo_devil.png

以图形表示邪恶情绪。

emo_dont-tell.png

以图形表示秘密请求。

emo_embarrassed.png

以图形表示尴尬情绪。

emo_exclamation.png

一个感叹号的图示。

emo_flower.png

一朵花的图示。

emo_ghost.png

一个鬼的图示。

emo_goldstar.png

一颗金星的图示。

emo_grin.png

以图形表示露齿而笑。

emo_kiss.png

以图形表示亲吻。

emo_laughing.png

以图形表示欢笑情绪。

emo_lifepreserver.png

一个救生设备的图示。

emo_lightning.png

雷暴云和闪电的图示。

emo_lovestruck.png

以图形表示爱慕情绪的图释。

emo_martini.png

一个马提尼酒杯的图示。

emo_money.png

几堆硬币的图示。

emo_musicnote.png

一个音符的图示。

emo_nerd.png

傻笑的图示。

emo_nottalking.png

以图形表示转过去的面孔。

emo_phone.png

一部电话机的图示。

emo_present.png

一件带包装礼物的图示。

emo_psychoknife.png

一把刀的图示。

emo_rathole.png

一个老鼠洞的图示。

emo_sad.png

以图形表示悲伤情绪。

emo_sick.png

以图形表示生病。

emo_sleep.png

以图形表示睡眠。

emo_smiley.png

以图形表示微笑。

emo_straightfaced.png

一个板起面孔之人的图示。

emo_sunshining.png

太阳的图示。

emo_surprised.png

以图形表示惊奇。

emo_tongue-out.png

一个伸出舌头之人的图示。

emo_violin.png

一把小提琴的图示。

emo_whatever.png

以图形表示漠不关心或轻视。

应用程序图标 - Windows

im_app_icon_16.png

Windows 标题栏图标。

im_app_icon_24.png

Windows 标题栏图标。

tray_icon.ico

Windows 系统托盘图标。

应用程序图标 - 所有平台

logo_login_footer.png

在“登录”对话框底部显示的徽标。

logo_register.png

在“注册”对话框中显示的徽标。

logo_sun.png

在“登录”对话框中显示的 Sun 徽标。

工具栏图标

tb_addcontacts.png

“添加联系人”按钮的图形。

tb_alert.png

“发送警报”按钮的图形。

tb_chat.png

“与用户聊天”按钮的图形。

tb_conf.png

“添加会议”按钮的图形。

联系人列表图标

cl_folder_closed.png

以图形表示一个关闭的文件夹。

cl_folder_open.png

以图形表示一个打开的文件夹。

在线图标 - 联系人列表

cl_activeconf.png

用于表示在“联系人列表”中出现的活动会议而显示的图标。

cl_away.png

出现在“联系人列表”中的离开状态图标。

cl_dnd.png

 

cl_idle.png

用于显示在“联系人列表”中出现的空闲状态而显示的图标。

cl_inactiveconf.png

用于表示在“联系人列表”中出现的非活动会议而显示的图标。

cl_offline.png

出现在“联系人列表”中的脱机状态图标。

cl_online.png

出现在“联系人列表”中的脱机状态图标。

cl_pending.png

用于指示在“联系人列表”中出现的未决状态的图标。

在线图标 - 状态栏

sb_away.png

出现在“状态栏”中的离开状态图标。

sb_dnd.png

 

sb_idle.png

出现在“状态栏”中的空闲状态图标。

sb_offline.png

出现在“状态栏”中的脱机状态图标。

sb_online.png

出现在“状态栏”中的联机状态图标。

背景配置文件

bgstyles.properties

用于扩展背景设置的配置文件。

调色板的背景和背景色标

bgplt_tex_blue.gif

bgplt_tex_brown.gif

bgplt_tex_bubble_blue.gif

bgplt_tex_bubble_brown.gif

bgplt_tex_bubble_green.gif

bgplt_tex_bubble_grey.gif

bgplt_tex_bubble_orange.gif

bgplt_tex_bubble_purple.gif

bgplt_tex_bubble_ruby.gif

bgplt_tex_crackle_blue.gif

bgplt_tex_crackle_green1.gif

bgplt_tex_crackle_grey.gif

bgplt_tex_crackle_olive.gif

bgplt_tex_crackle_orange.gif

bgplt_tex_crackle_purple.gif

bgplt_tex_crackle_ruby.gif

bgplt_tex_gradation_blue.gif

bgplt_tex_gradation_brown.gif

bgplt_tex_gradation_green.gif

bgplt_tex_gradation_grey.gif

bgplt_tex_gradation_orange.gif

bgplt_tex_gradation_purple.gif

bgplt_tex_gradation_ruby.gif

bgplt_tex_green.gif

bgplt_tex_orange.gif

bgplt_tex_pink.gif

bgplt_tex_purple.gif

bgplt_tex_weave_blue.gif

bgplt_tex_weave_brown.gif

bgplt_tex_weave_green.gif

bgplt_tex_weave_grey.gif

bgplt_tex_weave_orange.gif

bgplt_tex_weave_purple.gif

bgplt_tex_weave_ruby.gif

bgplt_tex_white.gif

bg_tex_bubble_blue.gif

bg_tex_bubble_brown.gif

bg_tex_bubble_green.gif

bg_tex_bubble_grey.gif

bg_tex_bubble_orange.gif

bg_tex_bubble_purple.gif

bg_tex_bubble_ruby.gif

bg_tex_crackle_blue.gif

bg_tex_crackle_green1.gif

bg_tex_crackle_grey.gif

bg_tex_crackle_olive.gif

bg_tex_crackle_orange.gif

bg_tex_crackle_purple.gif

bg_tex_crackle_ruby.gif

bg_tex_gradation_blue.gif

bg_tex_gradation_brown.gif

bg_tex_gradation_green.gif

bg_tex_gradation_grey.gif

bg_tex_gradation_orange.gif

bg_tex_gradation_purple.gif

bg_tex_gradation_ruby.gif

bg_tex_weave_blue.gif

bg_tex_weave_brown.gif

bg_tex_weave_green.gif

bg_tex_weave_grey.gif

bg_tex_weave_orange.gif

bg_tex_weave_purple.gif

bg_tex_weave_ruby.gif

声音

alert.wav

警报声音。

alerttpc.wav

警报声音。

away.wav

将状态改为离开时所用的声音。

receive.wav

收到消息时所用的声音。

send.wav

发送消息时所用的声音。

soundoff.wav

关闭声音时所用的声音。

soundon.wav

打开声音时所用的声音。

自定义 Instant Messenger 的外观

imbrand.jar 文件包含控制 Instant Messenger 外观的所有图像和属性。可以通过修改 imbrand.jar 文件中的图像和属性来自定义 Instant Messenger 的外观。

    自定义 Instant Messenger
  1. imbrand.jar 文件复制到一个工作目录。例如:
  2. cp im_svr_base/html/lang/imbrand.jar working_directory

  3. 转到该工作目录。
  4. cd working_directory

  5. 提取 imbrand.jar 文件。
  6. jar xf imbrand.jar

    此命令可创建复制资源文件的目录树。当您修改 jar 文件中的个别文件时,必须保持此目录结构。

    或者,可提取包括在 imbrand.jar 中的单个文件,并将其置于指定的目录结构中。例如,要只提取 brand.properties,使用以下命令:

    jar xf imbrand.jar com/sun/im/desktop/brand/brand.properties

  7. 用修改后的 .gif.wav.properties 文件更新 imbrand.jar 文件。
  8. 可按如下所述更新 imbrand.jar 中的所有文件:

    jar cf imbrand.jar。

    要用单个修改过的文件更新 imbrand.jar 文件,使用以下命令:

    jar uf imbrand.jar com/sun/im/desktop/brand/<filename>

    其中,<filename> 是 imbrand.jar 中所包括文件的名称,例如 brand.properties

  9. imbrand.jar 文件复制到资源目录。例如:
  10. cp imbrand.jar im_svr_base/html/lang/


    如果支持多种语言环境,则应对每种支持的语言环境执行自定义 Instant Messenger 的过程。


自定义用户名显示

可在工具提醒和搜索结果中自定义用户名显示。

在搜索结果中自定义用户名显示

如果两个最终用户具有相同的姓氏和名字,就无法知道应添加哪一个最终用户到联系人列表中。可以将 Instant Messenger 自定义为:在用户搜索结果中显示更多信息。要在用户搜索结果中显示更多信息,就需要在 imbrand.jar 文件中将 dialogs.searchresults.format 属性添加到下列位置的 brand.properties 文件:

com/sun/im/desktop/brand/

有关如何修改 imbrand.jar 的更多信息,参见自定义应用程序 (Java Web Start)

通过在 dialogs.searchresults.format 属性中包括附加 LDAP 属性值,便可在用户搜索结果中显示更多信息。

LDAP 属性用以下格式指定:

${attr:attribute-name}

下列示例显示 dialogs.searchresults.format 属性中的 LDAP 属性:

dialogs.searchresults.format=(${attr:title})

要使用 LDAP 用户条目中的任意属性,就必须在服务器配置文件 iim.conf 中指定这些自定义属性的列表。这些自定义属性必须指定为属性 iim_ldap.userattributes 的值。

下列示例显示了列示自定义属性为如下值的 iim_ldap.userattributes

iim_ldap.userattributes=title,department,telephonenumber

在工具提醒中自定义用户名显示

可以将 Instant Messenger 自定义为在联系人工具提醒中显示附加信息。

例如,当鼠标放在联系人上时,显示该联系人的电话号码:

  1. 转到下列目录:
  2. com/sun/im/client/

  3. 打开 brand.properties 文件。
  4. 添加 contact.tooltip.format.html 属性到文件中。
  5. 保存对文件的更改
  6. 转到下列目录。
  7. cd im_svr_base/html

  8. 添加 contact.tooltip.format.html 属性和 telephonenumber 属性,作为它在 imbrand.jar 文件的 HTML 代码中的值。
  9. contact.tooltip.format.html=mailto: ${attr:mail} tel: ${attr:telephonenumber}

有关自定义 imbrand.jar 文件的信息,参见自定义应用程序 (Java Web Start)


修改客户机用户搜索联系人的方式

在默认情况下,"commonname" 或 "cn" LDAP 属性用于表示用户的显示名称,并用作用户的搜索属性。如果您想转而使用 "nickname" LDAP 属性,则可通过设置 iim.conf 中的下列参数达到此目的:

iim_ldap.userdisplay=nickname

要使用户可按常用名称或昵称进行搜索,修改 iim_ldap.usergroupbynamesearchfilter 属性。这将指定搜索用户或组时所用的 LDAP 搜索。它使用标准的 LDAP 过滤器语法。可对其进行修改以便可进行更复杂的搜索。有关修改搜索字符串的更多信息,参见 Directory Server 文档。


管理会议室和新闻频道

可以通过在 Instant Messenger 中执行下列任务管理会议室和新闻频道。有关执行这些任务的更多信息,参见联机帮助。

授予最终用户创建会议室和新闻频道的权限

管理员可以为最终用户创建会议室和新闻频道。但具有适当权限的最终用户也可进行上述操作。有关添加策略以允许最终用户创建会议室和新闻频道的更多信息,参见第 6 章“管理 Instant Messaging 和在线策略”。默认情况下,创建会议室或新闻频道的最终用户具有 Manage 访问权限,因此可以管理会议室或新闻频道。


修改 Instant Messenger 代理设置

Instant Messaging消息可以包含嵌入式 URL。例如 http://stocks.yahoo.com?id=sunw。如果使用代理服务器,则必须通过修改 Java Web Start 配置中的 Instant Messenger 代理设置,解析此类嵌入式 URL。

如果您的组织有防火墙,而您必须通过代理服务器才能将客户机主机连接到 internet,或者 Java Web Start 没有配置正确的代理设置,就可能发生这种情况。

修改 Instant Messenger 代理设置

Java Web Start 可以通过查询系统或默认浏览器来自动配置代理设置。但是,如果这些代理设置是使用 JavaScript 文件配置的,Java Web Start 就无法自动配置。

    手动设置代理设置
  1. 调用 Java Web Start。
  2. 从“文件”菜单中选择“首选项”。
  3. 在“首选项”对话框中选择“手动”选项。
  4. 输入下列详细信息:
  5. HTTP 代理。输入代理服务器的名称或 IP 地址。

    HTTP 端口。输入代理服务器的端口号。

    无代理主机。输入可以跳过代理服务器直接连接的任何域名。使用逗号分隔多个主机名。

  6. 单击“确定”保存代理设置。


控制公开的 Messenger 功能集

管理员可以通过配置 applet 描述符文件中的 Instant Messaging applet 参数,来控制公开的 Instant Messenger 功能集。

表 5-4 显示 applet 描述符文件中的 Instant Messenger applet 参数。还包含这些参数的说明和默认值。

表 5-4 Instant Messenger Applet 参数 

参数

默认值

说明

server

127.0.0.1

Instant Messaging 服务器主机和端口。

debug

FALSE

如果此参数设置为 true,applet 将会记录在 java 控制台上执行的所有任务。

uid

 

此参数用于 SSO。

token

 

此参数包含 SSO 标记,用于自动登录。

secure

FALSE

指示在 SRA 模式下运行的 Instant Messenger。它显示安全指示符。

usessl

FALSE

指示 Instant Messenger 在连接到服务器时使用 SSL。

allow_alert_only

FALSE

指示 Instant Messenger 让最终用户不显示联系人列表与新闻频道。

此参数用于 CHATPOPUP 风格。

allow_file_transfer

TRUE

允许文件附件和传送。

enable_moderator

TRUE

如果设置为 true,将启用主持会议功能。

messenger_bean

 

此参数包含要使用的 messenger bean 列表。可以输入多个 factory 类名称,用逗号分隔。

domain

null

此参数用于多域 Sun Java System Access Manager 部署。此参数的值应为此最终用户所在组织的逻辑域名。

gateway_url

null

此参数包含门户 SRA 的网关组件的 URL。


存储在最终用户系统中的 Instant Messenger 数据

Instant Messenger 在最终用户的系统缓存中存有一定数量的信息,以供自动登录之用。这些信息位于:

home_directory/.sunmsgr

home_directory 是最终用户的起始目录。最终用户的起始目录可从 Java 系统属性中的 user.home 参数获取。

表 5-5 显示包含缓存数据的目录和文件,还包含这些文件和目录的说明。

表 5-5 缓存数据目录和文件 

文件/目录名称

类型

说明

.sunmsgr/messenger.
properties

文件     

包含自动登录属性的文件

.sunmsgr/<user_domain>

目录

包含特定 {登录名,域名} 组合专有数据的目录。

home_directory/sunmsgr/<user_domain>/messenger.properties

文件

此文件包含特定 <user_domain> 专有的自动登录选项。未使用此文件。

home_directory/sunmsgr/<user_domain>/messages/

目录

此目录包含缓存消息。未使用此目录。

表 5-6 显示 Instant Messaging 的自动登录属性。还包含这些属性的说明和默认值。

表 5-6 自动登录属性 

参数

默认值

说明

client.password.encoded

false

决定是否对用户口令进行编码(以用于 SSO)。如果此参数的值为 true,则编码口令将作为 net.password 参数的值存储。

net.server

127.0.0.1

Instant Messaging 服务器主机名和端口。

net.server.n

(其中 n 是用来区别条目的数字)

 

辅助服务器的主机名和端口号。

net.user

 

默认用户 ID

net.password

 

启用自动登录的已编码用户口令。


使用日历弹出提示

Instant Messaging 与 Sun Java System Calendar Server 集成在一起,以向 Instant Messenger 用户提供针对日历事件和任务的自动弹出提示。

本部分包括以下主题:

弹出提示概述

本部分包括以下主题:

弹出提示操作

对于用户日历中即将发生的事件和任务,用户可收到相应的 Instant Messenger 弹出提示。要启用这些弹出提示,必须具备以下条件:

在启用了弹出消息后,当即将到来的事件或任务临近时,“事件通知系统”中设置的报警将促使 Calendar Server 发送电子邮件通知,并使 Instant Messaging 显示弹出提示。

弹出提示体系结构流程

如果进行了配置,则 Instant Messaging 弹出提示将遵循以下体系结构流程:

  1. Instant Messaging JMS 订户在“事件通知服务”(ENS) 中订阅“日历”服务器事件和通知。
  2. “日历”服务器向 ENS 发布 text/xmltext/calendar 格式的事件或任务通知。
  3. Instant Messaging JMS 订户收到日历事件或任务通知,然后生成 text/calendar 格式的消息。
  4. 如果最终用户处于联机状态,则 Instant Messaging 服务器将向日历所有者发送此消息。
  5. 如果有收件人,则 Instant Messenger 会根据此消息在最终用户桌面上生成 HTML 弹出提示。
  6. 如果没有收件人,则 Instant Messaging 服务器会丢弃此消息。

配置 Instant Messaging 弹出消息

本节包括以下配置说明:

    配置 Instant Messaging Server
  1. 安装新软件包 SUNWiimag
  2. 表 5-7 中所示,编辑 iim.conf 文件中的一个或多个参数。
  3. 所显示的参数值假定您需要事件和任务的弹出提示。如果您的 iim.conf 文件中还没有这些参数,则添加它们。

    表 5-7 用于配置日历弹出消息的 iim.conf 参数 

    参数

    说明和要使用的相应值

                                              JMS 用户部分

    jms.consumers

    报警名称。将此值设置为:

    cal_reminder

    jms.consumer.cal_reminder.destination

    报警的目的地。它必须与 ics.conf 文件中 caldb.serveralarms.url 配置参数的值相同。例如,

    enp:///ics/customalarm

    jms.consumer.cal_reminder.provider

    提供者名称。设置为 ens。它必须与“JMS 提供者”部分 jms.providers 中的名称相同。

    jms.consumer.cal_reminder.type

    要设置的报警类型。将此值设置为:

    topic

    jms.consumer.cal_reminder.param

    报警参数。按以下形式设置此值,包括引号:

    "eventtype=calendar.alarm"

    jms.consumer.cal_reminder.factory

    针对新的日历提示消息而自行注册的侦听器。将此值设置为:

    com.iplanet.im.server.JMSCalendarMessageListener

                                              提供者部分

    jms.providers

    提供者名称。将值设置为 ens。它必须与“JMS 消费者”部分中列出的 jms.consumer.cal_reminder.provider 的值相同。

    jms.provider.ens.broker

    ENS 的主机名和 ENS 侦听外来请求时所在的端口号。设置为在 ics.conf 文件参数 service.ens.port 中指定的端口。默认值为 57997。例如:

    jms.provider.ens.broker=cal.example.com:57997

    jms.provider.ens.factory

    用于创建主题连接对象的 Factory 类。将此值设置为:

    com.iplanet.ens.jms.EnsTopicConnFactory

                                              一般参数

    iim_agent.enable

    启用“日历”代理。按以下形式设置此值,包括引号:

    iim_agent.enable="true"

    iim_agent.agent-calendar.enable

    加载可启用“日历”代理的组件。按以下形式设置此值,包括引号:

    iim_agent.agent-calendar.enable="true"

    agent-calendar.jid

    “日历”代理的 JID。按以下形式设置此值:

    agent-calendar.jid=calimbot.server.domain

    agent-calendar.password

    “日历”代理口令。按以下形式设置此值:

    agent-calendar.password=password

    iim_server.components

    按以下形式设置此值:

    iim_server.components=agent-calendar

  4. 使用 imadmin 启动“日历”代理。
  5. imadmin start agent-calendar

    imadmin 命令行实用程序位于下列目录中:

    im_svr_base/sbin

    其中,im_svr_base 是用于安装 Instant Messaging 的目录。

    配置 Calendar Server
  1. 确认表 5-8 中显示的 ics.conf 参数具有所显示的值。如果没有,执行以下步骤以使其一致。
  2. 以有权更改此配置的管理员身份登录到“日历”服务器主机。
  3. 转到 /etc/opt/SUNWics5/cal/config 目录。
  4. 通过复制和重命名旧的 ics.conf 文件将其保存。
  5. 表 5-8 中的参数修改为所显示的值。
  6. 表 5-8 用于配置日历弹出消息的 ics.conf 参数 

    参数

    说明和默认值

    caldb.serveralarms

    使日历报警排成队列。默认值为 "yes"(已启用)。

    caldb.serveralarms.
    contenttype

    报警内容的输出格式。默认值为 "text/xml"

    caldb.serveralarms.dispatch

    使日历报警得以分发。默认值为 "yes"(已启用)。

    caldb.serveralarms.
    dispatchtype

    要分发的服务器报警类型。默认值为 "ens"

    caldb.serveralarms.url

    这是检索报警内容的报警 URL。默认值为 "enp:///ics/customalarm"

  7. 将文件另存为 ics.conf
  8. 重新启动“日历”服务器。
  9. cal_svr_base/SUNWics5/cal/sbin/start-cal

    其中,cal_svr_base 是用于安装 Sun Java System Calendar Server 的目录。

    配置 Instant Messenger
  1. 在 Instant Messenger 主窗口的“工具”菜单中,选择“设置”。
  2. 在“设置”窗口中,单击“警报”选项卡。
  3. 选中“显示日历提醒”选项。
  4. 单击“确定”。
  5. 当用户处于联机状态时,可通过 Instant Messenger 接收“日历”弹出消息。

管理日历代理

“日历”代理是向“日历”和 Instant Messaging 用户提供弹出功能的一个 Instant Messaging 组件。使用 Instant Messaging 提供的工具,可启动、停止、重新启动“日历”代理或检查其状态,并可通过日志文件监视其活动。有关管理“日历”代理组件的信息,参见停止、启动和刷新 Instant Messaging 组件。有关“日历”代理日志的信息,另请参见管理日志记录


重新部署资源文件

如果您使用的是 Sun Java™ System Application Server 或 Sun Java™ System Web Server,并且在因为站点更改或自定义而运行 configure 实用程序后对资源文件进行了更改,则需要将这些文件重新部署到 Web 容器中。

    将资源文件重新部署到 Sun Java System Access Manager 或 Sun Java System Web Server

有关其他信息,参见 Web 容器的文档。



上一页      目录      索引      下一页     


文件号码 819-1489。版权所有 2005 Sun Microsystems, Inc. 保留所有权利。