DataExchange のユーティリティとサービスの使用
DataExchange のユーティリティとサービスのリファレンス
レプリケーション ネットワークを作成および管理するためのさまざまなフェーズで使用されるツールやリソースについて、以下の項目で説明します。
ユーティリティとサービスの概要
DataExchange にはレプリケーションのすべての段階で使用される一揃いのユーティリティとサービスが含まれています。DataExchange のユーティリティは、レプリケーションの必要条件をデザイン、カスタマイズおよび管理するのに役立ちます。このトピックでは、以下の項目について説明します。
レプリケーションの段階と使用するユーティリティ
次の表に DataExchange のユーティリティとサービス、および、それぞれが使用されるレプリケーションの主要な段階を示します。DataExchange ユーティリティとサービスの詳細については、この表に示されているトピックで説明しています。
レプリケーションの段階 | ユーティリティ/サービス名 | ファイル名 | 詳細情報 |
---|
アクティブ化 | プロジェクト リリースのアクティブ化 | | |
非アクティブ化 | プロジェクト リリースの非アクティブ化 | | |
アクティブ化 | データベースへのイベント ハンドラー DLL パスを読み書きするためのユーティリティ | | |
デザイン/アクティブ化 | 配置ユーティリティ | | |
デザイン/アクティブ化 | Deployment Wizard | | |
デザイン | 動的テーブルの設定およびテストのユーティリティ (Real-Time Backup Edition のみ) | | |
デザイン | Template Remover Wizard | | |
レプリケーション | DataExchange エージェント | | |
レプリケーション | 制御テーブルのクリーンアップ設定ユーティリティ | | |
レプリケーション | テーブルの同期化およびチェックのユーティリティ | | |
レプリケーション | Administrator | | |
レプリケーション | 統計およびログ ビュー | | |
レプリケーション | コンソール レプリケーション初期化ユーティリティ | | |
すべて | Zen Replication | | |
ユーティリティのアクセス方法
DataExchange ユーティリティのいくつかは、Control Center(ZenCC)で開かれるウィンドウとしてアクセスするか、あるいは[スタート]メニューからアクセスすることができます。他のツールはコマンド ライン インターフェイスのみを提供するため、コマンド プロンプトから実行する必要があります。サービスには、Windows のコントロール パネルからアクセスできます。以下のトピックでは、DataExchange ユーティリティ、サービスおよびショートカットにアクセスするさまざまな方法について示します。
コマンドライン ユーティリティにアクセスする
レプリケーションのコマンド ライン ユーティリティを実行するには、コマンド プロンプト ウィンドウを開きます。
ZenCC の GUI ユーティリティやウィザードにアクセスする
GUI ユーティリティやウィザードを実行するには、次の手順を実行します。
1 ZenCC のツリー ビューを展開し、項目を選択します。
ZenCC のメニューはツリー内のどの項目が選択されたかによって異なるものが表示されます。
2 データベースのレプリケーション ノードを選択します。
3 ZenCC メニューから[DataExchange]を選択し、ユーティリティを指定します。
コマンド ライン ユーティリティのリファレンス
このトピックでは、DataExchange のコマンド ライン ユーティリティのリファレンスを提供します。次の表に、ユーティリティと簡単な説明を示します。各ユーティリティの詳細と使用できるコマンド ライン オプションの一覧は、この表の後にあります。
ユーティリティ ファイル名 | ユーティリティ名 | 説明 |
---|
| データベース アクティブ化ユーティリティ | ローカル ランタイム環境でレプリケーション ネットワーク上のサイトに属することを登録することにより、有効なデータベースをアクティブ化します。 |
| 制御テーブルのクリーンアップ設定ユーティリティ | アクティブなデータベースの制御テーブルのクリーンアップ スケジュールを設定または取得します。 |
| データベース 非アクティブ化ユーティリティ | dxact を使用して以前にアクティブ化したリリースを非アクティブ化します。 |
| 配置ユーティリティ | DataExchange を XML 配置記述子ファイルで指定した設定を使用して 2 つのサイトに配置します。 |
(Real-Time Backup Edition のみ) | 動的テーブルの設定およびテストのユーティリティ | デザインされたデータベースの正規表現とファイル パターンの追加、置換、表示およびテストをサポートします。 |
| コンソール レプリケーション初期化ユーティリティ | ファイルを DSN からパートナー サイトへレプリケートします。 |
| テーブルの同期化およびチェックのユーティリティ | DataExchange イベント ハンドラーが処理に失敗した変更データを見つけ、制御テーブルを一貫性のある状態に戻します。 |
dxact
DataExchange プロジェクト リリースのアクティブ化
説明
このプログラムは、有効なデータベースをローカル レプリケーション ランタイム環境に登録することによって、そのデータベースをアクティブ化します。
レプリケーション エンジンが実行中で制御テーブルが存在する場合、最初のパートナー サイトとの最初のレプリケーションは自動的に実行されます。最初のレプリケーションが成功すると、新しくアクティブ化されたデータベースは、レプリケーション スケジュールなど、ネットワーク内のすべての管理データを完全に認識します。
構文
dxact [オプション] <DSN>
引数 | 説明 |
---|
<DSN> | アクティブ化されるデータベースのデータ ソース名です。 |
オプション
オプション | 説明 |
---|
/DES[CRIPTION]=<string> | このレプリケーション サイトの説明です。たとえば、"My First Site" となります。データベース名は自動的に追加されます。 [デフォルト=MyFirstSite] |
/DL[LPATH]=<string> | 指定した場合は、イベント ハンドラー DLL への絶対パスです。 [デフォルト=<null>] |
/FI[RSTSITE] | これが第 1 サイトで、このリリースがアクティブ化されている場合のみこのスイッチを使用します。 |
/FO[RCEINSTALL] | 指定した場合、既にアクティブ化されたサイトのコピーであるデータベースのアクティブ化を許可します。 |
/LOG={flags} | どのメッセージ タイプをログに残すかを指定します。 I = 情報メッセージ W = 警告メッセージ E = エラー メッセージ たとえば、'/log=e /log=w' または '/log=we'(デフォルト)はエラーと警告のみをログに記録します。指定しないメッセージはすべて記録されません。 [デフォルト=iwe] |
/LOGF[ILE]=<string> | ログ メッセージのファイル名です。'/LOGFILE=' のみを指定すると、ログはコンソールに出力されます。 [デフォルト=C:\ProgramData\Actian\Zen\Replication\LogFiles\DXACT.log] |
/LOGH[ISTORY]=nnn | ログ履歴で保持するファイル数です。 [デフォルト=5] |
/LOGS[IZE]=nnn | ログ ファイルの最大サイズです。0(ゼロ)は無制限を表します。 [デフォルト=0] |
/LOGW[IDTH]=nnn | ログ メッセージを折り返す行の長さです。(最小値 50) [デフォルト=79] |
/NOI[NITIALREPL] | 指定した場合、レプリケーション エンジンはリリースがアクティブ化された後に初期レプリケーションを実行しません。 |
/NOL[OGO] | 起動時のロゴを表示しません。 |
/ODBCC[ONNSTR]=<string> | 追加の ODBC 接続文字列パラメーターで、次のような書式で指定します。 <名前>=<値>[;<名前>=<値>...] [デフォルト=<null>] |
/ODBCN[AME]=<string> | ODBC 接続のユーザー名です。 [デフォルト=PDUSER] |
/ODBCP[ASSWORD]=<string> | ODBC 接続のパスワードです。 [デフォルト=<null>] |
例
第 1 サイトのコマンド プロンプトから次の例を実行すると、第 1 サイトのマシン上の Demodata という名前の DSN をアクティブ化します。
dxact /FIRSTSITE Demodata
次の例は、パートナー サイトから実行しますが、パートナー サイト上の Demodata という名前の DSN をアクティブ化し、Win10Server という名前のマシンとレプリケートします。
dxact /PARTNERNETADDR=Win10Server Demodata
次の例では第 1 サイト マシン上の Demodata という名前の DSN をアクティブ化し、dxact のログをコンソールに出力します。
dxact /FIRSTSITE /LOGFILE= Demodata
次の例ではパートナー サイト マシン上の Demodata という名前の DSN をアクティブ化し、Adminserver と呼ばれるマシンとレプリケートして、dxact のログを C:\ProgramData\Actian\Zen\Reports にある adminlog.txt という名前のファイルに記録します。
dxact /PARTNERNETADDR=AdminServer /LOGFILE=C:\ProgramData\Actian\Zen\Reports\adminlog.txt Demodata
dxcleanup
DataExchange 制御テーブルのクリーンアップ設定ユーティリティ
説明
このプログラムは、アクティブなデータベースの制御テーブル クリーンアップ スケジュールを設定または表示します。
構文
dxcleanup [オプション] <操作> <DSN>
引数 | 説明 |
---|
<操作> | 有効な引数には SET または SHOW があります。 |
<DSN> | データベースのデータ ソース名です。 |
オプション
オプション | 説明 |
---|
/C[LEANUPPERIOD]=nnn | クリーンアップ サイクルの間隔(日単位)です。 [デフォルト=7] |
/DXA[DMIN]=<string> | DX の管理者名です。 [デフォルト=ADMIN] |
/DXP[ASSWORD]=<string> | DX 管理者のパスワードです。 [デフォルト=password] |
/H[ELP] | コマンドの使用法のヘルプ テキストを表示します。 |
/LOG={flags} | どのメッセージ タイプをログに残すかを指定します。 I = 情報メッセージ W = 警告メッセージ E = エラー メッセージ たとえば、'/log=e /log=w' または '/log=we'(デフォルト)はエラーと警告のみをログに記録します。指定しないメッセージはすべて記録されません。 [デフォルト=iwe] |
/LOGF[ILE]=<string> | ログ メッセージのファイル名です。'/LOGFILE=' のみを指定すると、ログはコンソールに出力されます。 [デフォルト=C:\ProgramData\Actian\Zen\Replication\LogFiles\DXCLEANUP.log] |
/LOGH[ISTORY]=nnn | ログ履歴で保持するファイル数です。 [デフォルト=5] |
/LOGS[IZE]=nnn | ログ ファイルの最大サイズです。0(ゼロ)は無制限を表します。 [デフォルト=0] |
/LOGW[IDTH]=nnn | ログ メッセージを折り返す行の長さです。(最小値 50) [デフォルト=79] |
/N[OLOGO] | 起動時のロゴを表示しません。 |
/ODBCN[AME]=<string> | このデータベースのユーザー名です(セキュリティが有効な場合)。 [デフォルト=<null>] |
/ODBCP[ASSWORD]=<string> | ODBCName で指定されたユーザーのパスワードです(セキュリティが有効な場合)。 [デフォルト=<null>] |
/OL[DESTALLOWED]=nnn | 許容する最も古いレコードの経過日数(日単位)です。 [デフォルト=90] |
/PA[RTNERNETADDR]=<string> | 最初にレプリケートするパートナー サイトのネットワーク アドレス。このスイッチを指定しない場合、DXact はパートナー ネットワーク アドレスを入力する画面を表示します。 [デフォルト=<LocalHost>] |
/PN[LICENSE]=<string> | 登録する PNLicense ファイルを指定します(ネットワークの第 1 サイトでのみ指定)。 [デフォルト=C:\Program Files (x86)\Actian\Zen\bin\repllicense.pnl] |
/PR[EPROCESS] | 指定した場合、スタート データの前処理が実行されます。これは、デザインおよびアクティブ化中にデータベースが変更されておらず、デザイン時にスタート データの前処理が行われたことがわかっていない限り、実行する必要があります。実行しないと、スタート データはレプリケートされません。 |
/REC[ONCILEREP] | 指定した場合、レプリケーション エンジンは、リリースがアクティブ化された後、初期レプリケーション中に調整のための処理を実行します。アクティブ化されたサイトと第 1 サイトとの間でデータが一致していない限り、指定してください。そうしない場合、調整の処理は実行されません。 |
/SI[TETYPE]=<string> | 新規サイトのデフォルトのサイトのタイプを上書きします。COMPLETE または HIGH のいずれかである必要があります。 [デフォルト=COMPLETE] |
/SU[BSCRIBESITES] | 指定した場合、このサイトは(dSite テーブルを介して)すべての新規サイトに自動的にサブスクライブされます。 |
例
この例では、クリーンアップ期間に設定された日数、および demodata という名前のデータ ソースに現存する、許容されている最も古いレコードを表示します。
dxcleanup show demodata
制御テーブル クリーンアップ ユーティリティの名前とバージョンの一覧、および以下のような追加情報を示すメッセージが表示されます。
クリーンアップ期間は 7 日です
許容される最も古い経過日数は 90 日です
dxdeact
DataExchange プロジェクト リリースの非アクティブ化
説明
このプログラムは DXact を使用して前もってアクティブ化されたリリースを非アクティブ化し、レプリケーション用のアクティブ化されたデータベースの一覧からそれを削除します。レプリケートされたデータベースを物理ストレージから削除する場合には、まず非アクティブ化する必要があります。
構文
dxdeact [オプション] <DSN>
引数 | 説明 |
---|
<DSN> | データベースのデータ ソース名です。 |
オプション
オプション | 説明 |
---|
/K[EEPINFO] | システム データベースにアクティブ化情報を保持します(デフォルトでこの情報は削除されます)。 |
/LOG={flags} | どのメッセージ タイプをログに残すかを指定します。 I = 情報メッセージ W = 警告メッセージ E = エラー メッセージ たとえば、'/log=e /log=w' または '/log=we'(デフォルト)はエラーと警告のみをログに記録します。指定しないメッセージはすべて記録されません。 [デフォルト=iwe] |
/LOGF[ILE]=<string> | ログ メッセージのファイル名です。'/LOGFILE=' のみを指定すると、ログはコンソールに出力されます。 [デフォルト=C:\ProgramData\Actian\Zen\Replication\LogFiles\DXDEACT.log] |
/LOGH[ISTORY]=nnn | ログ履歴で保持するファイル数です。 [デフォルト=5] |
/LOGS[IZE]=nnn | ログ ファイルの最大サイズです。0(ゼロ)は無制限を表します。 [デフォルト=0] |
/LOGW[IDTH]=nnn | ログ メッセージを折り返す行の長さです。(最小値 50) [デフォルト=79] |
/N[OLOGO] | 起動時のロゴを表示しません。 |
/ODBCN[AME]=<string> | このデータベースのユーザー名です(セキュリティが有効な場合)。 [デフォルト=<null>] |
/ODBCP[ASSWORD]=<string> | ODBCName で指定されたユーザーのパスワードです(セキュリティが有効な場合)。 [デフォルト=<null>] |
/H[ELP] | コマンドの使用法のヘルプ テキストを表示します。 |
例
この例では、demodata という名前のデータ ソースを非アクティブ化し、システム データベース内のアクティブ化情報を保持します。デフォルトでアクティブ化情報は削除されます。
dxdeact /keepinfo demodata
dxdeploy
DataExchange Deploy
説明
このプログラムは、XML 配置記述子ファイルで指定された設定を使用して、DataExchange を 2 つのサイトに配置します。このユーティリティは、Dxact と Dxsynctables の機能を組み合わせることによってレプリケーション処理を簡素化します。
構文
dxdeploy [オプション] <XML ファイル>
引数 | 説明 |
---|
<XML ファイル> | XML 配置記述子ファイル。XML 記述子ファイル テンプレート(EXPRESS.XML および CUSTOM.XML)は、(64 ビット システムの場合)C:\Program Files (x86)\Actian\Zen\Replication\docs にあります。 |
オプション
オプション | 説明 |
---|
/LOG={flags} | どのメッセージ タイプをログに残すかを指定します。 I = 情報メッセージ W = 警告メッセージ E = エラー メッセージ たとえば、'/log=e /log=w' または '/log=we'(デフォルト)はエラーと警告のみをログに記録します。指定しないメッセージはすべて記録されません。 [デフォルト=iwe] |
/LOGF[ILE]=<string> | ログ メッセージのファイル名です。'/LOGFILE=' のみを指定すると、ログはコンソールに出力されます。 [デフォルト=C:\ProgramData\Actian\Zen\Replication\LogFiles\DXDEPLOY.log] |
/LOGH[ISTORY]=nnn | ログ履歴で保持するファイル数です。 [デフォルト=5] |
/LOGS[IZE]=nnn | ログ ファイルの最大サイズです。0(ゼロ)は無制限を表します。 [デフォルト=0] |
/LOGW[IDTH]=nnn | ログ メッセージを折り返す行の長さです。(最小値 50) [デフォルト=79] |
/N[OLOGO] | 起動時のロゴを表示しません。 |
/S[ITE]=<string> | サイト一覧のどのサイトを配置するか選択します。First | Partner この設定は省略可能です。デモの目的でのみ使用されます。 [デフォルト=<null>] |
/H[ELP] | コマンドの使用法のヘルプ テキストを表示します。 |
XML 記述子ファイルのテンプレート
DXdeploy は、一方向の Real-Time Backup や、一方向および双方向の Data Synchronization を実装するために使用されます。DXdeploy ユーティリティは、データベースおよびレプリケーション環境についての情報を捕捉するために作成しておいた XML 記述子ファイルを使用します。構文例に示したように、このファイルはユーティリティ実行時に引数として渡されます。DXdeploy は XML 記述子ファイルを使用してレプリケーションに必要な手順を処理します。
DataExchange には 2 つの異なる XML 記述子テンプレートが含まれているので、これを使用してご自身の XML 記述子ファイルを作成し、DXdeploy で使用することができます。DXdeploy にデータを正常にレプリケートさせるためには、テンプレートを編集して必要な情報を指定する必要があります。
注意: これらのテンプレート ファイルは、そのままでは正常にデータをレプリケートすることはできません。テンプレート ファイルを作成し、ご自身のレプリケーション環境に応じた情報を指定する必要があります。
EXPRESS.XML
EXPRESS.XML テンプレート ファイルを使用した配置の例については、
DXdeploy を使用した一方向の配置を参照してください。
CUSTOM.XML
CUSTOM.XML テンプレート ファイルを使用した配置の例については、
DXdeploy を使用した双方向の配置を参照してください。
dxdynpath
DataExchange 動的テーブルの設定およびテストのユーティリティ(Real-Time Backup のみ)
説明
デザインされた特定のデータベースの、既存の包含パターンや除外パターンおよび正規表現を追加、置換、または表示します。オプションで、既存または仮定のパターンまたは正規表現をテストすることができます。
構文
dxdynpath [オプション] <操作> <DSN>
引数 | 説明 |
---|
<操作> | 有効な引数には APPEND、REPLACE、SHOW または TEST があります。 |
<DSN> | DataExchange によって作成されたデータベースのデータ ソース名です。 |
オプション
オプション | 説明 |
---|
/F[ILEPATH]=<string> | テストする完全ファイル パスです(<操作> TEST のみで有効)。 ここで使用するパスは、DataExchange によって作成されたデータベースへの絶対パスです。 [デフォルト=<null>] |
/LOG={flags} | どのメッセージ タイプをログに残すかを指定します。 I = 情報メッセージ W = 警告メッセージ E = エラー メッセージ たとえば、'/log=e /log=w' または '/log=we'(デフォルト)はエラーと警告のみをログに記録します。指定しないメッセージはすべて記録されません。 [デフォルト=iwe] |
/LOGF[ILE]=<string> | ログ メッセージのファイル名です。'/LOGFILE=' のみを指定すると、ログはコンソールに出力されます。 [デフォルト=C:\ProgramData\Actian\Zen\Replication\LogFiles\DXDYNPATH.log] |
/LOGH[ISTORY]=nnn | ログ履歴で保持するファイル数です。 [デフォルト=5] |
/LOGS[IZE]=nnn | ログ ファイルの最大サイズです。0(ゼロ)は無制限を表します。 [デフォルト=0] |
/LOGW[IDTH]=nnn | ログ メッセージを折り返す行の長さです。(最小値 50) [デフォルト=79] |
/N[OLOGO] | 起動時のロゴを表示しません。 |
/ODBCN[AME]=<string> | このデータベースのユーザー名です(セキュリティが有効な場合)。 [デフォルト=<null>] |
/ODBCP[ASSWORD]=<string> | ODBCName で指定されたユーザーのパスワードです(セキュリティが有効な場合)。 [デフォルト=<null>] |
/P[ATTERN]=<string> | Glob スタイルのパターン(たとえば、"dir newfile*.mkd")または正規表現です。 <操作> が APPEND または REPLACE の場合、PATTERN は動的テーブルの設定に適用されます。<操作> が TEST の場合、PATTERN はパターン マッチのみに使用されます。それ以外では無視されます。 [デフォルト=<null>] |
/T[YPE]=<string> | INCLUDE、EXCLUDE または BOTH(BOTH は <操作> が SHOW の場合のみ有効)。 [デフォルト=INCLUDE] |
/H[ELP] | コマンドの使用法のヘルプ テキストを表示します。 |
備考
dxdynpath ユーティリティで使用するファイルには、システム キーが必要になります。
DataExchange がパターン マッチを使用してファイルの包含または除外を自動的に判断する方法を説明する前に、まず、使用できる式のタイプについて説明します。
メモ:dxdynpath は、Real-Time Backup Edition のみで使用されます。
式のタイプ
dxdynpath ユーティリティでは、以下のタイプのパターン マッチの式を使用することができます。
•Dir 式
•正規表現
Dir 式
このタイプの式は、Windows の dir(directory)コマンドに基づいており、正規表現の代わりに使用することができます。Dir 式には以下の特徴があります。
•最初の文字として dir を含む必要があります(dir の大文字と小文字は区別されません)。
•辞書ファイルからの相対パスを必ず含まなければなりません。
相対パスを参照してください。絶対パスは使用できません。
•ファイルの名前を含む必要があります。ファイル名には ? および * ワイルドカードを含むことができます。ピリオド(.)はピリオドのみを示すことに注意してください。? ワイルドカードと同じではありません。
•スラッシュ(/)文字、円記号(\)文字、またはその組み合わせを含むことができます。
•サブ ディレクトリのファイルを示すために /s オプションを含むことができます。/s オプションをこの式の最初の文字にすることはできません。それ以外は、オプションの位置に制約はありません。
•式の要素の区切りとして空白文字を含むことができます。
•セミコロン(;)で区切って複数の式を記述できます。セミコロンの前または後ろに空白文字を置くことができますが、必須ではありません。
有効な dir 式の例を以下に示します。
•dir mydbase\*.mkd /s
•dir ..\..\acct/acct*.?db
•dir ../payables/custdb/??posted??.pay
•dir mydbase\*.mkd /s ; dir ..\..\acct/acct*.?db
正規表現
正規表現は、テキストを解析および操作するためのパターン マッチ技法です。DataExchange は、Windows バージョンのプログラミング言語 perl と同じ正規表現を使用します。
正規表現には以下の特徴があります。
•リテラルまたは相対パスを含むことができます。相対パスを使用する場合は、
相対パスを参照してください。
•相対パス内の文字として、スラッシュ(/)文字、円記号(
\)文字、またはその組み合わせを含むことができます。相対パスで 2 つのピリオド文字(..)と組み合わされた場合、スラッシュおよび円記号はパス構造の一部と見なされます。たとえば、..
\..
\.*bak のように使用されます。相対パスを使用する場合は、
相対パスを参照してください。
•セミコロン(;)で区切って複数の式を記述できます。セミコロンの前または後ろに空白文字を置くことができますが、必須ではありません。
•大文字、小文字、およびその組み合わせを使用することができます。
•コマンドライン インタープリターにとって意味のある文字を式に含める場合は、二重引用符で囲みます。たとえば、"|" 文字は、正規表現内では "or" を示します。しかし、コマンド ライン インタープリターではこの同じ文字がパイプ命令を表します。"|" 文字を使用する正規表現では必ず二重引用符で囲む必要があります。文字について不明な場合は、正規表現を二重引用符で囲みます。
•この一覧で挙げた例外を除いて、有効な正規表現構文を使用する必要があります。正規表現の構文については perl のマニュアルを参考にしてください。
有効な正規表現の例を以下に示します。
•"..\..\(mon|tue|wed|thru|fri)\\(([01][0-9]|2[0-3]))\\.*\.mkd"(weekday\hour 相対ディレクトリ構造内の任意の mkd ファイル)
•.*bak("ホーム" ディレクトリ内、またはホーム ディレクトリ下の任意のバックアップ ファイル)
•day\dt\.ddf(名前の書式に day[0-9]t.ddf を持つ辞書ファイル。たとえば、day0t.ddf、day4t.ddf など)
•(\w+)\\.*\\\1\\.*(ホーム ディレクトリより下位にあるすべてのファイル。下位のディレクトリ名が繰り返されます。たとえば、/data/acct/data/purged)
相対パス
相対パスは、ホーム ディレクトリへの相対パスです。ホーム ディレクトリは、DataExchange が認識できるデータ辞書ファイル(DDF)を含むディレクトリです。DataExchange に認識させるためには、辞書ファイルは DataExchange のユーティリティのいずれかを使用して作成されているか、DataExchange レプリケーション処理で作成されている必要があります。レプリケーション処理で作成された辞書ファイルが既にある場合、ホーム ディレクトリはそれらの場所に対応します。
相対パスは "..\" を使用してディレクトリ レベルを参照します。円記号(\)の代わりにスラッシュ文字(/)を使用することもできます。"..\" はホーム ディレクトリに対してディレクトリ構造の 1 つ上に移動することを意味します。ホーム ディレクトリが c:\myapp\mydata\accounts\ の場合、相対パス "..\" は c:\myapp\mydata を示します。同様に、相対パス "..\..\" は c:\myapp を示します。
式のパターン マッチの検証
有効な正規表現を構築することは容易ではありません。このため、DataExchange は正規表現と dir 式のパターン マッチを検証するためのユーティリティ Dxdynpath.exe を提供しています。このユーティリティは、パターンをコマンド ライン引数と比較し、その比較が合格であるかどうかを報告します。
メモ:dxdynpath は、コマンド ライン引数に基づいてパターン マッチを検証するだけです。ファイルやディレクトリの存在を調べたり、ファイルやディレクトリ間を移動したりはしません。たとえば、ファイル acctdata\Bbzz95.mkd に対して式をテストした場合、dxdynpath はこのフォルダーとファイルが存在するかどうかは調べません。
次の例では、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
包含または除外のパターンが設定されていない場合は、次のようなメッセージが返されます。
INCLUDE パターンは "" です
EXCLUDE パターンは "" です
第 1 サイトで次のコマンドを実行すると、既に demodata に存在する包含パターンに attend*.mkd が追加されます。
dxdynpath /t=include /p="dir attend*.mkd" append demodata
メモ:コマンドでは大文字小文字を区別しません。大文字、小文字、およびその組み合わせを使用することができます。
dxregevnt
データベースへのイベント ハンドラー DLL パスを読み書きするための DataExchange ユーティリティ
説明
アクティブなデータベースのイベント ハンドラーを登録、登録解除、および表示します。
構文
dxregevnt [オプション] <操作> <DSN>
引数 | 説明 |
---|
<操作> | 有効な引数には REGISTER、UNREGISTER または SHOW があります。 |
<DSN> | データ ソース名です。 |
オプション
オプション | 説明 |
---|
/DXA[DMIN]=<string> | DX の管理者名です。 [デフォルト=ADMIN] |
/DXP[ASSWORD]=<string> | DX 管理者のパスワードです。 [デフォルト=password] |
/LOG={flags} | どのメッセージ タイプをログに残すかを指定します。 I = 情報メッセージ W = 警告メッセージ E = エラー メッセージ たとえば、'/log=e /log=w' または '/log=we'(デフォルト)はエラーと警告のみをログに記録します。指定しないメッセージはすべて記録されません。 [デフォルト=iwe] |
/LOGF[ILE]=<string> | ログ メッセージのファイル名です。'/LOGFILE=' のみを指定すると、ログはコンソールに出力されます。 [デフォルト=C:\ProgramData\Actian\Zen\Replication\LogFiles\DXREGEVNT.log] |
/LOGH[ISTORY]=nnn | ログ履歴で保持するファイル数です。 [デフォルト=5] |
/LOGS[IZE]=nnn | ログ ファイルの最大サイズです。0(ゼロ)は無制限を表します。 [デフォルト=0] |
/LOGW[IDTH]=nnn | ログ メッセージを折り返す行の長さです。(最小値 50) [デフォルト=79] |
/N[OLOGO] | 起動時のロゴを表示しません。 |
/ODBCN[AME]=<string> | このデータベースのユーザー名です(セキュリティが有効な場合)。 [デフォルト=<null>] |
/ODBCP[ASSWORD]=<string> | アドミニストレーターのパスワードです。 [デフォルト=<null>] |
/P[ATH]=<string> | イベント ハンドラーへの絶対パス(共有ライブラリ)です。 [デフォルト=<null>] |
/H[ELP] | コマンドの使用法のヘルプ テキストを表示します。 |
例
この例では、指定したデータベースがイベント ハンドラー DLL を登録しているかどうかを表示します。
dxregevnt show demodata
イベント ハンドラー 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"
dxrepl
DataExchange コンソール レプリケーション初期化ユーティリティ
説明
ファイルを DSN からパートナー サイトへレプリケートします。
構文
dxrepl [オプション] <DSN> [<SiteID>]
引数 | 説明 |
---|
<SiteID> | レプリケーション セッションの目的のサイトです。 [デフォルト=<null>] |
<DSN> | Zen レプリケーション データ ソース名です。 |
オプション
オプション | 説明 |
---|
/LOG={flags} | どのメッセージ タイプをログに残すかを指定します。 I = 情報メッセージ W = 警告メッセージ E = エラー メッセージ たとえば、'/log=e /log=w' または '/log=we' はエラーと警告のみをログに記録します。指定しないメッセージはすべて記録されません。 [デフォルト=iwe] |
/LOGF[ILE]=<string>/ | ログ メッセージのファイル名です。'/LOGFILE=' のみを指定すると、ログはコンソールに出力されます。 [デフォルト=C:\ProgramData\Actian\Zen\Replication\LogFiles\DXREPL.log] |
/LOGH[ISTORY]=nnn/ | ログ履歴で保持するファイル数です。 [デフォルト=5] |
/LOGS[IZE]=nnn | ログ ファイルの最大サイズです。0(ゼロ)は無制限を表します。 [デフォルト=0] |
/LOGW[IDTH]=nnn | ログ メッセージを折り返す行の長さです。最小値は 50 です。 [デフォルト=79] |
/N[OLOGO] | 起動時のロゴを表示しません。 |
/ODBCN[AME]=<string> | このデータベースのユーザー名(セキュリティが有効な場合) [デフォルト=<null>] |
/ODBCP[ASSWORD]=<string> | ODBCName で指定されたユーザーのパスワード(セキュリティが有効な場合) [デフォルト=<null>] |
/H[ELP] | コマンドの使用法のヘルプ テキストを表示します。 |
dxsynctables
DataExchange のテーブル同期とチェックのユーティリティ
説明
DataExchange イベント ハンドラーが処理に失敗した変更データを見つけ、制御テーブルを一貫性のある状態に戻します。
構文
dxsynctables [オプション] <テーブル> <DSN>
引数 | 説明 |
---|
<テーブル> | 更新するテーブルの名前(*=すべてのテーブル)です。 |
<DSN> | データ ソース名です。 |
オプション
オプション | 説明 |
---|
/E[XCLUDE]=<string> | オプションの、除外するテーブルのカンマ区切りリストです。 [デフォルト=<null>] |
/F[ORCE] | タイムスタンプを記された列の更新を強制します。 |
/LOG={flags} | どのメッセージ タイプをログに残すかを指定します。 I = 情報メッセージ W = 警告メッセージ E = エラー メッセージ たとえば、'/log=e /log=w' または '/log=we'(デフォルト)はエラーと警告のみをログに記録します。指定しないメッセージはすべて記録されません。 [デフォルト=iwe] |
/LOGF[ILE]=<string> | ログ メッセージのファイル名です。'/LOGFILE=' のみを指定すると、ログはコンソールに出力されます。 [デフォルト=C:\ProgramData\Actian\Zen\Replication\LogFiles\] |
/LOGH[ISTORY]=nnn | ログ履歴で保持するファイル数です。 [デフォルト=5] |
/LOGS[IZE]=nnn | ログ ファイルの最大サイズです。0(ゼロ)は無制限を表します。 [デフォルト=0] |
/LOGW[IDTH]=nnn | ログ メッセージを折り返す行の長さです。最小値は 50 です。 [デフォルト=79] |
/M[SD] | データにスタート データのタイムスタンプのマークを付けます。 |
/N[OLOGO] | 起動時のロゴを表示しません。 |
/ODBCN[AME]=<string> | このデータベースのユーザー名(セキュリティが有効な場合) [デフォルト=<null>] |
/ODBCP[ASSWORD]=<string> | ODBCName で指定されたユーザーのパスワード(セキュリティが有効な場合) [デフォルト=<null>] |
/H[ELP] | コマンドの使用法のヘルプ テキストを表示します。 |
GUI ユーティリティ
DataExchange には、レプリケーションのデザイン、管理および監視を行う 4 つのグラフィカル ユーザー インターフェイス(GUI)ユーティリティが含まれています。GUI ベースのユーティリティと各ユーティリティの簡単な説明を次の表に示します。
ユーティリティ ファイル名 | ユーティリティ名 | 説明 |
---|
| Manager | GUI DX 管理ユーティリティです。通知、ユーザー アクセスおよびレプリケーション スケジュール情報を設定します。 |
| レプリケーション進行状況ビューアーとログ ビューアー | GUI の統計およびログ表示ユーティリティです。レプリケーション セッションの設定、データ レプリケーションの監視およびログのオプションを設定します。 |
| Deployment Wizard | レプリケーションを配置するウィザードです。 |
| Template Remover Wizard | レプリケーション テンプレートを削除するウィザードです。 |
da
DataExchange Manager
説明
DataExchange Manager はレプリケーション ネットワークを管理するのに使用します。これは、ZenCC の外部で独立して実行できるアプリケーションです。[スタート]メニューから[Actian DataExchange]>[DX Manager]を選択するか、ZenCC から[DataExchange]>[Manager]を選択して開きます。
replmonitor
レプリケーション進行状況ビューアーとログ ビューアー
説明
DataExchange を使用すると、レプリケーション セッションの構成、レプリケーションの開始、レプリケーションの監視、およびそれを記録することができます。これらの操作を実行するツールはレプリケーション進行状況ビューアーとログ ビューアーです。この画面へは ZenCC からアクセスできます。
dpwizard
DataExchange Deployment Wizard
説明
DataExchange Deployment Wizard は、第 1 サイトとパートナー サイトにレプリケーションを配置するために必要な手順を示します。ウィザードは、DXdeploy コマンド ライン ユーティリティの自動化された代替手段で、[スタート]メニューの[Actian DataExchange]>[DX Deployment Wizard]から、もしくは ZenCC の[DataExchange]>[Deployment Wizard]から起動することができます。
trwizard
DataExchange Template Remover Wizard
説明
Template Remover はレプリケーション テンプレートを削除するウィザードです。削除されたテンプレートは、サイトをアクティブ化するためには二度と使用できません。このウィザードには、[スタート]メニューから[Actian DataExchange]>[DX Template Remover]を選択するか、ZenCC から[DataExchange]>[Template Remover]を選択してアクセスします。
サービス
DataExchange には、スタートアップ時に自動的に開始される 2 つのサービスがあります。このトピックでは、これらのサービスについて説明し、ご自身の業務のニーズに合わせてそのサービスを設定するための情報を提供します。
ファイル名 | ユーティリティ名 | 説明 |
---|
| DataExchange エージェント | レプリケーションでの重大な障害を検出し、管理者に電子メールで通知します。 |
| Zen Replication | データベース間のデータ レプリケーションを実行します。 |
dxagent
DataExchange エージェント
説明
レプリケーションでの重大な障害を検出し、管理者に電子メールで通知します。
障害の通知
DataExchange には、スケジュールされたレプリケーションに失敗した場合に電子メールで通知する機能があります。障害の種類は次のいずれかです。
•スケジュールされたレプリケーションが、指定時間内にレプリケートを行うことに失敗しました。
•レプリケーション サイトとの通信に失敗しました。マシンがダウンしていたり、ネットワークで問題が発生していたりするかもしれません。
通知エージェント
そのマシンに Zen サーバー製品がインストールされている場合、DataExchange は通知エージェントと呼ばれるコンポーネントをインストールします。通知エージェント DX Agent は、スケジュールされたレプリケーションに障害が発生したときに通知を行う機能を提供します。
このエージェントはレプリケーション エラーが起こると電子メールを送信します。電子メールの件名には「DataExchange の警告」という語が含まれています。電子メールの本文には以下の主要な内容が含まれています。
•障害が発生したコンピューターの ID
•データベースの名前
•レプリケーションに最後に成功してからの経過時間
通信プロトコル
このエージェントでは、メール サーバーと通信するために標準的な SMTP(Simple Mail Transfer Protocol)が必要です。エージェントを使用する各レプリケーション マシンでは SMTP サーバーにアクセスできるように設定する必要があります。それに伴って、SMTP サーバーはエージェントを実行している各レプリケーション サイトから電子メールを受け取るように設定する必要があります。
エージェントは認証や暗号化には対応しません。標準 SMTP ポートの 25 以外のポートを許可します。したがって、ファイアウォールが別のポートを開いている場合、どれを使うかを指定することができます。そのポートは認証や暗号化を要求することはできません。
レプリケーションで障害が発生し、SMTP サーバーと通信できない場合はポップアップ メッセージが表示されます。このメッセージは、電子メールが送信できなかったことと、通信できなかった SMTP サーバーの名前の一覧を知らせます。ポップアップ メッセージは、そのコンピューターに誰もログオンしていなくても表示されます。また、このメッセージはレプリケーションに成功するか、SMTP サーバーが使用可能になるまで表示され続けます。メッセージを消すために[OK]をクリックしても、表示され続けます。
エージェントの設定
DataExchange には、エージェントの構成に使用できる構成ファイルが含まれています。
►通知エージェントを構成するには
1 テキスト エディターで DXAgentConfig.xml ファイルを開きます。64 ビット システムの場合、このファイルは C:\Program Files (x86)\Actian\Zen\Replication\Config にあります。
<?xml version="1.0"?>
<dxagentconfig>
<smtpserver>
<hostname>SMTP Server To Be Configured
</hostname
<port>25</port>
</smtpserver>
<email>
<from>DXAgent@MyCompany.com</from>
<to>Email Address To Be Configured</to>
</email>
</dxagentconfig>
2 このファイルの以下の部分を指定します。
•設定する SMTP サーバー - 電子メール サーバーの名前または IP アドレス。
•25- メール受信に使用する電子メール サーバーのポート番号。デフォルトで、ポート 25 に設定されています。
•DXAgent@mycompany.com - 通知の送信者としてエージェントが使用する電子メール アドレス。このアドレスは情報としてのみ必要で、実際に有効なアドレスである必要はありません。
•設定する電子メール アドレス - エージェントが通知の受信者として使用する電子メールアドレス。アドレスは 1 つしか許可されませんが、グループ アドレスでもかまいません。
以下の例は、変更を加えた DXAgentConfig.xml ファイルを示します。
<?xml version="1.0"?>
<dxagentconfig>
<smtpserver>
<hostname>myserver.mylocation.mycompany.com</hostname>
<port>25</port>
</smtpserver>
<email>
<from>DXAgent@mycompany.com</from>
<to>mailbox@myserver.mylocation.mycompany.com</to>
</email>
</dxagentconfig>
3 変更した DXAgentConfig.xml ファイルを保存します。
4 レプリケーション スケジュールにまだ通知を含めていない場合は、通知を含めるように設定し直してください。
replserv
Zen レプリケーション サービス
説明
レプリケーション サービスの実行モジュールです。DataExchange サービスは、データベース間のデータ レプリケーションを実行します。
詳細については、
レプリケーションの開始と停止を参照してください。