手順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. スタンドアロンサーバー

   スタンドアロンサーバーでは、--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.4 JBoss EAP 6 のスタンドアロンインスタンスの停止

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

   JBoss EAP 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 EAP 6 インスタンスの 1 つの結果が返されます。
   2. kill process_ID を実行してプロセスに TERM シグナルを送信します。ここで、process_ID は上記 ps aux コマンドの 2 番目のフィールドにある数字に置き換えます。

手順2.5 サーバーの起動

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

   1. コンソールの上部より Runtime タブを選択します。

2. サーバーを選択します。

   Server Instances のリストから、起動するサーバーを選択します。実行されているサーバーはチェックマークで示されます。
   このリストにあるインスタンスにカーソルを合わせると、サーバーの詳細の下に青色でオプションが表示されます。

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

   インスタンスを起動するには、表示された Start Server テキストをクリックします。クリックすると、ダイアログボックスが開きます。Confirm ボタンをクリックしてサーバーを起動します。

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

1. 管理コンソールの Hosts, groups and server instances に移動します。

   1. コンソールの上部より Runtime タブを選択します。Topology タブのメインペインに、利用可能なサーバーインスタンスが表示されます。

2. サーバーを選択します。

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

3. Stop Server テキストをクリックします。

   サーバーエントリーにカーソルを合わせると表示される Stop Server テキストをクリックします。確認ダイアログウインドウが表示されます。
4. 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 Configurations パネルに移動します。

   1. コンソールの上部より Hosts タブを選択します。利用可能なサーバーインスタンスの表が表示されます。

2. サーバー設定の編集

   1. Available Server Configurations テーブルよりサーバーインスタンスを選択します。
   2. 選択したサーバーの下にある Edit ボタンを選択します。
   3. 設定属性を変更します。
   4. サーバーリストの下にある Save ボタンをクリックします。

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

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

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

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

   Content Repository タブ上の Add ボタンを選択します。Create Deployment ダイアログボックスが表示されます。

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

   ダイアログボックスの Browse ボタンを選択します。デプロイするファイルを参照し、アップロードするために選択します。ファイルが選択されたら、Next ボタンを選択して作業を続行します。

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

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

手順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 メニューを展開し、Logging エントリーをクリックします。
   3. コンソール上部の Log Categories タグをクリックします。

2. ロガー詳細の編集

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

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

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

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

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

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

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

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

手順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-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.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

手順3.28 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 usernamepassword

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

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

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

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

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

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

  必要に応じて、インターフェース属性を設定するために、管理 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. インターフェース属性の編集

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

       [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-attribute 操作を使用して新しい値を属性に書き込みます。タブ補完を使用して、入力するコマンド文字列を補完したり、利用可能な属性を公開したりできます。以下の例では、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-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. ポートオフセット属性の確認

       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 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 ドライバーのデプロイ

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 ファイルを作成します。module XSD は EAP_HOME/docs/schema/module-1_2.xsd ファイルに定義されます。
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.1 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.2 依存関係の例

       依存関係: com.mysql

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

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

       例6.3 サンプル 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 と選択します。

    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 と選択します。

    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 と選択します。
    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 と選択します。
    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 と選択します。
    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 と選択します。
    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)