test

Sun Java System Instant Messaging 7.2 管理指南

附录 C Instant Messaging imadmin 工具参考

本章在以下各节中说明用于管理 Instant Messaging 的 imadmin 命令：

imadmin 概述

您可以使用 imadmin 实用程序来启动、停止和刷新 Instant Messaging 服务器和多路复用器。以 root 身份或以配置过程中指定的最终用户身份运行 imadmin。

imadmin 要求

您必须从安装了 Instant Messaging 服务器的主机调用 imadmin 实用程序。

imadmin 位置

默认情况下，imadmin 安装在以下位置：

im-svr-base/sbin

imadmin 命令

表 C–1 列出并说明与 imadmin 命令相关的命令。

表 C–1 imadmin 命令与说明

命令 

说明 

imadmin assign_services

如果 iim.policy.modules 设置为 identity，则此命令为您指定的基本 DN 下的现有用户指定 Instant Messaging 和在线服务。该 DN 应为存储用户条目的组织的基本 DN。

如果 iim.policy.modules 设置为 iim_ldap，而 iim.userprops.store 设置为 ldap，则此命令会向目录中的用户条目添加对象类（sunIMUser 和 sunPresenceUser ）。Instant Messaging 需要这些对象类，以便在 LDAP 中存储属性。

imadmin status

（以前为 imadmin check）

查验组件（server、multiplexor 、agent-calendar 和 watchdog）是否在正常运行并显示结果。如果您没有指定组件，则 imadmin 实用程序会返回关于所有组件的信息。

imadmin start

启动启用的组件。 

imadmin stop

停止启用的组件。 

imadmin refresh

刷新启用的组件。 

imadmin start server

只启动服务器。 

imadmin stop server

只停止服务器。 

imadmin refresh server

只刷新服务器。 

imadmin start multiplexor

只启动多路复用器。 

imadmin stop multiplexor

只停止多路复用器。 

imadmin refresh multiplexor

只刷新多路复用器。 

imadmin start agent-calendar

只启动“日历”代理。 

imadmin stop agent-calendar

只停止“日历”代理。 

imadmin refresh agent-calendar

只刷新“日历”代理。 

imadmin start watchdog

只启动监视程序。 

imadmin stop watchdog

只停止监视程序。 

imadmin refresh watchdog

只刷新监视程序。 

imadmin version

显示版本。 

imadmin 语法

imadmin [选项] [操作] [组件]

imadmin 选项

表 C–2 列出并说明 imadmin 命令的选项。

表 C–2 imadmin 命令的选项

选项 

说明 

-c alt-config-file

与 start 和 refresh 操作一起使用，用于指定 /etc/opt/SUNWiim/config/iim.conf 文件之外的配置文件

-h

显示关于 imadmin 命令的帮助。

imadmin 操作

表 C–3 列出并说明在发出各种 imadmin 命令后执行的操作。

表 C–3 imadmin 命令的操作

选项 

说明 

status

（以前为 imadmin check）

返回关于 Instant Messaging 组件（server、multiplexor、agent-calendar 和 watchdog）的信息。此操作无需提供 [component]。

start

设置 classpath、Java 堆大小并启动所有指定的组件。

stop

停止指定组件的所有守护进程。 

refresh

停止然后启动指定的组件。此操作在配置更改后适用。 

imadmin 组件

表 C–4 列出并说明 imadmin 命令的组件。

表 C–4 imadmin 命令的组件

选项 

说明 

agent-calendar

表示“日历”代理 (agent-calendar)。

multiplexor

仅表示多路复用器。 

server

表示 Instant Messaging 服务器。 

watchdog

表示监视程序。