管理および設定ガイド

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

   Copy to Clipboard Toggle word wrap
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

   Copy to Clipboard Toggle word wrap
   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
      

      Copy to Clipboard Toggle word wrap
   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
        

        Copy to Clipboard Toggle word wrap
      • マシンが複数の 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
        

        Copy to Clipboard Toggle word wrap

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

   Copy to Clipboard Toggle word wrap
3. これが存在する場合は、name="HOST_NAME" 属性宣言を削除します。host 要素は以下のようになります。

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

   Copy to Clipboard Toggle word wrap
4. 以下のように、-Djboss.host.name 引数を渡すサーバーを起動します。

   -Djboss.host.name=HOST_NAME

   Copy to Clipboard Toggle word wrap

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

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

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

   Copy to Clipboard Toggle word wrap

   以下に例を示します。

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

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

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

   Copy to Clipboard Toggle word wrap

   以下に例を示します。

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

   Copy to Clipboard Toggle word wrap

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

    "outcome" => "success"

   Copy to Clipboard Toggle word wrap
   これにより、host -slave01.xml ファイルのホスト 名 属性が以下のように変更されます。

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

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

   reload --host=EXISTING_HOST_NAME

   Copy to Clipboard Toggle word wrap

   以下に例を示します。

   reload --host=master

   Copy to Clipboard Toggle word wrap

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

      Copy to Clipboard Toggle word wrap

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

      Copy to Clipboard Toggle word wrap
   2. ホストを起動します。

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

      Copy to Clipboard Toggle word wrap

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

   CLI を使用する場合:

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

   Copy to Clipboard Toggle word wrap
   Web コンソールを使用する場合:

   http://$IP1:9990
   

   Copy to Clipboard Toggle word wrap
   サーバーのインデックスページへアクセスします。

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

   Copy to Clipboard Toggle word wrap

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

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

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

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

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

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

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

   Copy to Clipboard Toggle word wrap
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

   Copy to Clipboard Toggle word wrap

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

       Copy to Clipboard Toggle word wrap
     • 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 
       ...
       

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

     jps -v | grep "Process Controller"

     Copy to Clipboard Toggle word wrap

     ps aux | grep "Process Controller"

     Copy to Clipboard Toggle word wrap
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")

   Copy to Clipboard Toggle word wrap
2. 次のコマンドを実行して動作を設定します。

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

   Copy to Clipboard Toggle word wrap

手順2.15 spec-descriptor-property-replacement

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

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

   Copy to Clipboard Toggle word wrap
2. 次のコマンドを実行して動作を設定します。

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

   Copy to Clipboard Toggle word wrap

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

  Copy to Clipboard Toggle word wrap

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

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

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

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

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

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

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

   Copy to Clipboard Toggle word wrap

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

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

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

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

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

   Copy to Clipboard Toggle word wrap

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

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

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

  Copy to Clipboard Toggle word wrap

手順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"
          ]
      }
  }
  

  Copy to Clipboard Toggle word wrap

1. Web ブラウザーを起動し、以下のアドレスに移動します。 http://localhost:9990/console/App.html
   注記
   ポート 9990 は、管理コンソールソケットバインディングとして事前定義されています。
2. 管理コンソールにログインするためのユーザー名とパスワードを入力します。

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

   

   View larger image

   

手順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 スタンドアロンデプロイメントの管理

   

   View larger image

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

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

   

   View larger image

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

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

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

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

   図3.9 サーバー設定

   

   View larger image

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

3. 設定の新規作成

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

   図3.10 設定の新規作成

   

   View larger image

   

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

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

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

   図3.11 ロギングパネル

   

   View larger image

   

2. ロガー詳細の編集

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

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

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

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

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

   

   View larger image

   

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

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

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

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

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

   

   View larger image

   

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

    Copy to Clipboard Toggle word wrap

  • Microsoft Windows Server での CLI の起動

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

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

    Copy to Clipboard Toggle word wrap

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

• connect コマンドの実行

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

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

  Copy to Clipboard Toggle word wrap
  • Linux システムで管理 CLI を起動するときに管理対象サーバーに接続するには、--connect パラメーターを使用します。

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

    Copy to Clipboard Toggle word wrap
  • --connect パラメーターを使用すると、サーバーのホストとポートを指定できます。ポート値 9999 でアドレス 192.168.0.1 に接続するには、以下が適用されます。

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

    Copy to Clipboard Toggle word wrap

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

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

   [standalone@localhost:9999 /] help

   Copy to Clipboard Toggle word wrap

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

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

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

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

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

   Copy to Clipboard Toggle word wrap

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

1. バッチモードの開始

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

   [standalone@localhost:9999 /] batch

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

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

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

3. バッチの実行

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

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

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

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

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

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

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

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

   Copy to Clipboard Toggle word wrap

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

1. 操作要求の構築

   操作リクエストを使用すると、管理モデルとの低レベルの対話が可能になります。サーバー設定を編集する制御方法を提供します。操作リクエストは 3 つの部分で構成されます。
   • スラッシュ(/)で始まる アドレス。
   • コロン(:)で始まる 操作名。
   • 括弧（）内の任意の パラメーター セット。

   1. アドレスの特定

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

      /node-type=node-name

      Copy to Clipboard Toggle word wrap
      • 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

      Copy to Clipboard Toggle word wrap

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

      /subsystem=datasources/data-source=java

      Copy to Clipboard Toggle word wrap

   2. 操作の特定

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

      :operation-name

      Copy to Clipboard Toggle word wrap
      • 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"
          ]
      }

      Copy to Clipboard Toggle word wrap

   3. パラメーターの決定

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

      (parameter-name=parameter-value)

      Copy to Clipboard Toggle word wrap
      • 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
          }
      }

      Copy to Clipboard Toggle word wrap

2. 完全操作要求の入力

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

   例3.8 操作要求の例

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

   Copy to Clipboard Toggle word wrap

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

   Copy to Clipboard Toggle word wrap

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

• read-attribute 操作の実行

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

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

  Copy to Clipboard Toggle word wrap

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

• whoami 操作の実行

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

  [standalone@localhost:9999 /] :whoami

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

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

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

  Copy to Clipboard Toggle word wrap

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

• version コマンドの実行

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

  [domain@localhost:9999 /] version

  Copy to Clipboard Toggle word wrap

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

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

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

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

  Copy to Clipboard Toggle word wrap

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

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

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

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

  Copy to Clipboard Toggle word wrap