| Sun ONE Instant Messaging 6.1 |
第 3 章
管理 Sun™ ONE Instant Messenger本章说明如何定制和管理 Sun™ ONE Instant Messenger。
本章包含以下内容：
配置 Sun ONE Instant Messenger配置和调用 Sun ONE Instant Messenger 有两种方法：
使用 Java Web Start 在此配置中，Sun ONE Instant Messenger 作为应用程序从 Java Web Start 启动。一旦启动 Sun ONE Instant Messenger，就不再需要浏览器。
使用 Java Plug-in 在此配置中，Sun ONE Instant Messenger 作为 Java applet 运行。要保持 Instant Messenger 会话处于活动状态，启动 applet 的浏览器窗口必须保持打开状态，且不能用于定位其它任何 URL。
有关如何配置启用 Sun ONE Instant Messenger 的 Java 软件的详细信息，请参阅 Sun One Instant Messaging Installation Guide（安装指南）。
调用 Instant Messenger您可以通过下列方式调用 Sun ONE Instant Messenger：
要调用 Sun ONE Instant Messenger
使用下列 URL 调用 Instant Messenger。
http://webserver:webserverport/subdirectory/filename
在此 URL 中，
您还可以执行下列任务：
解决 Web 服务器问题本节说明适用于 LDAP 部署及门户部署的 Web 服务器 问题。其中，Portal Server 主机上没有安装 Instant Messenger，使用的是另一台 Web 服务器 上的 Sun ONE Instant Messenger。
更改 Codebase
web-server-resource 目录可以与 instant-messaging-resource 目录相同，但它们也可以不同。如果在它们在您的站点上不相同，请通过下列适当的方法用 Web 服务器 下载 Sun ONE Instant Messenger 资源：
- 用于启动 Sun ONE Instant Messenger 的 URL - 最终用户用来访问 index.html（以及 im.html 和 im.jnlp 文件）的 URL。此 URL 需要引用 Sun ONE Instant Messenger 安装目录。
例如，如果 Sun ONE Instant Messaging 服务器主机为 iim.i-zed ，Sun ONE Instant Messenger 文件安装在 /opt/SUNWiim/html 目录中，则需要在 web-server-resource 目录中创建指向 /opt/SUNWiim/html 的符号链接（如 iim）。最终用户可以使用下列 URL 访问 Sun ONE Instant Messenger 主页 index.html：
codebase= http://servername:port/path/
如果 Web 服务器 的端口号没有配置为缺省值 80，则需要将其包括在内。
例如，如果 Instant Messaging 服务器主机为 iim.i-zed，Sun ONE Instant Messenger 文件安装在 /opt/SUNWiim/html 目录中，您可以在 web-server-resource 目录中创建指向 /opt/SUNWiim/html 的符号链接（如 iim）。然后将 im.jnlp 文件中的 codebase 参数更改如下：
codebase="http://iim.i-zed.com/iim/"
更改 Web 服务器端口
如果 Web 服务器 安装在非缺省端口 (80) 上，则需了解下列详细信息：
定制 Sun ONE Instant MessengerSun ONE Instant Messenger 可以定制。可以根据组织的特定要求定制 HTML 和 JNLP 文件。
可以通过下列方式定制 Instant Messenger，使之符合要求：
本节说明定制 Sun ONE Instant Messenger 时要修改的 Instant Messaging 服务器文件。所有可定制的文件都位于 html 目录中。例如，在 Solaris 上，HTML 文件位于 instant-messaging-resource 目录中。
Instant Messenger 资源Sun ONE Instant Messenger 文件
Sun ONE Instant Messenger 文件所在的目录称为 instant-messaging-resource 目录，该目录也简称为 resource 目录。
表 3-1 包含 instant-messaging-resource 目录中的 Sun ONE Instant Messenger 文件列表。它还包含这些文件的说明和定制信息。instant-messaging-resource 目录中含有本机子目录，其通用目录路径名为 lang，但也以特定语言的缩写表示，例如 en_US、jp 和 fr_FR。
定制 index.html 和 im.html 文件（仅限 LDAP 部署）
Instant Messenger 可让您修改 index.html 和 im.html 文件的“静态”部分，以产生完全定制的用户界面。这些 HTML 文件包含文本和说明文本格式制作及处理方式的标记。标记由指定标题格式、缩进、字体大小和字体样式的一组标签实现。
以下是一些可以修改的页面元素：
index.html 文件可启动 Sun ONE Instant Messenger applet 和 Java Web Start 应用程序。如果运行的是 Sun ONE Instant Messenger applet，请修改 im.html 文件。im.html 文件被 index.html 调用，自身可以调用 Instant Messenger applet。im.html 文件在安装期间生成，包含指向多路复用器的 applet 参数。
备注
参数“<PARAM NAME="server" VALUE="servername">”用于表示 im.html 文件中的 Sun ONE Instant Messaging多路复用器及其端口。如果更改 iim_mux.listenport 参数的缺省值，则必须将 servername 值更改为 host.domain:port。
使用 Sun ONE Identity Server SSO 启动 Instant Messenger：
要通过 Identity Server 单点登录来启动 Sun ONE Instant Messenger 客户机，请使用 jnlpLaunch.jsp 和 pluginLaunch.jsp。这些文件在 resource 目录中。要启动 Instant Messaging 服务器，请在浏览器中输入下列内容：
instant-messaging-codebase/jnlpLaunch.jsp?server=muliplexor-hostname:muliplexor-port
或
intant-messaging-codebase/pluginLaunch.jsp?server=www.example.com:49909
其中，
intant-messaging-codebase 是用于下载 Instant Messenger 资源的 codebase。例如 http://www.example.com。
(multiplexor)-hostname 是多路复用器的名称。例如 http://www.compnay22.com。
(multiplexor) port 是多路复用器端口号。例如 49909
利用 jnlpLaunch.jsp 即可通过 Java Web Start 启动 Instant Messenger。
利用 pluginLaunch.jsp 即可通过 Java Plug-in 启动 Instant Messenger。
定制应用程序 (Java Web Start)
如果使用 Java Web Start 运行 Sun ONE Instant Messenger，则可通过修改 im.jnlp、imres.jnlp 和 imres.jar 文件来定制用户界面。以下是可以对这些 HTML 文件所做的修改：
代码示例 3-1 显示了 im.jnlp 文件示例，可以定制的 HTML 代码以粗体显示。
- imbrand.jar - 此文件包含图像和音频文件以及可以定制的特性。您需要通过 Java Developers Kit 1.3 (JDK) 使用 jar 命令从 imres.jar 文件提取内容。有关 imbrand.jar 文件内容的详细信息，请参阅 imbrand.jar 文件的内容列表。
以下是 jar 命令的语法：
imbrand.jar 的内容列表
表 3-2 列出 imbrand.jar 文件中的文件及其说明。imbrand.jar 文件包含可用于定制Sun ONE Instant Messenger 的图像和音频文件。
表 3-2 imbrand.jar 文件的内容列表。
文件名
说明
Angry_16.gif
以图形表示愤怒情绪的图释。
Devil_16.gif
以图形表示邪恶情绪的图释。
Laugh_16.gif
以图形表示欢笑情绪的图释。
Angel_16.gif
一种以图形表示天使般情绪的图释。
Smiley_16.gif
以图形表示微笑情绪的图释。
Love_16.gif
以图形表示爱慕情绪的图释。
Grin_16.gif
以图形表示露齿而笑情绪的图释。
Wink_16.gif
以图形表示眨眼情绪的图释。
Sad_16.gif
以图形表示悲伤情绪的图释。
Suprise_16.gif
以图形表示惊奇情绪的图释。
Away_13.gif
出现在 Change Status 菜单中的离开状态图标。
Online_13.gif
出现在 Change Status 菜单中的联机状态图标。
Offline_13.gif
当最终用户处于离开或未连接状态时，出现在 Change Status 菜单中的图标。
Idle_13.gif
显示空闲状态的图标，出现在状态栏和联系人列表中。
Forwarded_13.gif
如果最终用户处于脱机状态并设置有电子邮件转发警报，则会显示此图标。此图标出现在联系人列表中。
Away_24.gif
出现在状态栏中的离开状态图标。
Online_24.gif
出现在状态栏中的联机状态图标。
Offline_24.gif
出现在状态栏中的脱机状态图标。
tray_icon.ico
出现在任务栏中的 Instant Messenger 图标。
app_icon.gif
Instant Messenger 应用程序图标。
logon_splash.gif
显示在“登录”和“关于”框中的 Sun ONE 徽标。
alert.au
最终用户收到警报时发出的声音。
away.au
最终用户将状态更改为离开时发出的声音。
soundon.au
最终用户退出 Instant Messenger 时发出的声音。
soundoff.au
最终用户登录 Instant Messenger 时发出的声音。
send.au
最终用户发送即时消息时发出的声音。
receive.au
最终用户收到即时消息时发出的声音。
定制Instant Messenger
imbrand.jar 文件包含控制 Instant Messenger 外观和感觉的所有图像和特性。可以通过修改 imbrand.jar 文件中的图像和特性来定制 Instant Messenger 的外观。
定制Instant Messenger：
- 将 imbrand.jar 文件复制到工作目录，并切换到此目录。例如：
cp instant-messaging-resource-directory/lang/imbrand.jar working_directory
- 提取 imbrand.jar 文件。
jar xf imbrand.jar
此命令可创建在其中复制资源文件的目录树。当您修改 jar 文件中的个别文件时，必须保持此目录结构。
- 用修改后的 .gif 文件和 .au 文件更新 imbrand.jar 文件。
jar cf imbrand.jar 。
- 将 imbrand.jar 文件复制到 resource 目录。例如：
cp imbrand.jar instant-messaging-resource-directory/lang/。
定制用户名显示
可在工具提示和搜索结果中定制用户名显示。
在搜索结果中定制用户名显示
如果两个最终用户具有相同的姓氏和名字，就无法知道应添加哪一个最终用户到联系人列表中。可以将 Instant Messenger 定制为：在用户搜索结果中显示更多信息。要在用户搜索结果中显示更多信息，就需要在 imbrand.jar 文件中将 dialogs.searchresults.format 属性添加到下列位置的 brand.properties 文件：
com/sun/im/client/
有关如何修改 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 定制为在联系人工具提示中显示附加信息。
例如，当鼠标放在联系人上时，显示该联系人的电话号码：
- 切换到下列目录：
com/sun/im/client/
- 打开 brand.properties 文件。
- 添加 contact.tooltip.format.html 属性到文件中。
- 保存对文件的更改
- 切换到下列目录。
cd instant-messaging-resource-directory
- 添加 contact.tooltip.format.html 属性和 telephonenumber 属性，作为它在 imbrand.jar 文件的 HTML 代码中的值。
contact.tooltip.format.html=mailto: ${attr:mail} tel: ${attr:telephonenumber}
有关定制 imbrand.jar 文件的信息，请参阅定制应用程序 (Java Web Start)。
管理 Sun ONE Instant Messenger 会议室和新闻频道可以通过在 Sun ONE Instant Messenger 中执行下列任务管理会议室和新闻频道。有关执行这些任务的详细信息，请参阅 Sun ONE Instant Messenger 联机帮助。
授予最终用户创建会议室和新闻频道的权限
管理员可以为最终用户创建会议室和新闻频道。但具有适当权限的最终用户也可以创建。有关添加策略以允许最终用户创建会议室和新闻频道的详细信息，请参阅第 4 章“管理 Instant Messaging 和在线策略”。缺省情况下，创建会议室或新闻频道的最终用户具有 Manage 访问权限，因此可以管理会议室或新闻频道。有关管理最终用户权限的详细信息，请参阅“管理最终用户权限”。
修改 Sun ONE Instant Messenger 代理设置Sun ONE Instant Messaging消息可以包含嵌入式 URL。例如 http://stocks.yahoo.com?id=sunw。如果使用代理服务器，则必须通过修改 Java Web Start 配置中的 Instant Messenger 代理设置，解析此类嵌入式 URL。
如果您的组织有防火墙，而您必须通过代理服务器才能将客户机主机连接到 Internet，或者 Java Web Start 没有配置正确的代理设置，就可能发生这种情况。
修改 Sun ONE Instant Messenger 代理设置
Java Web Start 可以通过查询系统或缺省浏览器来自动配置代理设置。但是，如果这些代理设置是使用 JavaScript 文件配置的，Java Web Start 就无法自动配置。
手动设置代理设置：
非代理主机。 输入可以不使用代理服务器直接连接的任何域名。若主机名为多个，使用逗号分隔。
控制公开的 Messenger 功能集管理员可以通过配置 applet 描述符文件中的Instant Messaging applet 参数，来控制公开的 Instant Messenger 功能集。
表 3-3 显示 applet 描述符文件中的 Instant Messenger applet 参数，还包含这些参数的说明和缺省值。
表 3-3 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 让最终用户不显示联系人列表与新闻频道。
此参数用于 CHAT 和 POPUP 风格。
allow_file_transfer
TRUE
允许文件附件和传送。
enable_moderator
TRUE
如果设置为 true，将启用主持会议功能。
messenger_bean
此参数包含要使用的 messenger bean 列表。可以输入多个 factory 类名称，用逗号分隔。
domain
null
此参数用于多域 Sun ONE Identity Server 部署。此参数的值应为此最终用户所在组织的逻辑域名。
gateway_url
null
此参数包含门户 SRA 的网关组件的 URL。
存储在最终用户系统中的 Instant Messenger 数据Instant Messenger 在最终用户的系统的缓存中存有一定数量的信息，以供自动登录之用。可在以下位置找到此信息：
home-directory/.sunmsgr
home-directory 是最终用户的起始目录。最终用户的起始目录可从 Java 系统特性中的 user.home 参数获取。
表 3-4 显示包含缓存数据的目录和文件，还包含这些文件和目录的说明。
表 3-4 包含缓存数据的目录和文件
文件/目录名称
类型
说明
.sunmsgr/messenger.properties
文件
包含自动登录特性的文件
.sunmsgr/<user_domain>/
目录
包含特定 {登录名，域名} 组合专有数据的目录。
.sunmsgr/<user_domain>/messenger.properties
文件
此文件包含特定 <user_domain> 专有的自动登录选项。未使用此文件。
.sunmsgr/<user_domain>/messages/
目录
此目录包含缓存消息。未使用此目录。
表 3-5 显示 Instant Messaging 的自动登录特性，还包含这些特性的说明和缺省值。
表 3-5 自动登录特性
参数
缺省值
说明
net.server
127.0.0.1
Instant Messaging 服务器主机名和端口。
net.server.n
（其中 n 是用来区别条目的数字）
辅助服务器的主机名和端口号。
net.user
缺省用户ID
net.pass
启用自动登录的已编码用户密码。
