安装和配置 Instant Messaging

在安装、升级或迁移 Instant Messaging 之前，应先阅读并理解第 1 章, “准备安装,”中的信息，然后完成本节的安装检查表。

完成安装检查表

在安装、升级和迁移期间，会提示要求输入一些基本的配置信息。您应先收集这些信息，然后开始操作。根据您决定安装的组件，系统将提示您输入部分或所有信息。

打印表 2-1，在提供的空格中写下您的部署信息。您可以重复利用此安装工作表以多次安装、卸载Instant Messaging 或升级 Instant Messaging。此表包含口令和其它敏感信息，因此请妥善存储这些资料。

表 2-1 Instant Messaging 安装参数
参数	说明	您的回答
安装目录	instant-messaging-install-dir 或 installation directory 安装 Instant Messaging 的目录。缺省值： Solaris：/opt/SUNWiim Linux：/opt/soim Windows：C:\Program Files\Sun\Instant Messaging
Instant Messaging 服务器主机和域名	安装 Instant Messaging 的主机名以及与主机关联的域名。例如：主机名：instantmessaging.siroe.com 域名：siroe.com
Instant Messaging 服务器端口号	Instant Messaging 服务器在此端口号监听外来请求，不监听 Instant Messenger 客户机发来的请求。缺省值：49999
多路复用器端口号（仅限多路复用器配置）	Instant Messaging 服务器在此端口监听 Instant Messenger 客户机发来的请求。缺省值：49909
停用服务器	如果您安装的实例将用作多路复用器而非服务器，请选择此选项。如果选择此选项，则必须为远程 Instant Messaging 服务器主机名（仅限多路复用器配置）提供有效值。
远程 Instant Messaging 服务器主机名（仅限多路复用器配置）	此多路复用器对其路由消息的 Instant Messaging 服务器的主机名。如果您配置的安装实例是 Instant Messaging 服务器而非多路复用器，请勿输入此参数的值。依赖性：必须选择停用服务器参数，也就是说必须停用服务器功能。
分配 Instant Messaging 服务给现有用户（仅限 Solaris，可选）	如果选择此选项，将会启用现有 Sun ONE Identity Server 用户的 Instant Messaging。依赖性：Sun ONE Portal Server 和 Sun ONE Identity Server。
安全模式（仅限 Solaris，可选）	如果选择此选项，将会集成 Sun ONE Portal Server Secure Remote Access 功能。使用“Secure Remote Access”可以为内部网中的远程用户提供安全访问。用户可以通过入口网关登录到基于网络的 Portal Server 桌面，以使用“Secure Remote Access”。依赖性：需要 Sun ONE Portal Server 和 Sun ONE Identity Server。仅在配置了 Sun ONE Portal Server Secure Remote Access 时才能以安全模式运行 Instant Messaging。有关说明，请参阅 Sun ONE Instant Messaging 管理员指南和 Sun ONE Portal Server，Secure Remote Access 管理员指南。如果启用此功能，则必须为以下参数提供值： Netlet Instant Messaging 端口号（仅限 Solaris，可选） Messenger Secure Download 端口（仅限 Solaris，可选）
Netlet Instant Messaging 端口号（仅限 Solaris，可选）	如果启用了安全模式（仅限 Solaris，可选），这将是 Netlet 接收外来请求的端口号。缺省值：49917 依赖性：安全模式（仅限 Solaris，可选）启用，Sun ONE Portal Server 和 Sun ONE Identity Server。
Messenger Secure Download 端口（仅限 Solaris，可选）	如果启用了安全模式（仅限 Solaris，可选），这将是用于通过 Netlet 下载 Instant Messenger 资源的端口号。缺省值：49916 依赖性：安全模式（仅限 Solaris，可选）启用，Sun ONE Portal Server 和 Sun ONE Identity Server。
启用 Instant Message 归档（仅限 Solaris，可选）	如果选择此选项，将会启用 Sun ONE Portal Server 基于搜索的 Instant Messaging 归档。依赖性：Sun ONE Portal Server 和 Sun ONE Identity Server。
LDAP 主机名。	包含 Instant Messaging 用户和组信息的 LDAP 服务器的主机名。例如 directory.siroe.com。依赖性：LDAP 服务器，如 Sun ONE Directory Server。
LDAP 端口号	目录服务器用于监听外来请求的端口号。例如 389。依赖性：LDAP 服务器，如 Sun ONE Directory Server。
基本 DN	包含 Instant Messaging 用户和组信息的目录树中的基本辨别名。例如 o=airius.com。依赖性：LDAP 服务器，如 Sun ONE Directory Server。
绑定 DN	在安装期间，您必须使用“Directory Manager 绑定 DN”和口令。此信息只用于更新其中包括 Instant Messaging 的目录方案、线上服务模板和属性。这需要访问“Directory Manager”。除了安装和初始配置，不会保存或使用“Directory Manager 绑定 DN”和口令。对于服务器配置，Instant Messaging 使用此绑定 DN 搜索目录中的用户和组。如果可以匿名搜索到目录，请将此留空。依赖性：LDAP 服务器，如 Sun ONE Directory Server。
绑定口令	绑定 DN 口令。
SMTP 服务器主机名（可选）	用来发送消息的电子邮件通知给脱机用户的 SMTP 服务器主机名。例如 mail.siroe.com。如果 SMTP 服务器不使用端口 25，请指定端口及主机名。例如，如果 SMTP 服务器使用端口 1025： mail.siroe.com:1025 依赖性：SMTP 服务器，如 Sun ONE Messaging Server。
数据库、日志和运行时文件路径名。	运行时文件、数据库和日志的存储位置。缺省值： Solaris：/var/opt/SUNWiim/default Linux：/var/opt/soim Windows：C:\Program Files\Sun\Instant Messaging
资源和帮助文件路径名	instant-messaging-resource-directory 或 resource directory 安装资源和联机帮助文件的目录。缺省值： Solaris：/opt/SUNWiim/html Linux：/opt/soim/html Windows：C:\Program Files\Sun\Instant Messaging\html
代码库	Instant Messenger 下载资源的 URL。您可以将资源安装到Web 服务器的文档根目录。例如，假设Web 服务器 www.example.com 监听端口 89，此Web 服务器的文档根目录是 /opt/web/，您选择安装 messenger 资源到 /opt/web/im，则 messenger 资源代码基如下： http://www.example.com:89/im/ 如果您在安装时没有提供正确的 codebase，则必须用正确的 URL 更新 messenger 启动页 codebase/lang/im[ssl].html 和 codebase/lang/im[ssl].jnlp。在 UNIX 上，可以将资源安装到目录中，然后使用符号链接将资源显示给Web 服务器。例如，如果在上例中，您将资源安装到 /opt/SUNWiim/html 中，则可以通过创建以下符号链接将 messenger 资源显示给Web 服务器。 ln -s /opt/SUNWiim/html /opt/web/im 有关详细信息，请参阅Sun ONE Instant Messaging 管理员指南和您的Web 服务器文档。

安装和配置 Instant Messaging

使用 JES 安装程序在 Solaris 上安装 Instant Messaging。对于 Linux 和 Windows，则使用 Windows 版 Instant Messaging 和 Linux 媒体工具包安装 CD 中提供的 setup 程序。

安装之前，请确保已完成“准备工作”中的步骤，并已安装和配置 Instant Messaging 部署所需的任何附加服务器。有关需要安装的服务器的信息，请参阅“与其他服务器的依存性”。

可以使用相同的过程安装服务器和多路复用器。安装服务器时，也会同时安装和启用多路复用器。如果希望主机只支持多路复用器，请停用该主机上安装的服务器。多路复用器用于平衡大型安装工程中路由消息的超负荷。有关多路复用器的详细信息，请参阅第 1 章, “准备安装,”。

如果Web 服务器和 Instant Messaging 服务器不在同一主机上，请将 Instant Messenger 资源安装到Web 服务器主机上。

使用 JES 安装程序安装和配置（仅限 Solaris）

使用图形用户界面安装和配置（Linux 和 Windows）

运行 setup 安装 Instant Messaging 时，是安装新软件和提供初始配置信息。

以超级用户的身份登录。例如，root (Linux) 或 administrator (Windows)。

解压 Instant Messaging 归档文件到临时目录。

切勿解压归档文件到要安装 Instant Messaging 的目录。

切换到归档文件所解压的目录，然后输入 ./setup (Linux) 或运行 setup.exe (Windows)。



备注	仅限 Linux：切勿在后台运行安装程序。如果是在远程机器上安装或者 root 不拥有显示，请将 DISPLAY 环境变量设置为您的主机名。例如，在 C shell 类型中： setenv DISPLAY myhost:0.0

安装程序会显示“欢迎”屏幕。

单击“下一步”继续。

“许可协议”会出现。

阅读许可协议，单击“是（接受许可）”接受它，单击“否”则退出而不安装。

“软件要求”对话框会出现，其中显示出 Instant Messaging 的要求和依赖性。

确认信息与您的部署要求相符，并且已安装所需的服务器，然后单击“下一步”。

如果没有安装适当的服务器，请单击“退出”以退出 Instant Messaging 安装。有关 Instant Messaging 所需的其它服务器的信息，请参阅“与其他服务器的依存性”。

选择安装 Instant Messaging s 软件的目录，然后单击“下一步”。

缺省目录为 /opt/soim (Linux) 和 C:\Program Files\Sun\Instant Messaging (Windows)。

“选择组件”对话框会出现，并显示以下选项：

Instant Messaging 服务器

此组件包括服务器和多路复用器软件。

多路复用器将 Instant Messenger 消息从多台客户机路由到 Instant Messaging 服务器。

Sun ONE Instant Messenger 资源

资源是文件的集合，其中包括用来启动 Instant Messenger 客户机的文件、可自定义的属性、样式表、图像和音频文件，以及 Instant Messenger 的联机帮助。

选择要安装的软件组件，然后单击“下一步”。

“确认升级和添加组件”对话框会出现，显示要安装的组件列表。

确认组件列表，然后单击“下一步”。

如果要安装“Instant Messenger 资源”，“Instant Messenger 资源目录”对话框会出现，显示安装程序将要安装资源文件的目录。安装资源的缺省目录如下：

对于 Linux：/var/opt/soim/html

对于 Windows：C:\Program Files\Sun\Instant Messaging\html

单击“下一步”。

安装程序会检查是否有充分的磁盘空间，然后显示“准备安装”对话框。

单击“立即安装”。

当安装过程完成时，会出现“摘要信息”对话框。

单击“详细信息”，查看有关安装的摘要信息。查看完摘要信息后，单击“退出”关闭“摘要信息”对话框。

单击“下一步”开始配置 Instant Messaging。

会出现一系列对话框，请求提供将要设置 Instant Messaging 初始配置的信息。出现的对话框因您选择的组件而异。使用检查表中的值填写请求的信息。有关详细信息，请参阅“完成安装检查表”。

单击“退出”以退出安装程序。

从命令行安装和配置（仅限 Linux）

运行 setup 安装 Instant Messaging 时，会安装新软件和提供初始配置信息。

在本机终端窗口中，以 root 身份登录。

解压 Instant Messaging 归档文件到临时目录。

切勿解压归档文件到要安装 Instant Messaging 的目录。

切换到归档文件所解压的目录，然后输入：

./setup -nodisplay

安装程序会在当前窗口中运行，并且出现文本，解释命令行安装如何运作。

按 Enter 继续。

会出现一则欢迎消息。

按 Enter 继续。

预备文本会出现。

按 Enter 显示“Sun ONE 软件许可协议”。

阅读许可协议，输入 Yes（接受协议），然后按 Enter 确认并继续。输入 No 并按 Enter，就会中止安装“Sun ONE Instant Messaging”。

“软件要求”屏幕会出现，显示 Instant Messaging 的要求和依赖性。

确认信息与您的部署要求相符，并且已安装所需的服务器，然后按 Enter。

如果没有安装适当的服务器，请输入 Exit 以退出 Instant Messaging 的安装。有关 Instant Messaging 所需的其它服务器的信息，请参阅“与其他服务器的依存性”。

选择要安装 Instant Messaging 软件的目录，然后按 Enter。

缺省情况下此目录为 /opt/soim。

“选择组件”屏幕会出现，显示以下选项：

Instant Messaging 服务器

此组件包括服务器和多路复用器软件。

多路复用器将 Instant Messenger 消息从多台客户机路由到 Instant Messaging 服务器。

Sun ONE Instant Messenger 资源

资源是文件的集合，其中包括用来启动 Instant Messenger 客户机的文件、可自定义的属性、样式表、图像和音频文件，以及 Instant Messenger 的联机帮助。

选择要安装的软件组件，然后按 Enter。

“确认升级和添加组件”屏幕会出现，并显示要安装的组件列表。

确认组件列表，然后按 Enter。

如果要安装“Sun ONE Instant Messenger 资源”，“Instant Messenger 资源目录”屏幕会出现，显示安装程序将要安装资源文件的目录。缺省情况下资源的安装目录为 /var/opt/soim/html。

接受缺省值，或者输入不同的目录，然后按 Enter。

安装程序会检查是否有充分的磁盘空间，然后显示“准备安装”屏幕。

按 Enter 开始安装。

当安装过程完成时，“摘要信息”屏幕会出现。

按 Enter 开始配置 Instant Messaging。

会出现一系列提示，请求提供将要设置 Instant Messaging 为初始配置的信息。出现的提示因您选择的组件而异。使用检查表中的值填写请求的信息。有关详细信息，请参阅“完成安装检查表”。

输入 Exit 以退出安装程序。

迁移和升级以前版本的 Instant Messaging

您可以基于 Instant Messaging 以前的软件版本进行升级；但升级进程会因您使用的平台而异。在 Solaris 上，先进行全新安装，然后迁移现有数据。在 Linux 和 Windows，可以从以前版本的 Instant Messaging 直接升级。

获取 Instant Messaging 软件。

计划关闭 Instant Messaging 服务器的时间。

将您的关机计划提前通知您的用户。

备份数据库、任何现有资源以及自定义的配置文件。其中包括数据库、安装和资源目录中的文件。这些目录的缺省位置如下：


Solaris	数据库目录：/var/opt/SUNWiim/default/db 安装目录：/opt/SUNWiim 资源目录：/var/opt/SUNWiim/html
Linux	数据库目录：/var/opt/soim/db 安装目录：/opt/soim 资源目录：/var/opt/soim/html
Windows	数据库目录：C:\Program Files\Sun\Instant Messaging\db 安装目录：C:\Program Files\Sun\Instant Messaging 资源目录：C:\Program Files\Sun\Instant Messaging\html

（仅限 Solaris）卸载 Instant Messaging，然后删除在卸载期间没有删除的所有目录和安全软件包，例如 NSRP 和 NSS。有关卸载的说明，请参阅Sun Java Enterprise System Installation Guide。

确保已完成“完成安装检查表”中的检查表。升级完成之后，您需要使用此信息来配置 Instant Messaging。

如果您以前安装了“IM Portal Channel”和“Portal Archive”，则必须在升级 Instant Messaging 之前予以删除。

确保已经安装并配置了所有其它必要的服务器。

有关详细信息，请参阅“与其他服务器的依存性”。

关闭 Instant Messaging 服务器和所有多路复用器。

执行升级或迁移。

其中包括安装新软件和配置 Instant Messaging。

执行升级后操作过程。

Solaris：迁移数据。请参阅“迁移 Instant Messaging（仅限 Solaris）”。

Linux 和 Windows：升级期间，setup 程序会在 config 和 html 目录中创建 .new 文件。这些文件包含此版本中添加的所有更改。例如，如果您自定义了现有 iim.conf 文件，安装程序会创建 iim.conf.new 文件。升级之后，必须将更改合并到您自定义的文件中。“升级 Instant Messaging（Linux 和 Windows）”.

迁移 Instant Messaging（仅限 Solaris）

为了升级此版本的 Instant Messaging，您必须备份当前的安装，使用 JES 安装程序执行全新安装，然后将现有数据从备份中迁移到新的安装目录中。

要将数据迁移到新版本的 Instant Messaging，在安装完成之后，将以下目录备份复制到新安装目录：

升级 Instant Messaging（Linux 和 Windows）

在 Linux 上，可以使用 setup 程序的图形用户界面或者命令行界面升级 Instant Messaging。在 Windows 上，必须使用图形用户界面升级 Instant Messaging。

使用图形用户界面升级 Instant Messaging（Linux 和 Windows）

当您运行 setup 升级现有安装时，会安装新软件并提供 Instant Messaging 的初始配置信息。

要升级 Instant Messaging 服务器、多路复用器和资源，请执行以下步骤：

以超级用户的身份登录。例如，root (Linux) 或 administrator (Windows)。

关闭 Instant Messaging 服务器和多路复用器。

Linux：imadmin stop

Windows：从“服务控制面板”停止服务器。

解压 Instant Messaging 归档文件到临时目录。

切勿解压归档文件到要安装 Instant Messaging 的目录。

切换到归档文件所解压的目录，然后输入 ./setup (Linux) 或运行 setup.exe (Windows)。



备注	仅限 Linux：切勿在后台运行安装程序。如果是在远程机器上安装或者 root 不拥有显示，请将 DISPLAY 环境变量设置为您的主机名。例如，在 C shell 类型中： setenv DISPLAY myhost:0.0

安装程序会显示“欢迎”对话框。

单击“下一步”继续。

“许可协议”会出现。

阅读许可协议，单击“是（接受许可）”接受它，单击“否”则退出而不升级。

“软件要求”对话框会出现，并显示 Instant Messaging 的要求和依赖性。

确认信息与您的部署要求相符，并且已安装所需的服务器，然后单击“下一步”。

如果没有安装适当的服务器，请单击“退出”以退出 Instant Messaging 的安装。有关 Instant Messaging 所需的其它服务器的信息，请参阅“与其他服务器的依存性”。

“选择组件”对话框会出现，并显示以下选项：

Instant Messaging 服务器

此组件包括服务器和多路复用器软件。

多路复用器将 Instant Messenger 消息从多台客户机路由到 Instant Messaging 服务器。

Sun ONE Instant Messenger 资源

资源是文件的集合，其中包括用来启动 Instant Messenger 客户机的文件、可自定义的属性、样式表、图像和音频文件，以及 Instant Messenger 的联机帮助。

安装程序会自动选择系统中已经安装的组件。如果系统中已经安装某组件的相同或更高版本，该组件会在列表中显示为禁用状态。

选择要升级的所有其他软件组件，然后单击“下一步”。

“确认升级和添加组件”对话框会出现，显示要升级的组件列表。

确认组件列表，然后单击“下一步”。

如果要升级资源，“Instant Messenger 资源目录”对话框会出现，并显示 setup 程序将要安装资源文件的目录。安装 messenger 资源的缺省目录如下：

对于 Linux：/var/opt/soim/html

对于 Windows：C:\Program Files\Sun\Instant Messaging\html

单击“下一步”。

setup 程序会检查是否有充分的磁盘空间，然后显示“准备安装”对话框。

单击“立即安装”。

当升级进程完成时，“摘要信息”对话框会出现。

单击“详细信息”，查看有关升级的摘要信息。查看完摘要信息后，单击“退出”关闭“摘要信息”对话框。

单击“下一步”开始配置 Instant Messaging。

会出现一系列对话框，请求提供将要设置 Instant Messaging 为初始配置的信息。出现的对话框因您在步骤 7 中选择的组件而异。使用检查表中的值填写请求的信息。有关详细信息，请参阅“完成安装检查表”。

单击“退出”以退出 setup 程序。

如果您备份了旧的安装，并想从备份中恢复数据库和自定义文件，请参阅“事后升级说明（Linux 和 Windows）”。

从命令行升级（仅限 Linux）

当您运行 setup 升级现有安装时，会安装新软件并提供 Instant Messaging 的初始配置信息。

从命令行升级 Instant Messaging 服务器、多路复用器和资源，请执行以下步骤：

在本机终端窗口中，以 root 身份登录。

解压 Instant Messaging 归档文件到临时目录。

切勿解压归档文件到要安装 Instant Messaging 的目录。

切换到归档文件所解压的目录，然后输入：

./setup -nodisplay

setup 程序会在当前窗口中运行，并且出现文本，解释命令行安装如何运作。

按 Enter 继续。

会出现一则欢迎消息。

按 Enter 继续。

预备文本出现。

按 Enter 显示“Sun ONE 软件许可协议”。

阅读许可协议，输入 Yes（接受协议），然后按 Enter 确认并继续。输入 No 并按 Enter，则退出 setup 程序而不升级。

“软件要求”屏幕会出现，并显示 Instant Messaging 的要求和依赖性。

确认信息与您的部署要求相符，并且已安装所需的服务器，然后按 Enter。

如果没有安装适当的服务器，请输入 Exit 以退出 setup 程序。有关 Instant Messaging 所需的其它服务器的信息，请参阅“与其他服务器的依存性”。

“选择组件”屏幕会出现，并显示以下选项：

Instant Messaging 服务器

此组件包括服务器和多路复用器软件。

多路复用器将 Instant Messenger 消息从多台客户机路由到 Instant Messaging 服务器。

Sun ONE Instant Messenger 资源

资源是文件的集合，其中包括用来启动 Instant Messenger 客户机的文件、可自定义的属性、样式表、图像和音频文件，以及 Instant Messenger 的联机帮助。

安装程序会自动选择系统中已经安装的组件。如果系统中已经安装某组件的相同或更高版本，该组件会在列表中显示为禁用状态。

选择要升级的所有其他软件组件，然后按 Enter。

“确认升级和添加组件”屏幕会出现，并显示要升级的组件列表。

确认组件列表，然后按 Enter。

如果要升级 Sun ONE Instant Messenger 资源，“Instant Messenger 资源目录”屏幕会出现，并显示 setup 程序将要安装资源文件的目录。缺省情况下 Instant Messenger 资源的安装目录为 /var/opt/soim/html。

按 Enter。

setup 程序会检查是否有充分的磁盘空间，然后显示“准备安装”屏幕。

按 Enter。

当升级进程安装完软件时，“摘要信息”屏幕会出现。

按 Enter 开始配置 Instant Messaging。

会出现一系列提示，请求提供将要设置 Instant Messaging 为初始配置的信息。出现的提示因您在步骤 8 中选择的组件而异。使用检查表中的值填写请求的信息。有关详细信息，请参阅“完成安装检查表”。

完成升级和配置 Instant Messaging 之后，输入 Exit 退出 setup 程序。

如果您备份了旧的安装，并想从备份中恢复数据库和自定义文件，请参阅“事后升级说明（Linux 和 Windows）”。

事后升级说明（Linux 和 Windows）

要从创建的备份中恢复数据库，请将备份数据库目录及其所有内容复制到新的数据库目录。缺省情况下，升级期间创建的数据库目录会安装在以下位置：

升级期间，setup 程序会在 config 和 html 目录中创建 .new 文件。这些文件包含此版本中添加的所有更改。例如，如果您自定义了现有 iim.conf 文件，安装程序会创建 iim.conf.new 文件。

升级为新版本之后，必须找到 .new 文件，然后将更改合并到现有文件。如果没有保存所做的更改，请删除旧文件，重命名相应的 .new 文件。

合并更改时，请将旧文件与 .new 文件逐行比较，并编辑现有文件以合并这些更改。

表 2-2 列出了可以自定义的文件，以及在升级期间为其创建的 .new 文件。

表 2-2 .new 文件
文件类型	Linux	Windows
配置	installation directory/default/config/iim.conf installation directory/default/config/acls/sysAdmin.acl installation directory/default/config/acls/sysTopicsAdd.acl installation directory/default/config/acls/sysRoomsAdd.acl installation directory/default/config/acls/sysSendAlerts.acl installation directory/acls/sysWatch.acl installation directory/default/config/acls/sysSaveUserSettings.acl	installation directory\config\iim.conf installation directory\config\acls\sysAdmin.acl installation directory\config\acls\sysTopicsAdd.acl installation directory\config\acls\sysRoomsAdd.acl installation directory\config\acls\sysSendAlerts.acl installation directory\config\acls\sysWatch.acl installation directory\config\acls\sysSaveUserSettings.acl
资源	resource directory/im.html resource directory/im.jnlp resource directory/index.html resource directory/language/imres.jnlp resource directory/language/imbrand.jar resource directory/imssl.jnlp resource directory/imssl.html	resource directory\im.html resource directory\im.jnlp resource directory\index.html resource directory\language\imres.jnlp resource directory\language\imbrand.jar resource directory\imssl.jnlp resource directory\imssl.html
对于 Linux，安装目录的缺省值是 /opt/soim/config，资源目录的缺省值是 /opt/soim/html。对于 Windows，安装目录的缺省值是 c:\Program Files\Sun\InstantMessaging，资源目录的缺省值是 c:\Program Files\Sun\InstantMessaging\html。

第 2 章 安装和配置 Instant Messaging

准备工作

完成安装检查表