D3管理
Related information
クイックスタート
このセクションでは、2つのTIBCO EBX®インスタンスを使用した基本的なD3アーキテクチャの構成を紹介します。開始する前に、各インスタンスが独自のリポジトリで正しく機能することを確認してください。
注意:
EBX®を2つの異なるWebアプリケーションコンテナにデプロイします。両方のインスタンスが同じホストで実行されている場合は、すべての通信TCPポートが異なることを確認してください。
プライマリノードでの既存データスペースの宣言
目的は、プライマリノードから既存のデータスペースを構成してブロードキャストすることです。
ebx.properties プライマリノード構成ファイルを次のように更新します。
-
キー
ebx.d3.modeでD3モードをプライマリとして定義します。
注意:
プライマリノードは、構成後に開始できます。
-
ブロードキャストするデータスペースを「配信データスペース」テーブルに追加し、許可されたプロファイルを宣言します。
-
配信プロファイルを使用して配信データスペースを「配信マッピング」テーブルにマッピングします。
注意:
これで、プライマリノードは、配信プロファイルでレプリカノードを登録する準備が整いました。
登録用レプリカノードの構成
目的は、配信プロファイルと通信設定に基づいてレプリカノードを構成および登録することです。
ebx.propertiesレプリカノード構成ファイルを次のように更新します。
-
キー
ebx.d3.modeでD3モードをレプリカとして定義します。 -
ebx.d3.delivery.profilesにプライマリノードで設定する
配信プロファイルを定義します(配信プロファイルはカンマとスペースで区切る必要があります)。 -
ノード通信のためのプライマリノードユーザー認証（ビルトイン管理者プロファイルが必要）を
ebx.d3.master.usernameおよびebx.d3.master.passwordに定義します。 -
プロパティキーebx.d3.master.urlの値を設定して、プライマリノード通信用の
HTTP/TCPプロトコルを定義します。 -
ノード通信のためのレプリカノードのユーザー認証(ビルトインの管理者プロファイルが必要)を
ebx.d3.slave.usernameおよびebx.d3.slave.passwordに定義します。 -
プロパティキーebx.d3.slave.urlの値を設定して、レプリカノード通信用の
HTTP/TCPプロトコルを定義します。
注意:
レプリカノードは、構成後に開始できます。
注意:
ブロードキャストする前に、モデルが使用可能であることを確認してください（データモデルアシスタントから、公開する必要があります）。
これで、レプリカノードをブロードキャストする準備が整いました。
D3ノードの構成
ユーザーインターフェイスを介したプライマリノードとハブノードのランタイム構成
プライマリノード、ハブノード、レプリカノードの構成
プライマリノード
プライマリノードとして機能するには、EBX®のインスタンスがメインの構成ファイルで次のプロパティを宣言する必要があります。
ebx.d3.mode=masterノードの構成例：
##################################################################
## D3 configuration
##################################################################
##################################################################
# Configuration for master, hub and slave
##################################################################
# Optional property.
# Possibles values are single, master, hub, slave
# Default is single meaning the server will be a standalone instance.
ebx.d3.mode=master
以下も参照してください。:
ハブノード
ハブノード（プライマリノード構成とレプリカノード構成の組み合わせ）として機能するには、EBX®のインスタンスがメイン構成ファイルで次のプロパティを宣言する必要があります。
ebx.d3.mode=hubノードの構成例：
##################################################################
## D3 configuration
##################################################################
##################################################################
# Configuration for master, hub and slave
##################################################################
# Optional property.
# Possibles values are single, master, hub, slave
# Default is single meaning the server will be a standalone instance.
ebx.d3.mode=hub
##################################################################
# Configuration dedicated to hub or slave
##################################################################
# Profiles to subscribe to
# Mandatory property if ebx.d3.mode=hub or ebx.d3.mode=slave
ebx.d3.delivery.profiles=
# User and password to be used to communicate with the master.
# Mandatory properties if ebx.d3.mode=hub or ebx.d3.mode=slave
ebx.d3.master.username=
ebx.d3.master.password=
# User and password to be used by the master to communicate with the hub or slave.
# Mandatory property if ebx.d3.mode=hub or ebx.d3.mode=slave
ebx.d3.slave.username=
ebx.d3.slave.password=
以下も参照してください。:
レプリカノード
レプリカノードとして機能するには、EBX®のインスタンスがメインの構成ファイルで次のプロパティを宣言する必要があります。
ebx.d3.mode=slaveノードの構成例：
##################################################################
## D3 configuration
##################################################################
##################################################################
# Configuration for master, hub and slave
##################################################################
# Optional property.
# Possibles values are single, master, hub, slave
# Default is single meaning the server will be a standalone instance.
ebx.d3.mode=slave
##################################################################
# Configuration dedicated to hub or slave
##################################################################
# Profiles to subscribe to
# Mandatory property if ebx.d3.mode=hub or ebx.d3.mode=slave
ebx.d3.delivery.profiles=
# User and password to be used to communicate with the master.
# Mandatory properties if ebx.d3.mode=hub or ebx.d3.mode=slave
ebx.d3.master.username=
ebx.d3.master.password=
# User and password to be used by the master to communicate with the hub or slave.
# Mandatory property if ebx.d3.mode=hub or ebx.d3.mode=slave
ebx.d3.slave.username=
ebx.d3.slave.password=
以下も参照してください。:
ノードのネットワークプロトコルの構成
HTTP(S)およびソケットTCPプロトコル
HTTP(S)ネットワークプロトコルを使用した
ebx.d3.mode=hubまたは ebx.d3.mode=slaveノードの構成例：
##################################################################
# HTTP(S) and TCP socket configuration for D3 hub and slave
##################################################################
# URL to access the data services connector of the master
# Mandatory property if ebx.d3.mode=hub or ebx.d3.mode=slave and JMS for D3 is not activated.
# This property will be ignored if JMS for D3 is activated.
# The URL must follow this pattern: [protocol]://[master_host]:[master_port]/ebx-dataservices/connector
# Where the possible values of 'protocol' are 'http' or 'https'.
ebx.d3.master.url=
# URL to access the data services connector of the slave
# Mandatory property if ebx.d3.mode=hub or ebx.d3.mode=slave and JMS for D3 is not activated.
# This property will be ignored if JMS for D3 is activated.
# The URL must follow this pattern: [protocol]://[slave_host]:[slave_port]/ebx-dataservices/connector
# Where the possible values of 'protocol' are 'http' or 'https'.
ebx.d3.slave.url=
# Minimum port to use to transfer archives on TCP mode.
# Must be a positive integer above zero and below 65535.
# If not set, a random port will be used.
#ebx.d3.slave.socket.range.min=
# Max port to use on TCP mode to transfer archives.
# Must be a positive integer above ebx.d3.slave.socket.range.min and below 65535.
# Mandatory if ebx.d3.slave.socket.range.min is set.
#ebx.d3.slave.socket.range.max=
JMSプロトコル
JMSがアクティブ化されている場合、D3ノードのJMS機能を有効にするために、次のプロパティを定義できます。
JMSネットワークプロトコルを使用するすべてのD3ノードの構成例：
##################################################################
## JMS configuration for D3
##################################################################
# Taken into account only if Data Services JMS is configured properly
##################################################################
# Configuration for master, hub and slave
##################################################################
# Default is false, activate JMS for D3
## If activated, the deployer must ensure that the entries
## 'jms/EBX_D3ReplyQueue', 'jms/EBX_D3ArchiveQueue' and 'jms/EBX_D3CommunicationQueue'
## are bound in the operational environment of the application server.
## On slave or hub mode, the entry 'jms/EBX_D3MasterQueue' must also be bound.
ebx.jms.d3.activate=false
# Change the default timeout when using reply queue.
# Must be a positive integer that does not exceed 3600000.
# Default is 10000 milliseconds.
#ebx.jms.d3.reply.timeout=10000
# Time-to-live message value expressed in milliseconds.
# This value will be set on each message header 'JMSExpiration' that defines the
# countdown before the message deletion managed by the JMS broker.
# Must be a positive integer equal to 0 or above the value of 'ebx.jms.d3.reply.timeout'.
# The value 0 means that the message does not expire.
# Default is 3600000 (one hour).
#ebx.jms.d3.expiration=3600000
# Archive maximum size in KB for the JMS body message. If exceeds, the message
# is transferred into several sequences messages in a same group, where each one does
# not exceed the maximum size defined.
# Must be a positive integer equals to 0 or above 100.
# Default is 0 that corresponds to unbounded.
#ebx.jms.d3.archiveMaxSizeInKB=
##################################################################
# Configuration dedicated to hub or slave
##################################################################
# Master repository ID, used to set a message filter for the concerned master when sending JMS message
# Mandatory property if ebx.jms.d3.activate=true and if ebx.d3.mode=hub or ebx.d3.mode=slave
#ebx.jms.d3.master.repositoryId=
以下も参照してください。:
プライマリノードのサービス
|
リプレイの再起動
|
フェデレーションの配信を待機しているすべてのリプレイをすぐに再開します。
|
|
レプリカノード配信データスペースの削除
|
選択したレプリカノードの配信データスペースを削除するか、D3プライマリノードの構成から登録を解除します。
サービスにアクセスするには、プライマリノードの[配信データスペース]テーブルから配信データスペースを選択し、ウィザードを起動します。
|
|
完全に再同期
|
最後にブロードキャストされたスナップショットの全コンテンツを、登録されたレプリカノードにブロードキャストします。
|
|
レプリカノードのサブスクライブ
|
選択したレプリカノードのセットをサブスクライブします。
|
|
レプリカノードの非アクティブ化
|
選択したレプリカノードをブロードキャストスコープから削除し、それらの状態を「使用不可」に切り替えます。
注意:
「進行中」のブロードキャストコンテキストはロールバックされます。
|
|
レプリカノード登録の解除
|
選択したレプリカノードをプライマリノードから切断します。
注意:
「進行中」のブロードキャストコンテキストはロールバックされます。
|
注意:
上記のプライマリノードサービスは、一部のブロードキャストが保留中または進行中の間は非表示になります。
レプリカノードのサービス
|
レプリカノードの登録
|
レプリカノードが登録解除されている場合は、プライマリノードに再サブスクライブします。
|
|
レプリカノード登録の解除
|
レプリカノードをプライマリノードから切断します。
注意:
「進行中」のブロードキャストコンテキストはロールバックされます。
|
|
スナップショットを閉じて削除
|
レプリカノード配信データスペースをクリーンアップします。
サービスにアクセスするには、レプリカノードの[配信データスペース]テーブルから配信データスペースを選択し、ウィザードに従って、作成日に基づいてスナップショットを閉じて削除します。
注：最後のブロードキャストスナップショットは自動的に選択から除外されます。
|
監督
最後のブロードキャストスナップショットは、データスペースのスナップショットテーブルで強調表示され、最初の列に表示されるアイコンで表されます。
プライマリノード管理コンソール
いくつかのテーブルは、プライマリノードの「管理」領域の「D3プライマリノード構成」の下にあるプライマリノードの管理コンソールを構成します。それらは次のとおりです。
|
登録されたレプリカノード
|
プライマリノードに登録されているレプリカノード。この表から、各レコードでいくつかのサービスを利用できます。
|
|
公開履歴
|
行われた公開操作の履歴。
|
|
レプリカノード登録ログ
|
行われた初期化操作の履歴。
|
|
詳細な履歴
|
行われたアーカイブ配信の履歴。関連する配信アーカイブのリストには、選択ノードを使用して、テーブル「ブロードキャスト履歴」および「初期化履歴」からアクセスできます。
|
プライマリノード監視サービス
Java APIを介したレプリカノードの監視
レプリカノード監視クラスを作成して、レプリカノードのステータスが「使用可能」または「使用不可」に切り替わったときにトリガーされるアクションを実装できます。そのためには、
NodeMonitoringインターフェイスを実装する必要があります。このクラスは、EBX®モジュールの外部にあり、「ebx.jar」のクラスローダーからアクセスできる必要があり、その完全なクラス名は「D3レプリカノード構成」で指定する必要があります。
以下も参照してください。:
プライマリノードの通知
ログ監視
技術的な監視は、EBX®メイン構成ファイルで宣言されているログカテゴリ「ebx.d3」を介して実行できます。例：
ebx.log4j.category.log.d3= INFO, Console, ebxFile:d3
以下も参照してください。:
一時ファイル
交換されたアーカイブ、SOAPメッセージ、ブロードキャストキュー（...）などの一部の一時ファイルが作成され、EBX®一時ディレクトリに書き込まれます。この場所は、EBX®メイン構成ファイルで定義されています。
#################################################
## Directories for temporary resources.
#################################################
# When set, allows specifying a directory for temporary files different from java.io.tmpdir.
# Default value is java.io.tmpdir
ebx.temp.directory = ${java.io.tmpdir}
# Allows specifying the directory containing temporary files for cache.
# If unset, the used directory is ${ebx.temp.directory}/ebx.platform.
#ebx.temp.cache.directory = ${ebx.temp.directory}/ebx.platform
# When set, allows specifying the directory containing temporary files for import.
# If unset, the used directory is ${ebx.temp.directory}/ebx.platform.
#ebx.temp.import.directory = ${ebx.temp.directory}/ebx.platform