| |
| pt-verify-checksum |
| ================== |
| |
| 概要 |
| ---- |
| |
| 指定したPostgreSQLのファイルのチェックサムを検証します。 |
| |
| チェックサムを有効にしてデータベースクラスタを作成している必要があります。 （``initdb`` コマンドの ``-k`` オプション） |
| |
| PostgreSQL 9.3以降のバージョンが対象です。 |
| |
| このスクリプトは内部で ``verifychecksum`` コマンドを呼び出します。Red Hat Enterprise Linux 6/CentOS 6以外のOSで動作させる場合は、``src/verifychecksum.c`` を別途ビルドして ``bin`` ディレクトリ以下に配置する必要があります。 |
| |
| 実行方法 |
| -------- |
| |
| .. code-block:: none |
| |
| pt-verify-checksum [option...] [segment file | directory] |
| |
| 引数としてファイル名を指定した場合には、そのファイルのチェックサムを検証します。 |
| |
| 引数としてディレクトリ名を指定した場合には、そのディレクトリにあるファイルのうち、以下のファイルを対象としてチェックサムを検証します。 |
| |
| * ``global`` または ``base`` ディレクトリ以下にあり、かつ、 |
| * ファイル名が数字で構成されるもの（例: ``1234``、``1234.1``）、および末尾に ``_vm`` または ``_fsm`` が付与されているファイル（例: ``1234_vm``、``1234_fsm``） |
| |
| チェックサム検証で1つ以上のファイルにエラーが見つかった場合には終了コード ``1`` を返します。それ以外のエラーが発生した場合には終了コード ``2`` を返します。どのファイルにも問題がなかった場合には ``0`` を返します。 |
| |
| オプション |
| ---------- |
| |
| .. code-block:: none |
| |
| -r, --recursive |
| -v, --verbose |
| --help |
| |
| ``-r``, ``--recursive`` オプションは、ディレクトリを指定した場合に、サブディレクトリ以下を再帰的にスキャンし、該当するファイルのチェックサムを検証します。 |
| |
| ``-v``, ``--verbose`` オプションは、チェックサム検証中により多くのメッセージを出力します。 |
| |
| |
| 出力項目 |
| -------- |
| |
| .. csv-table:: |
| |
| ``blkno``, チェックサムエラーの見つかったブロック番号 |
| ``expected``, ブロックのデータから計算されたチェックサム |
| ``found``, ページヘッダに記録されていたチェックサム |
| ``Verified N files``, チェックサムの検証をしたファイル数 |
| ``N files corrupted``, チェックサムのエラーの見つかったファイル数 |
| |
| 実行例 |
| ------ |
| |
| 単一のファイルのチェックサムを検証します。 |
| |
| .. code-block:: none |
| |
| $ pt-verify-checksum /var/lib/pgsql/9.4/data/base/16386/16399 |
| [2015-03-28 15:50:03] INFO: Verified 1 files. 0 files corrupted. |
| $ |
| |
| データベース内のすべてのファイルのチェックサムを検証します。 |
| |
| .. code-block:: none |
| |
| $ pt-verify-checksum /var/lib/pgsql/9.4/data/base/16386 |
| [2015-03-28 15:51:00] INFO: Verified 311 files. 0 files corrupted. |
| $ |
| |
| データベースクラスタ内を再帰的に探索し、すべてのファイルのチェックサムを検証します。 |
| |
| .. code-block:: none |
| |
| $ pt-verify-checksum -r /var/lib/pgsql/9.4/data |
| [2015-03-28 15:55:16] INFO: /var/lib/pgsql/9.4/data/base/12144/11905: blkno 7, expected 2cf, found da97 |
| [2015-03-28 15:55:16] INFO: 1 blocks corrupted in /var/lib/pgsql/9.4/data/base/12144/11905. |
| [2015-03-28 15:55:16] INFO: Verified 1046 files. 1 files corrupted. |
| $ |
