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,則此指令會將 Instant Messaging 和身份認證服務指派給您所指定基底 DN 下的現有使用者。DN 應為儲存使用者項目之組織的基底 DN。

如果 iim.policy.modules 設定為 iim_ldap,且 iim.userprops.store 設定為 ldap,則此指令會將物件類別 (sunIMUsersunPresenceUser) 新增至目錄中的使用者項目。Instant Messaging 需要這些物件類別,以便在 LDAP 中儲存特性。

imadmin status

(以前為 imadmin check)

檢查元件 (servermultiplexoragent-calendarwatchdog) 是否在正常執行並顯示結果。如果您未指定元件,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

startrefresh 動作搭配使用,用以指定 /etc/opt/SUNWiim/config/iim.conf 檔案以外的不同配置檔案。

-h

顯示有關 imadmin 指令的。

imadmin 動作

表 C–3 列出並描述發出各種 imadmin 指令後執行的動作。

表 C–3 imadmin 指令的動作

選項 

說明 

status

(以前為 imadmin check)

傳回關於 Instant Messaging 元件 (server multiplexoragent-calendarwatchdog) 的資訊。執行此動作無需提供 [component]

start

設定 classpath,Java 堆疊大小並啟動所有指定的元件。

stop

停止所有指定元件的常駐程式。 

refresh

停止並啟動指定的元件。用於配置變更之後。 

imadmin 元件

表 C–4 列出並描述 imadmin 指令的元件。

表 C–4 imadmin 指令的元件

選項 

說明 

agent-calendar

表示行事曆代理程式 (agent-calendar)。

multiplexor

僅表示多重訊號組合器。 

server

表示 Instant Messaging 伺服器。 

watchdog

表示監視程式。