1 はじめに
2.2 RepCLIコマンド
2.2.1 困ったときは（help）
2.2.2 バージョン番号の印刷（version）
2.2.3 パスワードを暗号化する（暗号化）
2.2.4 ネットワークへの参加（joinnetwork）
2.2.5 ネットワークを離れる（leavenetwork）
2.2.6 データベースを追加する（adddb）
2.2.7 データベースの削除（removedb）
2.2.8 パブリケーションを作成する（createpub）
2.2.9 出版物への参加（joinpub）
2.2.10 出版物を残す（leavepub）
2.2.11 公開（removepub）を除去します
2.2.12 パブリケーションへのテーブルの追加（追加可能）
2.2.14 フィルタを追加する（addfilter）
2.2.15 フィルタを有効にする（enablefilter）
2.2.16 フィルタを更新する（updatefilter）
2.2.17 フィルタを無効にする（disablefilter）
2.2.18 フィルタを削除する（removefilter）
2.2.19 スナップショットをとる（startsnapshot）
2.2.20 スナップショットの再読み込み
2.2.22 スナップショットの状態確認（checksnapshot）
2.2.23 ストリーミング開始（startstreaming）
2.2.24 ストリーミングの停止（stopstreaming）
2.2.26 ロールを作成する（createrole）
2.2.27 ユーザーを作成する（createuser）
2.2.28 ユーザー権限の更新（updateuser）
2.2.29 ユーザパスワードの更新（updatepassword）
2.2.31 データベースリスト（listdb）
2.2.32 出版物リスト（listpub）
2.2.33 出版テーブルの一覧表示（listpubtable）
2.2.34 リスト消費者（listconsumer）
2.2.35 リストの衝突（listconflicts）
2.2.38 Kafka ACLを追加する（addkafkaacl）
2.2.39 Kafka ACLの削除（removekafkaacl）
2.2.40 Kafka ACLのリスト（listkafkaacl）
3 フィルタリング
4 セキュリティ
4.1.1 パスワードを要求しないためのパスワードファイル
4.1.2 権限と役割
4.1.2.1 権限の割り当て
4.1.2.2 ロールの利用
4.2 TLS / SSLセキュリティ
4.2.2 サーバーSSL認証と暗号化通信の有効化
4.2.3 クライアントSSL認証と暗号化通信の有効化
5 モニタリング
5.1 メトリクス
5.1.1 ブローカメトリクス
5.1.2 トピックメトリクスとパーティションメトリクス
5.1.3 クライアントメトリクス
5.1.4 メトリクスの要約
5.1.1.2 アクティブコントローラ数
5.1.1.3 リクエストハンドラの平均アイドル率
5.1.1.4 全てのトピック
5.1.1.5 すべてのトピック
5.1.1.6 全てのトピックメッセージ
5.1.1.7 パーティション数
5.1.1.8 リーダー数
5.1.1.9 オフラインパーティション数
5.1.3.1 記録エラー率
5.1.3.2 リクエスト待ち時間の平均
5.1.3.3 フェッチレイテンシ平均
5.2 監視を開始する
6 その他の設定
6.1 競合の検出、処理、および回復
6.1.1 主キーの一意性
6.1.2 外部キー制約
6.1.1.1 競合解消ポリシーの停止
6.1.1.2 競合解決ポリシーをスキップする
6.1.1.3 競合解決ポリシーの再試行
6.2.1 セキュリティグループへのアクセス
6.2.2 ファイアウォールポートの追加
6.2.3 RepCLIコマンドでのホストロケーションの参照
7 データバリデータ
7.1 インストールと設定
7.2 データ検証の実行
9.1 エラーメッセージと解決方法
9.1.1 RepCLIのエラーメッセージ
9.1.2 データベースを登録できない
9.1.4 データベースサーバへの接続が拒否されました
9.1.5 データベースサーバに接続できない
9.1.7 データベースを削除できない
9.1.8 データベース接続を追加できない
9.1.9 特定のデータ型に対してフィルタを定義できない
9.1.10 テーブル/ビューに同じ名前のフィルタがすでに存在する
9.1.11 パブリケーションテーブルのトリガを作成できない
9.1.12 発行プロセスの問題
9.1.13 パブリケーションを作成できない
9.1.14 パブリケーションスキーマを作成できない
9.2 エラーを探す
9.3 一般的な問題チェックリスト
9.4 トラブルシューティング領域
9.4.1 Javaランタイムエラー
9.4.1.1 パブリケーションサーバの起動
10 自動パーティショニング
1 はじめにこの文書は EDB Postgres Replication Serverバージョン7の 特定の側面に関する詳細情報を提供します 。 EDB Postgres Replication Server（以降EDB Replication Serverと呼びます ）は、PostgreSQL®およびEDB Postgres™Advanced Serverで利用可能なレプリケーションストリーミングシステムです。後者はAdvanced Serverと呼ばれます 。EDB Replication Serverに関する一般情報と、複写ネットワークのインストール、設定、設定の基本手順については、 『 EDB Postgres Replication Serverスタートアップガイド』を参照してください 。
以下の説明では、 用語は、言語キーワード、ユーザー指定の値、リテラルなどである任意の単語または単語のグループを指します。用語の正確な意味は、それが使用される文脈によって異なります。
./runServer.sh --host host_ip_address--config EPRS_HOME / server / etcEPRS_HOME /server/etcディレクトリへのフルディレクトリパス 。同じホストマシン上で複数のレプリケーションサーバーを実行する場合は、 EPRS_HOME /serverディレクトリのコピーを作成し、追加のレプリケーションサーバーのEPRS_HOME /server/etcディレクトリにある特定のプロパティファイルを変更する必要があります。
2.2 RepCLIコマンドEDB Replication Server RepCLIコマンドは 、EDB Replication ServerクライアントパッケージがインストールされているEPRS_HOME /client/binあるrunRepCLI.shスクリプトによって呼び出されます 。一般に、RepCLIコマンドは、RepCLIコマンドの効果をレプリケーションネットワークに関連させるために、リーダーサービスとしてレプリケーションサーバーを実行しているホスト上のEPRS_HOME /client/binディレクトリから実行する必要があります。クライアントパッケージは、リーダーのサービスが実行されているとは別のホストにインストールされている場合あるいは、あなたは場合RepCLIは、この別のホストからのコマンドを実行することができます client.propertiesでファイルEPRS_HOME /client/etcディレクトリを指定するように編集されてリーダーサービスのホストIPアドレスとポート。2.2.1 困ったときは（help）helpコマンドは、すべてのRepCLIコマンドの構文の要約を提供します。2.2.2 バージョン番号の印刷（version）versionコマンドは、EDB Replication ServerのCLIのバージョン番号を提供します。2.2.3 パスワードを暗号化する（暗号化）encryptコマンドは、入力ファイルで提供されたテキストを暗号化し、指定した出力ファイルに暗号化された結果を書き込みます。 encryptコマンドを使用して、データベースユーザーのパスワードを必要とするadddbコマンドで参照できる暗号化パスワードをテキストファイルに生成します。注： encryptコマンドには、以下の許可が必要です。
3 フィルタリング
4 セキュリティ
4.2 TLS / SSLセキュリティKafkaは、 Transport Layer Security （TLS）/ Secure Sockets Layer （SSL）証明書を使用したサーバーとクライアントの認証をサポートしています 。 Kafkaブローカーとクライアント（プロデューサー/コンシューマー）のTLS構成は、キーストアとトラストストアの構成と共に提供する必要があります。注意：次の例では、EDB Replication Serverクライアントとサーバは、1つの複写サーバを持つ同じ単一のホストマシン上で実行されます。したがって、単一のファイルセットのみが生成されます。レプリケーションネットワークに複数のレプリケーションサーバーを含める場合は、このプロセスを各レプリケーションサーバーのブローカーごとに繰り返す必要があります。ステップ1：鍵ストアを生成します。鍵ストアは、サーバーとクライアントのマシンを識別するための証明書と一緒に暗号化に使用される鍵ペアです。Javaの keytoolユーティリティを使用してキーストアを生成できます。手順2：サーバー証明書とクライアント証明書に自己署名するための認証局（CA）を作成します。以下のすべての例で、パスワードtestpassが示されています。ステップ3：ステップ 2で作成した認証局をサーバーおよびクライアントのトラストストアに追加して、この認証局で署名された証明書がサーバーおよびクライアントによって信頼されるようにします。同じトラストストアがサーバーとクライアントの両方のマシンに使用されます。キーストアファイルとトラストストアファイルがディレクトリ /home/user/certにあると仮定して 、次のように、パラメータdir 、 certificate 、およびprivate_keyについて、ファイルopenssl.cnfのセクションで編集を行います。サーバーの最終手順：キーストアからサーバー証明書をエクスポートして署名し、再度インポートします。ステップ6a：サーバ証明書をエクスポートします。ステップ6b：証明書署名要求を生成します。ステップ6c：サーバのキーストアにca-certをインポートします。手順6d：署名付きサーバー証明書をサーバーキーストアにインポートします。クライアントへの最後のステップ：キーストアからクライアント証明書をエクスポートして署名し、インポートします。ステップ7a：クライアント証明書をエクスポートします。ステップ7b：証明書署名要求を生成します。ステップ7c： ca-certをクライアントキーストアにインポートします。ステップ7d：署名付きクライアント証明書をクライアント鍵ストアにインポートします。4.2.2 サーバーSSL認証と暗号化通信の有効化注意：次の例では、EDB Replication Serverクライアントとサーバは、1つの複写サーバを持つ同じ単一のホストマシン上で実行されます。したがって、1セットのプロパティファイルだけが変更されます。レプリケーションネットワークに複数のレプリケーションサーバーが含まれる場合は、各個別のレプリケーションサーバーのブローカーごとにプロパティファイルを変更する必要があります。kafkastore.sslパラメータを修正して適切なディレクトリの場所を指定し、パスワードを指定します。4.2.3 クライアントSSL認証と暗号化通信の有効化注意：次の例では、EDB Replication Serverクライアントとサーバは、1つの複写サーバを持つ同じ単一のホストマシン上で実行されます。したがって、1セットのプロパティファイルだけが変更されます。レプリケーションネットワークに複数のレプリケーションサーバーが含まれる場合は、各個別のレプリケーションサーバーのブローカーごとにプロパティファイルを変更する必要があります。
5 モニタリングモニタリングとは、Kafkaブローカーやコンシューマーやプロデューサーとの間のメッセージ交換などの内部コンポーネントに基づいて、レプリケーションネットワークのパフォーマンスに関連する特定の情報を調べ、記録し、それに対応するプロセスです。JMXインタフェースを使用してMBeanを読み取るためにJolokia と呼ばれる機能を使用してメトリックが読み取られます。 Jolokiaとそのアーキテクチャに関する情報は、次のWebサイトから入手できます。
5.1 メトリクス
5.2 監視を開始する手順1：監視は、レプリケーションサーバーが実行されているホストから実行することも、レプリケーションサーバーのない別のホストから実行することもできます。後者を実現するには、 edb-rs-libsパッケージとedb-rs-monitorパッケージをインストールして監視を実行します。インストール手順については、 EDB Postgres Replication Server入門ガイドを参照してください。ngen.total.nodes = number_of_replication_servers
ngen.jolokia.host.node n = replication_server_host_ip
ngen.jolokia.port.node n = 8778ngen.sender.email = alert_sender_email_address
ngen.sender.email.encrypted.password = encrypted_sender_passwd
ngen.recipient.email = recipient_email_address以下のために送信者の電子メールのパスワードを暗号化し ngen.sender.email.encrypted.passwordとencryptを実行したコマンドrunMonitor.sh中にスクリプトEPRS_HOME /monitor/binディレクトリ：./runMonitor.sh -encrypt -input unencrypted_password_file–output encrypted_password_file注：あなたはまたそれが電子メールを送信するためにこの監視アプリケーションによって送信者の電子メールアカウントへのアクセスを許可することを要求されるかもしれません。モニター・ロギング情報は 、以下に示すように、 EPRS_HOME /monitor/etc/logback.xmlファイルのpropertyエレメントで指定されたディレクトリーおよびファイルに保管されています。cd EPRS_HOME / monitor / bin注：次の例では、角かっこ[cenmmJolokiaMonitorThread]間のテキストは削除されているため、このドキュメントではメトリックを読みやすくしています。ステップ4：重大な問題が発生した場合、モニタリングの出力は次のようになります。monitor.properties以下で示すようにファイルが構成されています。ngen.total.nodes = number_of_replication_servers
ngen.jolokia.host.node n = replication_server_host_ip
ngen.jolokia.port.node n = 8778ngen.sender.email = alert_sender_email_address
ngen.sender.email.encrypted.password = encrypted_sender_passwd
ngen.recipient.email = recipient_email_addressステップ2：用の送信者の電子メールのパスワードを暗号化しngen.sender.email.encrypted.passwordとencryptを実行したコマンドrunMonitor.sh中にスクリプトEPRS_HOME /monitor/binディレクトリ：./runMonitor.sh -encrypt -input unencrypted_password_file–output encrypted_password_fileステップ3： Gmailアカウントにログインします。ステップ4： Settings > Accounts > Google Account settings > security.
ステップ6： ./runMonitor.shコマンドを実行してEメールを送信します。
6 その他の設定
6.1 競合の検出、処理、および回復6.1.1 主キーの一意性
7 データバリデータ比較されている2つのデータベースは、 ソースデータベースとターゲットデータベースと呼ばれ ます 。ソースデータベースはEnterpriseDBタイプにすることができます。ターゲットデータベースもEnterpriseDBタイプである必要があります。注：データバリデータは、次のデータ型を持つ列を検証しません。これらのタイプの1つ以上の列を含む表は、部分的にのみ検証されます。
7.1 インストールと設定ステップ1： EDB Postgres Replication Serverをインストールすると、Data Validator用のコンポーネントもインストールされます。
7.2 データ検証の実行Data Validatorスクリプト runValidation.sh を呼び出す現在の作業ディレクトリは、スクリプトを含むbinサブディレクトリ（つまり、 EPRS_HOME/datavalidator/bin ）である必要があります。./runValidation.sh {–ss | --source-schema} schema_name[ option ] ..../runValidation.sh –ss schema[-ts schema ][-ld log_directory_path ][-sdbms database_type ][-sh host ][-sp port ][-sdb dbname ][-su user ][-spw password ][-tdbms database_type ][ - host ][-tp port ][-tdb dbname ][-tu user ][-tpw password ][-bs row_count ][-fs row_count ]わかりやすくするために、上記の構文図では1文字形式のオプションのみを示しています。 オプションのサブセクションのリストの両方のオプションの単一文字と複数文字の形。データベース接続オプション（前の構文図にリストされている-sdbmsから-tpw ）を指定すると、 datavalidator.propertiesファイル内の対応するパラメーターがオーバーライドされます。 datavalidator.propertiesファイルについては、 7.1項を参照してください。ソースデータベースと比較されるテーブルを含むターゲットデータベースのスキーマ。省略した場合、ターゲットデータベースのスキーマは、 -ssオプションでソースデータベースに指定されたものと同じスキーマになります。比較のために含まれるソーススキーマ内のテーブル。省略した場合、 -etオプションを使用して比較対象から除外された表を除き、ソーススキーマ内のすべての表がターゲットスキーマ内の表と比較されます。 注：カンマとテーブル名の間に空白があってはいけません。比較から除外されるソーススキーマ内のテーブル。省略した場合は、 -itオプションで指定された表のみが比較対象になります。 -itと-et両方のオプションを省略すると、すべてのソーススキーマテーブルが比較のために含まれます。 注：カンマとテーブル名の間に空白があってはいけません。-srs 、 --skip-rowsonlyin-source { true | false }-srt 、 --skip-rowsonlyin-target { true | false }-srb 、 --skip-rowsin-both { true | false }Data Validatorのログファイルと差分ファイルが作成および格納される場所へのディレクトリパス。場合 log_directory_path存在しない場合、データValidatorは、それを作成しようとします。フル・ディレクトリー・パスが指定されていない場合、 log_directory_pathが作成されるか、 runValidation.shスクリプトが呼び出されるEPRS_HOME / datavalidator/ binサブディレクトリーを基準にして配置されると想定されます。 （つまり、logsディレクトリーはEPRS_HOME / datavalidator /bin/ log_directory_pathです。） runValidation.shスクリプトを呼び出すために使用されるオペレーティング・システム・アカウントに、ディレクトリーがまだ存在しない場合はそのディレクトリーを作成する特権、またはファイルを作成する特権があることを確認してください。指定されたディレクトリが既に存在する場合省略した場合、デフォルトはEPRS_HOME /bin/logsディレクトリーです。-ds 、-- --display-summary { true | false }データ検証機能の要約のみを表示するには、 trueを指定し true 。これにより、ソースデータベースとターゲットデータベースの接続情報、およびソースデータベーステーブルによる結果の詳細な内訳が省略されます。すべてのデータ検証ツールの結果を表示するには、 falseを指定しfalse 。 Data Validatorが呼び出されたときにコマンドラインコンソールに表示される情報の種類と量は、その実行のログファイルにも格納されている情報と同じです。省略した場合、デフォルトはfalse （つまり、すべてのData Validator結果が表示されます）。-bsオプションは、ソースおよびターゲット・データベース・テーブルを横切って比較のために使用されるバッチにグループに行数を指定します。たとえば、テーブルに1000行が含まれている場合、 -bs設定を100にすると、ソースデータベースとターゲットデータベースの比較を完了するために10回のバッチ反復が必要になります。 Data Validatorは、ソーステーブルとターゲットテーブルの両方から100行を読み取り、それらをソースバッファとターゲットバッファに追加します。検証スレッドは、ソースバッファとターゲットバッファから100行を読み取り、比較を実行します。その後、比較のために次の100行を読み取って準備します。データベースから100行を-fsために必要な実際のデータベースラウンドトリップは、フェッチサイズの-fsオプションによって異なります。たとえば、 -fsを100に設定すると1往復だけで済み、 -fsを10に設定すると10回のデータベース往復が必要になります。サイズが非常に大きいテーブルに対してデータ検証を実行すると、デフォルトのフェッチサイズ5000行を使用すると、データバリデータがヒープ領域外エラーで終了することがあります。ヒープ領域不足の問題を回避するために、フェッチサイズを小さく指定するには、 -fsオプションを使用します。結果セットの反復は、1回のデータベースラウンドトリップでrow_count値で表されるのと同じ数の行をrow_countます。
コントロールの複製元は、パブリケーションデータベースの登録プロセスの一部として自動的に作成されます。起点は _ngx_DBNAMEであるデータベース名、例えば_ngx_inventory ちなんで命名されます 。パブリケーションデータベースの登録が解除されると、コントロールの複製元は削除されます。ステップ1： SQL端末（たとえばpsql）を開き、ユーザートランザクションを開始します。手順2：他の（クエリ）操作を実行する前に、現在のトランザクションの複製元セッションを設定します。手順3：ユーザー固有のクエリを実行してアプリケーションを変更します（一括変更を目的としています）。Publicationの一部でもあるテーブル exclude_user_test に複数の行を追加します 。レプリケーションからスキップされる一括変更（5K）をシミュレートします。この表もEPRS7クラスター出版物の一部となります。手順4：複製元をリセットします。
9.1 エラーメッセージと解決方法9.1.1 RepCLIのエラーメッセージ
9.2 エラーを探す
9.3 一般的な問題チェックリスト手順2： EDB Replication Serverが実行されていることを確認します。ステップ3： マルチマスターレプリケーションシステムのマスター定義ノードの場合、パブリケーションデータベースユーザーがスーパーユーザーであり、 pg_catalog テーブル を変更する権限を持っていることを確認して ください。ステップ4： ifconfig コマンド によって返されたネットワークIPアドレスが 、application.propertiesのngen.server.hostに 設定されて いるIPアドレスと一致すること を 確認します。ステップ5： ポートが占有されていないことを確認します 。 ポートが占有されている場合は、 application.properties および server.propertiesの ポートを変更してください 。詳細はセクション 6.2.2 を 参照し てください。手順6： 十分な空きディスク容量があることを確認します。そうしないと、インストールおよび設定中にEDB Replication Serverで問題が発生する可能性があります。ステップ7： ファイアウォールを設定した場合は、ファイアウォール設定で、異なるマシンで実行されているEDB Replication Serverを使用したクラスタ設定でEDB Replication Serverが使用するポートにアクセスできることを確認してください。ステップ8： 地理的に分散したネットワークの場合は、実質的に は/ usr / EDB / RS-X.0 /サーバの/ etc にある server.properties ファイル 内 のパラメータ zookeeper.session.timeouts の値を大きくしてください 。さもなければ、ブローカーと動物園主の間で頻繁な機能停止があるでしょう。デフォルト値は6000です。
9.4 トラブルシューティング領域9.4.1 JavaランタイムエラーJavaプログラムが見つからない、またはJavaヒープスペースエラーなど、Java Runtime Environmentに関するエラーが発生した場合は、 / usr / edb / rs にあるEDB Replication Server起動設定ファイル ngxReplicationServer-7.config ファイルに 設定されているパラメータを確認してください。 - x.0 / common / etc / sysconfig9.4.1.1 パブリケーションサーバの起動ステップ2： コントローラデータベースを実行しているデータベースサーバのログファイルでエラーを確認します。
10 自動パーティショニング