13.7 ijsundeployment

Interstage Application Server リファレンスマニュアル（コマンド編）

目次索引

第3部 J2EE編

> 第13章 J2EE運用コマンド

13.7 ijsundeployment

名前

　ijsundeployment - J2EEアプリケーションの配備解除

形式

　ijsundeployment -n name -t targetname ...
　ijsundeployment -n name -k kind -a application ...
　ijsundeployment -n name -f

機能説明

　ijsundeploymentコマンドは、IJServerのワークユニットに配備されたアプリケーションの配備解除処理を行います。IJServerのワークユニットが運用中の場合は、HotDeploy機能を使用したJ2EEアプリケーションの配備解除となります。

　以下に、ijsundeploymentコマンドのオプションおよび引数を説明します。

-n name

　配備解除対象のアプリケーションが配備されているIJServerのワークユニット名を指定します。

-t targetname

　配備解除するモジュール名を指定します。
　空白で区切ることによりモジュール名を複数指定することができます。
　本オプションは、-k、-aおよび-fオプションと同時に指定することはできません。
　なお、形式“ijsundeployment -n name -t targetname ...”は、Interstage Application Server V7以降で作成されたIJServerのワークユニットで使用可能です。

-k kind

　配備解除するアプリケーションの種別を指定します。
　種別には次の値が指定できます。

ejb :EJBアプリケーション
web :Webアプリケーション

　本オプションは、-tおよび-fオプションと同時に指定することはできません。
　なお、形式“ijsundeployment -n name -k kind -a application ...”は、Interstage Application Server V6で作成されたIJServerのワークユニットでのみ使用可能です。

-a application

　配備解除するアプリケーション名を指定します。
　同一種別のアプリケーションであれば、空白で区切ることによりアプリケーション名を複数指定することができます。
　本オプションは、-kオプションと同時に指定します。
　本オプションは、-tおよび-fオプションと同時に指定することはできません。

-f

　対象のIJServerのワークユニットに配備されている全アプリケーションを配備解除します。
　本オプションは、-k、-aおよび-tオプションと同時に指定することはできません。

戻り値

　0 = 正常終了
　上記以外 = エラーが発生し処理を中断

注意事項

本コマンドを使用する場合は、コマンドを実行するマシンにInterstage JMXサービスがインストールされ、起動されている必要があります。
下記の場合、本コマンドを実行する前に対象となるIJServerのワークユニットが停止している必要があります。
- HotDeploy機能を使用していない場合
- Interstage Application Server V6で作成されたIJServerの場合
本コマンドで配備対象となるIJServerのワークユニットは、Interstage管理コンソールで作成したIJServerのワークユニットのみです。
サーバ上の任意の位置で実行するWebアプリケーションを配備解除した場合、アプリケーションの配備情報だけがIJServerワークユニットから削除され、任意のディレクトリ配下に展開されているWebアプリケーションは削除されません。必要に応じて、Webアプリケーションを削除してください。
本コマンドは、Interstageが起動されているか全強制停止モード以外で停止されている場合に実行できます。
このコマンドによる操作は、Interstage管理コンソールの実行基盤となっているInterstage JMXサービスで処理されます。下記のような場合は、Interstage JMXサービスのカスタマイズを行ってください。Interstage JMXサービスの環境設定については、“Interstage Application Server 運用ガイド”の“Interstage管理コンソール環境のカスタマイズ”を参照してください。
- メモリ不足が発生した場合
  “Interstage JMXサービスのjavaプロセスに指定するオプション情報”をカスタマイズしてください。
- Interstage JMXサービスの通信のタイムアウトが発生した場合
  “Interstage JMXサービスの通信のタイムアウト時間”をカスタマイズしてください。

本コマンドは、管理者権限を所有するユーザだけが実行可能です。

使用例

　Interstage Application Server V7以降で作成されたIJServerのワークユニット名がIJServer001、モジュール名がsample.earの操作例を以下に示します。

  -----------------------------------------------------------------------
    ijsundeployment -n IJServer001 -t sample.ear
  -----------------------------------------------------------------------

　Interstage Application Server V6で作成されたIJServerのワークユニット名がIJServer001、アプリケーション種別がEJB、アプリケーション名がsampleEJBの操作例を以下に示します。

  -----------------------------------------------------------------------
    ijsundeployment -n IJServer001 -k ejb -a sampleEJB
  -----------------------------------------------------------------------

目次索引