6.5. HA シングルトンデプロイメント

• 特定のノード上のクラスター化されたサーバーのグループは、設定の問題やネットワークの問題により接続を確立できません。

• 以下の設定ファイルなど、HA 以外の設定が使用されます。

  • Java EE 8 Web Profile、または Java EE 8 Web Profile をサポートする standalone.xml 設定または、Java EE 8 Full Platform プロファイルをサポートする standalone-full.xml。
  • デフォルトのドメインプロファイルまたはフルドメインプロファイルのいずれかで設定される domain.xml 設定。

手順

• アプリケーションが EAR ファイルにデプロイされている場合は、jboss-all.xml ファイル内にある singleton-deployment.xml 記述子または singleton- deployment 要素を META-INF ディレクトリーの最上位に移動します。

  例: シングルトンデプロイメント記述子

  <?xml version="1.0" encoding="UTF-8"?>
  <singleton-deployment xmlns="urn:jboss:singleton-deployment:1.0"/>

  Copy to Clipboard

• アプリケーションデプロイメントを WAR ファイルまたは JAR ファイルとして追加するには、singleton-deployment.xml 記述子をアプリケーションアーカイブの /META-INF ディレクトリーの最上位に移動します。

  例: 特定のシングルトンポリシーを使用したシングルトンデプロイメント記述子

  <?xml version="1.0" encoding="UTF-8"?>
  <singleton-deployment policy="my-new-policy" xmlns="urn:jboss:singleton-deployment:1.0"/>

  Copy to Clipboard

• オプション: jboss-all.xml ファイルで singleton-deployment を定義するには、jboss-all.xml 記述子をアプリケーションアーカイブの /META-INF ディレクトリーの最上位に移動します。

  例: jboss-all.xml での singleton-deployment の定義

  <?xml version="1.0" encoding="UTF-8"?>
  <jboss xmlns="urn:jboss:1.0">
      <singleton-deployment xmlns="urn:jboss:singleton-deployment:1.0"/>
  </jboss>

  Copy to Clipboard

• オプション: singleton ポリシーを使用して jboss-all.xml ファイルで singleton-deployment を定義します。jboss-all.xml 記述子をアプリケーションアーカイブの /META-INF ディレクトリーの最上位に移動します。

  例: 特定のシングルトンポリシーを使用した jboss-all.xml での singleton-deployment の定義

  <?xml version="1.0" encoding="UTF-8"?>
  <jboss xmlns="urn:jboss:1.0">
      <singleton-deployment policy="my-new-policy" xmlns="urn:jboss:singleton-deployment:1.0"/>
  </jboss>

  Copy to Clipboard

• 単純な選択ポリシー

  simple-election-policy は position 属性で示された特定のメンバーを選択します (該当するアプリケーションがデプロイされます)。position 属性は、降順の経過時間でソートされた候補のリストから選択するノードのインデックスを決定します (0 は最も古いノード、1 は 2 番目に古いノード、-1 は最も新しいノード、-2 は 2 番目に新しいノードを示します)。指定された位置が候補の数を超えると、モジュロ演算が適用されます。

  例: 管理 CLI を使用して simple-election-policy で新しいシングルトンポリシーを作成し、位置を -1 に設定

  batch
  /subsystem=singleton/singleton-policy=my-new-policy:add(cache-container=server)
  /subsystem=singleton/singleton-policy=my-new-policy/election-
  policy=simple:add(position=-1)
  run-batch

  Copy to Clipboard

  注記

  新しく作成されたポリシー my-new-policy をデフォルトとして設定するには、以下のコマンドを実行します。

  /subsystem=singleton:write-attribute(name=default, value=my-new-policy)

  Copy to Clipboard

  例: standalone-ha.xml で位置を -1 として simple-election-policy を設定

  <subsystem xmlns="urn:jboss:domain:singleton:1.0">
     <singleton-policies default="my-new-policy">
        <singleton-policy name="my-new-policy" cache-container="server">
           <simple-election-policy position="-1"/>
        </singleton-policy>
     </singleton-policies>
  </subsystem>

  Copy to Clipboard

• ランダムな選択ポリシー

  random-election-policy は、該当するアプリケーションがデプロイされるランダムなメンバーを選択します。

  例: 管理 CLI を使用して random-election-policy で新しいシングルトンポリシーを作成

  batch
  /subsystem=singleton/singleton-policy=my-other-new-policy:add(cache-container=server)
  /subsystem=singleton/singleton-policy=my-other-new-policy/election-policy=random:add()
  run-batch

  Copy to Clipboard

  例: standalone-ha.xml を使用した random-election-policy の設定

  <subsystem xmlns="urn:jboss:domain:singleton:1.0">
     <singleton-policies default="my-other-new-policy">
        <singleton-policy name="my-other-new-policy" cache-container="server">
           <random-election-policy/>
        </singleton-policy>
     </singleton-policies>
  </subsystem>

  Copy to Clipboard

  注記

  ポリシーを追加する前に、cache-container の default-cache 属性を定義する必要があります。定義しないと、カスタムキャッシュコンテナーを使用する場合に、エラーメッセージが表示されることがあります。