1. 管理ドメイン

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

   例2.3 Red Hat Enterprise Linux 上の管理ドメインで別の設定ファイルを利用

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

   例2.4 Microsoft Windows サーバー上の管理ドメインで別の設定ファイルを利用

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

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

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

   例2.5 Red Hat Enterprise Linux 上のスタンドアローンサーバーで別の設定ファイルを利用

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

   例2.6 Microsoft Windows サーバー上のスタンドアローンサーバーで別の設定ファイルを利用

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

手順2.1 タスク：

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

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

手順2.2 タスク

1. /etc/init.d/ ディレクトリーに起動スクリプトをコピーします。

   起動スクリプトと、関連する設定ファイルは、EAP_HOME/bin/init.d/ ディレクリーに存在します。これらの各ファイルを /etc/init.d/ ディレクリーにコピーします。

   [user@host init.d]$sudo cp jboss-as-standalone.sh jboss-as.conf /etc/init.d

2. 起動スクリプトをサービスとして追加します。

   chkconfig サービス管理コマンドを使用して、新しい jboss-as-standalone.sh サービスを自動的に起動されるサービスのリストに追加します。

   [user@host init.d]$sudo chkconfig --add jboss-as-standalone.sh

3. スクリプトオプションを編集します。

   必要な場合は、jboss-as.conf ファイルを編集して JBoss Enterprise Application Platform と JVM の起動オプションをカスタマイズします。ファイルのコメントをガイダンスとして使用します。このファイルで、JBoss Enterprise Application Platform 6 を抽出したディレクリーを参照するよう JBOSS_HOME 変数を設定することが推奨されます。ディレクリー名の最後にスラッシュ (/) を追加しないでください。

4. スクリプト自体を編集します。

   起動スクリプト自体を編集する必要がある場合があります。起動ファイルの名前と JBoss Enterprise Application Platform インスタンスの場所について推測が行われます。スクリプトをカスタマイズし、以下の変数に特別な注意を払います。これらの変数は、JBoss Enterprise Application Platform 6 を管理対象ドメインとして起動するためにカスタマイズする必要があります。
   • JBOSS_HOME - JBoss Enterprise Application Platform 6 が抽出される場所
   • JBOSS_USER - JBoss Enterprise Application Platform を実行できるユーザー。これは、非特権ユーザーである必要があります (スーパーユーザー特権なし)。
   • JBOSS_CONFIG - JBoss Enterprise Application Platform 6 を起動するために使用される設定ファイルの名前 (domain.xml や standalone.xml など)
   • JBOSS_SCRIPT - JBoss Enterprise Application Platform 6 を起動するために使用されるスクリプト (domain.sh や standalone.sh など)

5. サービスを起動します。

   必要な場合は、Red Hat Enterprise Linux サービスを起動するために標準的な構文を使用して新しいサービスを起動します。

   [user@host bin]$sudo service jboss-as-standalone.sh start

手順2.3 タスク

1. お使いのアーキテクチャー向けのネイティブユーティリティーパッケージをダウンロードします。

   32 ビット、64 ビット、および Itanium 64 ビットパッケージは、Red Hat カスタマーポータル (https://access.redhat.com) で入手できます。Red Hat カスタマーポータルからのソフトウェアのダウンロードに関する詳細については、『『JBoss Enterprise Application Platform 6 Installation Guide』』(JBoss Enterprise Application Platform 6 インストールガイド) (https://access.redhat.com/knowledge/docs/JBoss_Enterprise_Application_Platform/ で入手可能) を参照してください。

2. ダウンロードしたアーカイブを展開します。

   アーカイブを新規フォルダーに展開します。
   結果: modules\native\bin\ フォルダーが作成されます。

   modules\native\bin\ フォルダーには、JBoss Enterprise Application Platform 6 をサービスとしてインストールするために必要なファイルが含まれます。これらのサービスは、Apache Commons により提供される一連のラッパースクリプトである 『Procrun』 の一部です。『Procrun』 とその構文の詳細については、http://commons.apache.org/daemon/procrun.html を参照してください。

3. modules\sbin\prunsrv.exe 実行可能ファイルを実行します。

   prunsrv.exe install path_to_startup_script

   結果

   サービスがインストールされます。JBoss Enterprise Application Platform 6 がサービスアプレット services.msc にリストされます。

4. サービスを管理します。

   modules\bin\prunmgr.exe 実行可能ファイルを使用してサービスを管理、追加、または削除します。以下のコマンドラインオプションがサポートされています。
   • run
   • service
   • start
   • stop
   • update
   • install
   • delete
   • pause [seconds]
   • version
   • help
   一般的な構文は以下のとおりです。

   prunmgr.exe commandservice_name

手順2.4 タスク

1. 管理コンソールでの Server Instances への移動

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

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

2. サーバーの選択

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

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

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

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

手順2.5 タスク

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

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

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

2. サーバーの選択

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

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

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

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

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 

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

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

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

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

1. スナップショットの削除

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

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

2. スナップショットの削除

   :delete-snapshot コマンドを実行して、特定のスナップショットを削除します。

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

手順2.6 タスク

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

  :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 タスク

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

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

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

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

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

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

手順3.3 タスク

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

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

   図3.2 サーバー設定

2. サーバー設定の編集

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

手順3.4 タスク

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

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

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

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

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

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

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

   図3.4 デプロイメント選択

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

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

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

手順3.5 タスク

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

   1. コンソールの右上から Hosts タブを選択します。
   2. コンソールの左側にある Server Configurations メニュー項目を展開し、リストから既存のサーバーを選択します。
   選択したサーバーの Server Configuration パネルが表示されます。
   

   図3.8 サーバー設定

2. 新しい設定の作成

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

   図3.9 新しい設定の作成

手順3.6 タスク

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

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

   図3.10 ロギングパネル

2. ロガーの詳細の編集

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

手順3.7 タスク

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

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

   図3.11 Server Groups ビュー

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

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

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

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

   図3.12 Create Server Group ダイアログ

手順3.8 タスク

• • 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 タスク

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

手順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.1 操作アドレスの例

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

      /subsystem=logging

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

      /subsystem=datasources/data-source=java

   2. 操作の決定

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

      :operation-name

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

      例3.2 利用可能な操作

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

      [standalone@localhost:9999 /] /subsystem=logging:read-operation-names
      {
          "outcome" => "success",
          "result" => [
              "add",
              "change-root-log-level",
              "read-attribute",
              "read-children-names",
              "read-children-resources",
              "read-children-types",
              "read-operation-description",
              "read-operation-names",
              "read-resource",
              "read-resource-description",
              "remove-root-logger",
              "set-root-logger",
              "write-attribute"
          ],
          "compensating-operation" => undefined
      }

   3. パラメーターの決定

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

      (parameter-name=parameter-value)

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

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

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

      [standalone@localhost:9999 /] /subsystem=logging:read-operation-description(name=change-root-log-level)
      {
          "outcome" => "success",
          "result" => {
              "operation-name" => "change-root-log-level",
              "description" => "Change the root logger level.",
              "request-properties" => {"level" => {
                  "type" => STRING,
                  "description" => "The log level specifying which message levels will be logged by this logger. 
                                   Message levels lower than this value will be discarded.",
                  "required" => true
              }}
          },
          "compensating-operation" => undefined
      }

2. 完全操作要求の入力

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

   例3.4 操作要求の例

   [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 を使用し、アクティブユーザーのアカウントを表示します。

  [standalone@localhost:9999 /] :whoami

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

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

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

手順3.16 タスク

• version コマンドの実行

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

  [domain@localhost:9999 /] version

手順3.17 タスク

• read-operation-description 操作の実行

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

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

手順3.18 タスク

• read-operation-names の実行

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

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

手順3.19 タスク

1. read-resource 操作の実行

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

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

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

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

   [standalone@localhost:9999 /]:read-resource
   {
       "outcome" => "success",
       "result" => {
           "deployment" => undefined,
           "management-major-version" => 1,
           "management-minor-version" => 2,
           "name" => "hostname",
           "namespaces" => [],
           "product-name" => "EAP",
           "product-version" => "6.0.0.GA",
           "profile-name" => undefined,
           "release-codename" => "Steropes",
           "release-version" => "7.1.2.Final-redhat-1",
           "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.configadmin" => 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.logging" => undefined,
               "org.jboss.as.mail" => undefined,
               "org.jboss.as.naming" => undefined,
               "org.jboss.as.osgi" => 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,
               "configadmin" => undefined,
               "datasources" => undefined,
               "deployment-scanner" => undefined,
               "ee" => undefined,
               "ejb3" => undefined,
               "infinispan" => undefined,
               "jaxrs" => undefined,
               "jca" => undefined,
               "jdr" => undefined,
               "jmx" => undefined,
               "jpa" => undefined,
               "mail" => undefined,
               "naming" => undefined,
               "osgi" => 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.10 ルートノードからの子ノードリソースの公開

   [standalone@localhost:9999 /] /subsystem=web/connector=http:read-resource                      
   {
       "outcome" => "success",
       "result" => {
           "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" => 8433,
           "scheme" => "http",
           "secure" => false,
           "socket-binding" => "http",
           "ssl" => undefined,
           "virtual-server" => undefined
       }
   }
   
   

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

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

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

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

   [standalone@localhost:9999 connector=http] :read-resource
   {
       "outcome" => "success",
       "result" => {
           "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" => 8433,
           "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.12 include-runtime パラメーターを使用して追加でアクティブな値を公開

   [standalone@localhost:9999 /] /subsystem=web/connector=http:read-resource(include-runtime=true)
   {
       "outcome" => "success",
       "result" => {
           "bytesReceived" => "0",
           "bytesSent" => "0",
           "enable-lookups" => false,
           "enabled" => true,
           "errorCount" => "0",
           "executor" => undefined,
           "max-connections" => undefined,
           "max-post-size" => 2097152,
           "max-save-post-size" => 4096,
           "maxTime" => "0",
           "name" => "http",
           "processingTime" => "0",
           "protocol" => "HTTP/1.1",
           "proxy-name" => undefined,
           "proxy-port" => undefined,
           "redirect-port" => 8433,
           "requestCount" => "0",
           "scheme" => "http",
           "secure" => false,
           "socket-binding" => "http",
           "ssl" => undefined,
           "virtual-server" => undefined
       }
   }
   
   

手順3.20 タスク

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

手順3.23 タスク

• write-attribute 操作の実行

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

手順3.24 タスク

• history コマンドの実行

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

  [standalone@localhost:9999 /] history

手順3.25 タスク

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

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

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

手順3.26 タスク

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

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

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

手順3.27 タスク

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

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

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

手順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. 管理ユーザーの追加を選択します。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    2. パターン属性の編集

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

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

    3. パターン属性の確認

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

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

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

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

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

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

    2. Profile tab の選択

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    2. Server タブを選択します。

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

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

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

手順5.1 タスク

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

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

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

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

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

   -Djava.net.preferIPv4Stack=false

3. 以下の 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
   

   注記

   元の設定に戻すには、-Djava.net.preferIPv4Stack を true に変更し、-Djava.net.preferIPv6Addresses=true を削除します。

手順5.2 タスク

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

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

6. サーバーを再起動し、変更を実装します。

手順5.3 タスク

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 タスク

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

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

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

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

手順6.2 タスク

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

   例6.1 module.xml ファイルの例

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

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

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

   例6.2 CLI コマンドの例

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

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

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

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

       依存関係: MODULE_NAME

       例6.3 依存関係の例

       依存関係: com.mysql

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

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

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

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

手順6.4 タスク

• • 管理 CLI

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

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

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

       data-source enable --name=DATASOURCE_NAME

  • 管理コンソール

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

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

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

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

          • ドメインモード

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

       図6.1 データソースパネル

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

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

手順6.5 タスク

1. サーバーを起動します。
2. CLI の起動

3. 設定可能な属性の判断

   次のコマンドを実行し、データソースの設定可能なオプションを判断します。

   /subsystem=datasources/data-source=DATASOURCE_NAME:read-resource

4. 属性の設定

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

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

5. サーバーの再ロード

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

   :reload

手順6.6 タスク

• 次のコマンドを実行してデータソースを削除します。

  data-source remove --jndi-name=JNDI_NAME

手順6.7 タスク

1. サーバーを起動します。
2. 管理 CLI を起動します。
3. 次のコマンドを実行して XA データソースを作成します。

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

   例6.6 コマンドの例

   data-source add --name=MSSQLDS --jndi-name=java:jboss/MSSQLDS --connection-url=jdbc:microsoft:sqlserver://localhost:1433;DatabaseName=MSSQLDB --driver-name=sqljdbc4.jar

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

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

   xa-data-source enable --name=NAME

手順6.8 タスク

1. 設定可能な属性の判断

   次のコマンドを実行し、XA データソースの設定可能なオプションを判断します。

   /subsystem=datasources/xa-data-source=XA_DATASOURCE_NAME:read-resource

2. 属性の設定

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

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

3. サブリソースの設定

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

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

4. サーバーの再ロード

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

   :reload

手順6.9 タスク

• 次のコマンドを実行して XA データソースを削除します。

  xa-data-source remove --jndi-name=JNDI_NAME

手順8.1 タスク

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

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

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

   デプロイメントの方法は、スタンドアローンサーバーインスタンス、管理ドメインにデプロイするかにより違います。

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

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

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

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

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

     2. 確定

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

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

   • 管理ドメインへデプロイ

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

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

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

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

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

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

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

     3. 確定

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

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

手順8.2 タスク

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

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

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

   アンデプロイメントの方法は、スタンドアローンサーバーインスタンス、管理ドメインにデプロイするかにより違います。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

     5. 残りのサーバーグループで繰り返しアンデプロイする手順

        他のサーバーグループに対しても随時、繰り返し設定を行います。アプリケーションステータスは Deployments の表でサーバーグループごとに確認されます。
        

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

手順8.3 タスク

• deploy コマンドの実行

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

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

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

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

手順8.4 タスク

• undeploy コマンドの実行

  管理 CLI で、アプリケーションデプロイメントのファイル名とともにundeploy コマンドを入力します。--all-relevant-server-groups パラメーターを追加することにより、アプリケーションは最初にデプロイされたサーバーグループからデプロイ解除できます。

  [domain@localhost:9999 /] undeploy test-application.war --all-relevant-server-groups
  Successfully undeployed test-application.war.

手順8.5 タスク

• deploy コマンドの実行

  管理 CLI で、アプリケーションデプロイメントへのパスとともに、deploy コマンドを入力します。

  [standalone@localhost:9999 /] deploy ~/path/to/test-application.war 
  'test-application.war' deployed successfully.

手順8.6 タスク

• undeploy コマンドの実行

  管理 CLI で、アプリケーションデプロイメントのファイル名とともに、undeploy コマンドを入力します。

  [standalone@localhost:9999 /] undeploy test-application.war 
  Successfully undeployed test-application.war.

手順8.7 タスク

1. デプロイメントフォルダーへのコンテンツのコピー

   アプリケーションファイルを、EAP_HOME/standalone/deployments/ にあるデプロイメントフォルダーにコピーします。

2. デプロイメントスキャンモード

   アプリケーションデプロイメントは、デプロイメントスキャナーモードが自動か、手動かによって異なります。

   • 自動デプロイメント

     デプロイメントスキャナーは、フォルダーのステータスの変更を検出し、「デプロイメントスキャナーマーカーファイルのリファレンス」トピックで定義されたようにマーカーファイルを作成します。

   • 手動デプロイメント

     デプロイメントスキャナーでは、デプロイメントプロセスをトリガーするマーカーファイルが必要です。以下の例では、Unix touch コマンドを使用して新しい .dodeploy ファイルを作成します。

     例8.1 touch コマンドを使用したデプロイ

     [user@host bin]$ touch $EAP_HOME/standalone/deployments/example.war.dodeploy

手順8.8 タスク

• アプリケーションの再デプロイ

  デプロイメントフォルダーからアプリケーションを削除するか、デプロイメントステータスのみを変更するかに応じて、アプリケーションをデプロイ解除するには 2 つの方法があります。

  • マーカーファイルの削除によるデプロイ解除

    デプロイされたアプリケーションの example.war.deployed マーカーファイルを削除して、ランタイムからのアプリケーションのデプロイ解除を開始するためにデプロイメントスキャナーをトリガーします。

    結果

    デプロイメントスキャナーは、アプリケーションをデプロイ解除し、example.war.undeployed マーカーファイルを作成します。アプリケーションは、デプロイメントフォルダーに維持されます。

  • アプリケーションの削除によるデプロイ解除

    デプロイメントディレクトリーからアプリケーションを削除して、ランタイムからのアプリケーションのデプロイ解除を開始するためにデプロイメントスキャナーをトリガーします。

    結果

    デプロイメントスキャナーは、アプリケーションをデプロイ解除し、filename.filetype.undeployed マーカーファイルを作成します。アプリケーションは、デプロイメントフォルダーにありません。

手順8.9 タスク

• アプリケーションの再デプロイ

  デプロイメントスキャナーでデプロイされたアプリケーションを再デプロイするには、3 つの方法があります。これらの方法はデプロイメントサイクルを開始するためにデプロイメントスキャナーをトリガーし、個々の設定に応じて選択できます。

  • マーカーファイルの変更による再デプロイ

    マーカーファイルのアクセスと変更タイムスタンプを変更して、デプロイメントスキャナーの再デプロイメントをトリガーします。次の Linux の例では、touch コマンドが使用されます。

    例8.3 touch コマンドを使用した再デプロイ

    [user@host bin]$ touch $EAP_HOME/standalone/deployments/example.war.dodeploy

    結果

    デプロイメントスキャナーは、マーカーファイルの変更を検出し、アプリケーションを再デプロイします。新しい .deployed ファイルマーカーは以前のものを置き換えます。

  • 新しい .dedeploy マーカーファイルの作成による再デプロイ

    新しい .dodeploy マーカーファイルを作成することにより、デプロイメントスキャナー再デプロイメントをトリガーします。「デプロイメントスキャナーを使用してスタンドアロンサーバーインスタンスにアプリケーションをデプロイ」に記載された手動デプロイメント手順を参照してください。

  • マーカーファイルの削除による再デプロイ

    「デプロイメントスキャナーマーカーファイルのリファレンス」で説明されているように、デプロイされたアプリケーションの .deployed マーカーファイルを削除すると、デプロイメント解除がトリガーされ、.undeployed マーカーが作成されます。デプロイメント解除マーカーを削除すると、デプロイメントサイクルが再びトリガーされます。詳細については、「デプロイメントスキャナーを使用してスタンドアロンサーバーインスタンスにアプリケーションをデプロイ解除」を参照してください。

手順8.10 タスク

1. 設定するデプロイメントスキャナー属性を決定

   管理 CLI を使用してデプロイメントスキャナーを設定するには、最初に正しい属性名を公開する必要があります。これは、ルートノードで read-resources 操作を使用するか、または cd コマンドを使用してサブシステム子ノードに移動することにより、行えます。また、このレベルで ls コマンドを使用して属性を表示することもできます。

   • read-resource 操作を使用して、デプロイメントスキャナー属性を公開します。

     read-resource 操作を使用して、デフォルトのデプロイメントスキャナーリソースで定義された属性を公開します。

     [standalone@localhost:9999 /]/subsystem=deployment-scanner/scanner=default:read-resource
     {
         "outcome" => "success",
         "result" => {
             "auto-deploy-exploded" => true,
             "auto-deploy-xml" => true,
             "auto-deploy-zipped" => true,
             "deployment-timeout" => 60,
             "path" => "deployments",
             "relative-to" => "jboss.server.base.dir",
             "scan-enabled" => true,
             "scan-interval" => 5000
         }
     }
     

   • ls コマンドを使用してデプロイメントスキャナー属性を公開

     ls コマンドを -l オプション引数を使用して、サブシステムノード属性、値、およびタイプを含む結果の表を表示します。ls コマンドとその引数の詳細は、ls --help と入力して CLI ヘルプエントリを表示して学習できます。管理 CLI のヘルプメニューの詳細については、トピック「管理 CLI でのヘルプの使用」を参照してください。

     [standalone@localhost:9999 scanner=default] ls -l
     ATTRIBUTE            VALUE                 TYPE    
     auto-deploy-exploded true                  BOOLEAN 
     auto-deploy-xml      true                  BOOLEAN 
     auto-deploy-zipped   true                  BOOLEAN 
     deployment-timeout   60                    LONG    
     path                 deployments           STRING  
     relative-to          jboss.server.base.dir STRING  
     scan-enabled         true                  BOOLEAN 
     scan-interval        5000                  INT
     

2. write-attribute 操作を使用してデプロイメントスキャナーを設定

   変更する属性の名前を決定したら、write-attribute を使用して、書き込む属性名と新しい値を指定します。以下のサンプルは、すべて子ノードレベルで実行され、cd コマンドと Tab 補完を使用してデフォルトスキャナーノードに公開および移動できます。

   [standalone@localhost:9999 /] cd subsystem=deployment-scanner/scanner=default
   

   1. 展開されたコンテンツの自動デプロイメントを有効化

      write-attribute 操作を使用して、展開されたアプリケーションコンテンツの自動デプロイメントを有効にします。

      [standalone@localhost:9999 scanner=default] :write-attribute(name=auto-deploy-exploded,value=true)
      {"outcome" => "success"}
      

   2. XML コンテンツの自動デプロイメントを無効化

      write-attribute 操作を使用して XML アプリケーションコンテンツの自動デプロイメントを無効にします。

      [standalone@localhost:9999 scanner=default] :write-attribute(name=auto-deploy-xml,value=false)     
      {"outcome" => "success"}
      

   3. zip 形式のコンテンツの自動デプロイメントを無効化

      write-attribute コマンドを使用して zip 形式のアプリケーションコンテンツの自動デプロイメントを無効にします。

      [standalone@localhost:9999 scanner=default] :write-attribute(name=auto-deploy-zipped,value=false)
      {"outcome" => "success"}
      

   4. パス属性の設定

      write-attribute 操作を使用して、パス属性を変更し、例の newpathname 値を監視するデプロイメントスキャナーの新しいパス名に置き換えます。変更を反映するにはサーバーでリロードする必要があります。

      [standalone@localhost:9999 scanner=default] :write-attribute(name=path,value=newpathname)            
      {
          "outcome" => "success",
          "response-headers" => {
              "operation-requires-reload" => true,
              "process-state" => "reload-required"
          }
      }
      

   5. 相対パス属性の設定

      write-attribute 操作を使用して設定 XML ファイルのパスセクションで定義されたファイルシステムパスに対する相対参照を変更します。変更を反映するには、サーバーでリロードする必要があります。

      [standalone@localhost:9999 scanner=default] :write-attribute(name=relative-to,value=new.relative.dir)
      {
          "outcome" => "success",
          "response-headers" => {
              "operation-requires-reload" => true,
              "process-state" => "reload-required"
          }
      }
      

   6. デプロイメントスキャナーの無効化

      write-attribute 操作を使用して、scan-enabled 値を false に設定することにより、デプロイメントスキャナーを無効にします。

      [standalone@localhost:9999 scanner=default] :write-attribute(name=scan-enabled,value=false)        
      {"outcome" => "success"}
      

   7. スキャン間隔の変更

      write-attribute 操作を使用してスキャン間隔を 5000 ミリ秒から 10000 ミリ秒に変更します。

      [standalone@localhost:9999 scanner=default] :write-attribute(name=scan-interval,value=10000)
      {"outcome" => "success"}
      

手順8.11 Maven によるアプリケーションのデプロイ

1. ターミナルセッションで Maven デプロイコマンドを実行

   ターミナルセッションを開き、quickstart サンプルを含むディレクリーに移動します。
2. Maven デプロイコマンドを実行してアプリケーションをデプロイします。アプリケーションがすでに実行されている場合、アプリケーションはデプロイ解除されます。

   [localhost]$ mvn package jboss-as:deploy

3. アプリケーションデプロイメントの確認

   • ターミナルウィンドウでの結果の参照

     デプロイメントは、ターミナルウィンドウで操作ログを参照して確認できます。

     例8.5 Maven での helloworld アプリケーションの確認

                             
     [INFO] ------------------------------------------------------------------------
     [INFO] BUILD SUCCESSFUL
     [INFO] ------------------------------------------------------------------------
     [INFO] Total time: 3 seconds
     [INFO] Finished at: Mon Oct 10 17:22:05 EST 2011
     [INFO] Final Memory: 21M/343M
     [INFO] ------------------------------------------------------------------------
     
     

   • サーバーターミナルウィンドウでの結果の参照

     また、デプロイメントは、アクティブアプリケーションサーバーインスタンスのステータスストリームで確認することもできます。

     例8.6 アプリケーションサーバーでの helloworld アプリケーションの確認

          
     17:22:04,922 INFO  [org.jboss.as.server.deployment] (pool-1-thread-3) Content added at location /home/dryan/EAP_Home/standalone/data/content/2c/39607b0c8dbc6a36585f72866c1bcfc951f3ff/content
     17:22:04,924 INFO  [org.jboss.as.server.deployment] (MSC service thread 1-1) Starting deployment of "jboss-as-helloworld.war"
     17:22:04,954 INFO  [org.jboss.weld] (MSC service thread 1-3) Processing CDI deployment: jboss-as-helloworld.war
     17:22:04,973 INFO  [org.jboss.weld] (MSC service thread 1-2) Starting Services for CDI deployment: jboss-as-helloworld.war
     17:22:04,979 INFO  [org.jboss.weld] (MSC service thread 1-4) Starting weld service
     17:22:05,051 INFO  [org.jboss.web] (MSC service thread 1-2) registering web context: /jboss-as-helloworld
     17:22:05,064 INFO  [org.jboss.as.server.controller] (pool-1-thread-3) Deployed "jboss-as-helloworld.war"
     
     

手順8.12 Maven によるアプリケーションのデプロイ解除

1. ターミナルウィンドウで Maven デプロイコマンドを実行

   ターミナルセッションを開き、quickstart サンプルを含むディレクリーに移動します。

   例8.7 helloworld アプリケーションディレクリーに移動します。

   [localhost]$ cd ~/EAP_Quickstarts/helloworld
   

2. Maven デプロイ解除コマンドを実行してアプリケーションをデプロイ解除します。

   [localhost]$ mvn jboss-as:undeploy

3. アプリケーションデプロイ解除の確認

   • ターミナルウィンドウでの結果の参照

     デプロイメント解除は、ターミナルウィンドウの操作ログを参照して確認できます。

     例8.8 Maven での helloworld アプリケーションの確認

                             
     [INFO] ------------------------------------------------------------------------
     [INFO] Building JBoss AS Quickstarts: Helloworld
     [INFO]    task-segment: [jboss-as:undeploy]
     [INFO] ------------------------------------------------------------------------
     [INFO] [jboss-as:undeploy {execution: default-cli}]
     [INFO] Executing goal undeploy for /home/dryan/EAP_Quickstarts/helloworld/target/jboss-as-helloworld.war on server localhost (127.0.0.1) port 9999.
     Oct 10, 2011 5:33:02 PM org.jboss.remoting3.EndpointImpl <clinit>
     INFO: JBoss Remoting version 3.2.0.Beta2
     Oct 10, 2011 5:33:02 PM org.xnio.Xnio <clinit>
     INFO: XNIO Version 3.0.0.Beta2
     Oct 10, 2011 5:33:02 PM org.xnio.nio.NioXnio <clinit>
     INFO: XNIO NIO Implementation Version 3.0.0.Beta2
     [INFO] ------------------------------------------------------------------------
     [INFO] BUILD SUCCESSFUL
     [INFO] ------------------------------------------------------------------------
     [INFO] Total time: 1 second
     [INFO] Finished at: Mon Oct 10 17:33:02 EST 2011
     [INFO] Final Memory: 11M/212M
     [INFO] ------------------------------------------------------------------------
     
     

   • サーバーターミナルウィンドウでの結果の参照

     また、デプロイメント解除は、アクティブアプリケーションサーバーインスタンスのステータスストリームで確認することもできます。

     例8.9 アプリケーションサーバーでの helloworld アプリケーションの確認

          
     17:33:02,334 INFO  [org.jboss.weld] (MSC service thread 1-3) Stopping weld service
     17:33:02,342 INFO  [org.jboss.as.server.deployment] (MSC service thread 1-3) Stopped deployment jboss-as-helloworld.war in 15ms
     17:33:02,352 INFO  [org.jboss.as.server.controller] (pool-1-thread-5) Undeployed "jboss-as-helloworld.war"