手順2.1 プラットフォームサービスをスタンドアロンサーバーとして起動

1. Red Hat Enterprise Linux の場合

   コマンドの実行: EAP_HOME/bin/standalone.sh

2. Microsoft Windows Server の場合

   コマンドの実行: EAP_HOME\bin\standalone.bat

3. 別のパラメーターを指定します (任意)

   起動スクリプトに渡すことができる他のパラメーター一覧を出力するには、-h パラメーターを使います。

手順2.2 プラットフォームサービスを管理対象ドメインとして起動

1. Red Hat Enterprise Linux の場合

   コマンドの実行: EAP_HOME/bin/domain.sh

2. Microsoft Windows Server の場合

   コマンドの実行: EAP_HOME\bin\domain.bat

3. 他のパラメーターを起動スクリプトに渡します (任意)

   起動スクリプトに渡すことができる各種パラメーターを確認するには、-h パラメーターを使います。

手順2.3 別の設定でインスタンスを起動

1. 管理対象ドメイン

   管理対象ドメインでは、--domain-config パラメーターに設定ファイルのファイル名をオプションとして指定します。設定ファイルが EAP_HOME/domain/configuration/ ディレクトリにある場合は、フルパスを指定する必要はありません。

   例2.1 Red Hat Enterprise Linux の管理対象ドメインに別の設定ファイルを使用

   [user@host bin]$ ./domain.sh --domain-config=domain-alternate.xml

   例2.2 Microsoft Windows Server の管理対象ドメインに別の設定ファイルを使用

   C:\EAP_HOME\bin> domain.bat --domain-config=domain-alternate.xml

2. スタンドアロンサーバー

   スタンドアロンサーバーでは、--server-config パラメーターに設定ファイルのファイル名をオプションとして指定します。設定ファイルが EAP_HOME/standalone/configuration/ ディレクトリにある場合は、設定ファイルにフルパスを指定する必要はありません。

   例2.3 Red Hat Enterprise Linux のスタンドアロンサーバーに別の設定ファイルを使用

   [user@host bin]$ ./standalone.sh --server-config=standalone-alternate.xml

   例2.4 Microsoft Windows Server のスタンドアロンサーバーに別の設定ファイルを使用

   C:\EAP_HOME\bin> standalone.bat --server-config=standalone-alternate.xml

手順2.4 JBoss Enterprise Application Platform 6 のスタンドアロンインスタンスの停止

1. コマンドラインプロンプトから対話的に起動したインスタンスを停止します。

   JBoss Enterprise Application Platform 6 が実行されているターミナルで Ctrl-C を押します。

2. オペレーティングシステムサービスとして起動されたインスタンスを停止します。

   オペレーティングシステムに応じて、以下のいずれかの手順を実行します。

   • Red Hat Enterprise Linux

     Red Hat Enterprise Linux でサービススクリプトを記述したときは、stop 機能を使用します。これは、スクリプトに記述する必要があります。次に、service scriptname stop を使用できます。ここで scriptname はスクリプトの名前に置き換えます。

   • Microsoft Windows Server

     Microsoft Windows の場合は、net service コマンドを使用するか、コントロールパネルの サービス アプレットからサービスを停止します。

3. バックグラウンドで実行されているインスタンスを停止します (Red Hat Enterprise Linux)。

   1. プロセスリストからインスタンスを特定します。コマンド ps aux |grep "[j]ava -server" を実行することもできます。これにより、ローカルマシンで実行されている各 JBoss Enterprise Application Platform 6 インスタンスの 1 つの結果が返されます。
   2. kill process_ID を実行してプロセスに TERM シグナルを送信します。ここで、process_ID は上記 ps aux コマンドの 2 番目のフィールドにある数字に置き換えます。

手順2.5 サーバーの起動

1. 管理コンソールの Server Instances に移動します。

   1. コンソールの右上から Runtime タブを選択します。
   2. コンソールの左側にあるメニューから Domain Status → Server Instances を選択します。
   

   図2.1 サーバーインスタンス

2. サーバーの選択

   Server Instances のリストから、起動するサーバーを選択します。実行されているサーバーはチェックマークで示されます。

3. Start ボタンをクリックします。

   サーバーリスト上部にある Start ボタンをクリックして、確認ダイアログボックスを開きます。Confirm ボタンをクリックしてサーバーを起動します。
   

   図2.2 サーバーの変更の確認

手順2.6 管理コンソールを使用したサーバーの停止

1. 管理コンソールの Server Instances に移動します。

   1. コンソールの右上から Runtime タブを選択します。
   2. コンソールの左側にあるメニューから Domain Status → Server Instances を選択します。
   

   図2.4 サーバーインスタンス

2. サーバーの選択

   Server Instances のリストから、停止するサーバーを選択します。実行されているサーバーはチェックマークで示されます。

3. Stop ボタンをクリックします。

   サーバーリスト上部にある Stop ボタンをクリックして、確認ダイアログボックスを開きます。Confirm ボタンをクリックしてサーバーを停止します。

1. 開始するバックアップバージョンを特定します。この例では、正常な起動後の最初の変更の前にサーバーモデルのインスタンスが呼び出されます。

   EAP_HOME/configuration/standalone_xml_history/current/standalone.v1.xml 

2. jboss.server.config.dir 下で相対ファイル名を渡し、バックアップモデルのこの設定を用いてサーバーを起動します。

   EAP_HOME/bin/standalone.sh --server-config=standalone_xml_history/current/standalone.v1.xml 

手順2.7 設定スナップショットの撮影および保存

• スナップショットの保存

  take-snapshot 操作を実行して、現在のサーバー設定のコピーを取得します。

  [standalone@localhost:9999 /] :take-snapshot
  {
      "outcome" => "success",
      "result" => "/home/User/EAP_HOME/standalone/configuration/standalone_xml_history/snapshot/20110630-172258657standalone.xml"
  

手順2.8 設定スナップショットのロード

1. ロードするスナップショットを識別します。この例では、スナップショットディレクトリーから以下のファイルが呼び出されます。スナップショットファイルのデフォルトのパスは以下のとおりです。

   EAP_HOME/standalone/configuration/standalone_xml_history/snapshot/20110812-191301472standalone.xml

   スナップショットは相対パスにより表されます。たとえば、上記の例は次のように記述できます。

   jboss.server.config.dir/standalone_xml_history/snapshot/20110812-191301472standalone.xml

2. ファイル名を渡し、選択したスナップショットを用いてサーバーを起動します。

   EAP_HOME/bin/standalone.sh --server-config=standalone_xml_history/snapshot/20110913-164449522standalone.xml

手順2.9 特定のスナップショットの削除

1. ロードするスナップショットを指定します。この例では、スナップショットディレクトリーから以下のファイルが削除されます。

   EAP_HOME/standalone/configuration/standalone_xml_history/snapshot/20110630-165714239standalone.xml

2. :delete-snapshot コマンドを実行して、特定のスナップショットを削除します。以下の例のようにスナップショットの名前を指定します。

   [standalone@localhost:9999 /] :delete-snapshot(name="20110630-165714239standalone.xml")
   {"outcome" => "success"}
   

手順2.10 スナップショットすべてを削除

• :delete-snapshot(name="all") コマンドを以下の例のとおりに実行し、スナップショットをすべて削除します。

  [standalone@localhost:9999 /] :delete-snapshot(name="all")
  {"outcome" => "success"}
  

手順2.11 すべての設定スナップショットのリスト

• すべてのスナップショットのリスト

  :list-snapshotsコマンドを実行して、保存されたすべてのスナップショットをリストします。

  [standalone@localhost:9999 /] :list-snapshots
  {
      "outcome" => "success",
      "result" => {
          "directory" => "/home/hostname/EAP_HOME/standalone/configuration/standalone_xml_history/snapshot",
          "names" => [
              "20110818-133719699standalone.xml",
              "20110809-141225039standalone.xml",
              "20110802-152010683standalone.xml",
              "20110808-161118457standalone.xml",
              "20110912-151949212standalone.xml",
              "20110804-162951670standalone.xml"
          ]
      }
  }
  

手順3.1 管理コンソールへログイン

1. 管理コンソールのスタートページに移動

   Web ブラウザーで管理コンソールに移動します。デフォルトの場所は http://localhost:9990/console/ です。ポート 9990 は管理コンソールのソケットバインディングとして事前定義されています。

2. 管理コンソールへログイン

   以前作成したアカウントのユーザー名とパスワードを入力し、管理コンソールのログイン画面でログインします。
   

   図3.1 管理コンソールのログイン画面

手順3.2 Web ベース管理コンソールの言語の変更

1. 管理コンソールにログインします。

   Web ベースの管理コンソールにログインします。

2. Settings ダイアログを開きます。

   画面の右下付近に Settings ラベルがあります。これをクリックして管理コンソールの設定を開きます。

3. 必要な言語を選択します。

   Locale 選択ボックスから希望の言語を選択します。次に、Save を選択します。確認ボックスに、アプリケーションをリロードする必要があると表示されます。Confirm をクリックします。新しいロケールを使用するために Web ブラウザを更新します。

手順3.3 サーバーの設定

1. 管理コンソールでサーバーの Server Configuration パネルに移動します。

   1. コンソールの右上から Server タブを選択します。
   2. コンソールの左側にある Server Configurations メニュー項目を展開し、リストから該当するサーバーを選択します。
   

   図3.2 サーバー設定

2. サーバー設定の編集

   1. サーバーリストの下にある Edit ボタンをクリックします。
   2. 設定属性を変更します。
   3. サーバーリストの下にある Save ボタンをクリックします。

手順3.4 デプロイメントの追加および検証

1. 管理コンソールの Manage Deployments パネルに移動します。

   1. コンソールの右上から Runtime タブを選択します。
   2. スタンドアロンサーバーの場合、コンソールの左側にある Server メニューを展開し、Manage Deployments を選択します。管理対象ドメインの場合は、コンソールの左側にある Domain メニューを展開し、Manage Deployments を選択します。
   Manage Deployments パネルが表示されます。
   

   図3.3 スタンドアロンデプロイメントの管理

2. デプロイメントコンテンツの追加

   Deployments パネルの右上の Add ボタンを選択します。Upload ダイアログボックスが表示されます。

3. デプロイするファイルの選択

   ダイアログボックスで、Choose File ボタンを選択します。デプロイしたいファイルを見つけ、アップロードするために選択します。ファイルを選択したら、Next ボタンを選択して作業を続行します。
   

   図3.4 デプロイメント選択

4. デプロイメント名の確認

   Upload ダイアログボックスに表示されるデプロイメント名とランタイム名を確認します。名前を確認したら、Save ボタンを選択してファイルをアップロードします。
   

   図3.5 デプロイメント名の確認

手順3.5 サーバー設定の新規作成

1. 管理コンソールの Server Configurations ページに移動します。

   コンソールの右上から Server タブを選択します。

2. 設定の新規作成

   1. Server Configuration パネルの上部にある Add ボタンを選択します。
   2. Create Server Configuration ダイアログで基本的なサーバー設定を編集します。
   3. Save ボタンを選択して、新しいサーバー設定を保存します。

手順3.6 ロギングレベルの編集

1. 管理コンソールの Logging パネルに移動します。

   1. 管理対象ドメインを使用している場合は、コンソールの右上の Profiles タブを選択し、次にコンソールの左側にあるドロップダウンリストから該当するプロファイルを選択します。
   2. 管理対象ドメインとスタンドアロンサーバーのどちらの場合でも、コンソールの左側にあるメニューより Core → Logging と選択します。
   3. コンソール上部の Log Categories タグをクリックします。
   

   図3.7 ロギングパネル

2. ロガー詳細の編集

   Log Categories テーブル内のエントリーの詳細を編集します。
   1. Log Categories テーブル内のエントリを選択し、その下にある Details セクションの Edit ボタンを押します。
   2. Log Level ドロップダウンボックスでカテゴリーのログレベルを設定します。設定したら、Save ボタンを押します。

手順3.7 サーバーグループの新規作成および追加

1. Server Groups のビューに移動します。

   右上隅の Host タブを選択します。
2. 左欄の Server Groups メニューにある Group Configurations タブを選択します。
   

   図3.8 Server Groups ビュー

3. サーバーグループの追加

   Add ボタンをクリックし新規サーバーグループを追加します。

4. サーバーグループの設定

   1. サーバーグループ名を入力します。
   2. サーバーグループを追加するプロファイルを選択します。
   3. サーバーグループを追加するソケットバインディングを選択します。
   4. Save ボタンを押し、新規グループを保存します。
   

   図3.9 Create Server Group ダイアログ

手順3.8 Linux または Windows での CLI の起動

• • Linux での CLI の起動

    コマンドラインで以下のコマンドを入力して、EAP_HOME/bin/jboss-cli.sh ファイルを実行します。

    $ EAP_HOME/bin/jboss-cli.sh

  • Windows での CLI の起動

    ダブルクリックするか、コマンドラインで以下のコマンドを入力して、EAP_HOME\bin\jboss-cli.bat ファイルを実行します。

    C:\>EAP_HOME\bin\jboss-cli.bat

手順3.9 管理 CLI の終了

• quit コマンドの実行

  管理 CLI で、quit コマンドを入力します。

  [domain@localhost:9999 /] quit
  Closed connection to localhost:9999

手順3.10 管理対象サーバーインスタンスへの接続

• connect コマンドを実行します。

  管理 CLI で、connect コマンドを入力します。

  [disconnected /] connect
  Connected to domain controller at localhost:9999

  • Linux システムで管理 CLI を起動する時に管理対象サーバーへ接続するには、--connect パラメーターを使用します。

    $ EAP_HOME/bin/jboss-cli.sh --connect

  • --connect パラメーターは、ホストとサーバーのポートを指定するために使用できます。ポートの値が 9999 であるアドレス 192.168.0.1 に接続するには、次のコマンドを使用します。

    $ EAP_HOME/bin/jboss-cli.sh --connect --controller=192.168.0.1:9999

手順3.11 一般および状況依存ヘルプ

1. help コマンドの実行

   管理 CLI で、help コマンドを入力します。

   [standalone@localhost:9999 /] help

2. 状況依存ヘルプの使用

   管理 CLI で、help -commands 拡張コマンドを入力します。

   [standalone@localhost:9999 /] help --commands

3. 特定のコマンドの詳細については、'--help' を引数として help コマンドを実行してください。

   [standalone@localhost:9999 /]  deploy --help

手順3.12 バッチモードのコマンドおよび操作

1. バッチモードの開始

   batch コマンドを使用してバッチモードを開始します。

   [standalone@localhost:9999 /] batch
   [standalone@localhost:9999 / #]

   バッチモードは、プロンプトでハッシュ記号 (#) で示されます。

2. バッチへの操作要求の追加

   バッチモードが開始されたら、操作要求を通常どおり入力します。操作要求は、入力された順序でバッチに追加されます。
   操作要求のフォーマット化の詳細については、「管理 CLI での操作およびコマンドの使用」 を参照してください。

3. バッチの実行

   操作要求のシーケンス全体が入力されたら、run-batch コマンドを使用してバッチを実行します。

   [standalone@localhost:9999 / #] run-batch
   The batch executed successfully.

   バッチの作業に使用できるコマンドの完全リストは 「CLI のバッチモードコマンド」 を参照してください。

4. 外部ファイルに保存されたバッチコマンド

   頻繁に実行するバッチコマンドは、外部のテキストファイルに保存できます。これらのバッチコマンドをロードするには、ファイルへのフルパスを引数として batch コマンドに渡すか、run-batch コマンドの引数として直接実行します。
   テキストエディターを使用してバッチコマンドファイルを作成できます。1 行に 1 つのコマンドのみががあるようにし、CLI がコマンドにアクセスできなければなりません。
   次のコマンドは、バッチモードで myscript.txt ファイルをロードします。このファイルのすべてのコマンドは編集または削除できます。新しいコマンドを挿入できます。このバッチセッションで変更された内容は myscript.txt ファイルへ保持されません。

   [standalone@localhost:9999 /] batch --file=myscript.txt

   次のコマンドは、myscript.txt ファイルに保存されたバッチコマンドを即時実行します。

   [standalone@localhost:9999 /] run-batch --file=myscript.txt

手順3.13 リクエストの作成、設定、および実行

1. 操作要求の構築

   操作要求では、管理モデルとの低レベルの対話が可能です。この場合、サーバー設定を制御された方法で編集できます。操作要求は、以下の 3 つの部分から構成されます。
   • スラッシュ (/) で始まる アドレス。
   • コロン (:) で始まる 操作名。
   • 丸かっこ「()」で囲まれたパラメーターのオプションセット。

   1. アドレスの決定

      設定はアドレス指定可能なリソースの階層ツリーとして表されます。各リソースノードは、異なる操作セットを提供します。アドレスは、操作を実行するリソースノードを指定します。アドレスでは以下の構文を使用します。

      /node-type=node-name

      • node-type は、リソースノードタイプです。これは、設定 XML の要素名に対してマッピングされます。
      • node-name はリソースノード名です。これは、設定 XML の要素の name 属性に対してマッピングされます。
      • スラッシュ (/) を使用してリソースツリーの各レベルを区切ります。
      設定 XML ファイルを参照して必要なアドレスを決定します。EAP_HOME/standalone/configuration/standalone.xml ファイルは、スタンドアロンサーバーの設定を保持し、EAP_HOME/domain/configuration/domain.xml ファイルと EAP_HOME/domain/configuration/host.xml ファイルは管理対象ドメインの設定を保持します。

      例3.3 操作アドレスの例

      ロギングサブシステムで操作を実行するには、操作要求に以下のアドレスを使用します。

      /subsystem=logging

      Java データソースに対して操作を実行するには、操作要求に以下のアドレスを使用します。

      /subsystem=datasources/data-source=java

   2. 操作の決定

      リソースノードのタイプによって操作は異なります。操作では以下の構文を使用します。

      :operation-name

      • operation-name は、要求する操作の名前です。
      利用可能な操作をリストするために、スタンドアロンサーバーの任意のリソースアドレスで read-operation-names 操作を使用します。

      例3.4 利用可能な操作

      ロギングサブシステムのすべての利用可能な操作をリストするために、スタンドアロンサーバーの以下の要求を入力します。

      [standalone@localhost:9999 /] /subsystem=logging:read-operation-names
      {
          "outcome" => "success",
          "result" => [
              "add",
              "read-attribute",
              "read-children-names",
              "read-children-resources",
              "read-children-types",
              "read-operation-description",
              "read-operation-names",
              "read-resource",
              "read-resource-description",
              "remove",
              "undefine-attribute",
              "whoami",
              "write-attribute"
          ]
      }
      

   3. パラメーターの決定

      各操作では異なるパラメーターが必要な場合があります。
      パラメーターは以下の構文を使用します。

      (parameter-name=parameter-value)

      • parameter-name は、パラメーターの名前です。
      • parameter-value は、パラメーターの値です。
      • 複数のパラメーターは、カンマ (,) で区切られます。
      必要なパラメーターを決定するには、リソースノードで操作名をパラメーターとして渡し、read-operation-description コマンドを実行します。詳細については、例3.5「操作パラメーターの決定」 を参照してください。

      例3.5 操作パラメーターの決定

      ロギングサブシステムで read-children-types 操作に必須のパラメーターを決定するには、以下のように read-operation-description コマンドを入力します。

      [standalone@localhost:9999 /] /subsystem=logging:read-operation-description(name=read-children-types)
      {
          "outcome" => "success",
          "result" => {
              "operation-name" => "read-children-types",
              "description" => "Gets the type names of all the children under the selected resource",
              "reply-properties" => {
                  "type" => LIST,
                  "description" => "The children types",
                  "value-type" => STRING
              },
              "read-only" => true
          }
      }
      

2. 完全操作要求の入力

   アドレス、操作、およびパラメーターが決定されたら、完全操作要求を入力します。

   例3.6 操作要求の例

   [standalone@localhost:9999 /] /subsystem=web/connector=http:read-resource(recursive=true)

手順3.14 選択した属性の現在のランタイム値を表示する

• read-attribute 操作の実行

  管理 CLI より read-attribute を使用してリソース属性の値を表示します。操作要求の詳細は 「管理 CLI での操作およびコマンドの使用」 を参照してください。

  [standalone@localhost:9999 /]:read-attribute(name=name-of-attribute)

手順3.15 whoami を使用した管理 CLI でのアクティブユーザーの表示

• whoami の実行

  管理 CLI より whoami を使用し、アクティブユーザーのアカウントを表示します。

  [standalone@localhost:9999 /] :whoami

  次の例はスタンドアロンサーバーで whoami を使用し、アクティブユーザーは username で ManagementRealm レルムが割り当てられていることを表しています。

  例3.8 スタンドアロンインスタンスでの whoami の使用

  [standalone@localhost:9999 /]:whoami
  {
      "outcome" => "success",
      "result" => {"identity" => {
          "username" => "username",
          "realm" => "ManagementRealm"
      }}
  }
  
  
  

手順3.16 管理 CLI でのシステムおよびサーバー情報の表示

• version コマンドの実行

  管理 CLI で、version コマンドを入力します。

  [domain@localhost:9999 /] version

手順3.17 管理 CLI でのコマンドの実行

• read-operation-description 操作の実行

  管理 CLI で、read-operation-description を使用して、操作に関する情報を表示します。操作ではキーと値のペアの形式でパラメーターを追加して、表示する操作を示す必要があります。操作結果の詳細については、「管理 CLI での操作およびコマンドの使用」 を参照してください。

  [standalone@localhost:9999 /]:read-operation-description(name=name-of-operation)

手順3.18 管理 CLI でのコマンドの実行

• read-operation-names の実行

  管理 CLI より read-operation-names 操作を使用して利用可能な操作の名前を表示します。操作要求の詳細については、トピック「管理 CLI での操作およびコマンドの使用」を参照してください。

  [standalone@localhost:9999 /]:read-operation-names

手順3.19 管理 CLI でのコマンドの実行

1. read-resource 操作の実行

   管理 CLI で、read-resource 操作を使用して利用可能なリソースを表示します。

   [standalone@localhost:9999 /]:read-resource

   以下の例は、スタンドアロンサーバーインスタンスで read-resource 操作を使用して一般的なリソース情報を公開する方法を示しています。結果は standalone.xml 設定ファイルに類似し、サーバーインスタンス向けにインストールまたは設定されたシステムリソース、拡張機能、インターフェース、およびサブシステムを表示します。これらは、さらに直接問い合わせることができます。

   例3.11 ルートレベルでの read-resource 操作の使用

   [standalone@localhost:9999 /]:read-resource
   {
       "outcome" => "success",
       "result" => {
           "deployment" => undefined,
           "deployment-overlay" => undefined,
           "management-major-version" => 1,
           "management-micro-version" => 0,
           "management-minor-version" => 4,
           "name" => "longgrass",
           "namespaces" => [],
           "product-name" => "EAP",
           "product-version" => "6.1.0.GA",
           "release-codename" => "Janus",
           "release-version" => "7.2.0.Final-redhat-3",
           "schema-locations" => [],
           "system-property" => undefined,
           "core-service" => {
               "management" => undefined,
               "service-container" => undefined,
               "server-environment" => undefined,
               "platform-mbean" => undefined
           },
           "extension" => {
               "org.jboss.as.clustering.infinispan" => undefined,
               "org.jboss.as.connector" => undefined,
               "org.jboss.as.deployment-scanner" => undefined,
               "org.jboss.as.ee" => undefined,
               "org.jboss.as.ejb3" => undefined,
               "org.jboss.as.jaxrs" => undefined,
               "org.jboss.as.jdr" => undefined,
               "org.jboss.as.jmx" => undefined,
               "org.jboss.as.jpa" => undefined,
               "org.jboss.as.jsf" => undefined,
               "org.jboss.as.logging" => undefined,
               "org.jboss.as.mail" => undefined,
               "org.jboss.as.naming" => undefined,
               "org.jboss.as.pojo" => undefined,
               "org.jboss.as.remoting" => undefined,
               "org.jboss.as.sar" => undefined,
               "org.jboss.as.security" => undefined,
               "org.jboss.as.threads" => undefined,
               "org.jboss.as.transactions" => undefined,
               "org.jboss.as.web" => undefined,
               "org.jboss.as.webservices" => undefined,
               "org.jboss.as.weld" => undefined
           },
           "interface" => {
               "management" => undefined,
               "public" => undefined,
               "unsecure" => undefined
           },
           "path" => {
               "jboss.server.temp.dir" => undefined,
               "user.home" => undefined,
               "jboss.server.base.dir" => undefined,
               "java.home" => undefined,
               "user.dir" => undefined,
               "jboss.server.data.dir" => undefined,
               "jboss.home.dir" => undefined,
               "jboss.server.log.dir" => undefined,
               "jboss.server.config.dir" => undefined,
               "jboss.controller.temp.dir" => undefined
           },
           "socket-binding-group" => {"standard-sockets" => undefined},
           "subsystem" => {
               "logging" => undefined,
               "datasources" => undefined,
               "deployment-scanner" => undefined,
               "ee" => undefined,
               "ejb3" => undefined,
               "infinispan" => undefined,
               "jaxrs" => undefined,
               "jca" => undefined,
               "jdr" => undefined,
               "jmx" => undefined,
               "jpa" => undefined,
               "jsf" => undefined,
               "mail" => undefined,
               "naming" => undefined,
               "pojo" => undefined,
               "remoting" => undefined,
               "resource-adapters" => undefined,
               "sar" => undefined,
               "security" => undefined,
               "threads" => undefined,
               "transactions" => undefined,
               "web" => undefined,
               "webservices" => undefined,
               "weld" => undefined
           }
       }
   }
   
   
   

2. 子ノードに対する read-resource 操作の実行

   read-resource 操作は、ルートから子ノードを問い合わせるために実行できます。操作の構造は最初に公開するノードを定義し、ノードに対して実行する操作を追加します。

   [standalone@localhost:9999 /]/subsystem=web/connector=http:read-resource

   以下の例では、特定の Web サブシステムノードに対して read-resource 操作を行うことにより、Web サブシステムコンポーネントに関する固有のリソース情報を公開できます。

   例3.12 ルートノードからの子ノードリソースの公開

   [standalone@localhost:9999 /] /subsystem=web/connector=http:read-resource                      
   {
       "outcome" => "success",
       "result" => {
           "configuration" => undefined,
           "enable-lookups" => false,
           "enabled" => true,
           "executor" => undefined,
           "max-connections" => undefined,
           "max-post-size" => 2097152,
           "max-save-post-size" => 4096,
           "name" => "http",
           "protocol" => "HTTP/1.1",
           "proxy-name" => undefined,
           "proxy-port" => undefined,
           "redirect-port" => 443,
           "scheme" => "http",
           "secure" => false,
           "socket-binding" => "http",
           "ssl" => undefined,
           "virtual-server" => undefined
       }
   }
   
   
   

   同じ結果は、cd コマンドを使用して子ノードに移動し、read-resource 操作を直接実行することにより、得ることができます。

   例3.13 ディレクトリーを変更することにより子ノードリソースを公開

   [standalone@localhost:9999 /] cd subsystem=web
   

   [standalone@localhost:9999 subsystem=web] cd connector=http
   

   [standalone@localhost:9999 connector=http] :read-resource
   {
       "outcome" => "success",
       "result" => {
           "configuration" => undefined,
           "enable-lookups" => false,
           "enabled" => true,
           "executor" => undefined,
           "max-connections" => undefined,
           "max-post-size" => 2097152,
           "max-save-post-size" => 4096,
           "name" => "http",
           "protocol" => "HTTP/1.1",
           "proxy-name" => undefined,
           "proxy-port" => undefined,
           "redirect-port" => 443,
           "scheme" => "http",
           "secure" => false,
           "socket-binding" => "http",
           "ssl" => undefined,
           "virtual-server" => undefined
       }
   }
   
   
   

3. 再帰的なパラメーターを使用して結果にアクティブな値を含める

   再帰的なパラメーターを使用して、永続的でない値、起動時に渡された値、またはランタイムモデルでアクティブな他の属性を含むすべての属性の値を公開できます。

   [standalone@localhost:9999 /]/interface=public:read-resource(include-runtime=true)

   以前の例と比較して、include-runtime 要求プロパティーを含めることにより、HTTP コネクターにより送信されたバイトや受信されたバイトなどの追加のアクティブな属性が公開されます。

   例3.14 include-runtime パラメーターを使用して追加でアクティブな値を公開

   [standalone@localhost:9999 /] /subsystem=web/connector=http:read-resource(include-runtime=true)
   {
       "outcome" => "success",
       "result" => {
           "any" => undefined,
           "any-address" => undefined,
           "any-ipv4-address" => undefined,
           "any-ipv6-address" => undefined,
           "inet-address" => expression "${jboss.bind.address:127.0.0.1}",
           "link-local-address" => undefined,
           "loopback" => undefined,
           "loopback-address" => undefined,
           "multicast" => undefined,
           "name" => "public",
           "nic" => undefined,
           "nic-match" => undefined,
           "not" => undefined,
           "point-to-point" => undefined,
           "public-address" => undefined,
           "resolved-address" => "127.0.0.1",
           "site-local-address" => undefined,
           "subnet-match" => undefined,
           "up" => undefined,
           "virtual" => undefined
       }
   }
   
   
   

手順3.20 管理 CLI でのコマンドの実行

1. read-resource-description の実行

   管理 CLI で、read-resource-description 操作を使用して利用可能なリソースを読み取り、表示します。操作要求の詳細については、トピック「管理 CLI での操作およびコマンドの使用」を参照してください。

   [standalone@localhost:9999 /]:read-resource-description

2. オプションパラメーターの使用

   read-resource-description 操作では、追加パラメーターを使用できます。
   1. リソースの操作の説明を表示するには、operations パラメーターを使用します。

      [standalone@localhost:9999 /]:read-resource-description(operations=true)

   2. リソースの継承された操作の説明を表示または非表示にするには、inherited パラメーターを使用します。デフォルトの状態は true です。

      [standalone@localhost:9999 /]:read-resource-description(inherited=false)

   3. 子リソースの操作の再帰的な説明を表示するには、recursive パラメーターを使用します。

      [standalone@localhost:9999 /]:read-resource-description(recursive=true)

   4. リソースの説明を表示するには、locale パラメーターを使用します。null の場合は、デフォルトのロケールが使用されます。

      [standalone@localhost:9999 /]:read-resource-description(locale=true)

手順3.21 アプリケーションのリロード

• reload 操作の実行

  管理 CLI で、reload 操作を使用して System.exit(0) システムコールを介してサーバーをシャットダウンします。操作要求の詳細については、トピック「管理 CLI での操作およびコマンドの使用」を参照してください。

  [standalone@localhost:9999 /]:reload
  {"outcome" => "success"}
  

手順3.22 アプリケーションサーバーのシャットダウン

• shutdown 操作の実行

  • 管理 CLI で、shutdown 操作を使用し System.exit(0) システムコールを介してサーバーをシャットダウンします。操作要求の詳細については、トピック「管理 CLI での操作およびコマンドの使用」を参照してください。
    • スタンドアロンモードでは、次のコマンドを使用します。

      [standalone@localhost:9999 /]:shutdown

    • ドメインモードでは、適切なホスト名を指定して次のコマンドを使用します。

      [domain@localhost:9999 /]/host=master:shutdown

  • デタッチした CLI インスタンスへ接続し、サーバーをシャットダウンするには、次のコマンドを実行します。

    jboss-admin.sh --connect command=:shutdown
    

  • リモート CLI インスタンスへ接続し、サーバーをシャットダウンするには、次のコマンドを実行します。

    [disconnected /] connect IP_ADDRESS
    Connected to IP_ADDRESS:PORT_NUMBER
    [192.168.1.10:9999 /] :shutdown
    

    IP_ADDRESS をインスタンスの IP アドレスに置き換えます。

手順3.23 管理 CLI でのリソース属性の設定

• write-attribute 操作の実行

  管理 CLI で、write-attribute 操作を使用してリソース属性の値を変更します。操作は、完全リソースパスが指定されたリソースの子ノードまたは管理 CLI のルートノードで実行できます。

手順3.24 管理 CLI コマンド履歴の表示

• history コマンドの実行

  管理 CLI で、history コマンドを入力します。

  [standalone@localhost:9999 /] history

手順3.25 管理 CLI コマンド履歴の消去

• history --clear コマンドの実行

  管理 CLI で、history --clear コマンドを入力します。

  [standalone@localhost:9999 /] history --clear

手順3.26 管理 CLI コマンド履歴の無効化

• history --disable コマンドの実行

  管理 CLI で、history --disable コマンドを入力します。

  [standalone@localhost:9999 /] history --disable

手順3.27 管理 CLI コマンド履歴の有効化

• history --enable コマンドの実行

  管理 CLI で、history --enable コマンドを入力します。

  [standalone@localhost:9999 /] history --enable

手順4.1 リモート管理インターフェースに最初の管理ユーザーを作成

1. add-user.sh または add-user.bat スクリプトを呼び出します。

   JPP_HOME/bin/ ディレクトリへ移動します。オペレーティングシステムに対応するスクリプトを呼び出します。

   Red Hat Enterprise Linux

   [user@host bin]$ ./add-user.sh

   Microsoft Windows Server

   C:\bin>  add-user.bat

2. 管理ユーザーの追加を選択します。

   オプション a を選択して管理ユーザーを追加します。このユーザーは ManagementRealm に追加され、Web ベース管理コンソールまたはコマンドラインベース管理 CLI を使用して管理操作を実行することを許可されます。他のオプション b を選択すると、ユーザーが ApplicationRealm に追加され、特定のパーミッションは提供されません。このレルムはアプリケーションで使用するために提供されます。

3. ユーザーのレルムを選択します。

   次のプロンプトは、ユーザーが追加されるレルムを示します。JBoss Enterprise Application Platform 6 を管理するパーミッションを持つユーザーの場合は、デフォルト値 (ManagementRealm) を選択します。

4. 希望のユーザー名とパスワードを入力します。

   入力を促されたら、セキュリティーレルム、ユーザー名、パスワードを入力します。ENTER を押すと、管理インターフェースを使用してユーザーが JBoss Enterprise Application Platform 6 を管理できる ManagementRealm のデフォルトレルムが選択されます。このレルムには最低でも 1 人のユーザーを追加する必要があります。情報を確認するよう促されます。内容が適切である場合は yes と入力します。

5. ユーザーがリモート JBoss Enterprise Application Platform 6 サーバーインスタンスを表すかどうかを選択します。

   管理者以外に、ManagementRealm で JBoss Enterprise Application Platform 6 に追加する必要がある場合がある他の種類のユーザーは、JBoss Enterprise Application Platform 6 の別のインスタンスを表すユーザーであり、メンバーとしてクラスターに参加することを認証できる必要があります。次のプロンプトでは、この目的のために追加されたユーザーを指定できます。yes を選択した場合は、異なる設定ファイルに追加する必要があるユーザーのパスワードを表すハッシュされた secret 値が提供されます。このタスクでは、この質問に対して no と回答してください。

6. 追加ユーザーを入力します。

   希望する場合はこの手順を繰り返して追加のユーザーを入力することができます。また、稼働中のシステムにいつでもユーザーを追加することが可能です。デフォルトのセキュリティーレルムを選択する代わりに他のレルムにユーザーを追加して、承認を細かく調整することが可能です。

7. 非対話的にユーザーを作成します。

   コマンドラインで各パラメーターを渡すと非対話的にユーザーを作成することができます。ログや履歴ファイルにパスワードが表示されるため、この方法は共有システムでは推奨されません。監理レルムを使用した、コマンドの構文は次のとおりです。

   [user@host bin]$ ./add-user.sh usernamepassword

   アプリケーションレルムを使用するには、-a パラメーターを使用します。

   [user@host bin]$ ./add-user.sh -a usernamepassword

8. --silent パラメーターを渡すと add-user スクリプトの通常出力を無効にできます。これは、username および password の最低限のパラメーターが指定されている場合のみ適用されます。エラーメッセージは表示されます。

• インターフェース属性の設定

  必要に応じて、インターフェース属性を設定するために、管理 CLI または管理コンソールを選択します。

  • 管理 CLI でのインターフェース属性の設定

    管理 CLI を使用して、新しいインターフェースを追加し、インターフェース属性に新しい値を書き込みます。

    1. 新しいインターフェースの追加

       必要な場合は、add 操作を使用して新しいインターフェースを作成します。このコマンドは、管理 CLI セッションのルートから実行できます。次の例では、新しいインターフェースの名前タイトル interfacename が 12.0.0.2 と宣言された inet-address とともに作成されます。

       /interface=interfacename/:add(inet-address=12.0.0.2)

    2. インターフェース属性の編集

       write 操作を使用して新しい値を属性に書き込みます。タブ補完を使用して、入力するコマンド文字列を補完したり、利用可能な属性を公開したりできます。以下の例では、inet-address 値を 12.0.0.8 に更新します。

       /interface=interfacename/:write(inet-address=12.0.0.8)

    3. インターフェース属性の編集

       read-resource 操作で include-runtime=true パラメーターを実行して値を変更し、サーバーモデルでアクティブな現在のすべての値を公開します。

       [standalone@localhost:9999 interface=public] :read-resource(include-runtime=true)

  • 管理コンソールでのインターフェース属性の設定

    管理コンソールを使用して、新しいインターフェースを追加し、インターフェース属性に新しい値を書き込みます。

    1. 管理コンソールにログインします。

       管理対象ドメインまたはスタンドアロンサーバーインスタンスの管理コンソールにログインします。

    2. 管理対象ドメインを使用する場合は、適切なプロファイルを選択します。

       右上にある Profiles タブを選択し、次の画面の左上にある Profile メニューから適切なプロファイルを選択します。

    3. ナビゲーションメニューから [Interfaces] 項目を選択します。

       ナビゲーションメニューから [Interfaces] 項目を選択します。

    4. 新しいインターフェースの追加

       1. Add ボタンをクリックします。
       2. Name、Inet Address、および Address Wildcard に必要な値を入力します。
       3. Save をクリックして終了します。

    5. インターフェース属性の編集

       1. 編集するインターフェースを選択し Edit ボタンをクリックします。
       2. Name、Inet Address、および Address Wildcard に必要な値を入力します。
       3. Save をクリックして終了します。

• ソケットバインディンググループのソケットバインディングの設定

  管理 CLI または管理コンソールを選択して、必要に応じてソケットバインディングを設定します。

  • 管理 CLI を使用したソケットバインディングの設定

    管理 CLI を使用してソケットバインディングを設定します。

    1. 新しいソケットバインディングの追加

       add 操作を使用して、必要な場合に新しいアドレス設定を作成します。このコマンドは、管理 CLI セッションのルートから実行できます。この場合、以下の例では、newsocket という新しいソケットバインディングが作成され、port 属性が 1234 として宣言されます。以下の例は、standard-sockets ソケットバインディンググループ上で編集を行うスタンドアロンサーバーおよび管理対象ドメインの両方に適用されます。

       [domain@localhost:9999 /] /socket-binding-group=standard-sockets/socket-binding=newsocket/:add(port=1234)

    2. パターン属性の編集

       write 操作を使用して新しい値を属性に書き込みます。タブ補完を使用して、入力するコマンド文字列を補完したり、利用可能な属性を公開したりできます。以下の例では、port 値を 2020 に更新します。

       [domain@localhost:9999 /] /socket-binding-group=standard-sockets/socket-binding=newsocket/:write-attribute(name=port,value=2020)

    3. パターン属性の確認

       read-resource 操作で include-runtime=true パラメーターを実行して値を変更し、サーバーモデルでアクティブな現在のすべての値を公開します。

       [domain@localhost:9999 /] /socket-binding-group=standard-sockets/socket-binding=newsocket/:read-resource

  • 管理コンソールを使用したソケットバインディングの設定

    管理コンソールを使用してソケットバインディングを設定します。

    1. 管理コンソールへのログイン

       管理対象ドメインまたはスタンドアロンサーバーの管理コンソールにログインします。

    2. Profile tab の選択

       右上の Profiles タブを選択します。

    3. ナビゲーションメニューより Socket Binding を選択

       ナビゲーションメニューから Socket Binding メニュー項目を選択します。管理対象ドメインを使用している場合は Socket Binding Groups メニューから希望のグループを選択します。

    4. 新しいソケットバインディングの追加

       1. Add ボタンをクリックします。
       2. Name、Port、および Binding Group に必要な値を入力します。
       3. Save をクリックして終了します。

    5. インターフェース属性の編集

       1. 編集するソケットバインディングを選択し、Edit ボタンをクリックします。
       2. Name、Interface、または Port など、必要な値を入力します。
       3. Save をクリックして終了します。

• ポートオフセットの設定

  管理 CLI または管理コンソールを選択してポートオフセットを設定します。

  • 管理 CLI を使用したポートオフセットの設定

    管理 CLI を使用してポートオフセットを設定します。

    1. ポートオフセットの編集

       write 操作を使用して新しい値をポートオフセット属性に書き込みます。次の例は、server-two の socket-binding-port-offset 値を 250 に更新します。このサーバーはデフォルトローカルホストグループのメンバーです。変更を有効にするには再起動が必要となります。

       [domain@localhost:9999 /] /host=master/server-config=server-two/:write-attribute(name=socket-binding-port-offset,value=250)

    2. ポートオフセット属性の確認

       read-resource 操作で include-runtime=true パラメーターを実行して値を変更し、サーバーモデルで現在アクティブであるすべての値を公開します。

       [domain@localhost:9999 /] /host=master/server-config=server-two/:read-resource(include-runtime=true)

  • 管理コンソールを使用したポートオフセットの設定

    管理コンソールを使用してポートオフセットを設定します。

    1. 管理コンソールにログインします。

       管理対象ドメインの管理コンソールにログインします。

    2. Hosts タブの選択

       右上の Hosts タブを選択します。

    3. ポートオフセット属性の編集

       1. Configuration Name セクションでサーバーを選択し、Edit ボタンをクリックします。
       2. Port Offset フィールドで必要な値を入力します。
       3. Save ボタンをクリックして終了します。

手順5.1 IPv4 Stack Java プロパティーの無効化

1. インストールに関連するファイルを開きます。

   • スタンドアロンサーバーの場合:

     EAP_HOME/bin/standalone.conf を開きます。

   • 管理対象ドメインの場合:

     EAP_HOME/bin/domain.conf を開きます。
2. IPv4 Stack Java プロパティーを false に変更します。

   -Djava.net.preferIPv4Stack=false

   例：

   # Specify options to pass to the Java VM.
   #
   if [ "x$JAVA_OPTS" = "x" ]; then
      JAVA_OPTS="-Xms64m -Xmx512m -XX:MaxPermSize=256m -Djava.net.preferIPv4Stack=false 
      -Dorg.jboss.resolver.warning=true -Dsun.rmi.dgc.client.gcInterval=3600000 
      -Dsun.rmi.dgc.server.gcInterval=3600000 -Djava.net.preferIPv6Addresses=true"
   fi
   

手順5.2 IPv6 ネットワーキングのインターフェースの設定

1. コンソールの右上にある Profile タブを選択します。
2. General Configuration の Interfaces オプションを選択します。
3. 設定する名前付きネットワークインターフェースを選択します。
4. Edit ボタンをクリックします。
5. 下記の inet アドレスを設定します。

   ${jboss.bind.address.management:[ADDRESS]}

6. Save ボタンをクリックして変更を保存します。
7. サーバーを再起動し、変更を実装します。

手順5.3 IPv6 アドレスを優先するよう JBoss Enterprise Application Platform 6 インストールを設定する

1. インストールに関連するファイルを開きます。

   • スタンドアロンサーバーの場合:

     EAP_HOME/bin/standalone.conf を開きます。

   • 管理対象ドメインの場合:

     EAP_HOME/bin/domain.conf を開きます。
2. 以下の Java プロパティーを Java VM オプションに追加します。

   -Djava.net.preferIPv6Addresses=true

   例：

   # Specify options to pass to the Java VM.
   #
   if [ "x$JAVA_OPTS" = "x" ]; then
      JAVA_OPTS="-Xms64m -Xmx512m -XX:MaxPermSize=256m -Djava.net.preferIPv4Stack=false 
      -Dorg.jboss.resolver.warning=true -Dsun.rmi.dgc.client.gcInterval=3600000 
      -Dsun.rmi.dgc.server.gcInterval=3600000 -Djava.net.preferIPv6Addresses=true"
   fi
   

手順6.1 JDBC ドライバーのデプロイ

1. 管理コンソールへのアクセス

   「管理コンソールへログイン」

2. JAR ファイルをサーバーあるいはサーバーグループにデプロイします。

   管理対象ドメインを使用する場合は、JAR ファイルをサーバーグループにデプロイします。使用しない場合はサーバーにデプロイします。「管理コンソールを使用したアプリケーションのデプロイ」 を参照してください。

手順6.2 コアモジュールとしての JDBC ドライバーのインストール

1. EAP_HOME/modules/ ディレクトリ下にファイルパス構造を作成します。たとえば、MySQL JDBC ドライバーの場合には、EAP_HOME/modules/com/mysql/main/ のようなディレクトリ構造を作成します。
2. JDBC ドライバー JAR を main/ サブディレクトリにコピーします。
3. main/ サブディレクトリに、以下の例のような module.xml ファイルを作成します。

   例6.1 module.xml ファイルの例

   <?xml version="1.0" encoding="UTF-8"?>
   <module xmlns="urn:jboss:module:1.0" name="com.mysql">
     <resources>
       <resource-root path="mysql-connector-java-5.1.15.jar"/>
     </resources>
     <dependencies>
       <module name="javax.api"/>
       <module name="javax.transaction.api"/>
     </dependencies>
   </module>
   
   
   

   モジュール名 com.mysql はそのモジュールのディレクトリ構造と一致する必要があります。
4. サーバーを起動します。
5. 管理 CLI を起動します。
6. 次の CLI コマンドを実行して、JDBC ドライバーモジュールをドライバーとして追加します。

   /subsystem=datasources/jdbc-driver=DRIVER_NAME:add(driver-name=DRIVER_NAME,driver-module-name=MODULE_NAME,driver-xa-datasource-class-name=XA_DATASOURCE_CLASS_NAME)

   例6.2 CLI コマンドの例

   /subsystem=datasources/jdbc-driver=mysql:add(driver-name=mysql,driver-module-name=com.mysql,driver-xa-datasource-class-name=com.mysql.jdbc.jdbc2.optional.MysqlXADataSource)

手順6.3 アプリケーションへの依存関係の追加

• • MANIFEST.MF ファイルの設定

    1. テキストエディターでアプリケーションの META-INF/MANIFEST.MF ファイルを開きます。
    2. JDBC モジュールの依存関係を追加し、ファイルを保存します。

       依存関係: MODULE_NAME

       例6.3 依存関係の例

       依存関係: com.mysql

  • 1. jboss-deployment-structure.xml ファイルの作成

       アプリケーションの META-INF/ または WEB-INF フォルダーで jboss-deployment-structure.xml という名前のファイルを作成します。

       例6.4 サンプル jboss-deployment-structure.xml ファイル

       <jboss-deployment-structure>
         <deployment>
           <dependencies>
             <module name="com.mysql" />
           </dependencies>
         </deployment>
       </jboss-deployment-structure>
       
       
       

手順6.4 管理 CLI または管理コンソールのいずれかを使用したデータソースの作成

• • 管理 CLI

    1. CLI ツールを起動し、サーバーに接続します。
    2. 以下のコマンドを実行して非 XA データソースを作成し、適切に変数を設定します。

       data-source add --name=DATASOURCE_NAME --jndi-name=JNDI_NAME --driver-name=DRIVER_NAME  --connection-url=CONNECTION_URL

    3. データソースを有効にします。

       data-source enable --name=DATASOURCE_NAME

  • 管理コンソール

    1. 管理コンソールへログインします。

    2. 管理コンソールの Datasources パネルに移動します。

       1. • スタンドアロンモード

            コンソールの右上より Profile タブを選択します。

          • ドメインモード

            1. コンソールの右上より Profiles タブを選択します。
            2. 左上のドロップダウンボックスより該当するプロファイルを選択します。
            3. コンソールの左側にある Subsystems メニューを展開します。
       2. コンソールの左側にあるメニューより Connector → Datasources と選択します。
       

       図6.1 データソースパネル

    3. 新しいデータソースの作成

       1. Datasources パネル上部にある Add ボタンを選択します。
       2. Create Datasource ウィザードで新しいデータソースの属性を入力し、Next ボタンを押します。
       3. Create Datasource ウィザードで JDBC ドライバーの詳細を入力し、Next ボタンを押します。
       4. Create Datasource ウィザードで接続設定を入力し、Done ボタンを押します。

手順6.5 非 XA データソースの編集

• • 管理 CLI

    1. 「Management CLI の起動」
    2. write-attribute コマンドを使用してデータソース属性を設定します。

       /subsystem=datasources/data-source=DATASOURCE_NAME:write-attribute(name=ATTRIBUTE_NAME,value=ATTRIBUTE_VALUE)

    3. サーバーを再ロードして変更を確認します。

       :reload

  • 管理コンソール

    1. 「管理コンソールへログイン」

    2. 管理コンソールの Datasources パネルに移動します。

       1. • スタンドアロンモード

            コンソールの右上より Profile タブを選択します。

          • ドメインモード

            1. コンソールの右上より Profiles タブを選択します。
            2. 左上のドロップダウンボックスより該当するプロファイルを選択します。
            3. コンソールの左側にある Subsystems メニューを展開します。
       2. コンソールの左側にあるメニューより Connector → Datasources と選択します。
       

       図6.2 データソースパネル

    3. データソースの編集

       1. Available Datasources リストより関連する データソースを選択します。下にある Attributes パネルにデータソースの属性が表示されます。
       2. Edit ボタンを選択してデータソース属性を編集します。
       3. データソース属性を編集し、作業が終了したら、Save ボタンを選択します。

手順6.6 非 XA データソースの削除

• • 管理 CLI

    1. 「Management CLI の起動」
    2. 次のコマンドを実行して非 XA データソースを削除します。

       data-source remove --name=DATASOURCE_NAME

  • 管理コンソール

    1. 「管理コンソールへログイン」

    2. 管理コンソールの Datasources パネルに移動します。

       1. • スタンドアロンモード

            コンソールの右上より Profile タブを選択します。

          • ドメインモード

            1. コンソールの右上より Profiles タブを選択します。
            2. 左上のドロップダウンボックスより該当するプロファイルを選択します。
            3. コンソールの左側にある Subsystems メニューを展開します。
       2. コンソールの左側にあるメニューより Connector → Datasources と選択します。
       

       図6.3 データソースパネル

    3. 削除する登録済みのデータソースを選択し、コンソールの右上隅にある Remove ボタンをクリックします。

手順6.7 管理 CLI または管理コンソールのいずれかを使用した XA データソースの作成

• • 管理 CLI

    1. 「Management CLI の起動」
    2. 以下のコマンドを実行して XA データソースを作成し、適切に変数を設定します。

       xa-data-source add --name=XA_DATASOURCE_NAME --jndi-name=JNDI_NAME --driver-name=DRIVER_NAME --xa-datasource-class=XA_DATASOURCE_CLASS

    3. XA データソースプロパティーの設定

       1. サーバー名の設定

          次のコマンドを実行し、ホストのサーバー名を設定します。

          /subsystem=datasources/xa-data-source=XA_DATASOURCE_NAME/xa-datasource-properties=ServerName:add(value=HOSTNAME)

       2. データベース名の設定

          次のコマンドを実行し、データベース名を設定します。

          /subsystem=datasources/xa-data-source=XA_DATASOURCE_NAME/xa-datasource-properties=DatabaseName:add(value=DATABASE_NAME)

    4. データソースを有効にします。

       xa-data-source enable --name=XA_DATASOURCE_NAME

  • 管理コンソール

    1. 「管理コンソールへログイン」

    2. 管理コンソールの Datasources パネルに移動します。

       1. • スタンドアロンモード

            コンソールの右上より Profile タブを選択します。

          • ドメインモード

            1. コンソールの右上より Profiles タブを選択します。
            2. 左上のドロップダウンボックスより該当するプロファイルを選択します。
            3. コンソールの左側にある Subsystems メニューを展開します。
       2. コンソールの左側にあるメニューより Connector → Datasources と選択します。
       

       図6.4 データソースパネル

    3. XA Datasource パネルを選択します。

    4. 新しい XA データソースの作成

       1. XA Datasource パネルの上にある Add ボタンを選択します。
       2. Create XA Datasource ウィザードに新しい XA データソースの属性を入力し、Next ボタンを押します。
       3. Create XA Datasource ウィザードに JDBC ドライバーの詳細を入力し、Next ボタンを押します。
       4. XA プロパティーを編集し、Next ボタンを押します。
       5. Create XA Datasource ウィザードに接続設定を入力し、Done ボタンを押します。

手順6.8 管理 CLI または管理コンソールのいずれかを使用した XA データソースの編集

• • 管理 CLI

    1. 「Management CLI の起動」

    2. XA データソース属性の設定

       write-attribute コマンドを使用してデータソース属性を設定します。

       /subsystem=datasources/xa-data-source=XA_DATASOURCE_NAME:write-attribute(name=ATTRIBUTE_NAME,value=ATTRIBUTE_VALUE)

    3. XA データソースプロパティーの設定

       次のコマンドを実行して XA データソースサブリソースを設定します。

       /subsystem=datasources/xa-data-source=DATASOURCE_NAME/xa-datasource-properties=PROPERTY_NAME:add(value=PROPERTY_VALUE)

    4. サーバーを再ロードして変更を確認します。

       :reload

  • 管理コンソール

    1. 「管理コンソールへログイン」

    2. 管理コンソールの Datasources パネルに移動します。

       1. • スタンドアロンモード

            コンソールの右上より Profile タブを選択します。

          • ドメインモード

            1. コンソールの右上より Profiles タブを選択します。
            2. 左上のドロップダウンボックスより該当するプロファイルを選択します。
            3. コンソールの左側にある Subsystems メニューを展開します。
       2. コンソールの左側にあるメニューより Connector → Datasources と選択します。
       

       図6.5 データソースパネル

    3. XA Datasource パネルを選択します。

    4. データソースの編集

       1. Available XA Datasources リストより関連する XA データソースを選択します。下にある Attributes パネルに XA データソースの属性が表示されます。
       2. Edit ボタンを選択してデータソース属性を編集します。
       3. XA データソースの属性を編集し、終わったら Save ボタンを選択します。

手順6.9 管理 CLI または管理コンソールのいずれかを使用した XA データソースの削除

• • 管理 CLI

    1. 「Management CLI の起動」
    2. 次のコマンドを実行して XA データソースを削除します。

       xa-data-source remove --name=XA_DATASOURCE_NAME

  • 管理コンソール

    1. 「管理コンソールへログイン」

    2. 管理コンソールの Datasources パネルに移動します。

       1. • スタンドアロンモード

            コンソールの右上より Profile タブを選択します。

          • ドメインモード

            1. コンソールの右上より Profiles タブを選択します。
            2. 左上のドロップダウンボックスより該当するプロファイルを選択します。
            3. コンソールの左側にある Subsystems メニューを展開します。
       2. コンソールの左側にあるメニューより Connector → Datasources と選択します。
       

       図6.6 データソースパネル

    3. XA Datasource パネルを選択します。
    4. 削除する登録済みの XA データソースを選択し、コンソールの右上隅にある Remove ボタンをクリックします。

手順6.10

• /subsystem=datasources/data-source=ExampleDS/statistics=jdbc:read-resource(include-runtime=true)
  

  /subsystem=datasources/data-source=ExampleDS/statistics=pool:read-resource(include-runtime=true)
  

手順9.1 管理コンソールの使用によるアプリケーションのデプロイメント

1. 管理コンソールの Manage Deployments パネルに移動します。

   1. コンソールの右上から Runtime タブを選択します。
   2. コンソールの左側のメニューから Deployments → Manage Deployments オプションを選択します。

2. アプリケーションのデプロイメント

   デプロイメントの方法は、デプロイメント先がスタンドアロンサーバーインスタンスまたは管理対象ドメインのどちらになるかによって異なります。

   • スタンドアロンサーバーインスタンスへのデプロイメント

     Deployments の表に利用可能なアプリケーションデプロイメントとその状態が表示されます。
     

     図9.1 利用可能なデプロイメント

     1. スタンドアロンサーバーインスタンスでのアプリケーションの有効化

        Deployments の表のEnable ボタンをクリックし、アプリケーションのデプロイメントを有効にします。

     2. 確定

        confirm ボタンをクリックし、サーバーインスタンスでのアプリケーションの有効化を確定します。
        

        図9.2 スタンドアロンサーバーで利用可能なデプロイメント

   • 管理対象ドメインへのデプロイメント

     Deployment Content 部には、 Content Repository の表が含まれており、利用可能なアプリケーションデプロイメントとその状態がすべて表示されます。
     

     図9.3 管理対象ドメインで利用可能なデプロイメント

     1. 管理対象ドメインでのアプリケーションの有効化

        Content Repository の表から Add to Groups ボタンをクリックします。

     2. サーバーグループの選択

        アプリケーションを追加したいサーバーグループのボックスにチェックマークを付け、Save ボタンをクリックして続行します。
        

        図9.4 アプリケーションデプロイメントでのサーバーグループの選択

     3. 確定

        Server Group Deployments タブをクリックし、Server Groups の表を表示します。お使いのアプリケーションは先ほど選択したサーバーグループにデプロイされています。
        

        図9.5 サーバーグループにアプリケーションがデプロイされているかを確認

手順9.2 管理コンソールを使用してアプリケーションをアンデプロイ

1. 管理コンソールの Manage Deployments パネルに移動します。

   1. コンソールの右上から Runtime タブを選択します。
   2. コンソールの左側のメニューから Deployments → Manage Deployments オプションを選択します。

2. アプリケーションのアンデプロイ

   アンデプロイする方法は、デプロイ先がスタンドアロンサーバーインスタンスまたは管理対象ドメインのどちらになるかによって異なります。

   • スタンドアロンサーバーインスタンスからのアンデプロイ

     Deployments の表で利用可能なアプリケーションデプロイメントとその状態が表示されます。
     

     図9.6 利用可能なデプロイメント

     1. スタンドアロンサーバーインスタンスでのアプリケーションの無効化

        Deployments の表の Disable ボタンをクリックし、アプリケーションを無効にします。

     2. アプリケーションの無効化を確定

        confirm ボタンをクリックし、サーバーインスタンスでのアプリケーションの無効化を確定します。
        

        図9.7 アプリケーションの無効化を確定

   • 管理対象ドメインからのアンデプロイ

     Deployment Content 部には、 Content Repository の表が含まれており、利用可能なアプリケーションデプロイメントとその状態がすべて表示されます。
     

     図9.8 管理対象ドメインで利用可能なデプロイメント

     1. 管理対象ドメインのアプリケーションを無効化

        Server Group Deployments をクリックすると、サーバーグループとそのグループにデプロイされたアプリケーションの状態が表示されます。
        

        図9.9 サーバーグループのデプロイメント

     2. サーバーグループの選択

        Server Group の表からサーバー名をクリックし、そのサーバーからアプリケーションをアンデプロイします。

     3. 選択したサーバーからアプリケーションを無効化

        disable ボタンをクリックし、選択したサーバーのアプリケーションを無効にします。

     4. アプリケーションの無効化を確定

        confirm ボタンをクリックし、サーバーインスタンスでのアプリケーションの無効化を確定します。
        

        図9.10 アプリケーションの無効化を確定

     5. 残りのサーバーグループを繰り返しアンデプロイ

        必要に応じて、他のサーバーグループにも同じ手順を繰り返します。Deployments の表の各サーバーグループに対してアプリケーションの状態が確定されます。
        

        図9.11 サーバーグループにアプリケーションがデプロイされているかを確認

手順9.3 管理対象ドメインにアプリケーションをデプロイ

• deploy コマンドの実行

  管理 CLI で、アプリケーションデプロイメントへのパスを指定して deploy コマンドを入力します。すべてのサーバーグループをデプロイするために --all-server-groups パラメーターを追加します。

  [domain@localhost:9999 /] deploy /path/to/test-application.war --all-server-groups
  'test-application.war' deployed successfully.

  • または、--server-groups パラメーターを追加して、デプロイメントに固有なサーバーグループを定義します。

    [domain@localhost:9999 /] deploy /path/to/test-application.war --server-groups server_group_1, server_group_2 
    'test-application.war' deployed successfully.

手順9.4 管理対象ドメインでアプリケーションをアンデプロイ

• undeploy コマンドの実行

  管理 CLI で、アプリケーションデプロイメントのファイル名を指定して undeploy コマンドを入力します。--all-relevant-server-groups パラメーターを追加すると、アプリケーションがデプロイされたすべてのサーバーグループからアプリケーションをアンデプロイできます。

  [domain@localhost:9999 /]undeploytest-application.war--all-relevant-server-groupsSuccessfully undeployed test-application.war.