手順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 台のマシンで JBoss EAP スタンドアロンサーバーの複数のインスタンスを実行

1. 各スタンドアロンサーバーの EAP_HOME/standalone/ ディレクトリーを直接 EAP_HOME/ の下に作成します。たとえば、スタンドアロンサーバーの node1 および node2 のディレクトリーを作成するには、以下のコマンドを入力します。

   $ cd EAP_HOME
   $ cp -a ./standalone ./node1 
   $ cp -a ./standalone ./node2

2. ノード名、IP アドレス、サーバーディレクトリー、オプションのサーバー設定ファイル、および任意のポートオフセットを指定して、各 JBoss EAP スタンドアロンインスタンスを起動します。このコマンドは、以下の構文を使用します。

   $ ./bin/standalone.sh -Djboss.node.name=UNIQUE_NODENAME -Djboss.server.base.dir=EAP_HOME/NODE_DIRECTORY -b IP_ADDRESS -bmanagement MGMT_IP_ADDRESS --server-config=SERVER_CONFIGURATION_FILE -Djboss.socket.binding.port-offset=PORT_OFFSET

   1. この例では、node1を起動します。

      $ cd EAP_HOME
      $ ./bin/standalone.sh -Djboss.node.name=node1 -Djboss.server.base.dir=EAP_HOME/node1 -b 10.10.10.10 -bmanagement 127.0.0.1
      

   2. node2 を起動する例は、マシンが複数の IP アドレスをサポートするかどうかによって異なります。
      • マシンが複数の IP アドレスをサポートする場合、以下のコマンドを使用します。

        $ cd EAP_HOME
        $ ./bin/standalone.sh -Djboss.node.name=node2 -Djboss.server.base.dir=EAP_HOME/node2 -b 10.10.10.40 -bmanagement 127.0.0.40
        

      • マシンが複数の IP アドレスをサポートしない場合は、jboss.socket.binding.port-offset プロパティーを指定してポートの競合を避ける必要があります。

        $ cd EAP_HOME
        $ ./bin/standalone.sh -Djboss.node.name=node2 -Djboss.server.base.dir=EAP_HOME/node2 -b 10.10.10.10 -bmanagement 127.0.0.1 -Djboss.socket.binding.port-offset=100
        

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

1. Red Hat Enterprise Linux の場合

   EAP_HOME/bin/domain.shコマンドを実行します。

2. Microsoft Windows Server の場合

   EAP_HOME\bin\domain.batコマンドを実行します。

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

   起動スクリプトで利用可能なパラメーターの一覧を表示するには、-h パラメーターを使用します。

手順2.4 システムプロパティーを用いたホスト名の設定

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.5 特定の名前を用いたホスト名の設定

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 ファイルのホスト 名 属性が以下のように変更されます。

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

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

   reload --host=EXISTING_HOST_NAME

   以下に例を示します。

   reload --host=master

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

1. マシン 1 での作業

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

      EAP_HOME/bin/domain.sh --host-config=host-master.xml -bmanagement=$IP1

2. マシン 2 での作業

   1. EAP_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. ホストを起動します。

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

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

   CLI を使用する場合:

   EAP_HOME/bin/jboss-cli.sh -c --controller=$IP1
   

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

   http://$IP1:9990
   

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

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

手順2.7 1 台のマシンで複数のホストコントローラーを実行する

1. ドメインコントローラーの EAP_HOME/domain ディレクトリーをコピーします。

   cp -r EAP_HOME/domain /path/to/domain1

2. ホストコントローラーの EAP_HOME/domain ディレクトリーをコピーします。

   cp -r EAP_HOME/domain /path/to/host1

3. /path/to/domain1 を使用してドメインコントローラーを起動します。

   EAP_HOME/bin/domain.sh --host-config=host-master.xml -Djboss.domain.base.dir=/path/to/domain1

4. /path/to/host1 を使用してホストコントローラーを起動します。

   EAP_HOME/bin/domain.sh --host-config=host-slave.xml -Djboss.domain.base.dir=/path/to/host1 -Djboss.domain.master.address=IP_ADDRESS -Djboss.management.native.port=PORT

手順2.8 JBoss EAP 6 のインスタンスの停止

• コマンドラインプロンプトから対話的に起動したインスタンスの停止

  JBoss EAP 6 が稼働しているターミナルで Ctrl-C を押します。

手順2.9 オペレーティングシステムサービスとして起動されたインスタンスの停止

• • Red Hat Enterprise Linux

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

  • Microsoft Windows Server

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

手順2.10 バックグラウンドで実行されているインスタンスの停止 (Red Hat Enterprise Linux)

1. プロセスのプロセス ID(PID)を取得します。

   • 単一のインスタンスのみが実行されている場合 (スタンドアロンモード)

     以下のコマンドのいずれかが、JBoss EAP 6 の単一インスタンスの PID を返します。
     • pidof java
     • jps
       （ jps コマンドは、jboss-modules.jar 用と jps 自体の 2 つのプロセスの ID を返します。jboss-modules.jar の ID を使用して EAP インスタンスを停止します。

   • 複数の EAP インスタンスが実行されている場合 (ドメインモード)

     複数の EAP インスタンスが実行されている場合、正しいプロセスを識別するには、さらに包括的なコマンドを使用する必要があります。
     • jps コマンドは冗長モードで使用して、見つかった java プロセスに関する詳細情報を提供できます。
       以下は、PID およびロールによって実行されている EAP プロセスを特定する、詳細な jps コマンドからのブリッジ出力です。

       $ jps -v
       12155 jboss-modules.jar -D[Server:server-one] -XX:PermSize=256m -XX:MaxPermSize=256m -Xms1303m 
       ...
       
       12196 jboss-modules.jar -D[Server:server-two] -XX:PermSize=256m -XX:MaxPermSize=256m -Xms1303m 
       ...
       
       12096 jboss-modules.jar -D[Host Controller] -Xms64m -Xmx512m -XX:MaxPermSize=256m 
       ...
       
       11872 Main -Xms128m -Xmx750m -XX:MaxPermSize=350m -XX:ReservedCodeCacheSize=96m -XX:+UseCodeCacheFlushing 
       ...
       
       11248 jboss-modules.jar -D[Standalone] -XX:+UseCompressedOops -verbose:gc 
       ...
       
       12892 Jps 
       ...
       
       12080 jboss-modules.jar -D[Process Controller] -Xms64m -Xmx512m -XX:MaxPermSize=256m 
       ...
       

     • ps aux コマンドを使用して、複数の EAP インスタンスに関する情報を返すこともできます。
       以下は、PID およびロールによって実行されている EAP プロセスを特定する、冗長 ps aux コマンドの出力です。

       $ ps aux | grep java
       username 12080  0.1  0.9 3606588 36772 pts/0   Sl+  10:09   0:01 /path/to/java -D[Process Controller] -server -Xms128m -Xmx128m -XX:MaxPermSize=256m 
       ...
       
       username 12096  1.0  4.1 3741304 158452 pts/0  Sl+  10:09   0:13 /path/to/java -D[Host Controller] -Xms128m -Xmx128m -XX:MaxPermSize=256m 
       ...
       
       username 12155  1.7  8.9 4741800 344224 pts/0  Sl+  10:09   0:22 /path/to/java -D[Server:server-one] -XX:PermSize=256m -XX:MaxPermSize=256m -Xms1000m -Xmx1000m -server -
       ...
       
       username 12196  1.8  9.4 4739612 364436 pts/0  Sl+  10:09   0:22 /path/to/java -D[Server:server-two] -XX:PermSize=256m -XX:MaxPermSize=256m -Xms1000m -Xmx1000m -server 
       ...
       

     上記の例では、ドメイン全体を停止するには Process Controller プロセスを停止します。
     grep ユーティリティーは、以下のいずれかのコマンドを使用して Process Controller を特定できます。

     jps -v | grep "Process Controller"

     ps aux | grep "Process Controller"

2. kill PID を実行してプロセス TERM シグナルを送信します。ここで、PID は上記のコマンドの 1 つで識別されるプロセス ID です。

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

1. コンソール上部の ドメイン タブを選択し、TOPOLOGY タブを選択します。左側のナビゲーションバーの Domain で Overview を選択します。
2. Server Instances リストから、起動するサーバーを選択します。実行中のサーバーはチェックマークで表示されます。
   このリストにあるインスタンスにカーソルを合わせ、サーバーの詳細の下に青色でオプションを表示します。
3. インスタンスを起動するには、表示された時に Start Server テキストをクリックします。確認ダイアログボックスが開きます。確認 をクリックしてサーバーを起動します。

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

1. コンソール上部の ドメイン タブを選択し、TOPOLOGY タブを選択します。左側のナビゲーションバーの Domain で Overview を選択します。
2. 利用可能なサーバーインスタンスの 一覧は 、ホスト、グループ、およびサーバーインスタンス の表に表示されます。実行中のサーバーはチェックマークで表示されます。
3. 選択したサーバーにカーソルを合わせます。表示される Stop Server テキストをクリックします。確認ダイアログウインドウが表示されます。
4. 確認 をクリックしてサーバーを停止します。

手順2.13 設定データのバックアップ

1. ユーザーおよびプロファイルデータ、ドメイン、ホスト、スレーブ、およびロギング設定を保持するには、以下のディレクトリーの内容全体をバックアップします。

   • EAP_HOME/standalone/configuration/
   • EAP_HOME/domain/configuration
2. EAP_HOME/modules/system/layers/base/ ディレクトリーに作成されたカスタムモジュールをバックアップします。
3. EAP_HOME/welcome-content/ ディレクトリーの Welcome コンテンツをバックアップします。
4. EAP_HOME/bin/ ディレクトリーに作成されたカスタムスクリプトをバックアップします。

手順2.14 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.15 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)

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

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

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

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

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

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

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

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

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

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

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

  :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 ブラウザーを起動し、以下のアドレスに移動します。 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. コンソールの上部から ドメイン タブを選択します。利用可能なサーバーインスタンスが表に表示されます。
2. Server Configurations をクリックします。
   関連するホストの Server Configurations パネルが表示されます。
3. Available Server Configurations テーブルからサーバーインスタンスを選択します。
4. 選択したサーバーの詳細の上に Edit をクリックします。
5. 設定属性を変更します。
6. Save をクリックして終了します。

1. コンソールの上部にある Deployments タブを選択します。
2. コンテンツリポジトリー タブで 追加 を選択します。Create Deployment ダイアログボックスが表示されます。

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

   
3. ダイアログボックスで、Browse をクリックします。デプロイするファイルを参照し、これを選択してアップロードします。Next をクリックして先に進みます。

   図3.8 デプロイメントの選択

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

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

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

   コンソールの上部から ドメイン タブを選択します。

   図3.9 サーバー設定

   
2. 左側のメニューの Server Configurations をクリックします。

3. 設定の新規作成

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

   図3.10 設定の新規作成

   

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

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

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

   図3.11 ロギングパネル

   

2. ロガー詳細の編集

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

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

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

   コンソールの上部から ドメイン タブを選択します。
2. 左側の列で Server Groups を選択します。

   図3.12 サーバー グループ ビュー

   

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

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

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

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

   図3.13 サーバー グループの作成 ダイアログ

   

手順3.6 管理コンソールでの JBoss EAP 6 ログの表示

1. 管理コンソールの上部から Runtime タブを選択します。
   1. 管理対象ドメインを使用している場合は、左側のメニューの Change Server ボタンを使用して、ログを表示する JBoss EAP 6 サーバーを選択します。
2. 左側の Platform メニューを展開し、Log Viewer を選択します。
3. 一覧からログファイルを選択し、表示 ボタンをクリックします。
   Download をクリックして、ログファイルをローカルマシンにダウンロードすることもできます。
   注記

   管理コンソールログビューアーは、15MB を超えるログファイルを開こうとすると確認を表示します。

   管理コンソールログビューアーは、非常に大きなログファイル(>100MB)を表示するテキストエディターの代わりとして使用するものではありません。管理コンソールログビューアーで非常に大きなログファイルを開くと Web ブラウザーがクラッシュする可能性があるため、大きなログファイルを常にダウンロードして、テキストエディターで開く必要があります。
4. 選択したログは、管理コンソールの新しいタブとして開きます。LOG FILES タブに戻り、直前の手順を繰り返すと、他のタブで複数のログファイルを開くことができます。

手順3.7 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.8 管理対象サーバーインスタンスへの接続

• 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 extended コマンドを入力します。

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

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

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

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

1. バッチモードの開始

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

   [standalone@localhost:9999 /] batch

   バッチモードになると、プロンプトにハッシュ (#) が表示されます。

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

   バッチモードでは、通常通りに操作リクエストを入力します。操作リクエストは、入力順にバッチに追加されます。
   操作リクエストのフォーマットに関する詳細は、「管理 CLI での操作およびコマンドの使用」 を参照してください。

3. バッチの実行

   操作リクエストのシーケンス全体を入力したら、run-batch コマンドでバッチを実行します。

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

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

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

   頻繁に実行する batch コマンドは、外部テキストファイルに保存できます。batch コマンドの引数として完全パスをファイルに渡すか、run- batch コマンドの引数として直接実行することができます。
   テキストエディターを使用して、batch コマンドファイルを作成できます。各コマンドは 1 行で記載する必要があり、CLI はこれにアクセスできる必要があります。
   以下のコマンドは、myscript.txt ファイルをバッチモードで読み込みます。このファイルのすべてのコマンドを編集または削除できるようになりました。新しいコマンドを挿入することもできます。このバッチセッションでの変更は、myscript.txt ファイルに永続化されません。

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

   次のコマンドは、myscript.txtファイルに保存されている batch コマンドを即座に実行します。

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

手順3.10 要求の作成、設定、および実行

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 ファイルは管理対象ドメインの設定を保持します。
      注記

      ドメインモードで CLI コマンドを実行するには、ホストおよびサーバー仕様が必要です。例： /host=master/server=server-one/subsystem=logging

      例3.5 操作アドレスの例

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

      /subsystem=logging

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

      /subsystem=datasources/data-source=java

   2. 操作の特定

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

      :operation-name

      • operation-name はリクエストする操作の名前です。
      スタンドアロンサーバーのリソースアドレスで read-operation-names 操作を使用して、利用可能な操作を一覧表示します。

      例3.6 利用可能な操作

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

      [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.7「操作パラメーターの決定」 を参照してください。

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

      ロギングサブシステムで 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.8 操作要求の例

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

手順3.11 管理 CLI でのプロパティー置換の有効化

1. EAP_HOME/bin/jboss-cli.xml ファイルを開きます。
2. resolve-parameter-values パラメーターを見つけ、値を true に変更します（デフォルトは falseです）。

   <!-- whether to resolve system properties specified as command argument or operation parameter values in the Management CLI VM before sending the operation requests to the controller -->
       <resolve-parameter-values>true</resolve-parameter-values>
   

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

• read-attribute 操作の実行

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

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

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

• whoami 操作の実行

  管理 CLI で whoami 操作を使用してアクティブなユーザーアカウントを表示します。

  [standalone@localhost:9999 /] :whoami

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

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

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

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

• version コマンドの実行

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

  [domain@localhost:9999 /] version

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

• read-operation-description 操作を実行します。

  管理 CLI から read-operation-description を使用して、操作に関する情報を表示します。操作には、表示する操作を示すために、キーと値のペアの形式で追加のパラメーターが必要です。操作リクエストの詳細は、「管理 CLI での操作およびコマンドの使用」 のトピックを参照してください。

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

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

• read-operation-names 操作を実行します。

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

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

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

• シャットダウン 操作の実行

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

      [standalone@localhost:9999 /]shutdown

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

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

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

    jboss-cli.sh --connect command=shutdown
    

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

    [disconnected /] connect IP_ADDRESS
    [standalone@IP_ADDRESS: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.22 システムプロパティーをスタンドアロンサーバーへ追加

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

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

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

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

     [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.24 システムプロパティーをドメインのホストおよびそのサーバーへ追加

     [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.25 システムプロパティーを管理対象ドメインのサーバーインスタンスへ追加

     [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.26 スタンドアロンサーバーからシステムプロパティーの読み取り

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

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

     /system-property=PROPERTY_NAME:read-resource

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

     [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.28 ドメインのホストおよびそのサーバーからシステムプロパティーを読み取り

     [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.29 管理対象ドメインのサーバーインスタンスからシステムプロパティーを読み取り

     [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.30 スタンドアロンサーバーからシステムプロパティーを削除

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

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

     /system-property=PROPERTY_NAME:remove

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

     [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.32 ドメインのホストおよびそのインスタンスからシステムプロパティーを削除

     [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.33 管理対象ドメインのサーバーからシステムプロパティーを削除

     [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 で 履歴 コマンドを入力します。

  [standalone@localhost:9999 /] history

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

• history --clear コマンドを実行します。

  管理 CLI で 履歴 --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. 監査ロギングの有効化

   以下のコマンドを実行します。

   [.. /]/core-service=management/access=audit/logger=audit-log:write-attribute(name=enabled,value=true)

2. syslog ハンドラーの作成

   この例では、syslog サーバーが JBoss EAP インスタンスと同じサーバーで、ポート 514 で実行します。ホスト 属性の値を、実際の環境に適した値に置き換えます。

   例3.34 syslog ハンドラーの例

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

3. syslog ハンドラーへの参照の追加

   以下のコマンドを実行します。

   [.. /]/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 を使用して管理操作を実行することが承認されます。もう 1 つの選択肢は b で、ユーザーを ApplicationRealm に追加し、特定のパーミッションは提供されません。そのレルムはアプリケーションで使用するために提供されます。

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

   プロンプトが表示されたら、ユーザー名とパスワードを入力します。入力後、パスワードを確認するよう指示されます。

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

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

5. 情報を確認します。

   情報を確認するよう求められます。問題がなければ、yes を入力します。

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

   管理者以外に、ManagementRealm の JBoss EAP 6 の別のインスタンスを表すユーザーである で 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 が指定されている場合にのみ該当します。エラーメッセージが表示されます。

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

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

    タブ補完を使用して、入力しながらコマンド文字列を補完したり、利用可能な属性を表示したりできます。
    管理 CLI を使用して、新しいサーバーを追加してインスタンスをそのサーバーに設定し、同じ設定を XML に追加します。server-name を実際のサーバー名に置き換え、ip-address を実際の IP アドレスに置き換えます。

    /host=master/server-config=server-name:add(group=main-server-group)
    /host=master/server-config=server-name/interface=public:add(inet-address=ip-address)

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

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

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

       /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. Configuration タブに移動します。

       画面上部の Configuration タブを選択します。
       注記

       ドメインモードの場合は、画面左上の Profile ドロップダウンメニューからプロファイルを選択します。

    3. ナビゲーションメニュー から インターフェース を選択します。

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

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

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

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

       1. 利用可能なインターフェース の一覧から編集する必要があるインターフェースを選択し、編集 をクリックします。
       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. 追加 ボタンをクリックします。
       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. ドメイン タブの選択

       画面上部の ドメイン タブを選択します。

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

       1. Available Server Configurations リストでサーバーを選択し、以下のアセンブリーリストの上部にある Edit をクリックします。
       2. Port Offset フィールドに任意の値を入力します。
       3. Save をクリックして終了します。

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

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

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

     Open EAP_HOME/bin/standalone.conf.

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

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

   -Djava.net.preferIPv4Stack=false

   以下に例を示します。

   例5.8 JVM オプション

   # 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. インストールに関連するファイルを開きます。

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

     Open EAP_HOME/bin/standalone.conf.

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

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

   -Djava.net.preferIPv6Addresses=true

   以下に例を示します。

   例5.9 JVM オプション

   # 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 管理コンソールを使用したデータソースプール接続のテスト

1. 「管理コンソールへのログイン」.
2. 管理コンソールの上部から Runtime タブを選択します。
3. 左側の Subsystems メニューを展開し、Datasources を選択します。
4. Test Connection ボタンをクリックしてデータソースへの接続をテストし、設定が正しいことを確認します。

手順6.2 管理 CLI を使用したデータソース接続のテスト

1. CLI ツールを起動し、サーバーに接続します。
2. 以下の管理 CLI コマンドを実行して接続をテストします。
   • スタンドアロンモードでは、以下のコマンドを入力します。

     /subsystem=datasources/data-source=ExampleDS:test-connection-in-pool
     

   • ドメインモードでは、以下のコマンドを入力します。

     host=master/server=server-one/subsystem=datasources/data-source=ExampleDS:test-connection-in-pool

手順6.3 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.4 管理 CLI を使用してコアモジュールとしての JDBC ドライバーのインストール

1. サーバーを起動します。
2. 管理 CLI を起動しますが、稼働中のインスタンスへの接続に --connect 引数または -c 引数を使用しないでください。
3. module add CLI コマンドを使用して、新しいモジュールを追加します。

   例6.1 MySQL JDBC ドライバーモジュールを追加する CLI コマンドの例

   module add --name=com.mysql --resources=/path/to/mysql.jar --dependencies=javax.api,javax.transaction.api

   注記

   module 管理 CLI コマンドを使用してモジュールの追加および削除は テクノロジープレビュー としてのみ提供されるため、リモート JBoss EAP インスタンスにモジュールを追加しないでください。本番環境では、モジュールを手作業で追加および削除する必要があります。

   以下の手順に従って、モジュールを手動で追加します。

   1. ファイルパス構造は EAP_HOME/modules/ ディレクトリーの下に作成されます。たとえば、MySQL JDBC ドライバーの場合は、EAP_HOME/modules/com/mysql/main/ のようになります。
   2. リソースとして指定された JAR ファイルは main/ サブディレクトリーにコピーされます。
   3. 指定の依存関係を持つ module.xml ファイルが main/ サブディレクトリーに作成されます。module.xml ファイルの例は、「モジュール」 を参照してください。

   このコマンドを使用してモジュールを追加および削除する方法は、module --help を実行します。
4. CLI コマンド connect を使用して、実行中のインスタンスに接続します。
5. 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

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

   例6.2 ドライバークラスエラー

   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.3 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.4 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.5 複数のドライバークラスエントリーを持つ 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.6 複数のドライバークラスエントリーを持つ 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.7 複数の非 XA ドライバークラスエントリーを持つ JDBC JAR に対するドメインモードの CLI コマンド

     /profile=ha/subsystem=datasources/jdbc-driver=oracle/:add(driver-module-name=com.oracle,driver-name=oracle,jdbc-compliant=true,driver-datasource-class-name=oracle.jdbc.OracleDriver)

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

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

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

       Dependencies: MODULE_NAME

       例6.8 com.mysql が依存関係として宣言されている MANIFEST.MF ファイル

       Dependencies: com.mysql

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

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

       例6.9 com.mysql が依存関係として宣言されている jboss-deployment-structure.xml ファイル

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

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

• • 管理 CLI

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

       DRIVER_NAME の値は、JDBC ドライバー JAR にある /META-INF/services/java.sql.Driver ファイルにリストされているクラスの数によって異なります。クラスが 1 つしかない場合、値は JAR の名前になります。複数のクラスがある場合、値は JAR + driverClassName + "_" + majorVersion +"_" + minorVersion の名前になります。これを実行しないと、以下のエラーがログに記録されます。

       JBAS014775:    New missing/unsatisfied dependencies

       たとえば、MySQL 5.1.31 ドライバーに必要な DRIVER_NAME 値は mysql-connector-java-5.1.31-bin.jarcom.mysql.jdbc.Driver_5_1 です。

       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. 完了 をクリック し て終了します。

手順6.7 非 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.8 非 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.9 管理 CLI または管理コンソールのいずれかを使用した XA データソースの作成

• • 管理 CLI

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

       DRIVER_NAME の値は、JDBC ドライバー JAR にある /META-INF/services/java.sql.Driver ファイルにリストされているクラスの数によって異なります。クラスが 1 つしかない場合、値は JAR の名前になります。複数のクラスがある場合、値は JAR + driverClassName + "_" + majorVersion +"_" + minorVersion の名前になります。これを実行しないと、以下のエラーがログに記録されます。

       JBAS014775:    New missing/unsatisfied dependencies

       たとえば、MySQL 5.1.31 ドライバーに必要な DRIVER_NAME 値は mysql-connector-java-5.1.31-bin.jarcom.mysql.jdbc.Driver_5_1 です。

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

手順6.10 管理 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 データソースを選択します。XA データソース属性は、その下の Attributes パネルに表示されます。
       2. Edit ボタンを選択してデータソース属性を編集します。
       3. XA データソース属性を編集し、作業が完了したら Save ボタンを選択します。

手順6.11 管理 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 データソースを永続的に 削除 します。