1.9 lxrepmkdefコマンド

[名称]

定義ファイル作成コマンド

[抽出対象データベース]

Symfoware Server(Postgres)
Enterprise Postgres

[形式]

表単位レプリケーションの場合で、抽出定義の定義ファイルを作成する場合

lxrepmkdef  -k  CRE
            -r  抽出定義名
            -d  データベース名.スキーマ名.表名
           [  -u  ユーザ名  [  -w  ]  ]
           [  -f  出力先ディレクトリパス名  ]

グループ単位レプリケーションの場合で、抽出定義の定義ファイルを作成する場合

lxrepmkdef  -k  CRE
            -g  レプリケーショングループ名
            -d  データベース名
            [  -u  ユーザ名  [  -w  ]  ]
            -t  情報ファイル名
            [  -f  出力先ディレクトリパス名  ]

表単位レプリケーションの場合で、DBサービス定義の定義ファイルを作成する場合

lxrepmkdef  -k  GEN
            -D  { SYMFOPGS | ENTERPGS }
            -port ポート番号1 [, ポート番号2 ]  [  -u  ユーザ名  [  -w  ]  ]
            -r  INTABLE識別名
            -d  データベース名.スキーマ名.表名
            [  -f  出力先ディレクトリパス名  ]
            [  -host ホスト名1,ホスト名2 ]
            [  -sslmode  { disable | allow | prefer | require | verify-ca | verify-full } ]
            [  -sslservercertcn  サーバ群の共通証明書のCN名 ]

グループ単位レプリケーションの場合で、DBサービス定義の定義ファイルを作成する場合

lxrepmkdef  -k  GEN
            -D  { SYMFOPGS | ENTERPGS }
            -port ポート番号1 [, ポート番号2 ]   [  -u  ユーザ名  [  -w  ]  ]
            -g  REPLICAGROUP識別名
            -d  データベース名
            -t  情報ファイル名
            [  -f  出力先ディレクトリパス名  ]
            [  -host ホスト名1,ホスト名2 ]
            [  -sslmode { disable | allow | prefer | require | verify-ca | verify-full } ]
            [  -sslservercertcn  サーバ群の共通証明書のCN名 ]

レプリケーション用に一括差分複写、または全複写業務定義の定義ファイルを作成する場合

lxrepmkdef  -k  WRK
            -n  業務名
            -m  {  DIFF  |  ALL  } 
            -p  {  PUSH  |  PULL  }
            [  -t  情報ファイル名  ] 
            [  -f  出力先ディレクトリパス名  ]

レプリケーション用に初期複写業務定義の定義ファイルを作成する場合

lxrepmkdef  -k  WRK
            -n  業務名
            -m  INIT
            -p  {  PUSH  |  PULL  }
            -t  情報ファイル名
             [  -f  出力先ディレクトリパス名  ]

[機能説明]

本コマンドは、以下に示す定義ファイルを作成します。

抽出定義の定義ファイル
複写元データベースの定義情報から、抽出定義の定義ファイルの雛型を自動作成します。Symfoware抽出レプリケーションの場合に使用できます。
利用者は、出力されたファイルを必要に応じてカスタマイズし、抽出定義コマンド（lxrepcreコマンド）の入力ファイルとして使用できます。

DBサービス定義の定義ファイル
複写先データベースの定義情報から、DBサービス定義ファイルの雛型を自動作成します。Symfoware抽出レプリケーションの場合で、複写先データベースがSymfoware ServerまたはEnterprise Postgresの場合に使用できます。
利用者は、出力されたファイルを必要に応じてカスタマイズし、DBサービス定義の定義ファイルとして使用できます。

業務定義の業務ファイル
レプリケーション業務用に、業務定義の定義ファイルの雛型を自動作成します。
利用者は、出力されたファイルを必要に応じてカスタマイズし、業務定義の定義ファイルとして使用できます。

[オプションの意味]

-k { CRE | GEN | WRK }

作成する定義ファイルの種類を指定します。

CRE：抽出定義の定義ファイルを作成する場合に指定します。

GEN：DBサービス定義の定義ファイルを作成する場合に指定します。

WRK：業務定義の定義ファイルを作成する場合に指定します。

-D { SYMFOPGS | ENTERPGS }: 複写先データベースの種類を指定します。
SYMFOPGS：定義ファイルの対象とするデータベースがSymfoware Server(Openインタフェース)であることを意味します。
ENTERPGS：定義ファイルの対象とするデータベースがSymfoware Server(Postgres)またはEnterprise Postgresであることを意味します。

-port ポート番号1 [ ,ポート番号2 ]: 接続するSymfoware ServerまたはEnterprise Postgresのデータベースクラスタのpostgresql.confに指定したportパラメタの値を指定します。DBミラーリングシステムに接続する場合は、構成するデータベースサーバのポート番号を全て指定します。hostオプションのn番目に指定したサーバのポート番号は、portオプションのn番目に指定してください。データベースへの接続に関する詳細については、Symfoware ServerまたはEnterprise Postgresのマニュアルを参照してください。

-u ユーザ名: 本コマンドがSymfoware ServerまたはEnterprise Postgresに接続するユーザの名前を63バイト以内の文字列で指定します。ユーザには指定したデータベースへのCONNECT権限が付与されている必要があります。
このオプションを指定すると、パスワードの入力を促すプロンプトが表示され、100バイト以内の文字列のパスワードが入力できます。ただし、本オプションを指定してバッチファイルやシェルスクリプトからコマンドを実行する場合には、-wオプションも合わせて指定してください。
本オプションを省略した場合は、コマンド実行時のOSのユーザ名が指定されたものとみなされます。
本オプションは、抽出定義を作成する場合、またはDBサービス定義の定義ファイルを作成する場合に指定します。

-w: パスワードの入力を促しません。本オプションを指定した場合には、Symfoware ServerまたはEnterprise Postgresへの接続はパスワードを指定せずに行われます。パスワード認証に関する詳細については、Symfoware ServerまたはEnterprise Postgresのマニュアルを参照してください。

-r ｛抽出定義名 | INTABLE識別名｝

表単位のレプリケーションの抽出定義およびDBサービス定義の定義ファイルを作成する場合に指定します。

抽出定義名：抽出定義の定義ファイルを作成する場合に指定します。

INTABLE識別名：DBサービス定義の定義ファイルを作成する場合に指定します。

-g { レプリケーショングループ名 | REPLICAGROUP識別名 }

グループ単位のレプリケーションの抽出定義およびDBサービス定義の定義ファイルを作成する場合に指定します。

レプリケーショングループ名：抽出定義の定義ファイルを作成する場合に指定します。

REPLICAGROUP識別名：DBサービス定義の定義ファイルを作成する場合に指定します。

-d { データベース名.スキーマ名.表名 | データベース名 }: -rオプションを指定した場合は、データベース名、スキーマ名、表名をピリオド“.”で区切って指定します。
-gオプションを指定した場合は、データベース名だけを指定します。

-t 情報ファイル名: 情報ファイル名を214バイト以内の絶対パスで指定します。
-gオプションまたは-kオプションを指定した場合に指定します。
情報ファイルの記述形式は、“1.9.1 情報ファイルの記述形式”を参照してください。

-f 出力先ディレクトリパス名: 本コマンドで作成する定義ファイルの出力先パス名を214バイト以内の絶対パス名で指定します。
空白を含むディレクトリパス名は指定できません。
本オプションを省略した場合、本コマンドを実行したディレクトリに定義ファイルを作成します。
作成したファイルのファイル名は以下のようになります。

-kオプションにCREを指定し、-rオプションを指定した場合
抽出定義名.def
-kオプションにCREを指定し、-gオプションを指定した場合
レプリケーショングループ名.def
-kオプションにGENを指定し、-rオプションを指定した場合
INTABLE識別名.def
-kオプションにGENを指定し、-gオプションを指定した場合
REPLICAGROUP識別名.def
-kオプションにWRKを指定した場合
業務定義名.def

-host ホスト名1,ホスト名2: DBミラーリングシステム連携の場合、複写元のSymfoware ServerまたはEnterprise Postgresにおけるプライマリサーバとスタンバイサーバのホスト名をカンマ区切りで指定します。hostオプションのn番目に指定したサーバのポート番号は、portオプションのn番目に指定してください。データベースへの接続に関する詳細については、Symfoware ServerまたはEnterprise Postgresのマニュアルを参照してください。

-sslmode { disable | allow | prefer | require | verify-ca | verify-full }

Symfoware ServerまたはEnterprise Postgresに接続する際の通信データを暗号化する場合に設定します。本オプションを省略した場合、Symfoware ServerまたはEnterprise Postgresの暗号化設定に従って接続します。データベースへの接続に関する詳細については、Symfoware ServerまたはEnterprise Postgresのマニュアルを参照してください。

disable：非SSLで接続します。

allow：非SSLで接続し、失敗したらSSLで接続します。

prefer：SSLで接続し、失敗したら非SSLで接続します。

require：必ずSSLで接続します。

verify-ca：SSLで接続し、信頼できるCAから発行された証明書を使用します。

verify-full：SSLで接続し、信頼できるCAから発行された証明書を使用してサーバのホスト名が証明書と一致するかを検証します。

-sslservercertcn CN名: DBミラーリングシステムに対して、証明書を使用してSSL接続を行う場合、Symfoware ServerまたはEnterprise Postgresサーバ群の共通証明書のCN名を64バイト以内で指定します。データベースへの接続に関する詳細については、Symfoware ServerまたはEnterprise Postgresのマニュアルを参照してください。
本オプションを指定する場合、-sslmodeオプションに“verify-full”を指定する必要があります。

-n 業務名: 作成するレプリケーション業務の業務名を32文字以内の英小文字を除く英数字で指定します。
ただし、-kオプションにWRKを指定しかつ-mオプションにINITを指定した場合には28文字以内となります。

-m { DIFF | ALL | INIT }

レプリケーション業務を指定します。

DIFF：一括差分複写業務

ALL ：全複写業務

INIT：初期複写業務

INITを指定した業務定義を作成する場合には、以下の注意事項があります。
- 情報ファイルの指定（-tオプション）が必要です。
- グループ単位のレプリケーションの場合、初期複写業務の業務定義ファイルには、抽出定義の数だけ副業務も作成されますが、そのままlxdefwrkコマンドに業務定義ファイル名を指定し、登録を行ってください。
なお、“業務定義ウィンドウ”から登録する場合は、“業務定義ウィンドウ”の[ファイル]-[業務定義ファイルの登録]によって登録を行ってください。
- 登録および反映した業務の開始や停止は、上記の副業務ではなく、-nオプションに指定した業務定義名に対して行ってください。

-p { PUSH | PULL }

レプリケーション業務の業務形態を指定します。

PUSH：押出型業務

PULL：取込み型業務

[注意事項]

抽出定義またはDBサービス定義の定義ファイルを作成する場合には、環境変数LXREPCONFIGにより、動作環境ファイルの作成先ファイルパス名を設定してください。
本コマンドで作成する抽出定義の定義ファイルの雛型、DBサービス定義ファイルの雛型は、複写元データベースと複写先データベースの各列構成が対応していることを前提としています。
対応していない場合は、出力されたファイルを必要に応じてカスタマイズしてください。
本コマンド実行時には、レプリケーション対象となるデータベースが作成されている必要があります。
本コマンド実行時には、Symfoware ServerまたはEnterprise Postgresのインスタンスが起動されている必要があります。
抽出定義名の規約については、“1.4.2 定義項目”を参照してください。
レプリケーショングループ名の規約については、“1.4.2 定義項目”を参照してください。
INTABLE識別名の規約については、“Linkexpress 運用ガイド”を参照してください。
REPLICAGROUP識別名の規約については、“5.2.3 REPLICAGROUP定義文”のNAMEオペランドを参照してください。
-fオプションに指定した出力先ディレクトリパスは、事前に作成しておく必要があります。
本コマンドの実行者は、-fオプションに指定した出力先ディレクトリパス対してファイルを作成する権限が必要です。
業務定義名の規約については、“Linkexpress 運用ガイド”を参照してください。
lxdefwrkコマンドについては、“Linkexpress コマンドリファレンス”を参照してください。

[復帰値]

0：正常終了

0以外：異常終了