Sun Java System Application Server Enterprise Edition 8.1 2005Q2 管理ガイド

アプリケーションの配備に関する管理コンソールタスク

Procedureエンタープライズアプリケーションを配備する

エンタープライズアプリケーションは、WAR ファイルや EJB JAR ファイルなど、任意のタイプの J2EE スタンドアロンモジュールを含むアーカイブファイルの一種である EAR ファイルにパッケージ化されています。

手順
  1. ツリーコンポーネントで、「アプリケーション」ノードを展開します。

  2. 「エンタープライズアプリケーション」ノードを選択します。

  3. 「エンタープライズアプリケーション」ページで、「配備」をクリックします。

  4. 「配備」ページで、EAR ファイルを配備する場所を指定します。

    サーバーマシンとは、Application Server のドメイン管理サーバーを実行しているホストです。クライアントマシンとは、ブラウザを介して管理コンソールを表示しているホストです。

    • ファイルがクライアントマシンにある場合、またはクライアントマシンからファイルにアクセス可能な場合は、ラジオボタンをクリックして、Application Server にアップロードするパッケージファイルを指定します。

      「ブラウズ」をクリックしてファイルを検索するか、またはファイルへの完全パスを入力します。

    • ファイルがサーバーマシンにある場合、または分割ディレクトリからパッケージ化されていないアプリケーションを配備する場合は、ラジオボタンをクリックして、サーバーからアクセス可能なパッケージファイルまたはディレクトリパスを指定します。

      ファイルまたはディレクトリへの完全パス名を入力します。分割ディレクトリからの配備は高度な開発者用なので、本稼働環境ではお勧めできません。

  5. 「次へ」をクリックして「Enterprise アプリケーションを配備」ページを表示します。

  6. 「Enterprise アプリケーションを配備」ページで、アプリケーションの設定値を指定します。

    1. 「アプリケーション名」フィールドで、ファイル名のプレフィックスであるデフォルト名を保持するか、または別の名前を入力します。

      ファイルのアップロードを選択した場合は、デフォルト名が表示されます。アプリケーション名は一意である必要があります。

    2. 配備後には利用できないようにアプリケーションを無効にする場合は、「無効」ラジオボタンをオンにします。

      デフォルトでは、アプリケーションは配備すると同時に利用可能になります。

    3. アプリケーションがすでに配備されている場合は、「再配備」チェックボックスを選択して、再配備します。そうでない場合、エラーが表示されます。

      また、別のアプリケーション名を選択して、新しい名前で配備することもできます。

    4. 配備の前にファイルの構造やコンテンツを検証するには、「ベリファイア」チェックボックスにチェックマークを付けます。

      大きなアプリケーションの検証は時間がかかる可能性があります。ファイルの破壊や移行不能が想定される場合は検証を行なってください。

    5. JSP ページを事前にコンパイルするには、「JSP」チェックボックスにチェックマークを付けます。

      このチェックボックスを選択しない場合、JSP ページは最初のアクセスの実行時にコンパイルされます。コンパイルは時間がかかる可能性があるので、本稼働環境ではこのチェックボックスにチェックマークを付けてください。

    6. 高可用性の設定を選択します。

      アプリケーションの高可用性を有効にするには、「可用性」チェックボックスを選択します。1 つのアプリケーションで可用性を有効にする場合、それより高いすべてのレベル (指定した設定および Web コンテナまたは EJB コンテナ) も同様に有効にする必要があります。

    7. アプリケーションを配備するターゲットを選択します。

      利用可能なターゲットのリストから、1 つまたは複数のターゲットを選択して「追加」をクリックします。ターゲットを選択しない場合、アプリケーションはデフォルトのサーバーインスタンス server に配備されます。

      再配備の場合は、ターゲットを選択しないでください。ここで選択した内容は、すべて無視されます。クラスタやスタンドアロンインスタンスの動的再設定が有効になっている場合、配備されているアプリケーションを参照する、ターゲットのクラスタ化またはスタンドアロンのすべてのサーバーインスタンスは、新しく再配備されたアプリケーションを自動的に参照します。サービスを中断せずにアプリケーションを再配備する方法の詳細については、「アプリケーションのアップグレード」を参照してください。

    8. RMI スタブを生成するかどうかを選択します。

      RMI スタブの生成を選択すると、静的 RMI-IIOP スタブが生成され、クライアント JAR ファイルに配置されます。

  7. 「了解」をクリックしてアプリケーションを配備します。

同機能を持つ asadmin コマンド

deploy

Procedure配備されているエンタープライズアプリケーションを編集する

手順
  1. ツリーコンポーネントで、「アプリケーション」ノードを展開します。

  2. 「エンタープライズアプリケーション」ノードを展開します。

  3. 配備されているアプリケーションのノードを選択します。

  4. 「エンタープライズアプリケーション」ページで、説明を変更します。

  5. 「Enterprise Edition」で、高可用性を有効または無効にします。

    1 つのアプリケーションで可用性を有効にする場合、それより高いすべてのレベル (指定した設定および Web コンテナまたは EJB コンテナ) も同様に有効にする必要があります。

ProcedureWeb アプリケーションを配備する

Web アプリケーションは、サーブレットや JSP ファイルなどのコンポーネントを含むアーカイブファイルの一種である WAR ファイルにパッケージ化されています。

手順
  1. ツリーコンポーネントで、「アプリケーション」ノードを展開します。

  2. 「Web アプリケーション」ノードを選択します。

  3. 「Web アプリケーション」ページで、「配備」をクリックします。

  4. 「配備」ページで、WAR ファイルを配備する場所を指定します。

    サーバーマシンとは、Application Server のドメイン管理サーバーを実行しているホストです。クライアントマシンとは、ブラウザを介して管理コンソールを表示しているホストです。

    • ファイルがクライアントマシンにある場合、またはクライアントマシンからファイルにアクセス可能な場合は、ラジオボタンをクリックして、Application Server にアップロードするパッケージファイルを指定します。

      「ブラウズ」をクリックしてファイルを検索するか、またはファイルへの完全パスを入力します。

    • ファイルがサーバーマシンにある場合、または分割ディレクトリからパッケージ化されていないアプリケーションを配備する場合は、ラジオボタンをクリックして、サーバーからアクセス可能なパッケージファイルまたはディレクトリパスを指定します。

      ファイルまたはディレクトリへの完全パス名を入力します。分割ディレクトリからの配備は高度な開発者用なので、本稼働環境ではお勧めできません。

  5. 「次へ」をクリックして「Web アプリケーションを配備」ページを表示します。

  6. 「Web アプリケーションを配備」ページで、アプリケーションの設定を指定します。

    1. 「アプリケーション名」フィールドで、ファイル名のプレフィックスであるデフォルト名を保持するか、または別の名前を入力します。

      ファイルのアップロードを選択した場合は、デフォルト名が表示されます。アプリケーション名は一意である必要があります。

    2. 「コンテキストルート」フィールドに、Web アプリケーションを識別する文字列を入力します。

      Web アプリケーションの URL では、コンテキストルートはポート番号の直後に続きます (http://host:port/context-root/...)。コンテキストルートがスラッシュで始まるようにしてください。たとえば次のようにします。/hello

    3. 配備後には利用できないようにアプリケーションを無効にする場合は、「無効」ラジオボタンをオンにします。

      デフォルトでは、アプリケーションは配備すると同時に利用可能になります。

    4. アプリケーションがすでに配備されている場合は、「再配備」チェックボックスを選択して、再配備します。そうでない場合、エラーが表示されます。

      また、別のアプリケーション名を選択して、新しい名前で配備することもできます。

    5. 配備の前にファイルの構造やコンテンツを検証するには、「ベリファイア」チェックボックスにチェックマークを付けます。

      大きなアプリケーションの検証は時間がかかる可能性があります。ファイルの破壊や移行不能が想定される場合は検証を行なってください。

    6. JSP ページを事前にコンパイルするには、「JSP」チェックボックスにチェックマークを付けます。

      このチェックボックスを選択しない場合、JSP ページは最初のアクセスの実行時にコンパイルされます。コンパイルは時間がかかる可能性があるので、本稼働環境ではこのチェックボックスにチェックマークを付けてください。

    7. 高可用性の設定を選択します。

      アプリケーションの高可用性を有効にするには、「可用性」チェックボックスを選択します。1 つのアプリケーションで可用性を有効にする場合、それより高いすべてのレベル (指定した設定および Web コンテナまたは EJB コンテナ) も同様に有効にする必要があります。

    8. アプリケーションを配備するターゲットを選択します。

      利用可能なターゲットのリストから、1 つまたは複数のターゲットを選択して「追加」をクリックします。ターゲットを選択しない場合、アプリケーションはデフォルトのサーバーインスタンス server に配備されます。

      再配備の場合は、ターゲットを選択しないでください。ここで選択した内容は、すべて無視されます。クラスタやスタンドアロンインスタンスの動的再設定が有効になっている場合、配備されているアプリケーションを参照する、ターゲットのクラスタ化またはスタンドアロンのすべてのサーバーインスタンスは、新しく再配備されたアプリケーションを自動的に参照します。サービスを中断せずにアプリケーションを再配備する方法の詳細については、「段階的アップグレードについて」を参照してください。

    9. RMI スタブを生成するかどうかを選択します。

      RMI スタブの生成を選択すると、静的 RMI-IIOP スタブが生成され、クライアント JAR ファイルに配置されます。

  7. 「了解」をクリックしてアプリケーションを配備します。

同機能を持つ asadmin コマンド

deploy

Procedure配備されている Web アプリケーションを起動する

アプリケーションを配備すると、管理コンソールから起動することができます。アプリケーションを起動するには、サーバーと HTTP リスナーが実行されている必要があります。

手順
  1. ツリーコンポーネントで、「アプリケーション」ノードを展開します。

  2. 「Web アプリケーション」をクリックします。

  3. Web アプリケーションの起動リンクをクリックします。

  4. 「Web アプリケーションへのリンク」ページのリンクをクリックして、アプリケーションを起動します。

ProcedureEJB モジュールを配備する

EJB モジュールは、EJB JAR ファイルとも呼ばれ、Enterprise JavaBeans を含んでいます。

手順
  1. ツリーコンポーネントで、「アプリケーション」ノードを展開します。

  2. 「EJB モジュール」ノードを選択します。

  3. 「EJB モジュール」ページで、「配備」をクリックします。

  4. 「配備」ページで、JAR ファイルを配備する場所を指定します。

    サーバーマシンとは、Application Server のドメイン管理サーバーを実行しているホストです。クライアントマシンとは、ブラウザを介して管理コンソールを表示しているホストです。

    • ファイルがクライアントマシンにある場合、またはクライアントマシンからファイルにアクセス可能な場合は、ラジオボタンをクリックして、Application Server にアップロードするパッケージファイルを指定します。

      「ブラウズ」をクリックしてファイルを検索するか、またはファイルへの完全パスを入力します。

    • ファイルがサーバーマシンにある場合、または分割ディレクトリからパッケージ化されていないアプリケーションを配備する場合は、ラジオボタンをクリックして、サーバーからアクセス可能なパッケージファイルまたはディレクトリパスを指定します。

      ファイルまたはディレクトリへの完全パス名を入力します。分割ディレクトリからの配備は高度な開発者用なので、本稼働環境ではお勧めできません。

  5. 「次へ」をクリックして「EJB モジュールを配備」ページを表示します。

  6. 「EJB モジュールを配備」ページで、モジュールの設定を指定します。

    1. 「アプリケーション名」フィールドで、ファイル名のプレフィックスであるデフォルト名を保持するか、または別の名前を入力します。

      ファイルのアップロードを選択した場合は、デフォルト名が表示されます。アプリケーション名は一意である必要があります。

    2. 配備後には利用できないようにモジュールを無効にする場合は、「無効」ラジオボタンをオンにします。

      デフォルトでは、モジュールは配備すると同時に利用可能になります。

    3. モジュールがすでに配備されている場合は、「再配備」チェックボックスを選択して、再配備します。そうでない場合は、エラーが表示されます。

      また、別のアプリケーション名を選択して、新しい名前で配備することもできます。

    4. 配備の前にファイルの構造やコンテンツを検証するには、「ベリファイア」チェックボックスにチェックマークを付けます。

      大きなアプリケーションの検証は時間がかかる可能性があります。ファイルの破壊や移行不能が想定される場合は検証を行なってください。

    5. 高可用性の設定を選択します。

      モジュールの高可用性を有効にするには、「可用性」チェックボックスを選択します。1 つのモジュールで可用性を有効にする場合、それより高いすべてのレベル (指定した設定および Web コンテナまたは EJB コンテナ) も同様に有効にする必要があります。

    6. モジュールを配備するターゲットを選択します。

      利用可能なターゲットのリストから、1 つまたは複数のターゲットを選択して「追加」をクリックします。ターゲットを選択しない場合、モジュールはデフォルトのサーバーインスタンス server に配備されます。

      再配備の場合は、ターゲットを選択しないでください。ここで選択した内容は、すべて無視されます。クラスタやスタンドアロンインスタンスの動的再設定が有効になっている場合、配備されているモジュールを参照する、ターゲットのクラスタ化またはスタンドアロンのすべてのサーバーインスタンスは、新しく再配備されたモジュールを自動的に参照します。サービスを中断せずにモジュールを再配備する方法の詳細については、「段階的アップグレードについて」を参照してください。

    7. RMI スタブを生成するかどうかを選択します。

      RMI スタブの生成を選択すると、静的 RMI-IIOP スタブが生成され、クライアント JAR ファイルに配置されます。

  7. 「了解」をクリックしてモジュールを配備します。

同機能を持つ asadmin コマンド

deploy

Procedureコネクタモジュールを配備する

コネクタはリソースアダプタとも呼ばれ、RAR ファイルというアーカイブファイルの一種にパッケージ化されています。

手順
  1. ツリーコンポーネントで、「アプリケーション」ノードを展開します。

  2. 「コネクタモジュール」ノードを選択します。

  3. 「コネクタモジュール」ページで、「配備」をクリックします。

  4. 「配備」ページで、RAR ファイルを配備する場所を指定します。

    サーバーマシンとは、Application Server のドメイン管理サーバーを実行しているホストです。クライアントマシンとは、ブラウザを介して管理コンソールを表示しているホストです。

    • ファイルがクライアントマシンにある場合、またはクライアントマシンからファイルにアクセス可能な場合は、ラジオボタンをクリックして、Application Server にアップロードするパッケージファイルを指定します。

      「ブラウズ」をクリックしてファイルを検索するか、またはファイルへの完全パスを入力します。

    • ファイルがサーバーマシンにある場合、またはパッケージ化されていないモジュールを分割ディレクトリから配備する場合は、ラジオボタンをクリックして、サーバーからアクセス可能なパッケージファイルまたはディレクトリパスを指定します。

      ファイルまたはディレクトリへの完全パス名を入力します。分割ディレクトリからの配備は高度な開発者用なので、本稼働環境ではお勧めできません。

  5. 「次へ」をクリックして「コネクタモジュールを配備」ページを表示します。

  6. 「コネクタモジュールを配備」ページで、モジュールの設定を指定します。

    1. 「アプリケーション名」フィールドで、ファイル名のプレフィックスであるデフォルト名を保持するか、または別の名前を入力します。

      ファイルのアップロードを選択した場合は、デフォルト名が表示されます。アプリケーション名は一意である必要があります。

    2. 「スレッドプール ID」フィールドで、配備するリソースアダプタのスレッドプールを指定します。

      デフォルトでは、Application Server は、デフォルトスレッドプールのすべてのリソースアダプタからの作業要求を処理します。このフィールドを使用して、特定のユーザーが作成したスレッドプールを関連付け、リソースアダプタからの作業要求を処理します。

    3. 配備後には利用できないようにモジュールを無効にする場合は、「無効」ラジオボタンをオンにします。

      デフォルトでは、モジュールは配備すると同時に利用可能になります。

      コネクタモジュールを有効または無効にすると、コネクタリソースとそのモジュールをポイントする接続プールも有効または無効にできます。

    4. モジュールがすでに配備されている場合は、「再配備」チェックボックスを選択して、再配備します。そうでない場合は、エラーが表示されます。

      また、別のアプリケーション名を選択して、新しい名前で配備することもできます。

    5. 配備の前にファイルの構造やコンテンツを検証するには、「ベリファイア」チェックボックスにチェックマークを付けます。

      大きなアプリケーションの検証は時間がかかる可能性があります。ファイルの破壊や移行不能が想定される場合は検証を行なってください。

    6. リソースアダプタに追加プロパティーが指定されている場合は、それらが表示されます。

      この表を使用して、これらのプロパティーのデフォルト値を変更します。

    7. モジュールを配備するターゲットを選択します。

      利用可能なターゲットのリストから、1 つまたは複数のターゲットを選択して「追加」をクリックします。ターゲットを選択しない場合、モジュールはデフォルトのサーバーインスタンス server に配備されます。

      再配備の場合は、ターゲットを選択しないでください。ここで選択した内容は、すべて無視されます。クラスタやスタンドアロンインスタンスの動的再設定が有効になっている場合、配備されているモジュールを参照する、ターゲットのクラスタ化またはスタンドアロンのすべてのサーバーインスタンスは、新しく再配備されたモジュールを自動的に参照します。サービスを中断せずにモジュールを再配備する方法の詳細については、「段階的アップグレードについて」を参照してください。

  7. 「了解」をクリックしてモジュールを配備します。

同機能を持つ asadmin コマンド

deploy

Procedureライフサイクルモジュールを作成する

ライフサイクルモジュールは、サーバーライフサイクルの 1 つまたは複数のイベントによってトリガーされると、タスクを実行します。このようなサーバーイベントには次のものがあります。

ライフサイクルモジュールは J2EE 仕様の一部ではなく、Application Server の拡張です。

手順
  1. ツリーコンポーネントで、「アプリケーション」ノードを展開します。

  2. 「ライフサイクルモジュール」ノードを選択します。

  3. 「ライフサイクルモジュール」ページで、「新規」をクリックします。

  4. 「ライフサイクルモジュールを作成」ページで、次の設定を指定します。

    1. 「名前」フィールドに、モジュールの機能を示す名前を入力します。

    2. 「クラス名」フィールドに、ライフサイクルモジュールのクラスファイルの完全修飾名を入力します。

    3. ライフサイクルを含む JAR ファイルがサーバーのクラスパスにある場合は、「クラスパス」フィールドを空白のままにしておきます。そうでない場合は、完全修飾パスを入力します。

      クラスパスを指定しない場合は、domain-dir/applications/lifecycle-module/module-name のクラスをアンパックする必要があります。クラスパスを指定する場合は、何もする必要はありません。

    4. 「読み込み順序」フィールドに、100 以上でオペレーティングシステムの MAXINT 値未満の整数を入力します。

      この整数によって、サーバーの起動時にライフサイクルモジュールが読み込まれる順番が決定します。モジュールに指定された数値が小さいほど、早く読み込まれます。

    5. サーバーを起動すると、すでに配備されたライフサイクルモジュールが読み込まれます。

      デフォルトでは、読み込みが失敗した場合も、サーバーは起動操作を継続します。読み込みが失敗したときにサーバーが起動しないようにするには、「読込み時の障害」チェックボックスにチェックマークを付けます。

    6. 配備後には利用できないようにモジュールを無効にする場合は、「無効」ラジオボタンをオンにします。

      ライフサイクルモジュールはサーバーの起動時に呼び出されるため、ライフサイクルモジュールを無効にしても、実際にはサーバーインスタンスが再起動されるまで無効になりません。

    7. モジュールを配備するターゲットを選択します。

      利用可能なターゲットのリストから、1 つまたは複数のターゲットを選択して「追加」をクリックします。ターゲットを選択しない場合、モジュールはデフォルトのサーバーインスタンス server に配備されます。

  5. 「了解」をクリックします。

同機能を持つ asadmin コマンド

create-lifecycle-module

Procedureアプリケーションクライアントモジュールを配備する

アプリケーションクライアントモジュールは、J2EE アプリケーションクライアント JAR ファイルとも呼ばれ、クライアントのサーバー側ルーチンを含んでいます。

手順
  1. ツリーコンポーネントで、「アプリケーション」ノードを展開します。

  2. 「アプリケーションクライアントモジュール」ノードを選択します。

  3. 「アプリケーションクライアントモジュール」ページで、「配備」をクリックします。

  4. 「配備」ページで、JAR ファイルを配備する場所を指定します。

    サーバーマシンとは、Application Server のドメイン管理サーバーを実行しているホストです。クライアントマシンとは、ブラウザを介して管理コンソールを表示しているホストです。

    • ファイルがクライアントマシンにある場合、またはクライアントマシンからファイルにアクセス可能な場合は、ラジオボタンをクリックして、Application Server にアップロードするパッケージファイルを指定します。

      「ブラウズ」をクリックしてファイルを検索するか、またはファイルへの完全パスを入力します。

    • ファイルがサーバーマシンにある場合、またはパッケージ化されていないモジュールを分割ディレクトリから配備する場合は、ラジオボタンをクリックして、サーバーからアクセス可能なパッケージファイルまたはディレクトリパスを指定します。

      ファイルまたはディレクトリへの完全パス名を入力します。分割ディレクトリからの配備は高度な開発者用なので、本稼働環境ではお勧めできません。

  5. 「次へ」をクリックして「アプリケーションクライアントモジュールを配備」ページを表示します。

  6. 「アプリケーションクライアントモジュールを配備」ページで、モジュールの設定を指定します。

    1. 「アプリケーション名」フィールドで、ファイル名のプレフィックスであるデフォルト名を保持するか、または別の名前を入力します。

      ファイルのアップロードを選択した場合は、デフォルト名が表示されます。アプリケーション名は一意である必要があります。

    2. モジュールがすでに配備されている場合は、「再配備」チェックボックスを選択して、再配備します。そうでない場合は、エラーが表示されます。

      また、別のアプリケーション名を選択して、新しい名前で配備することもできます。

    3. 配備の前にファイルの構造やコンテンツを検証するには、「ベリファイア」チェックボックスにチェックマークを付けます。

      大きなアプリケーションの検証は時間がかかる可能性があります。ファイルの破壊や移行不能が想定される場合は検証を行なってください。

    4. モジュールを配備するターゲットを選択します。

      利用可能なターゲットのリストから、1 つまたは複数のターゲットを選択して「追加」をクリックします。ターゲットを選択しない場合、モジュールはデフォルトのサーバーインスタンス server に配備されます。

      再配備の場合は、ターゲットを選択しないでください。ここで選択した内容は、すべて無視されます。クラスタやスタンドアロンインスタンスの動的再設定が有効になっている場合、配備されているモジュールを参照する、ターゲットのクラスタ化またはスタンドアロンのすべてのサーバーインスタンスは、新しく再配備されたモジュールを自動的に参照します。サービスを中断せずにモジュールを再配備する方法の詳細については、「段階的アップグレードについて」を参照してください。

    5. RMI スタブを生成するかどうかを選択します。

      RMI スタブの生成を選択すると、静的 RMI-IIOP スタブが生成され、クライアント JAR ファイルに配置されます。

      クライアント側ルーチンでは次のことを行います。

      • 通常、アプリケーションプロバイダは、クライアント側ルーチンを含む JAR ファイルを出荷します。

      • アプリケーションプロバイダは、asadmin deploy コマンドの --retrieve オプションを指定することにより、クライアント側スタブを取得できます。

  7. 「了解」をクリックしてモジュールを配備します。

同機能を持つ asadmin コマンド

deploy

Procedure配備用のアーカイブファイルを指定する

アプリケーションまたはモジュールのページで「配備」をクリックして、「配備」ページにアクセスします。「配備」ページで、アプリケーションまたはモジュールがパッケージ化されているアーカイブファイルの場所を指定します。

サーバーマシンとは、Application Server のドメイン管理サーバーを実行しているホストです。クライアントマシンとは、ブラウザを介して管理コンソールを表示しているホストです。

手順
  1. ファイルがクライアントマシンにある場合、またはクライアントマシンからファイルにアクセス可能な場合は、ラジオボタンをクリックして、Application Server にアップロードするパッケージファイルを指定します。

    「ブラウズ」をクリックしてファイルを検索するか、またはファイルへの完全パスを入力します。

  2. ファイルがサーバーマシンにある場合、または分割ディレクトリからパッケージ化されていないアプリケーションを配備する場合は、ラジオボタンをクリックして、サーバーからアクセス可能なパッケージファイルまたはディレクトリパスを指定します。

    ファイルまたはディレクトリへの完全パス名を入力します。分割ディレクトリからの配備は高度な開発者用なので、本稼働環境ではお勧めできません。