imadmin コマンドを使用すると、次のことを行うことができます。
すべての Instant Messaging コンポーネント (サーバー、マルチプレクサ、カレンダエージェント、クラスタエージェント、およびウォッチドッグ) を起動および停止する。
特定の Instant Messaging コンポーネントを起動および停止する。
すべての Instant Messaging コンポーネントの設定を更新する。
Instant Messaging コンポーネントを個別に更新する。
Instant Messaging コンポーネントのステータスを確認する。
imadmin コマンド行ユーティリティーを実行できるのは、root または Instant Messaging サーバーおよびマルチプレクサが実行されているシステムに対する管理者権限を持つユーザーのみです。この管理者権限を持つユーザーの例としては、サーバーを実行するユーザーとして、サーバーのインストール時に指定したユーザーが挙げられます。
Solaris の場合: inetuser。
Sun JavaTM System Access Manager を含む配備では、Sun Java System Portal Server と Instant Messaging サーバーが同一ホスト上にインストールされている場合、Access Manager を実行できるのは root ユーザーのみのため、imadmin コマンドを実行できるのユーザーも、root のみとなります。
imadmin コマンド行ユーティリティーは、次のディレクトリ内に格納されています。
im-svr-base/sbin
Instant Messaging サーバーを起動すると、Instant Messenger からサーバーに接続できるようになります。Instant Messaging サーバーを停止すると、すべての接続が閉じられ、すべての Instant Messenger クライアントとの接続が切断されます。
すべてのコンポーネントを同時に起動することも、各コンポーネントを個別に起動することもできます。
Instant Messaging サーバー、マルチプレクサ、カレンダエージェント、クラスタエージェント、およびウォッチドッグを起動するには、どのコンポーネントを有効にするかに応じて start オプションが指定された imadmin コマンドを使用します。
コマンド行で次のように入力します。
imadmin start |
サーバーとマルチプレクサの両方が有効になっていた場合、このコマンドによって、まず Instant Messaging サーバーが起動され、続いてマルチプレクサが起動されます。
ウォッチドッグが有効な場合 (デフォルト)、このコマンドによってウォッチドッグが起動され、ウォッチドッグが設定ファイルを読み取り、必要に応じて Instant Messaging サーバーまたはマルチプレクサ、あるいはその両方を起動します。
コマンド行で imadmin start コマンドを入力する際に、次のようにコンポーネントを特定する引数を指定します。
サーバー:
imadmin start server |
マルチプレクサ:
imadmin start multiplexor |
カレンダエージェント:
imadmin start agent-calendar |
ウォッチドッグ:
imadmin start watchdog |
すべてのコンポーネントを同時に停止することも、各コンポーネントを個別に停止することもできます。
Instant Messaging サーバー、マルチプレクサ、カレンダエージェント、クラスタエージェント、およびウォッチドッグを停止するには、どのコンポーネントを有効にするかに応じて stop オプションが指定された imadmin コマンドを使用します。
コマンド行で次のように入力します。
imadmin stop |
ウォッチドッグが実行されている場合、imadmin は最初にウォッチドッグを停止し、次にサーバーまたはマルチプレクサ、あるいはその両方を停止します。
このコマンドを実行すると、サーバー、マルチプレクサ、カレンダエージェント、クラスタエージェント、およびウォッチドッグが停止し、全エンドユーザーの接続が終了し、設定されているすべての送受信サーバーへの接続が切断されます。
コマンド行で imadmin stop コマンドを入力する際に、次のようにコンポーネントを特定する引数を指定します。
サーバー:
imadmin stop server |
マルチプレクサ:
imadmin stop multiplexor |
カレンダエージェント:
imadmin stop agent-calendar |
ウォッチドッグ:
imadmin stop watchdog |
refresh オプションを指定した imadmin コマンドを使用して、個々の Instant Messaging コンポーネントを停止および再起動し、コンポーネントの設定を更新します。
すべてのコンポーネントを同時に更新することも、各コンポーネントを個別に更新することもできます。
iim.conf ファイル内の設定パラメータを変更した場合、設定の更新も行う必要があります。
コマンド行で次のように入力します。
imadmin refresh |
このコマンドを実行すると、サーバー、マルチプレクサ、カレンダエージェント、クラスタエージェント、およびウォッチドッグが停止し、全エンドユーザーの接続が終了し、設定されているすべての送受信サーバーへの接続が切断されます。
ウォッチドッグが実行されている場合、imadmin は最初にウォッチドッグを停止し、次にサーバーまたはマルチプレクサ、あるいはその両方を停止します。次にウォッチドッグが起動され、ウォッチドッグが設定ファイルを読み取り、必要に応じて Instant Messaging サーバーまたはマルチプレクサ、あるいはその両方を起動します。
コマンド行で imadmin refresh コマンドを入力する際に、次のようにコンポーネントを特定する引数を指定します。
サーバー:
imadmin refresh server |
マルチプレクサ:
imadmin refresh multiplexor |
カレンダエージェント:
imadmin refresh agent-calendar |
クラスタエージェント:
imadmin refresh monitor |
ウォッチドッグ:
imadmin refresh watchdog |
status オプションを指定した imadmin コマンドを使用して、すべてのコンポーネントのステータスを同時に確認することも、各コンポーネントのステータスを個別に確認することもできます。このコマンドから返される結果の形式は、次のとおりです。
Component [status] |
たとえば、次のようになります。
Server [UP] Multiplexor [UP] Agent:calendar [DOWN] Watchdog [UP] |