Sun ONE Instant Messaging 6.1 安装指南 |
第 2 章
安装和配置 Instant Messaging本章下列各节介绍如何安装、升级和迁移 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,可选)
如果启用了安全模式(仅限 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 服务器主机上。
以下各节详细说明如何安装 Instant Messaging:
使用 JES 安装程序安装和配置(仅限 Solaris)
要安装 Instant Messaging 组件:
- 运行 JES 安装程序。
可以使用图形用户界面或命令行安装。有关使用 JES 安装程序的详细说明,请参阅 Java Enterprise System Installation Guide。
- 当系统提示您选择要安装的组件时,请展开 Instant Messaging,选择要安装的组件:
- Instant Messaging 核心服务
此组件包括服务器和多路复用器软件。
多路复用器将 Instant Messenger 消息从多台客户机路由到 Instant Messaging 服务器。
- Sun ONE Instant Messenger 资源
资源是文件的集合,其中包括用来启动 Instant Messenger 客户机的文件、可自定义的属性、样式表、图像和音频文件,以及 Instant Messenger 的联机帮助。
- Identity Server Instant Messaging Service
以 Sun ONE Identity Server 部署 Instant Messaging 时,Instant Messaging 服务即会添加到 Identity Server。Instant Messaging 服务可让管理员为访问 Instant Messaging 实施 Identity Server 策略机制。
您应该先安装 Sun ONE Identity Server,然后才能用此选项安装 Instant Messaging。
- 请按照屏幕上的说明进行。
- 安装之后,必须使用 configure 实用程序配置 Instant Messaging。请按以下步骤执行:
- 切换到安装 Instant Messaging 的目录。
缺省情况下此目录为 /opt/SUNWiim。
- 运行 configure 实用程序:
图形用户界面:配置
命令行:configure -nodisplay
会出现一系列提示,请求提供将要设置 Instant Messaging 为初始配置的信息。出现的提示因您选择的组件而异。使用检查表中的值填写请求的信息。有关详细信息,请参阅“完成安装检查表”。
使用图形用户界面安装和配置(Linux 和 Windows)
运行 setup 安装 Instant Messaging 时,是安装新软件和提供初始配置信息。
要在 Linux 和 Windows 上安装 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 Messenger 资源”,“Instant Messenger 资源目录”对话框会出现,显示安装程序将要安装资源文件的目录。安装资源的缺省目录如下:
对于 Linux:/var/opt/soim/html
对于 Windows:C:\Program Files\Sun\Instant Messaging\html
- 单击“下一步”。
安装程序会检查是否有充分的磁盘空间,然后显示“准备安装”对话框。
- 单击“立即安装”。
当安装过程完成时,会出现“摘要信息”对话框。
- 单击“详细信息”,查看有关安装的摘要信息。查看完摘要信息后,单击“退出”关闭“摘要信息”对话框。
- 单击“下一步”开始配置 Instant Messaging。
会出现一系列对话框,请求提供将要设置 Instant Messaging 初始配置的信息。出现的对话框因您选择的组件而异。使用检查表中的值填写请求的信息。有关详细信息,请参阅“完成安装检查表”。
- 单击“退出”以退出安装程序。
从命令行安装和配置(仅限 Linux)
运行 setup 安装 Instant Messaging 时,会安装新软件和提供初始配置信息。
从命令行安装 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。
“选择组件”屏幕会出现,显示以下选项:
- 选择要安装的软件组件,然后按 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 软件。
- 计划关闭 Instant Messaging 服务器的时间。
- 将您的关机计划提前通知您的用户。
- 备份数据库、任何现有资源以及自定义的配置文件。其中包括数据库、安装 和资源目录中的文件。这些目录的缺省位置如下:
- (仅限 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 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 所需的其它服务器的信息,请参阅“与其他服务器的依存性”。
“选择组件”屏幕会出现,并显示以下选项:
- 选择要升级的所有其他软件组件,然后按 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)要从创建的备份中恢复数据库,请将备份数据库目录及其所有内容复制到新的数据库目录。缺省情况下,升级期间创建的数据库目录会安装在以下位置:
Linux:/var/opt/soim/db
Windows:C:\Program Files\Sun\Instant Messaging\db
升级期间,setup 程序会在 config 和 html 目录中创建 .new 文件。这些文件包含此版本中添加的所有更改。例如,如果您自定义了现有 iim.conf 文件,安装程序会创建 iim.conf.new 文件。
升级为新版本之后,必须找到 .new 文件,然后将更改合并到现有文件。如果没有保存所做的更改,请删除旧文件,重命名相应的 .new 文件。
合并更改时,请将旧文件与 .new 文件逐行比较,并编辑现有文件以合并这些更改。
表 2-2 列出了可以自定义的文件,以及在升级期间为其创建的 .new 文件。