D3 管理
Related information
クイックスタート
このセクションでは、2 つのTIBCO EBX® インスタンスを使用した基本的な D3 アーキテクチャの構成を紹介します。開始する前に、各インスタンスが独自のリポジトリで正しく機能することを確認してください。
注意:
EBX® を 2 つの異なる Web アプリケーションコンテナに展開します。両方のインスタンスが同じホストで実行されている場合は、すべての通信 TCP ポートが異なることを確認してください。
プライマリノードでの既存データスペースの宣言
目的は、プライマリ ノードから既存のデータスペースを構成してブロードキャストすることです。
ebx.properties プライマリ ノード構成ファイルを次のように更新します。
-
キー
ebx.d3.modeでD3 モードをprimaryとして定義します。
注意:
プライマリ ノードは、構成後に開始できます。
-
ブロードキャストするデータスペースを「配信データスペース」テーブルに追加し、許可されたプロファイルを宣言します。
-
配信プロファイルを使用して配信データスペースを「配信マッピング」テーブルにマッピングします。
注意:
これで、プライマリ ノードは、配信プロファイルでレプリカノードを登録する準備が整いました。
登録用レプリカノードの構成
目的は、配信プロファイルと通信設定に基づいて レプリカ ノードを構成および登録することです。
ebx.properties レプリカノード構成ファイルを次のように更新します。
-
キー
ebx.d3.modeで D3 モードをreplicaとして定義します。 -
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 プライマリノードの構成から登録を解除します。
サービスにアクセスするには、プライマリノードの [配信データスペース] テーブルから配信データスペースを選択し、ウィザードを起動します。
|
|
完全に再同期
|
最後にブロードキャストされたスナップショットの全コンテンツを、登録されたレプリカノードにブロードキャストします。
|
|
レプリカノードのサブスクライブ
|
選択したレプリカノードのセットをサブスクライブします。
|
|
レプリカノードの非アクティブ化
|
選択したレプリカノードをブロードキャストスコープから削除し、その状態を「利用不可」に切り替えます。
注意:
「進行中」のブロードキャストコンテキストはロールバックされます。
|
|
レプリカノードの登録解除
|
選択したレプリカノードをプライマリノードから切断します。
注意:
「進行中」のブロードキャストコンテキストはロールバックされます。
|
注意:
一部のブロードキャストが保留中または進行中の場合、上記のプライマリノードサービスは非表示になります。
レプリカノード上のサービス
|
レプリカノードの登録
|
レプリカノードが登録解除されている場合は、プライマリノードに再サブスクライブします。
|
|
レプリカノードの登録解除
|
レプリカノードをプライマリノードから切断します。
注意:
「進行中」のブロードキャストコンテキストはロールバックされます。
|
|
スナップショットを閉じて削除
|
レプリカノード配信データスペースをクリーンアップします。
サービスにアクセスするには、レプリカノードの [配信データスペース] テーブルから配信データスペースを選択し、ウィザードに従って作成日に基づいてスナップショットを閉じて削除します。
注意： 最後のブロードキャストスナップショットは選択から自動的に除外されます。
|
監視
最後にブロードキャストされたスナップショットは、データスペースのスナップショット テーブルで強調表示され、最初の列に表示されるアイコンで表されます。
プライマリノード管理コンソール
プライマリノード監視サービス
Java API によるレプリカノードの監視
プライマリノードの通知
ログ監視
技術的な監視は、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