test

Sun Java System Instant Messaging 7.2 管理指南

第 9 章 管理 Instant Messaging 组件

本章说明如何管理 Instant Messaging 组件（服务器、多路复用器、“日历”代理、群集代理和监视程序）及执行其他管理任务，如更改配置参数和创建备份。

本章包含以下几节，分别介绍了 Instant Messaging 中的各种管理任务：

停止、启动、刷新和检查 Instant Messaging 组件

使用 imadmin 命令可以：

imadmin 命令行实用程序只能由超级用户或拥有运行 Instant Messaging 服务器和多路复用器的系统的管理权限的用户执行。此最终用户通常是用来运行服务器的那个身份，并在安装期间指定：

imadmin 命令行实用程序位于以下目录中：

im-svr-base/sbin

启动 Instant Messaging 服务器可使 Instant Messenger 与其进行连接。停止 Instant Messaging 服务器将终止所有连接，并断开与所有 Instant Messenger 客户机之间的连接。

启动 Instant Messaging 组件

可以一并启动所有组件，也可以分别启动单个组件。

以 start 选项使用 imadmin 命令可根据所启用的组件来启动 Instant Messaging Server、多路复用器、日历代理、群集代理、监视程序。

Procedure启动所有组件

    在命令行中键入如下内容：


    imadmin start

    如果服务器和多路复用器均已启用，则此命令将首先启动 Instant Messaging 服务器，然后启动多路复用器。

    如果启用了监视程序（默认设置），此命令将启动监视程序，然后监视程序将读取配置文件，并根据需要启动 Instant Messaging Server 和/或多路复用器。

Procedure启动单个组件

    如下所示在命令行中键入包含指定组件的参数的 imadmin start 命令：

    服务器：


    imadmin start server

    多路复用器：


    imadmin start multiplexor

    日历代理：


    imadmin start agent-calendar

    监视程序：


    imadmin start watchdog

停止 Instant Messaging 组件

可以一并停止所有组件，也可以分别停止单个组件。

以 stop 选项使用 imadmin 命令可根据所启用的组件来停止 Instant Messaging Server、多路复用器、日历代理、群集代理、监视程序。

Procedure停止所有组件

    在命令行中键入如下内容：


    imadmin stop

    如果监视程序正在运行，imadmin 将首先停止监视程序，然后停止服务器和/或多路复用器。

    此命令将停止服务器、多路复用器、日历代理、群集代理和监视程序，终止所有最终用户连接，并断开配置的所有入站和出站服务器连接。

Procedure停止单个组件

    如下所示在命令行中键入包含指定组件的参数的 imadmin stop 命令：

    服务器：


    imadmin stop server

    多路复用器：


    imadmin stop multiplexor

    日历代理：


    imadmin stop agent-calendar

    监视程序：


    imadmin stop watchdog

刷新组件配置

以 refresh 选项使用 imadmin 命令可停止和重新启动单个 Instant Messaging 组件并刷新该组件的配置。

可以一并刷新所有组件，也可以分别刷新单个组件。

无论何时在 iim.conf 文件中更改配置参数，都需要刷新配置。

Procedure刷新所有组件

    在命令行中键入如下内容：


    imadmin refresh

    此命令将停止服务器、多路复用器、日历代理、群集代理和监视程序，终止所有最终用户连接，并断开配置的所有入站和出站服务器连接。

    如果监视程序正在运行，imadmin 将首先停止监视程序，然后停止服务器和/或多路复用器。然后启动监视程序。该监视程序将读取配置文件，并根据需要启动 Instant Messaging 服务器和/或多路复用器。

Procedure刷新单个组件

    如下所示在命令行中键入包含指定组件的参数的 imadmin refresh 命令：

    服务器：


    imadmin refresh server

    多路复用器：


    imadmin refresh multiplexor

    日历代理：


    imadmin refresh agent-calendar

    群集代理：


    imadmin refresh monitor

    监视程序：


    imadmin refresh watchdog

检查 Instant Messaging 组件的状态

可以 status 选项使用 imadmin 命令一并检查所有组件的状态，或分别检查单个组件的状态。该命令会返回以下格式的结果：


Component  [status]

例如：


Server          [UP]
Multiplexor     [UP]
Agent:calendar  [DOWN]
Watchdog        [UP]

Procedure检查所有组件的状态

    在命令行中键入如下内容：


    imadmin status

    此命令将返回所有已启用组件的状态。

Procedure检查单个组件的状态

    如下所示在命令行中键入包含指定组件的参数的 imadmin status 命令：

    服务器：


    imadmin status server

    多路复用器：


    imadmin status multiplexor

    日历代理：


    imadmin status agent-calendar

    监视程序：


    imadmin status watchdog

更改 Instant Messaging 服务器和多路复用器配置参数

Instant Messaging 将配置参数存储在 iim.conf 文件中。有关配置参数的完整列表，参见附录 A，iim.conf 中的 Instant Messaging 配置参数。

要更改配置参数，请手动编辑 iim.conf 文件中的配置参数及其值，然后刷新 Instant Messaging 服务器配置。如果更改了多路复用器参数，只需刷新多路复用器，如下所示：


imadmin refresh multiplexor

有关配置参数及其值的完整列表，参见附录 A，iim.conf 中的 Instant Messaging 配置参数。

Procedure更改配置参数

  1. 转至 im-cfg-base 目录。

    有关查找 im-cfg-base 的说明，参见Instant Messaging 服务器目录结构。

  2. 使用文本编辑器编辑 iim.conf。

  3. 保存更改。

  4. 使用 imadmin 刷新配置。

    例如：


    imadmin refresh
    注 –

    如果更改了多路复用器的监听端口 (iim_mux.listenport) 和多路复用器主机，则相应更新 im.html 或 im.jnlp 文件。如果该操作失败，则会使 Instant Messenger 无法连接到服务器。有关更多信息，参见第 15 章，管理 Instant Messenger。

备份 Instant Messaging 数据

Instant Messaging 不附带任何故障恢复工具。请使用站点的备份系统定期备份配置和数据库目录。本部分的以下小节介绍备份 Instant Messaging 的相关信息：

备份信息

需要备份的 Instant Messaging 信息包括以下类型：

配置信息存储在配置目录 (im-cfg-base) 中。默认路径在 Instant Messaging 服务器目录结构中进行了描述。

Instant Messaging 数据存储在数据库目录 (im-db-base) 中。默认 im-db-base 也在 Instant Messaging 服务器目录结构中进行了描述。

如果 Instant Messenger 资源进行了自定义，则必须对其进行备份。安装期间提供了 Instant Messenger 资源的位置。

执行备份

虽然备份信息不经常更改，但 Instant Messaging 最终用户的数据却更改频繁。因此，为避免最终用户数据的丢失，应该定期备份 Instant Messaging 最终用户数据。备份需要在运行安装程序或卸载程序之前执行。

要备份最终用户数据和配置信息，不必停止 Instant Messaging 服务器，因为所有由服务器负责的磁盘提交会自动执行。

恢复备份信息

当出现磁盘故障并且所有最终用户数据和配置信息均丢失时，需要恢复最终用户数据和配置信息的备份。

Procedure从备份恢复最终用户数据

  1. 转至 im-runtime-base 目录。

    有关查找 im-runtime-base 的信息，参见Instant Messaging 服务器目录结构。

  2. 停止 Instant Messaging 服务器：


    imadmin stop

  3. 将备份数据复制到 im-db-base 目录。

    确保保持备份数据的目录结构。

  4. 检验新恢复数据的权限和所有者。

    文件应由 Instant Messaging 系统用户所有。有关该用户的信息，参见创建 UNIX 系统用户和组。应如下设置权限：

    • 文件：600（表示仅限所有者的读和写权限）

    • 目录：700（表示仅限所有者的读、写和执行权限）

    有关更改权限和所有者的信息，参阅您的操作系统文档。

  5. 启动 Instant Messaging 服务器：

    imadmin start