DataExchange のユーティリティとサービスのリファレンス

レプリケーション ネットワークを作成および管理するためのさまざまなフェーズで使用されるツールやリソースについて、以下の項目で説明します。

DataExchange にはレプリケーションのすべての段階で使用される一揃いのユーティリティとサービスが含まれています。DataExchange のユーティリティは、レプリケーションの必要条件をデザイン、カスタマイズおよび管理するのに役立ちます。このトピックでは、以下の項目について説明します。

次の表に DataExchange のユーティリティとサービス、および、それぞれが使用されるレプリケーションの主要な段階を示します。DataExchange ユーティリティとサービスの詳細については、この表に示されているトピックで説明しています。

DataExchange ユーティリティのいくつかは、Control Center（ZenCC）で開かれるウィンドウとしてアクセスするか、あるいは［スタート］メニューからアクセスすることができます。他のツールはコマンド ライン インターフェイスのみを提供するため、コマンド プロンプトから実行する必要があります。サービスには、Windows のコントロール パネルからアクセスできます。以下のトピックでは、DataExchange ユーティリティ、サービスおよびショートカットにアクセスするさまざまな方法について示します。

レプリケーションのコマンド ライン ユーティリティを実行するには、コマンド プロンプト ウィンドウを開きます。

GUI ユーティリティやウィザードを実行するには、次の手順を実行します。

このトピックでは、DataExchange のコマンド ライン ユーティリティのリファレンスを提供します。次の表に、ユーティリティと簡単な説明を示します。各ユーティリティの詳細と使用できるコマンド ライン オプションの一覧は、この表の後にあります。

このプログラムは、有効なデータベースをローカル レプリケーション ランタイム環境に登録することによって、そのデータベースをアクティブ化します。

レプリケーション エンジンが実行中で制御テーブルが存在する場合、最初のパートナー サイトとの最初のレプリケーションは自動的に実行されます。最初のレプリケーションが成功すると、新しくアクティブ化されたデータベースは、レプリケーション スケジュールなど、ネットワーク内のすべての管理データを完全に認識します。

dxact [オプション] <DSN>

第 1 サイトのコマンド プロンプトから次の例を実行すると、第 1 サイトのマシン上の Demodata という名前の DSN をアクティブ化します。

次の例は、パートナー サイトから実行しますが、パートナー サイト上の Demodata という名前の DSN をアクティブ化し、Win10Server という名前のマシンとレプリケートします。

次の例では第 1 サイト マシン上の Demodata という名前の DSN をアクティブ化し、dxact のログをコンソールに出力します。

次の例ではパートナー サイト マシン上の Demodata という名前の DSN をアクティブ化し、Adminserver と呼ばれるマシンとレプリケートして、dxact のログを C:\ProgramData\Actian\Zen\Reports にある adminlog.txt という名前のファイルに記録します。

このプログラムは、アクティブなデータベースの制御テーブル クリーンアップ スケジュールを設定または表示します。

dxcleanup [オプション] <操作> <DSN>

この例では、クリーンアップ期間に設定された日数、および demodata という名前のデータ ソースに現存する、許容されている最も古いレコードを表示します。

制御テーブル クリーンアップ ユーティリティの名前とバージョンの一覧、および以下のような追加情報を示すメッセージが表示されます。

許容される最も古い経過日数は 90 日です

このプログラムは DXact を使用して前もってアクティブ化されたリリースを非アクティブ化し、レプリケーション用のアクティブ化されたデータベースの一覧からそれを削除します。レプリケートされたデータベースを物理ストレージから削除する場合には、まず非アクティブ化する必要があります。

dxdeact [オプション] <DSN>

この例では、demodata という名前のデータ ソースを非アクティブ化し、システム データベース内のアクティブ化情報を保持します。デフォルトでアクティブ化情報は削除されます。

dxdeact /keepinfo demodata

このプログラムは、XML 配置記述子ファイルで指定された設定を使用して、DataExchange を 2 つのサイトに配置します。このユーティリティは、Dxact と Dxsynctables の機能を組み合わせることによってレプリケーション処理を簡素化します。

dxdeploy [オプション] <XML ファイル>

DXdeploy は、一方向の Real-Time Backup や、一方向および双方向の Data Synchronization を実装するために使用されます。DXdeploy ユーティリティは、データベースおよびレプリケーション環境についての情報を捕捉するために作成しておいた XML 記述子ファイルを使用します。構文例に示したように、このファイルはユーティリティ実行時に引数として渡されます。DXdeploy は XML 記述子ファイルを使用してレプリケーションに必要な手順を処理します。

DataExchange には 2 つの異なる XML 記述子テンプレートが含まれているので、これを使用してご自身の XML 記述子ファイルを作成し、DXdeploy で使用することができます。DXdeploy にデータを正常にレプリケートさせるためには、テンプレートを編集して必要な情報を指定する必要があります。

EXPRESS.XML テンプレート ファイルを使用した配置の例については、DXdeploy を使用した一方向の配置を参照してください。

CUSTOM.XML テンプレート ファイルを使用した配置の例については、DXdeploy を使用した双方向の配置を参照してください。

デザインされた特定のデータベースの、既存の包含パターンや除外パターンおよび正規表現を追加、置換、または表示します。オプションで、既存または仮定のパターンまたは正規表現をテストすることができます。

dxdynpath [オプション] <操作> <DSN>

dxdynpath ユーティリティで使用するファイルには、システム キーが必要になります。

DataExchange がパターン マッチを使用してファイルの包含または除外を自動的に判断する方法を説明する前に、まず、使用できる式のタイプについて説明します。

dxdynpath ユーティリティでは、以下のタイプのパターン マッチの式を使用することができます。

このタイプの式は、Windows の dir（directory）コマンドに基づいており、正規表現の代わりに使用することができます。Dir 式には以下の特徴があります。

有効な dir 式の例を以下に示します。

正規表現は、テキストを解析および操作するためのパターン マッチ技法です。DataExchange は、Windows バージョンのプログラミング言語 perl と同じ正規表現を使用します。

正規表現には以下の特徴があります。

有効な正規表現の例を以下に示します。

相対パスは、ホーム ディレクトリへの相対パスです。ホーム ディレクトリは、DataExchange が認識できるデータ辞書ファイル（DDF）を含むディレクトリです。DataExchange に認識させるためには、辞書ファイルは DataExchange のユーティリティのいずれかを使用して作成されているか、DataExchange レプリケーション処理で作成されている必要があります。レプリケーション処理で作成された辞書ファイルが既にある場合、ホーム ディレクトリはそれらの場所に対応します。

相対パスは "..\" を使用してディレクトリ レベルを参照します。円記号（\）の代わりにスラッシュ文字（/）を使用することもできます。"..\" はホーム ディレクトリに対してディレクトリ構造の 1 つ上に移動することを意味します。ホーム ディレクトリが c:\myapp\mydata\accounts\ の場合、相対パス "..\" は c:\myapp\mydata を示します。同様に、相対パス "..\..\" は c:\myapp を示します。

有効な正規表現を構築することは容易ではありません。このため、DataExchange は正規表現と dir 式のパターン マッチを検証するためのユーティリティ Dxdynpath.exe を提供しています。このユーティリティは、パターンをコマンド ライン引数と比較し、その比較が合格であるかどうかを報告します。

次の例では、dir 式と c:\bklog\hr または c:\bklog\hr のサブディレクトリに存在すると想定されるファイルを比較しています。この例は、コマンド プロンプトで 1 行で入力する必要があります。

dxdynpath /f=c:\mydata\acct\dbQ299x.mkd /p="Dir ..\..\bklog\hr\dbQ2???.mk? /s" test mydbdsn

想定ファイル dbQ299x.mkd がパターンに一致し、c:\bklog\hr のサブディレクトリに存在するため、dxdynpath は「照合に合格しました」と報告します。

デフォルトで、dxdynpath の出力は画面ではなくログ ファイルに書き込まれます。出力を画面にしたい場合は、/LOGF=オプションを使用します。

この例では、データ ソース名 demodata に現在設定されている包含および除外のパターンを表示します。

dxdynpath /t=both show demodata

包含または除外のパターンが設定されていない場合は、次のようなメッセージが返されます。

EXCLUDE パターンは "" です

第 1 サイトで次のコマンドを実行すると、既に demodata に存在する包含パターンに attend*.mkd が追加されます。

dxdynpath /t=include /p="dir attend*.mkd" append demodata

アクティブなデータベースのイベント ハンドラーを登録、登録解除、および表示します。

dxregevnt [オプション] <操作> <DSN>

この例では、指定したデータベースがイベント ハンドラー DLL を登録しているかどうかを表示します。

イベント ハンドラー DLL が登録されていない場合は、次のようなメッセージが表示されます。

次の例では、64 ビット システム上の C:\Program Files (x86)\Actian\Zen\bin にある dxevent.dll という名前のイベント ハンドラー DLL を demodata に登録します。

dxregevnt /p="C:\Program Files (x86)\Actian\Zen\bin\dxevent.dll" register demodata

イベント ハンドラー DLL が登録されている場合は、次のようなメッセージが表示されます。

Event Handler is "C:\Program Files (x86)\Actian\Zen\bin\dxevent.dll"

ファイルを DSN からパートナー サイトへレプリケートします。

dxrepl [オプション] <DSN> [<SiteID>]

DataExchange イベント ハンドラーが処理に失敗した変更データを見つけ、制御テーブルを一貫性のある状態に戻します。

dxsynctables [オプション] <テーブル> <DSN>

DataExchange には、レプリケーションのデザイン、管理および監視を行う 4 つのグラフィカル ユーザー インターフェイス ツールが含まれています。次の表に、各 GUI ユーティリティとその説明を示します。

DataExchange Manager はレプリケーション ネットワークを管理するのに使用します。これは、ZenCC の外部で独立して実行できるアプリケーションです。［スタート］メニューから［Actian DataExchange］>［DX Manager］を選択するか、ZenCC から［DataExchange］>［Manager］を選択して開きます。

詳細については、DataExchange Manager の使用を参照してください。

DataExchange を使用すると、レプリケーション セッションの構成、レプリケーションの開始、レプリケーションの監視、およびそれを記録することができます。これらの操作を実行するツールはレプリケーション進行状況ビューアーとログ ビューアーです。この画面へは ZenCC からアクセスできます。

詳細については、DataExchange 監視ツール の使用を参照してください。

DataExchange Deployment Wizard は、第 1 サイトとパートナー サイトにレプリケーションを配置するために必要な手順を示します。ウィザードは、DXdeploy コマンド ライン ユーティリティの自動化された代替手段で、［スタート］メニューの［Actian DataExchange］>［DX Deployment Wizard］から、もしくは ZenCC の［DataExchange］>［Deployment Wizard］から起動することができます。

Template Remover はレプリケーション テンプレートを削除するウィザードです。削除されたテンプレートは、サイトをアクティブ化するためには二度と使用できません。このウィザードには、［スタート］メニューから［Actian DataExchange］>［DX Template Remover］を選択するか、ZenCC から［DataExchange］>［Template Remover］を選択してアクセスします。

DataExchange には、スタートアップ時に自動的に開始される 2 つのサービスがあります。このトピックでは、これらのサービスについて説明し、ご自身の業務のニーズに合わせてそのサービスを設定するための情報を提供します。

レプリケーションでの重大な障害を検出し、管理者に電子メールで通知します。

DataExchange には、スケジュールされたレプリケーションに失敗した場合に電子メールで通知する機能があります。障害の種類は次のいずれかです。

そのマシンに Zen サーバー製品がインストールされている場合、DataExchange は通知エージェントと呼ばれるコンポーネントをインストールします。通知エージェント DX Agent は、スケジュールされたレプリケーションに障害が発生したときに通知を行う機能を提供します。

このエージェントはレプリケーション エラーが起こると電子メールを送信します。電子メールの件名には「DataExchange の警告」という語が含まれています。電子メールの本文には以下の主要な内容が含まれています。

このエージェントでは、メール サーバーと通信するために標準的な SMTP（Simple Mail Transfer Protocol）が必要です。エージェントを使用する各レプリケーション マシンでは SMTP サーバーにアクセスできるように設定する必要があります。それに伴って、SMTP サーバーはエージェントを実行している各レプリケーション サイトから電子メールを受け取るように設定する必要があります。

エージェントは認証や暗号化には対応しません。標準 SMTP ポートの 25 以外のポートを許可します。したがって、ファイアウォールが別のポートを開いている場合、どれを使うかを指定することができます。そのポートは認証や暗号化を要求することはできません。

レプリケーションで障害が発生し、SMTP サーバーと通信できない場合はポップアップ メッセージが表示されます。このメッセージは、電子メールが送信できなかったことと、通信できなかった SMTP サーバーの名前の一覧を知らせます。ポップアップ メッセージは、そのコンピューターに誰もログオンしていなくても表示されます。また、このメッセージはレプリケーションに成功するか、SMTP サーバーが使用可能になるまで表示され続けます。メッセージを消すために［OK］をクリックしても、表示され続けます。

DataExchange には、エージェントの構成に使用できる構成ファイルが含まれています。

レプリケーション サービスの実行モジュールです。DataExchange サービスは、データベース間のデータ レプリケーションを実行します。

詳細については、レプリケーションの開始と停止を参照してください。