手順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. 編集するホスト設定ファイル (例: host.xml) を開きます。
2. ファイルにある host 要素を見つけます。以下に例を示します。

   <host name="master" xmlns="urn:jboss:domain:1.6">

3. この要素が存在する場合は、name="HOST_NAME" 属性宣言を削除します。削除後、host 要素は以下のようになるはずです。

   <host xmlns="urn:jboss:domain:1.6">

4. 以下の例のように、-Djboss.host.name 引数を渡してサーバーを起動します。

   -Djboss.host.name=HOST_NAME

手順2.4 特定の名前を用いたホスト名の設定

1. 以下の構文を使用して、JBoss EAP スレーブホストを起動します。

   bin/domain.sh --host-config=HOST_FILE_NAME

   例を以下に示します。

   bin/domain.sh --host-config=host-slave01.xml

2. 管理 CLI を起動します。
3. 以下の構文を使用してホスト名を置き換えます。

   /host=EXISTING_HOST_NAME:write-attribute(name="name",value=UNIQUE_HOST_NAME)

   例を以下に示します。

   /host=master:write-attribute(name="name",value="host-slave01")

   次の結果が表示されるはずです。

    "outcome" => "success"

   これは、host-slave01.xml ファイルのホスト name 属性を以下のように変更します。

   <host name="host-slave01" xmlns="urn:jboss:domain:1.6">

4. この処理を完了するには、変更前のホスト名を使用してサーバー設定をリロードする必要があります。

   reload --host=EXISTING_HOST_NAME

   例を以下に示します。

   reload --host=master

手順2.5 2 台のマシンで管理対象ドメインを作成

1. マシン 1 での作業

   1. ホストがドメインコントローラーを認証できるようにするために、add-user.sh スクリプトを使用して管理ユーザー (例: slave01) を追加します。add-user 出力の SECRET_VALUE に注意してください。
   2. 専用のドメインコントローラー向けに事前設定された host-master.xml 設定ファイルでドメインを起動します。
   3. -bmanagement=$IP1 を使用して、他のマシンがドメインコントローラーを見えるようにします。

      [$JBOSS_HOME/bin]$ ./domain.sh --host-config=host-master.xml -bmanagement=$IP1

2. マシン 2 での作業

   1. ユーザークレデンシャルを用いて $JBOSS_HOME/domain/configuration/host-slave.xml ファイルを更新します。

      	<?xml version='1.0' encoding='UTF-8'?>
              <host xmlns="urn:jboss:domain:1.6" name="slave01">   
              <!-- add user name here -->
               <management>
                  <security-realms>
                     <security-realm name="ManagementRealm">
                        <server-identities>
                          <secret value="$SECRET_VALUE" />   
                          <!-- use secret value from add-user.sh output-->
                        </server-identities> 
                        ...

   2. ホストを起動します。

      [$JBOSS_HOME/bin]$ ./domain.sh --host-config=host-slave.xml  -Djboss.domain.master.address=$IP1 -b=$IP2

3. ドメインを管理します。

   CLI を使用する場合:

   [$JBOSS_HOME/bin]$ ./jboss-cli.sh -c --controller=$IP1

   Web コンソールを使用する場合:

   http://$IP1:9990

   サーバーのインデックスページへアクセスします。

   http://$IP2:8080/
   http://$IP2:8230/

手順2.6 代替設定を用いたインスタンスの起動

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

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

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

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

   この例は、EAP_HOME/standalone/configuration/standalone-alternate.xml 設定ファイルを使用します。

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

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

   この例は、EAP_HOME\standalone\configuration\standalone-alternative.xml 設定ファイルを使用します。

2. 管理対象ドメイン

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

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

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

   この例は、EAP_HOME/domain/configuration/domain-alternate.xml 設定ファイルを使用します。

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

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

   この例は、EAP_HOME\domain\configuration\domain-alternate.xml 設定ファイルを使用します。

手順2.10 管理対象ドメイン向けのサーバーの起動

1. コンソールの右上にある Runtime タブを選択します。Server メニューを展開し、Overview を選択します。
2. Server Instances のリストから、起動するサーバーを選択します。実行されているサーバーはチェックマークで示されます。
   このリストにあるインスタンスにカーソルを合わせ、サーバーの詳細の下に青色でオプションを表示します。
3. インスタンスを起動するには、表示された Start Server テキストをクリックします。クリックすると、ダイアログボックスが開きます。Confirm ボタンをクリックしてサーバーを起動します。

手順2.11 管理コンソールを使用した管理対象ドメインのサーバーの停止

1. コンソールの右上にある Runtime タブを選択します。Domain メニューを展開し、Overview を選択します。
2. Hosts, groups and server instances の表に使用可能な Server Instances のリストが表示されます。稼働中のサーバーにはチェックマークが付きます。
3. 選択したサーバーにカーソルを合わせ、表示される Stop Server テキストをクリックします。確認ダイアログウインドウが表示されます。
4. Confirm をクリックし、サーバーを停止します。

手順2.12 jboss-descriptor-property-replacement

1. 管理 CLI では、次のコマンドを実行して jboss-descriptor-property-replacement の値を決定します。

   /subsystem=ee:read-attribute(name="jboss-descriptor-property-replacement")

2. 次のコマンドを実行して動作を設定します。

   /subsystem=ee:write-attribute(name="jboss-descriptor-property-replacement",value=VALUE)

手順2.13 spec-descriptor-property-replacement

1. 管理 CLI では、次のコマンドを実行して spec-descriptor-property-replacement の値を確認します。

   /subsystem=ee:read-attribute(name="spec-descriptor-property-replacement")

2. 次のコマンドを実行して動作を設定します。

   /subsystem=ee:write-attribute(name="spec-descriptor-property-replacement",value=VALUE)

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

   EAP_HOME/standalone/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.14 設定スナップショットの撮影および保存

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

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

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

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

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.16 特定のスナップショットの削除

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.17 スナップショットすべてを削除

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

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

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

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

  :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"
          ]
      }
  }

1. 管理コンソールのスタートページへのアクセス

   Web ブラウザーを起動し、Web ブラウザーで管理コンソール (http://localhost:9990/console/App.html) に移動します。

   注記

   ポート 9990 は、管理コンソールソケットバインディングとして事前定義されています。
2. 以前作成したアカウントのユーザー名とパスワードを入力し、管理コンソールのログイン画面にログインします。
   

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

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

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

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

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

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

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

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

手順3.2 サーバーの設定

1. コンソールの上部より Domain タブを選択します。利用可能なサーバーインスタンスの表が表示されます。
2. Available Server Configurations テーブルよりサーバーインスタンスを選択します。
3. 選択したサーバーの詳細の上にある Edit ボタンをクリックします。
4. 設定属性を変更します。
5. Save をクリックして終了します。

1. コンソールの上部より Runtime タブを選択します。
2. スタンドアロンサーバーの場合は、Server メニューを展開し、Manage Deployments を選択します。管理対象ドメインの場合は、Domain メニューを展開し、Manage Deployments を選択します。Manage Deployments パネルが表示されます。
3. Content Repository タブの Add を選択します。Create Deployment ダイアログボックスが表示されます。
4. ダイアログボックスの Browse をクリックします。デプロイするファイルを選択し、アップロードします。Next をクリックして作業を続行します。
5. Create Deployments ダイアログボックスに表示されるデプロイメント名とランタイム名を確認します。名前を確認したら、Save をクリックし、ファイルをアップロードします。

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

1. 管理コンソールの Server Configurations ページへの移動

   コンソールの上部にある Domain タブを選択します。

2. 設定の新規作成

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

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

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

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

2. ロガー詳細の編集

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

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

1. Server Groups ビューへの移動

   コンソールの上部にある Domain タブを選択します。
2. 左側の列にあるメニューの Server ラベルを展開します。Server Groups を選択します。

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

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

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

   1. サーバーグループ名を入力します。
   2. サーバーグループのプロファイルを選択します。
   3. サーバーグループのソケットバインディングを選択します。
   4. Save ボタンをクリックし、新たに作成したグループを保存します。

手順3.6 Linux または Microsoft Windows Server での CLI の起動

• • Linux での CLI の起動

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

    $ EAP_HOME/bin/jboss-cli.sh

  • Microsoft Windows Server での CLI の起動

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

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

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

• 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

1. 一般的なヘルプの場合

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

   [standalone@localhost:9999 /] help

2. 状況依存ヘルプの取得

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

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

3. 特定のコマンドの詳細な説明については、そのコマンドとその後に --help を入力してください。

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

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

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.9 要求の作成、設定、および実行

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.10 選択した属性の現在のランタイム値を表示

• read-attribute 操作の実行

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

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

手順3.11 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.12 管理 CLI でのシステムおよびサーバー情報の表示

• version コマンドの実行

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

  [domain@localhost:9999 /] version

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

• read-operation-description 操作の実行

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

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

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

• read-operation-names の実行

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

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

手順3.15 管理 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.3.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.16 管理 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.17 アプリケーションサーバーのシャットダウン

• shutdown 操作の実行

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

      [standalone@localhost:9999 /]:shutdown

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

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

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

    jboss-cli.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.18 管理 CLI でのリソース属性の設定

• write-attribute 操作の実行

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

手順3.19 管理 CLI を使用したシステムプロパティーの設定

1. JBoss EAP サーバーを起動します。
2. ご使用のオペレーティングシステム向けのコマンドを使用して、管理 CLI を起動します。
   Linux の場合:

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

   Windows の場合:

   EAP_HOME\bin\jboss-cli.bat --connect

3. システムプロパティーを追加します。
   使用するコマンドは、スタンドアロンサーバーと管理対象ドメインのどちらを実行しているかによって異なります。管理対象ドメインを実行している場合、ドメインで稼働しているすべてのサーバーへシステムプロパティーを追加できます。
   • 以下の構文を使用して、スタンドアロンサーバーでシステムプロパティーを追加します。

     /system-property=PROPERTY_NAME:add(value=PROPERTY_VALUE)

     例3.17 システムプロパティーをスタンドアロンサーバーへ追加

     [standalone@localhost:9999 /] /system-property=property.mybean.queue:add(value=java:/queue/MyBeanQueue)
     {"outcome" => "success"}

   • 以下の構文を使用して、管理対象ドメインのすべてのホストおよびサーバーへシステムプロパティーを追加します。

     /system-property=PROPERTY_NAME:add(value=PROPERTY_VALUE)

     例3.18 管理対象ドメインのすべてのサーバーへシステムプロパティーを追加

     [domain@localhost:9999 /] /system-property=property.mybean.queue:add(value=java:/queue/MyBeanQueue)
     {
         "outcome" => "success",
         "result" => undefined,
         "server-groups" => {"main-server-group" => {"host" => {"master" => {
             "server-one" => {"response" => {"outcome" => "success"}},
             "server-two" => {"response" => {"outcome" => "success"}}
         }}}}
     }

   • 以下の構文を使用して、管理対象ドメインのホストおよびそのサーバーインスタンスへシステムプロパティーを追加します。

     /host=master/system-property=PROPERTY_NAME:add(value=PROPERTY_VALUE)

     例3.19 システムプロパティーをドメインのホストおよびそのサーバーへ追加

     [domain@localhost:9999 /] /host=master/system-property=property.mybean.queue:add(value=java:/queue/MyBeanQueue)
     {
         "outcome" => "success",
         "result" => undefined,
         "server-groups" => {"main-server-group" => {"host" => {"master" => {
             "server-one" => {"response" => {"outcome" => "success"}},
             "server-two" => {"response" => {"outcome" => "success"}}
         }}}}
     }

   • 以下の構文を使用して、管理対象ドメインのサーバーインスタンスにシステムプロパティーを追加します。

     /host=master/server-config=server-one/system-property=PROPERTY_NAME:add(value=PROPERTY_VALUE)

     例3.20 システムプロパティーを管理対象ドメインのサーバーインスタンスへ追加

     [domain@localhost:9999 /] /host=master/server-config=server-one/system-property=property.mybean.queue:add(value=java:/queue/MyBeanQueue)
     {
         "outcome" => "success",
         "result" => undefined,
         "server-groups" => {"main-server-group" => {"host" => {"master" => {"server-one" => {"response" => {"outcome" => "success"}}}}}}
     }

4. システムプロパティーを読み取ります。
   使用するコマンドは、スタンドアロンサーバーと管理対象ドメインのどちらを実行しているかによって異なります。
   • 以下の構文を使用して、スタンドアロンサーバーからシステムプロパティーを読み取ります。

     /system-property=PROPERTY_NAME:read-resource

     例3.21 スタンドアロンサーバーからシステムプロパティーの読み取り

     [standalone@localhost:9999 /] /system-property=property.mybean.queue:read-resource
     {
         "outcome" => "success",
         "result" => {"value" => "java:/queue/MyBeanQueue"}
     }

   • 以下の構文を使用して、管理対象ドメインのすべてのホストおよびサーバーからシステムプロパティーを読み取ります。

     /system-property=PROPERTY_NAME:read-resource

     例3.22 管理対象ドメインのすべてのサーバーからシステムプロパティーを読み取り

     [domain@localhost:9999 /] /system-property=property.mybean.queue:read-resource
     {
         "outcome" => "success",
         "result" => {
             "boot-time" => true,
             "value" => "java:/queue/MyBeanQueue"
         }
     }

   • 以下の構文を使用して、管理対象ドメインのホストおよびそのサーバーインスタンスからシステムプロパティーを読み取ります。

     /host=master/system-property=PROPERTY_NAME:read-resource

     例3.23 ドメインのホストおよびそのサーバーからシステムプロパティーを読み取り

     [domain@localhost:9999 /] /host=master/system-property=property.mybean.queue:read-resource
     {
         "outcome" => "success",
         "result" => {
             "boot-time" => true,
             "value" => "java:/queue/MyBeanQueue"
         }
     }

   • 以下の構文を使用して、管理対象ドメインのサーバーインスタンスからシステムプロパティーを読み取ります。

     /host=master/server-config=server-one/system-property=PROPERTY_NAME:read-resource

     例3.24 管理対象ドメインのサーバーインスタンスからシステムプロパティーを読み取り

     [domain@localhost:9999 /] /host=master/server-config=server-one/system-property=property.mybean.queue:read-resource
     {
         "outcome" => "success",
         "result" => {
             "boot-time" => true,
             "value" => "java:/queue/MyBeanQueue"
         }
     }

5. システムプロパティーを削除します。
   使用するコマンドは、スタンドアロンサーバーと管理対象ドメインのどちらを実行しているかによって異なります。
   • 以下の構文を使用して、スタンドアロンサーバーからシステムプロパティーを削除します。

     /system-property=PROPERTY_NAME:remove

     例3.25 スタンドアロンサーバーからシステムプロパティーを削除

     [standalone@localhost:9999 /] /system-property=property.mybean.queue:remove
     {"outcome" => "success"}

   • 以下の構文を使用して、管理対象ドメインのすべてのホストおよびサーバーからシステムプロパティーを削除します。

     /system-property=PROPERTY_NAME:remove

     例3.26 ドメインのホストおよびそのサーバーからシステムプロパティーを削除

     [domain@localhost:9999 /] /system-property=property.mybean.queue:remove
     {
         "outcome" => "success",
         "result" => undefined,
         "server-groups" => {"main-server-group" => {"host" => {"master" => {
             "server-one" => {"response" => {"outcome" => "success"}},
             "server-two" => {"response" => {"outcome" => "success"}}
         }}}}
     }

   • 以下の構文を使用して、管理対象ドメインのホストおよびそのサーバーインスタンスからシステムプロパティーを削除します。

     /host=master/system-property=PROPERTY_NAME:remove

     例3.27 ドメインのホストおよびそのインスタンスからシステムプロパティーを削除

     [domain@localhost:9999 /] /host=master/system-property=property.mybean.queue:remove
     {
         "outcome" => "success",
         "result" => undefined,
         "server-groups" => {"main-server-group" => {"host" => {"master" => {
             "server-one" => {"response" => {"outcome" => "success"}},
             "server-two" => {"response" => {"outcome" => "success"}}
         }}}}
     }

   • 以下の構文を使用して、管理対象ドメインのサーバーインスタンスからシステムプロパティーを削除します。

     /host=master/server-config=server-one/system-property=PROPERTY_NAME:remove

     例3.28 管理対象ドメインのサーバーからシステムプロパティーを削除

     [domain@localhost:9999 /] /host=master/server-config=server-one/system-property=property.mybean.queue:remove
     {
         "outcome" => "success",
         "result" => undefined,
         "server-groups" => {"main-server-group" => {"host" => {"master" => {"server-one" => {"response" => {"outcome" => "success"}}}}}}
     }

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

• history コマンドの実行

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

  [standalone@localhost:9999 /] history

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

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

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

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

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

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

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

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

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

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

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

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

手順3.24 syslog サーバーへのロギングの有効化

1. msyslog という名前の syslog ハンドラーを作成します。

   [standalone@localhost:9999 /]batch
   [standalone@localhost:9999 /]/core-service=management/access=audit/syslog-handler=mysyslog:add(formatter=json-formatter)
   [standalone@localhost:9999 /]/core-service=management/access=audit/syslog-handler=mysyslog/protocol=udp:add(host=localhost,port=514)
   [standalone@localhost:9999 /]run-batch

2. syslog ハンドラーへの参照を追加します。

   [standalone@localhost:9999 /]/core-service=management/access=audit/logger=audit-log/handler=mysyslog:add

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

1. add-user.sh または add-user.bat スクリプトを実行します。

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

   Red Hat Enterprise Linux

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

   Microsoft Windows Server

   C:\bin>  add-user.bat

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

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

3. ユーザー名とパスワードを入力します。

   ユーザー名とパスワードの入力を要求されたら入力します。入力後、パスワードを確認するよう指示されます。

4. グループ情報を入力します。

   ユーザーが属するグループを追加します。ユーザーが複数のグループに属する場合は、カンマ区切りリストを入力します。ユーザーがどのグループにも属さない場合は空白のままにします。

5. 情報を確認します。

   情報を確認するよう指示されます。情報が正しければ yes を入力します。

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

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

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

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

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

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

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

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

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

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

手順4.2 代替プロパティーファイルの指定

• • サーバー設定の代替のディレクトリーを指定するには、-sc 引数を使用します。この引数は、サーバー設定プロパティーファイルが含まれる代替のディレクトリーを指定します。
  • ドメイン設定の代替のディレクトリーを指定するには、-dc 引数を使用します。この引数は、ドメイン設定プロパティーファイルが含まれる代替のディレクトリーを指定します。
  • 代替のユーザー設定プロパティーファイルを指定するには、-up または --user-properties 引数を使用します。絶対パスを使用でき、代替の設定ディレクトリーを指定する -sc または -dc 引数と共に使用されるファイル名を使用することもできます。
  • 代替のグループ設定プロパティーファイルを指定するには、-gp または --group-properties 引数を使用します。絶対パスを使用でき、代替の設定ディレクトリーを指定する -sc または -dc 引数と共に使用されるファイル名を使用することもできます。

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

  タブ補完を使用して、入力しながらコマンド文字列を補完したり、利用可能な属性を表示したりできます。

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

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

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

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

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

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

       write-attribute 操作は、新しい値を属性に書き込みます。以下の例では、inet-address の値を 12.0.0.8 に更新します。

       /interface=interfacename/:write-attribute(name=inet-address, value=12.0.0.8)

    3. インターフェース属性の検証

       属性の値が変更されたことを確認するため、include-runtime=true パラメーターを使用して read-resource 操作を実行し、サーバーモデルで有効な現在の値をすべて表示します。例は次のとおりです。

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

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

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

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

    2. インターフェース画面への移動

       1. Configuration タブへ移動します。

          画面の上部から Configuration タブを選択します。

       2. ドメインモードのみ

          画面の左上にある Profile ドロップダウンメニューからプロファイルを選択します。

    3. ナビゲーションメニューからの Interfaces の選択

       General Configuration メニューを展開します。ナビゲーションメニューから Interfaces メニューを選択します。

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

       1. 追加 をクリックします。
       2. Name、Inet Address、および Address Wildcard に必要な値を入力します。
       3. Save をクリックします。

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

       1. Available Interfaces リストから編集する必要があるインターフェースを選択し、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-attribute 操作を使用して新しい値を属性に書き込みます。タブ補完を使用して、入力するコマンド文字列を補完したり、利用可能な属性を表示したりできます。以下の例では、port 値を 2020 に更新します。

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

    3. パターン属性の確認

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

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

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

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

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

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

    2. Configuration タブへ移動

       画面の上部にある Configuration タブを選択します。

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

       General Configuration メニューを展開し、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-attribute 操作を使用して新しい値をポートオフセット属性に書き込みます。次の例は、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. ポートオフセット属性の確認

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

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

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

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

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

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

    2. Domain タブの選択

       画面の上部にある Domain タブを選択します。

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

       1. Available Server Configurations リストのサーバーを選択し、属性リストの上にある 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. 画面の上部にある Configuration タブを選択します。
2. General Configuration メニューを展開し、Interfaces を選択します。
3. Available Interfaces リストからインターフェースを選択します。
4. 詳細リストの Edit をクリックします。
5. 下記の inet アドレスを設定します。

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

6. Save をクリックして終了します。
7. サーバーを再起動し、変更を実装します。

手順5.3 IPv6 アドレスを優先するよう JBoss EAP 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 ドライバー JAR の編集

1. 空の一時ディレクトリーに移動するか、空の一時ディレクトリーを作成します。
2. META-INF サブディレクトリーを作成します。
3. META-INF/services サブディレクトリーを作成します。
4. JDBC ドライバーの完全修飾クラス名を示す 1 行が含まれる、META-INF/services/java.sql.Driver ファイルを作成します。
5. JAR コマンドラインツールを使用して、次のように JAR を更新します。

   jar \-uf jdbc-driver.jar META-INF/services/java.sql.Driver

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

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

1. EAP_HOME/modules/ ディレクトリー下にファイルパス構造を作成します。たとえば、MySQL JDBC ドライバーの場合には、EAP_HOME/modules/com/mysql/main/ のようなディレクトリー構造を作成します。
2. JDBC ドライバー JAR を main/ サブディレクトリーにコピーします。
3. main/ サブディレクトリーで、「モジュール」 の例に似た module.xml ファイルを作成します。module XSD は EAP_HOME/docs/schema/module-1_2.xsd ファイルに定義されます。
4. サーバーを起動します。
5. 管理 CLI を起動します。
6. CLI コマンドを実行して JDBC ドライバーモジュールをサーバー設定に追加します。
   選択するコマンドは、JDBC ドライバー JAR にある /META-INF/services/java.sql.Driver ファイルにリストされたクラスの数によって異なります。たとえば、MySQL 5.1.20 JDBC JAR 内の /META-INF/services/java.sql.Driver ファイルは以下の 2 つのクラスをリストします。

   • com.mysql.jdbc.Driver
   • com.mysql.fabric.jdbc.FabricMySQLDriver

   複数のエントリーがある場合は、ドライバークラスの名前も指定する必要があります。これを行わないと、以下のようなエラーが発生します。

   JBAS014749: Operation handler failed: Service jboss.jdbc-driver.mysql is already registered

   • 1 つのクラスエントリーを含む JDBC JAR に対して CLI コマンドを実行します。

     /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.1 1 つのドライバークラスを持つ JDBC JAR に対するスタンドアロンモードの 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.2 1 つのドライバークラスを持つ JDBC JAR に対するドメインモードの CLI コマンドの例

     /profile=ha/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)

   • 複数のクラスエントリーを含む JDBC JAR に対して CLI コマンドを実行します。

     /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, driver-class-name=DRIVER_CLASS_NAME)

     例6.3 複数のドライバークラスエントリーを持つ JDBC JAR に対するスタンドアロンモードの 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, driver-class-name=com.mysql.jdbc.Driver)

     例6.4 複数のドライバークラスエントリーを持つ JDBC JAR に対するドメインモードの CLI コマンドの例

     /profile=ha/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, driver-class-name=com.mysql.jdbc.Driver)

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

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

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

       依存関係: MODULE_NAME

       例6.5 依存関係の例

       Dependencies: com.mysql

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

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

       例6.6 サンプル 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. コンソールの上部から Configuration タブを選択します。
       2. ドメインモードの場合は、左上のドロップダウンボックスからプロファイルを選択します。
       3. コンソールの左側にある Subsystems メニューを展開し、Connector メニューを展開します。
       4. コンソールの左側にあるメニューより Datasources を選択します。

    3. 新しいデータソースを作成します。

       1. Datasources パネルの上部にある Add を選択します。
       2. Create Datasource ウィザードで新しいデータソースの属性を入力し、Next ボタンを押します。
       3. Create Datasource ウィザードで JDBC ドライバーの詳細を入力し、Next をクリックします。
       4. Create Datasource ウィザードで接続設定を入力します。
       5. Test Connection ボタンをクリックしてデータソースへの接続をテストし、設定が正しいことを確認します。
       6. Done をクリックして終了します。

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

• • 管理 CLI

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

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

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

       :reload

  • 管理コンソール

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

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

       1. コンソールの上部から Configuration タブを選択します。
       2. ドメインモードの場合は、左上のドロップダウンボックスからプロファイルを選択します。
       3. コンソールの左側にある Subsystems メニューを展開し、Connector メニューを展開します。
       4. 展開されたメニューから Datasources を選択します。

    3. データソースを編集します。

       1. Available Datasources リストからデータソースを選択します。データソース属性は下に表示されます。
       2. Edit をクリックし、データソース属性を編集します。
       3. Save をクリックして終了します。

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

• • 管理 CLI

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

       data-source remove --name=DATASOURCE_NAME

  • 管理コンソール

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

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

       1. コンソールの上部から Configuration タブを選択します。
       2. ドメインモードの場合は、左上のドロップダウンボックスからプロファイルを選択します。
       3. コンソールの左側にある Subsystems メニューを展開し、Connector メニューを展開します。
       4. Datasources を選択します。
    3. 削除するデータソースを選択し、Remove をクリックします。

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

• • 管理 CLI

    1. 「管理 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. コンソールの上部から Configuration タブを選択します。
       2. ドメインモードの場合は、左上のドロップダウンボックスからプロファイルを選択します。
       3. コンソールの左側にある Subsystems メニューを展開し、Connector メニューを展開します。
       4. Datasources を選択します。
    3. XA Datasource タブを選択します。

    4. 新しい XA データソースを作成します。

       1. 追加 をクリックします。
       2. Create XA Datasource ウィザードに新しい XA データソースの属性を入力し、Next をクリックします。
       3. Create XA Datasource ウィザードに JDBC ドライバーの詳細を入力し、Next をクリックします。
       4. XA プロパティーを入力し、Next をクリックします。
       5. Create XA Datasource ウィザードで接続設定を入力します。
       6. Test Connection ボタンをクリックして XA データソースへの接続をテストし、設定が正しいことを確認します。
       7. Done をクリックして終了します。

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

• • 管理 CLI

    1. 「管理 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. コンソールの上部から Configuration タブを選択します。
       2. ドメインモードの場合は、左上のドロップダウンボックスからプロファイルを選択します。
       3. コンソールの左側にある Subsystems メニューを展開し、Connector メニューを展開します。
       4. Datasources を選択します。
    3. XA Datasource タブを選択します。

    4. データソースを編集します。

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

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

• • 管理 CLI

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

       xa-data-source remove --name=XA_DATASOURCE_NAME

  • 管理コンソール

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

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

       1. コンソールの上部から Configuration タブを選択します。
       2. ドメインモードの場合は、左上のドロップダウンボックスからプロファイルを選択します。
       3. コンソールの左側にある Subsystems メニューを展開し、Connector メニューを展開します。
       4. Datasources を選択します。
    3. XA Datasource タブを選択します。
    4. 削除する登録済みの XA データソースを選択し、Remove をクリックして XA データソースを永久的に削除します。

手順6.10 データベース接続検証設定の指定

1. 検証方法の選択

   以下のいずれかの検証方法を選択します。

   • <validate-on-match>true</validate-on-match>

     <validate-on-match> オプションが true に設定されている場合は、データ接続が、次の手順で指定された検証メカニズムを使用して接続プールからチェックアウトされるたびに検証されます。
     接続が有効でない場合は、警告がログに書き込まれ、プール内の次の接続が取得されます。このプロセスは、有効な接続が見つかるまで続行します。プール内の各接続を繰り返し処理しない場合は、<use-fast-fail> オプションを使用できます。有効な接続がプールにない場合は、新しい接続が作成されます。接続の作成に失敗すると、例外が要求元アプリケーションに返されます。
     この設定により、最も早いリカバリーが実現されますが、データベースへの負荷が最も大きくなります。ただし、これは、パフォーマンスを気にする必要がない場合は最も安全な方法です。

   • <background-validation>true</background-validation>

     <background-validation> オプションが true に設定されている場合は、<background-validation-millis> 値とともに使用され、バックグラウンド検証実行の頻度を決定します。<background-validation-millis> パラメーターのデフォルト値は 0 ミリ秒であり、デフォルトで無効になります。この値は <idle-timeout-minutes> 設定と同じ値に設定しないでください。
     特定のシステムの <background-validation-millis> 値を決定するには注意が必要です。値が小さいと、プールの検証頻度が多くなり、無効な接続がプールからすぐに削除されます。 ただし、値が小さいと、より多くのデータベースリソースが使用されます。値が大きい場合は、接続検証チェックの頻度が少なくなり、より少ないデータベースリソースが使用されますが、デッド接続は長時間検出されません。

   注記

   <validate-on-match> オプションが true に設定されている場合は、<background-validation> オプションを false に設定する必要があります。それとは逆に、<background-validation> オプションが true に設定されている場合は、<validate-on-match> オプションを false に設定する必要があります。

2. 検証メカニズムの選択

   以下のいずれかの検証メカニズムを選択します。

   • <valid-connection-checker> クラス名の指定

     これは、使用中の特定の RDBMS に対して最適化されるため、推奨されるメカニズムです。JBoss EAP 6 は、以下の接続チェッカーを提供します。

     • org.jboss.jca.adapters.jdbc.extensions.db2.DB2ValidConnectionChecker
     • org.jboss.jca.adapters.jdbc.extensions.mssql.MSSQLValidConnectionChecker
     • org.jboss.jca.adapters.jdbc.extensions.mysql.MySQLReplicationValidConnectionChecker
     • org.jboss.jca.adapters.jdbc.extensions.mysql.MySQLValidConnectionChecker
     • org.jboss.jca.adapters.jdbc.extensions.novendor.JDBC4ValidConnectionChecker
     • org.jboss.jca.adapters.jdbc.extensions.novendor.NullValidConnectionChecker
     • org.jboss.jca.adapters.jdbc.extensions.oracle.OracleValidConnectionChecker
     • org.jboss.jca.adapters.jdbc.extensions.postgres.PostgreSQLValidConnectionChecker
     • org.jboss.jca.adapters.jdbc.extensions.sybase.SybaseValidConnectionChecker

   • <check-valid-connection-sql> 用 SQL の指定

     接続を検証するために使用する SQL ステートメントを提供します。
     以下は、Oracle 用接続を検証するために SQL ステートメントをどのように指定するかの例です。

     <check-valid-connection-sql>select 1 from dual</check-valid-connection-sql>

     MySQL または PostgreSQL の場合は、以下の SQL ステートメントを指定する必要があります。

     <check-valid-connection-sql>select 1</check-valid-connection-sql>

3. <exception-sorter> クラス名の設定

   例外が致命的とマークされた場合、接続はトランザクションに参加していてもすぐに閉じられます。致命的な接続例外を適切に検出およびクリーンアップするには、例外ソータークラスオプションを使用します。JBoss EAP 6 は、以下の例外ソーターを提供します。

   • org.jboss.jca.adapters.jdbc.extensions.db2.DB2ExceptionSorter
   • org.jboss.jca.adapters.jdbc.extensions.informix.InformixExceptionSorter
   • org.jboss.jca.adapters.jdbc.extensions.mysql.MySQLExceptionSorter
   • org.jboss.jca.adapters.jdbc.extensions.novendor.NullExceptionSorter
   • org.jboss.jca.adapters.jdbc.extensions.oracle.OracleExceptionSorter
   • org.jboss.jca.adapters.jdbc.extensions.postgres.PostgreSQLExceptionSorter
   • org.jboss.jca.adapters.jdbc.extensions.sybase.SybaseExceptionSorter

手順6.11

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

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

• /subsystem=datasources/data-source=ExampleDS/statistics=pool:write-attribute(name=statistics-enabled,value=true)

  /subsystem=datasources/data-source=ExampleDS/statistics=jdbc:write-attribute(name=statistics-enabled,value=true)