第 15 章 管理 Instant Messenger

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

• 配置 Instant Messenger

• 调用 Instant Messenger

• 更改代码库

• 更改 Web 容器端口

• 自定义 Instant Messenger

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

• 管理会议室和新闻频道

• 修改 Instant Messenger 代理设置

• 控制公开的 Messenger 功能集

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

• 重新部署资源文件

配置 Instant Messenger

有两种方式可以调用和运行 Instant Messenger：

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

使用 Java 插件 - 在此配置中，Instant Messenger 作为 Java applet 运行。要保持 Instant Messenger 会话处于活动状态，启动 applet 的浏览器窗口必须保持打开状态，且不能用于定位其他任何 URL。此外，Java 插件不允许桌面集成，因此“设置”对话框中的“桌面集成设置”选项将不可用。

有关如何配置启用 Instant Messenger 的 Java 软件的更多信息，参见第 2 章，设置和启动 Instant Messenger。

调用 Instant Messenger

您可以从几个位置调用 Instant Messenger：

• 使用 index.html 文件，该文件可提供选项以启动 Java Web Start 和 Java 插件版 Instant Messenger。此文件还包含到 Instant Messenger 文档的链接。

• 您设计的带有指向 Instant Messenger 的链接的 Web 页。

• 使用 im.html 或 im.jnlp 文件的直接 URL。

• 通过命令行调用。

• 使用桌面快捷方式。

以下各节说明如何调用 Instant Messenger：

• 使用直接 URL 调用 Instant Messenger

• 通过命令行调用 Instant Messenger（仅 Solaris）

• 使用桌面快捷方式调用 Instant Messenger

使用直接 URL 调用 Instant Messenger

在您的 Web 浏览器中输入以下 URL 来调用 Instant Messenger：

http://webserver:webserverport/path/filename

在此 URL 中，

webserver

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

webserverport

（可选）指定 Web 容器端口。默认值为 80。

path

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

filename

指定要使用的 Instant Messenger 文件：

index.html - 此文件随产品提供。该文件包含指向 im.jnlp 和 im.html 的链接，分别用于启动 Java Web Start 和 Java 插件版的 Instant Messenger。

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

im.html - 仅启动 Java 插件版 Instant Messenger 的 Web 页。

通过命令行调用 Instant Messenger（仅 Solaris）

在命令行键入命令：

javaws_cmd URL

有关构造 URL 的信息，参见使用直接 URL 调用 Instant Messenger。

使用桌面快捷方式调用 Instant Messenger

创建并使用桌面快捷方式来调用 Instant Messenger

• 使用 Java Web Start 创建快捷方式。

• 手动创建快捷方式，然后按如下所示设置目标值：

  javaws_cmd jnlp-URL

  其中，jnlp-URL 是指向 im.jnlp 文件的 URL。

更改代码库

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

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

• 修改模板文件，以指向新的 URL。参见要更改资源模板中的代码库。

• 运行 configure 实用程序，当提示要配置哪些组件时，仅选择“Messenger Resources”组件。有关说明，参见安装或升级后配置 Instant Messaging。

• 重新部署资源文件。有关说明，参见重新部署资源文件。

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

在带有新 URL 的 im-svr-base/html 目录中，编辑每个模板文件。

模板文件命名为 *.template。有关模板文件的完整列表，参见Instant Messenger 资源文件。

更改 Web 容器端口

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

自定义 Instant Messenger

Instant Messenger 可以自定义。可以自定义 HTML 和 JNLP 文件以适应组织的特殊需要。如果想要自定义资源文件以用于部署，您应该运行 configure 实用程序（如果安装后尚未这样做），自定义文件，然后重新部署资源文件。您需要先运行 configure 实用程序，因为它创建某些您可以自定义的文件。（有关重新部署的说明，参见重新部署资源文件。）

可通过以下方式自定义 Instant Messenger 以满足您的要求：

• Instant Messenger 资源文件

• 自定义 index.html 和 im.html 文件

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

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

• 重建 Instant Messenger

• 自定义用户名和组名显示方式

本节说明您可以修改以自定义 Instant Messenger 的 Instant Messaging 服务器文件。所有您可以自定义的文件均位于资源目录 im-svr-base/html 目录中。有关默认目录位置的信息，参见表 3–1。

Instant Messenger 资源文件

Instant Messenger 资源文件位于称为资源目录或 im-svr-base/html 的目录内。

表 15–1 包含资源目录 (im-svr-base/html) 中 Instant Messenger 文件的列表。它还包含这些文件的说明和自定义信息。在资源目录内，/locale 子目录通常在目录路径中以 lang 表示，但在具体情况下用语言缩写来表示，例如 en_US、jp 和 fr_FR。

自定义 index.html 和 im.html 文件

如果您在不带 Sun Java System Access Manager 的部署中使用 Instant Messenger，则可以修改 index.html 和 im.html 文件的 static 部分，以生成一个完全自定义的用户界面。这些 HTML 文件包含说明如何格式化和处理文本的文本和标记。标记由指定标题格式、缩进、字体大小和字体样式的一组标签实现。

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

• 图像

• 标题

• 包含标题和字段标签的屏幕文本

• 背景方案

可从 index.html 启动 Instant Messenger applet 和 Java Web Start 应用程序。如果您运行 Instant Messenger applet，请修改 im.html 文件。im.html 文件被 index.html 调用，自身可以调用 Instant Messenger applet。im.html 文件在运行 configure 实用程序时生成，并包含一个指向多路复用器的 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 Messenger，可在 Web 浏览器中输入以下内容：

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.jnlp、imres.jnlp 和 imres.jar 文件来自定义用户界面。以下是可以对这些文件所做的修改：

• imbrand.jar - 此文件包含图像和音频文件以及可自定义的属性。您需要通过 Java Developers Kit 1.3 (JDK) 使用 jar 命令从 imres.jar 文件提取内容。有关 imbrand.jar 内容的更多信息，参见imbrand.jar 的内容。

  使用以下命令提取 imbrand.jar：

  jar xvf imbrand.jar

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

  替换 .gif 文件或 .wav 文件的版本时可以不更改文件名，然后使用以下 jar 命令将更改后的文件放回该目录：

  jar -uf imbrand.jar com/Sun/im/client/images/*.gif

  此命令使用修改后的 .gif 文件更新 imbrand.jar 文件。可以对音频文件（.wav 文件）进行同样的操作。

• im.jnlp - 此文件调用 Java Web Start 版的 Instant Messenger 应用程序。可以修改文件中的代码库、标题、供应商和说明。

  示例 15–1 显示了 im.jnlp 文件样例，可以自定义的 HTML 代码以粗体显示。

示例 15–1 im.jnlp 文件样例

<?xml version="1.0" encoding="utf-8"?>
<!-- Instant Messenger -->
<jnlp
  spec="1.0+"
  codebase="http://im.i-zed.com:80/im"
  href="en/im.jnlp">
  <information>
    <title>Instant Messaging</title>
    <vendor>I-Zed.com</vendor>
    <homepage href="http://www.I-zed.com/"/>
    <description>I-Zed’s Sun Java System Instant Messenger</description>
    <description kind="short">Instant Messenger</description>
    <icon href="CompanyLogo.gif"/>
    <offline-allowed/>
  </information>
  <security>
    <all-permissions/>
  </security>
  <resources>
    <j2se version="1.3+">
      <resources>
        <jar href="en/imres.jar"/>
        <jar href="en/imbrand.jar"/>
      </resources>
    </j2se>
    <jar href="messenger.jar"/>
    <jar href="imdesktop.jar"/>
    <jar href="imnet.jar"/>
    <jar href="icalendar.jar"/>
    <nativelib href="imjni.jar"/>
  </resources>
  <application-desc main-class="com.iplanet.im.client.iIM">
    <argument>server=im.i-zed.com:45222</argument>
    <argument>help_codebase=http://im.i-zed.com:80/im/en</argument>
  </application-desc>
</jnlp>

在 im.jnlp 文件中，参数 <argument> servername</argument> 表示 Instant Messaging 多路复用器主机和端口。如果您更改了 iim_mux.listenport 参数，则您需要将 servername 的值更改为 host.domain :port。

imbrand.jar 的内容

本节中的表列出了 imbrand.jar 文件中的文件并尽可能地提供了每个文件的说明。imbrand.jar 文件还包含您可用于重建 Instant Messenger 的图像和音频文件。本节包含以下表格：

• 表 15–2 – 用于配置 Instant Messenger 的配置文件。

• 表 15–3 – 聊天会话过程中可用的表情图标。

• 表 15–4 – Windows 中的应用程序使用的图标。

• 表 15–5 – 所有平台中的应用程序使用的图标。

• 表 15–6 – 工具栏中使用的图标。

• 表 15–7 – 联系人列表中使用的图标。

• 表 15–8 – 用于说明联系人列表中在线状态信息的图标。

• 表 15–9 – 用于说明状态栏中在线状态信息的图标。

• 表 15–10 – 可用的背景。

• 表 15–11 – 用于表示警报和状态或配置更改的声音。

重建 Instant Messenger

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

重建 Instant Messenger

1. 将 imbrand.jar 文件复制到一个工作目录中。

   例如：

   cp im-svr-base/html/lang/imbrand.jar working-directory

2. 转到该工作目录。

   cd working-directory

3. 提取 imbrand.jar 文件。

   jar xf imbrand.jar

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

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

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

4. 用修改后的 .gif、.wav 和 .properties 文件更新 imbrand.jar。

   您可以更新 imbrand.jar 中的所有文件，方法如下：

   jar cf imbrand.jar .

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

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

   其中，filename 是 imbrand.jar 中所包括文件的名称，例如，brand.properties。

5. 将 imbrand.jar 复制到资源目录。

   例如：

   cp imbrand.jar im-svr-base/html/lang/ .

   ---

   注 –

   如果您的部署中支持多语言环境，请对每个支持的语言环境执行该过程以重建 Instant Messenger。

   ---

自定义用户名和组名显示方式

您可以通过更改用于显示联系人姓名的属性来自定义 Instant Messenger 如何显示联系人和组的名称。默认情况下，Instant Messenger 使用属性 cn 表示用户的显示名称。在您的部署中，您可能喜欢使用 uid 或某些其他属性来代替 cn。

联系人姓名显示为名、姓。例如，Frank Smith、Mary Jones 等。如果两个最终用户具有相同的名和姓，就无法知道应添加哪一个最终用户到联系人列表中。您可以自定义 Instant Messenger 在用户的搜索结果中显示更多信息，并在“联系人”工具提示中显示附加信息以帮助区分联系人。例如，当鼠标放在联系人上时，显示该联系人的电话号码。

更改用于显示用户名的属性

1. 打开 iim.conf。

   有关查找和修改 iim.conf 的说明，参见iim.conf 文件语法。

2. 指定显示用户名要使用的属性，以 iim_ldap.userdisplay 的值的形式进行指定。

   例如，要使用 nickname 属性，则设置 iim_ldap.userdisplay 属性如下：

   iim_ldap.userdisplay=nickname

3. 保存并关闭该文件。

更改用于显示组名的属性

1. 打开 iim.conf。

   参见 iim.conf 文件语法以获得有关查找和修改 iim.conf 的说明。

2. 指定显示用户名要使用的属性，以 iim_ldap.groupdisplay 的值的形式进行指定。

   例如，要使用 uid 属性，则设置 iim_ldap.groupdisplay 属性如下：

   iim_ldap.groupdisplay=uid

   保存并关闭该文件。

自定义搜索结果中的用户名显示发式

1. 从 imbrand.jar 提取文件。

   有关 imbrand.jar 的默认位置，参见表 15–1

2. 转到下列目录：

   com/sun/im/client/

3. 打开 brand.properties。

4. 将 dialogs.searchresults.format 属性添加到该文件。

5. 按以下格式添加您想要包括在搜索结果中的属性：

   ${attr:attribute-name }

   其中，attribute-name 是 LDAP 属性的名称。

   例如，要包括 title 属性，可添加以下行：

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

6. 保存更改并关闭文件。

7. 重新打包 imbrand.jar。

8. 添加用户属性到 iim.conf。

   指定该属性作为 iim_ldap.userattributes 参数的值。使用逗号分隔多个属性，例如：

   iim_ldap.userattributes=title,department,telephonenumber

   有关查找和修改 iim.conf 的说明，参见iim.conf 文件语法。

自定义工具提示内容

1. 从 imbrand.jar 提取文件。

   有关 imbrand.jar 的默认位置，参见表 15–1

2. 转到下列目录：

   com/sun/im/client/

3. 打开 brand.properties。

4. 添加 contact.tooltip.format.html 属性到该文件。

5. 指定您想要在工具提示中显示为 contact.tooltip.format.html 的值的属性。

   例如，如果您想要显示联系人的电话号码和电子邮件地址，则输入：

   contact.tooltip.format.html=mailto: ${attr:mail} tel: ${attr:telephonenumber}

   有关自定义 imbrand.jar 文件内容的更多信息，参见自定义应用程序 (Java Web Start)。

6. 保存您的更改并关闭文件。

7. 重新打包 imbrand.jar。

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

默认情况下，commonname 或 cn LDAP 属性用作用户的搜索属性。您可以配置 Instant Messaging 以允许用户使用附加属性进行搜索。此外，如果您的目录已建立索引，允许使用通配符，则可以配置 Instant Messaging 服务器在搜索联系人姓名时允许使用通配符。

允许用户使用自定义属性进行搜索

1. 打开 iim.conf。

   有关查找和修改 iim.conf 的说明，参见iim.conf 文件语法。

2. 修改 iim_ldap.usergroupbynamesearchfilter 属性。

   此参数指定搜索用户或组时使用的 LDAP 搜索字符串。以标准 LDAP 过滤器语法提供属性值。可对其进行修改以便可进行更复杂的搜索。有关修改搜索字符串的更多信息，参见 Directory Server 文档。

3. 保存并关闭该文件。

允许在搜索中使用通配符

1. 打开 iim.conf。

   有关查找和修改 iim.conf 的说明，参见iim.conf 文件语法。

2. 将 iim_ldap.allowwildcardinuid 参数设置为 True。

   此参数将决定在进行搜索时，是否应该对用户 ID 启用通配符。大多数目录安装都为“用户 ID”建立索引以只进行精确搜索，故默认值为 False。

3. 确保为“用户 ID”建立索引以用于目录中的子字符串搜索。

   将 iim_ldap.allowwildcardinuid 参数设置为 True 可能会影响性能，除非为“用户 ID”建立索引以用于目录中的子字符串搜索。有关建立索引的说明，参见目录服务器文档。

管理会议室和新闻频道

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

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

• 管理会议室

• 管理新闻频道

• 给最终用户分配会议室访问权限级别

• 给最终用户分配新闻频道访问权限级别

• 指派最终用户到会议室

• 指派最终用户到新闻频道（订阅）

• 创建新会议室

• 创建新的新闻频道

• 配置最终用户设置

• 删除会议室

• 从新闻频道删除消息

• 删除新闻频道

• 在新闻频道中发布消息

• 从会议室删除最终用户

• 从新闻频道删除最终用户

修改 Instant Messenger 代理设置

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

如果您的组织有防火墙而您需要通过代理服务器才能将客户机主机连接到 Internet，或者如果 Java Web Start 未配置正确的代理设置，则很可能发生这种情况。

Java Web Start 可通过查询系统或默认的浏览器来自动配置代理设置。不过，如果代理设置使用 JavaScript 文件进行配置，则 Java Web Start 无法自动配置这些设置。

使用 Java Web Start 手动设置单个 Instant Messenger 客户机的代理设置

完成此过程会在用户的 messenger.properties 文件中保存代理首选项。如果您还配置了 im.jnlp 文件以使用代理，而该代理与用户首选项中的不同，则使用用户的首选项。

1. 调用 Java Web Start。

2. 从“文件”菜单中选择“首选项”。

3. 在“首选项”对话框中选择“手动”选项。

4. 输入下列详细信息：

   HTTP 代理。输入代理服务器的名称或 IP 地址。

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

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

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

配置 im.jnlp 中所有 Instant Messaging 客户机连接的代理设置

如果您在 im.jnlp 中设置的代理与用户在线状态文件 (/usr_home/.sunmsgr/messenger.properties ) 中的不同，则使用用户的在线状态。

1. 在文本编辑器中打开 im.jnlp 资源文件。

2. 通过添加以下参数指定代理服务器：

   <argument>proxy=proxy-host:proxy-port</argument>

   其中，proxy-host 是代理服务器的全限定域名，proxy-port 是代理服务器侦听收到的请求所使用的端口号。例如， myproxy.siroe.com:8080。

3. 通过添加以下参数指定代理类型：

   <argument>proxy_type=type

   其中，type 可为 http、https 或 socks 之一。

控制公开的 Messenger 功能集

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

表 15–12 所示为 applet 描述符文件中的 Instant Messenger applet 参数。还包含这些参数的说明和默认值。

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

Instant Messenger 在最终用户的系统中缓存限量的信息用于自动登录。这些信息位于：

home-directory/.sunmsgr

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

表 15–13 显示包含缓存数据的目录和文件。还包含这些文件和目录的说明。

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

重新部署资源文件

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

重新部署资源文件到 Sun Java System Application Server 或 Sun Java System Web Server

1. 运行 iwadmin 命令。

   im-svr-base/html/iwadmin

   其中，im-svr-base 是 Instant Messaging 的安装目录。

   运行 iwadmin 以更新 Instant Messenger .jar 文件。不过，iwadmin 不会更新或重新初始化 Instant Messenger 下载页面。

   有关附加信息，参见 Web 容器的文档。另请参见 iwadmin man 页面以获得附加配置选项。

2. （可选的）升级后，如果您想要重新初始化 Instant Messenger 下载页面，可再次运行 configure 实用程序。

   重新初始化下载页面会覆盖所有自定义内容。如果您选择不重新初始化下载页面，请明确下载页面上的产品版本和 Instant Messenger .jar 文件中的产品版本可能会不同。

   有关更多信息，参见第 1 章，安装后配置 Instant Messaging。