test

Sun Java System Calendar Server 6.3 管理指南

第 20 章 使用 Instant Messaging 弹出式提醒通知

与 Sun Java System Instant Messaging 6.0（或更高版本）集成的 Calendar Server 可以为日历事件和任务提供自动弹出式提醒通知。

本章介绍如何配置弹出式提醒通知的概念性信息和说明。

本章包括以下各节：

20.1 弹出式提醒通知概述

本节包括了解弹出式提醒通知在 Calendar Server 软件中的工作方式所需的概念性信息。

本节包含以下主题：

20.1.1 日历弹出式提醒通知的配置概念

本节介绍必须配置哪些内容才可使弹出式提醒通知起作用。

用户可以在其日历上接受到即将举行的事件和任务的 Instant Messenger 弹出式提醒通知。

要启用弹出式提醒通知，必须完成以下两件任务：

启用了弹出式提醒通知后，即将发生的事件或任务临近时，Event Notification System 中设置的警报将使 Calendar Server 发送电子邮件通知并使 Instant Messaging 显示弹出式提醒通知。

Calendar Server 管理员可以选择为最终用户配置电子邮件提醒通知或弹出式提醒通知，也可以选择同时配置这两项。例如，要关闭电子邮件提醒通知，可在 ics.conf 文件中设置以下参数：

caldb.serveralarms.binary.enable= "no"

20.1.2 弹出式提醒通知如何工作

本节介绍弹出式提醒通知的工作方式。

如果配置了 Instant Messaging 弹出式提醒通知，它将遵循下面的构建流程：

  1. Instant Messaging JMS 订户在事件通知服务 (ENS) 中订阅 Calendar Server 事件和通知。

  2. Calendar Server 将事件或任务通知以 text/xml 或 text/calendar 格式发送给 ENS。

  3. Instant Messaging JMS 订户接收日历事件或任务通知，然后生成 text/calendar 格式的消息。

  4. Instant Messaging Server 将消息发送给日历所有者（如果最终用户在线）。

  5. 如果收件人在线，Instant Messenger 将根据该消息在最终用户的桌面上生成 HTML 弹出式提醒通知。

20.2 配置弹出式提醒通知

本节介绍如何配置 Calendar Server 软件的弹出式提醒通知。

本节包括以下配置说明：

Procedure配置 Instant Messaging Server

配置 Instant Messaging 弹出式提醒通知所需的以下较高级别任务列表可以为您提供方便。要配置 Instant Messaging，请参阅以下站点上可用的 Instant Messaging 文档：

http://docs.sun.com/coll/1309.2

  1. 安装新软件包 SUNWiimag。

    使用 Instant Messaging 弹出式提醒通知之前，必须首先使用 Java Enterprise System 安装程序安装 Instant Messaging 软件包。

  2. 在已安装 Instant Messaging 的计算机中，转到以下目录：

    cd /etc/opt/SUNWiim/default/config

  3. 编辑下表中所示的 iim.conf 文件中的一个或多个参数。

    显示的参数值假定您要为事件和任务都启用弹出式提醒通知。如果 iim.conf 文件中尚不存在这些参数，则先添加它们。

    参数 

    说明和要使用的适当值 

    JMS Consumers 部分 

    		 

    jms.consumers

    警报名称。将该值设置为 cal_reminder。

    jms.consumer.cal_reminder.destination

    警报目标。将该值设置为 enp:///ics/customalarm 

    jms.consumer.cal_reminder.provider

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

    jms.consumer.cal_reminder.type

    要设置的警报的类型。将该值设置为 topic。

    jms.consumer.cal_reminder.param

    警报参数。将该值设置为 "eventtype=calendar.alarm"（包括引号）

    jms.consumer.cal_reminder.factory

    C++ 工厂名称。将该值设置为： 

    com.iplanet.im.server.
JMSCalendarMessageListener

    JMS Providers 部分 

    		 

    jms.providers

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

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

    ENS 侦听的端口号。设置为 ics.conf 文件参数 service.ens.port 中指定的端口。默认值为 57997。

    jms.provider.ens.factory

    要使用的 C++ 工厂。设置为 com.iplanet.ens.jms.EnsTopicConnFactory

    Calendar Server 常见参数 

    		 

    iim_agent.enable

    启用 Calendar 代理。按如下所示设置该值（包括引号）： 

    iim_agent.enable="true"

    iim_agent.agent-calendar.enable

    装入启用 Calendar 代理的组件。按如下所示设置该值（包括引号）： 

    iim_agent.agent-calendar.enable="true"

    agent-calendar.jid

    Calendar 代理的 JID。按如下所示设置该值： 

    agent-calendar.jid=calimbot.server.domain

    agent-calendar.password

    Calendar 代理密码。按如下所示设置该值： 

    agent-calendar.password=password

    iim_server.components

    按如下所示设置该值： 

    iim_server.components=agent-calendar

  4. 转到 imadmin 命令行实用程序所在的目录：

    cd /opt/SUNWiim/sbin

  5. 使用 imadmin 启动 Calendar 代理：

    imadmin start agent-calendar

    Calendar 代理是 Instant Messaging 的一个组件，可以为 Calendar Server 用户提供弹出式功能。使用 Instant Messaging 提供的工具，可以启动、停止、重新启动 Calendar 代理或检查它的状态，也可以通过日志文件监视它的活动。

    注 –

    如果有包含 stop、start 和 refresh 命令的脚本，则可将 Calendar 代理加入其中。

    有关 imadmin 和 Calendar 代理的更多信息，参见《Sun Java System Instant Messaging 7 2005Q1 管理指南》。

Procedure配置 Calendar Server

开始之前

确认下表中所示的 ics.conf 参数具有所示的值。如果它们不具有这些值，或者您要对它们进行自定义设置，则按以下步骤操作：

  1. 以具有配置权限的管理员身份登录。

  2. 发布 stop-cal 命令停止 Calendar Server 服务。

  3. 转至 /etc/opt/SUNWics5/cal/config 目录。

  4. 通过复制和重命名旧的 ics.conf 文件来保存该文件。

  5. 编辑下表中所示的 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"。

  6. 将此文件另存为 ics.conf。

  7. 重新启动 Calendar Server。

    cal-svr-base/SUNWics5/cal/sbin/start-cal

Procedure配置 Instant Messenger

要接收 Calendar Server 事件和任务的弹出式提醒通知，最终用户必须按以下方式配置 Instant Messenger：

  1. 在“主”窗口中，从“工具”菜单中选择“设置”。

  2. 在“设置”窗口中，单击“警报”选项卡。

  3. 选中“显示日历提醒通知”选项。

  4. 单击“确定”。