Cyber Thunderのブログ

Webサーバのコンテンツ配置ディレクトリがsambaマウント領域でsambaとの通信が瞬断事象

清書はこれから
■手動でsambaマウント

mount -t cifs -o username=smbuser //192.168.159.128/Share /mnt/smb_share

■fstabに記載
//192.168.159.128/Share /mnt/smb_share cifs credentials=/etc/samba/auth.cred,uid=apache,gid=apache,file_mode=0777,dir_mode=0777,defaults,_netdev 0 0

# mount -a

# systemctl daemon-reload

■mountコマンドを実行すると、デフォルトで以下のmountオプションが適用されている

---中略---

//192.168.159.128/Share on /mnt/smb_share type cifs (rw,relatime,vers=3.1.1,cache=strict,upcall_target=app,username=smbuser,uid=48,forceuid,gid=48,forcegid,addr=192.168.159.128,file_mode=0777,dir_mode=0777,soft,nounix,serverino,mapposix,reparse=nfs,nativesocket,symlink=native,rsize=4194304,wsize=4194304,bsize=1048576,retrans=1,echo_interval=60,actimeo=1,closetimeo=1)

■sambaクライアント側で以下を実行

# time cp -p /mnt/smb_share/testfile.img /tmp/

※ちなみにtestfile.imgは5GBのファイルで以下の実行には15秒くらいかかる

■sambaクライアント側でコピー開始から数秒後にsambaサーバ側でネットワークインタフェースを80秒間切断してから再接続
# nmcli device disconnect ens160 ; sleep 80 ; sudo nmcli device connect ens160

■コピー完了後にファイルが壊れてないか確認
# md5sum /mnt/smb_share/testfile.img
ec4bcc8776ea04479b786e063a9ace45 /mnt/smb_share/testfile.img
# md5sum /tmp/testfile.img
ec4bcc8776ea04479b786e063a9ace45 /tmp/testfile.img

■以下のようにretransとecho_intervalを変えてやれば十数秒の瞬断ではsamba接続は120秒おきに5回試行されるようになりコピー時間は伸びるがコピー自体は成功する
//192.168.159.128/Share on /mnt/smb_share type cifs (rw,relatime,vers=3.1.1,cache=strict,upcall_target=app,username=smbuser,uid=48,forceuid,gid=48,forcegid,addr=192.168.159.128,file_mode=0777,dir_mode=0777,soft,nounix,serverino,mapposix,reparse=nfs,nativesocket,symlink=native,rsize=4194304,wsize=4194304,bsize=1048576,retrans=5,echo_interval=120,actimeo=1,closetimeo=1)

逆に、,retrans=0,echo_interval=1にしたらコピーが失敗し、ファイルも破損した。

※echo_interval=0はkernelの仕様上許可されない設定範囲らしい

■このほかの考慮点

Webサーバ（バックエンドWebサーバとフロントエンドリバースプロキシ）の両方でTimeout値が存在し、httpd2.4ではデフォルト値は60秒。こちらに抵触してWeb通信がエラーになることがあるらしいが、この場合はWebクライアント側で通信が失敗したことが検知されるはずなので、クライアント側に誤って壊れたコンテンツがダウンロードされることはないらしい。クライアント側がブラウザならエラー画面が表示され、APIクライアントならやはりhttp通信の失敗が検知されるらしい。

ーーーーーーーーーーー以後したがきーーーーーーーーーーーーーーーーーーー

📋 本番作業時の想定挙動リスト（ネットワーク瞬断影響）

1. 前提条件と環境構成

作業内容: Web/DBサーバーが経由するネットワーク機器の再起動（想定通信断絶時間: 最大80秒間）
アクセス領域: ApacheのDocumentRootは、別の共有サーバーからSambaマウント（cifs）されている
処理内容: 静的コンテンツ（5GB等）のダウンロード、およびDB（PostgreSQL）に対するユーザー認証（SELECT文のみの参照処理）
クライアント要件: コンテンツ破損は絶対に不可（NG）。ただし、エラー検知後のクライアント側でのリトライ（再試行）は許容とする。

2. 各レイヤーにおける想定挙動とタイムアウト値

📂 ① ストレージ層（Sambaマウント / CIFS）

適用オプション: retrans=1, echo_interval=60（デフォルト値、または明示的指定）
想定挙動:
- 機器の切断が発生しても、OSの低レイヤー（TCP Retransmission）が自動的にパケット再送を繰り返し、最大数分間（約15分）バックグラウンドで粘り続けます。
- 80秒の切断であれば、Sambaマウントは「Host is down」等の致命的エラー（マウント解除）にはならず、セッションを完全に維持（暗黙の再マウント）します。
データ整合性: cache=strict の働きにより、ファイルが「虫食い（破損）」の状態で読み込まれることは絶対にありません。

🌐 ② Webサーバー層（Apache httpd 2.4 / nginx）

適用設定: Apache Timeout 120 / nginx proxy_read_timeout 120s（★60秒から変更済）
想定挙動:
- Sambaマウント層がバックグラウンドで粘っている間、Web層へデータが届かなくなるため、Apacheとnginxのタイムアウトタイマーが一斉にカウントを開始します。
- タイムアウト値を 120秒 に拡張しているため、80秒の瞬断中もWebサーバー側が先に諦めてセッションをブチ切ることはありません。 機器が復帰（80秒後）した瞬間に、データ転送が何事もなかったかのように再開されます。
- ※もしデフォルト（60秒）のままだった場合は、80秒を待てずにWebサーバーが接続を切り、クライアントへエラーを返します（これも仕様上検知可能なので許容内です）。

🗄️ ③ データベース層（PostgreSQL）

対象処理: ユーザー認証用の SELECT 文（参照のみ）
想定挙動:
- Sambaと同様にTCPプロトコル上で動いているため、数十秒〜80秒の瞬断であればOSのTCP再送が自動で耐え、復帰後に正常にクエリ結果が返ります。
- データ整合性: データの書き換え（INSERT/UPDATE）を行わないため、DB内のユーザーアカウント情報が破損・消失するリスクは「ゼロ」です。
- ※アプリやDB側で statement_timeout が短く（30秒など）設定されている場合、瞬断中にログインを試みた一部のユーザーが「認証タイムアウト（500/504等）」になりますが、データは守られます。

💻 ④ クライアント層（Webブラウザ / APIクライアント）

想定挙動:
- ブラウザ（Chrome/Edge等）: HTTPヘッダーの Content-Length を厳密にチェックしています。万が一サーバー側のタイムアウト（60秒など）が先に発動して途中で通信が切れた場合、一時ファイルを隔離して画面に「失敗 - ネットワークエラー」と赤字で明確に表示します。壊れたファイルを正常として保存する盲点は一切ありません。
- APIクライアント: データの不足、あるいはTCPソケットの突然の切断をプログラム上の「例外（Exception）」として100%確実に検知します。
- リトライ実行時: クライアントがエラーを検知してリトライをかければ、復帰後は確実に100%正しいファイルを最初から（または続きから）取得し直すことができます。

MariaDBのPITR

PITRはフルバックアップからバイナリーログを指定してロールフォーワードすることにより実行するらしい。

MariaDB Point In Time Recovery | MariaDBIn this blog, get step by step instructions on how to restore a MariaDB database to a point in time in the past.

mariadb.com

手順は以下の通り。

■バイナリログ有効化

my.cnfの[mysqld]セクションに以下を追記してmariadbサービスを再起動する。

# cat /etc/my.cnf.d/server.cnf
---中略---
[mysqld]

---中略---
log-bin = /var/lib/mysql_bin/mariadb-bin
binlog_format = ROW
server-id = 1
---中略---
※デフォルトでは、バイナリログ保存場所はmariadbのデータディレクトリになる

※PITRはフルバックアップとフルバックアップ取得時点から戻る日時までのバイナリログが必要で、mysqlデータディレクトリにバイナリログを書き込むとフルバックアップからリストアする際に一旦データディレクトリ内のバイナリログ以外のファイルを削除するプロセスがあるが、このときにバイナリログだけ残すのは煩雑なのであらかじめバイナリログの書き出し場所とデータディレクトリを別にした方が都合がいい。

# systemctl restart mariadb

デフォルトでは、バイナリログ保存場所はmariadbのデータディレクトリになる

# ll /var/lib/mysql_bin/mariadb-bin*
-rw-rw---- 1 mysql mysql 353 8月 15 06:54 /var/lib/mysql_bin/mariadb-bin.000001
-rw-rw---- 1 mysql mysql 42 8月 15 06:54 /var/lib/mysql_bin/mariadb-bin.index

■フルバックアップを取得

# mariabackup --backup -u root -pP@ssw0rd --target-dir /bk/mariabackup_$(date '+%Y%m%d')

# ll /bk

---中略---
drwx------ 7 root root 270 8月 15 07:27 mariabackup_20250815

---中略---

■仕込み

・数分おきに適当なデータをデータベースに書き込む

フルバックアップ取得直後

# mariadb -Ae "select * from test_db.test_tb;" -uroot -pP@ssw0rd
+----+--------------+-------------------+---------------------+
| id | name | comment | created_at |
+----+--------------+-------------------+---------------------+
| 2 | dagyah | before ful_backup | 2025-08-12 05:44:28 |
| 4 | dagyah0 | after ful_backup | 2025-08-13 05:29:19 |
| 5 | before_inc1 | after_full | 2025-08-13 05:56:54 |
| 6 | after_full_2 | after full_2 | 2025-08-13 09:53:23 |
+----+--------------+-------------------+---------------------+

# mariadb -Ae "select from test_db.test_tb;" -uroot -pP@ssw0rd*
+----+--------------+-------------------+---------------------+
| id | name | comment | created_at |
+----+--------------+-------------------+---------------------+
| 2 | dagyah | before ful_backup | 2025-08-12 05:44:28 |
| 4 | dagyah0 | after ful_backup | 2025-08-13 05:29:19 |
| 5 | before_inc1 | after_full | 2025-08-13 05:56:54 |
| 6 | after_full_2 | after full_2 | 2025-08-13 09:53:23 |
| 8 | 1 | test of PITR | 2025-08-15 07:30:29 |　　　　　　　←数分おきにデータを挿入
| 9 | 2 | test of PITR | 2025-08-15 07:34:13 |　　　　　　　←数分おきにデータを挿入
| 10 | 3 | test of PITR | 2025-08-15 07:37:18 |　　　　　　　←数分おきにデータを挿入
| 11 | 4 | test of PITR | 2025-08-15 07:41:04 |　　　　　　　←数分おきにデータを挿入
+----+--------------+-------------------+---------------------+

■フルバックアップからリストア

# mariabackup --prepare --target-dir /bk/mariabackup_20250815

# systemctl stop mariadb

※上記の前にアプリケーションサーバ、他のDBとのレプリケーションをすべて停止しておく
# rm -rf /var/lib/mysql/*
# mariabackup --copy-back --target-dir /bk/mariabackup_20250815
# chown -R mysql:mysql /var/lib/mysql/*
# systemctl start mariadb

・確認

# mariadb -Ae "select * from test_db.test_tb;" -uroot -pP@ssw0rd

+----+--------------+-------------------+---------------------+
| id | name | comment | created_at |
+----+--------------+-------------------+---------------------+
| 2 | dagyah | before ful_backup | 2025-08-12 05:44:28 |
| 4 | dagyah0 | after ful_backup | 2025-08-13 05:29:19 |
| 5 | before_inc1 | after_full | 2025-08-13 05:56:54 |
| 6 | after_full_2 | after full_2 | 2025-08-13 09:53:23 |
+----+--------------+-------------------+---------------------+

→フルバックアップ直後に戻った

■PITR

・ロールフォワード

「2025-08-15 07:37:00」を指定してロールフォワード

# mysqlbinlog --stop-datetime="2025-08-15 07:37:00" /var/lib/mysql_bin/mariadb-bin.* | mysql -uroot -pP@ssw0rd
※２０２５年８月１５日７時３７分以降の日時を持つ最初のトランザクションで出力を停止

・確認

# mariadb -Ae "select * from test_db.test_tb;" -uroot -pP@ssw0rd
+----+--------------+-------------------+---------------------+
| id | name | comment | created_at |
+----+--------------+-------------------+---------------------+
| 2 | dagyah | before ful_backup | 2025-08-12 05:44:28 |
| 4 | dagyah0 | after ful_backup | 2025-08-13 05:29:19 |
| 5 | before_inc1 | after_full | 2025-08-13 05:56:54 |
| 6 | after_full_2 | after full_2 | 2025-08-13 09:53:23 |
| 8 | 1 | test of PITR | 2025-08-15 07:30:29 |
| 9 | 2 | test of PITR | 2025-08-15 07:34:13 |
+----+--------------+-------------------+---------------------+

■バックアップ取得日時とバイナリログのローテーションタイミングの不一致問題

バイナリログのローテーションタイミングは以下の３つのいずれからしい。

・max_binlog_sizeのサイズに達した時

・mariadbサービスをリスタートした時

・手動でFLUSH LOGSコマンドを実行した時

もし、バイナリログにdelete文でレコードを削除したことが書き込まれた後に、バイナリログがローテーションするまでの間にフルバックアップを取得して、そのフルバックアップをリストアしてmysqlbinlogコマンドでロールフォワードをしようとした場合は、対象のバイナリログを含めて実行しようとすると、フルバックアップ内にすでに含まれてないレコードに対してdelete文を適用として「そのようなレコードは無い」という内容のエラーになってmysqlbinlogコマンドは失敗する。

この場合には、バイナリログがローテーションされてフルバックアップを所得する時点までのすべてのdelete文,trancate文,drop文などを除外した位置（時刻）を指定してmysqlbinlogコマンドを実行すれば成功する。
【例】

# mysqlbinlog --start-datetime="2025-08-15 07:20:00" --stop-datetime="2025-08-15 07:37:00" /var/lib/mysql_bin/mariadb-bin.* | mysql -uroot -pP@ssw0rd

※上記の赤文字のオプションでエラーになるすべてのSQLが含まれない読み込み開始時刻を指定して青文字のオプションで時刻を指定したPITRを実行する。

ちなみに、mysqlbinlogコマンドでバイナリログを指定して実行したらバイナリログの内容が標準出力されるので、実行したSQLと実行時刻を確認することができる。（ただしSQLの数が膨大な場合は現実的ではない？）

上記のほかにバイナリログのローテーションタイミングとフルバックアップ取得タイミングのズレを防ぐ方法としてより直接的に、フルバックアップ取得時にフルバックアップの整合性が確認されたバイナリログファイルと位置をxtrabackup_binlog_infoファイルで確認して以下のコマンドでロールフォワードを実行する。

【例】

# mysqlbinlog --start-position=位置 --stop-datetime="2025-08-15 07:37:00" /var/lib/mysql_bin/{バイナリログファイル1,バイナリログファイル2,・・・,バイナリログファイルn} | mysql -uroot -pP@ssw0rd

※バイナリログファイルはxtrabackup_binlog_infoファイルで確認したファイルからPITRでロールフォワードしたい位置までを含むバイナリログファイルをすべて併記する

■フルバックアップとバイナリログフラッシュ同期の必要性検証

・mariadbをリスタートしてバイナリログを強制的にローテ―ションする

リスタート前

# ls -lh
合計 20K
-rw-rw---- 1 mysql mysql 1.7K 8月 15 07:49 mariadb-bin.000001
-rw-rw---- 1 mysql mysql 1.2K 8月 15 08:08 mariadb-bin.000002
-rw-rw---- 1 mysql mysql 367 8月 15 08:13 mariadb-bin.000003
-rw-rw---- 1 mysql mysql 1.1K 8月 15 09:01 mariadb-bin.000004
-rw-rw---- 1 mysql mysql 152 8月 15 08:13 mariadb-bin.index
# systemctl restart mariadb
# ls -lh
合計 24K
-rw-rw---- 1 mysql mysql 1.7K 8月 15 07:49 mariadb-bin.000001
-rw-rw---- 1 mysql mysql 1.2K 8月 15 08:08 mariadb-bin.000002
-rw-rw---- 1 mysql mysql 367 8月 15 08:13 mariadb-bin.000003
-rw-rw---- 1 mysql mysql 1.2K 8月 15 11:02 mariadb-bin.000004
-rw-rw---- 1 mysql mysql 344 8月 15 11:02 mariadb-bin.000005　　　←ローテーションされた
-rw-rw---- 1 mysql mysql 190 8月 15 11:02 mariadb-bin.index

・現在のDBの状態

# mariadb -Ae "select * from test_db.test_tb;" -uroot -pP@ssw0rd
+----+--------------+-------------------+---------------------+
| id | name | comment | created_at |
+----+--------------+-------------------+---------------------+
| 2 | dagyah | before ful_backup | 2025-08-12 05:44:28 |
| 4 | dagyah0 | after ful_backup | 2025-08-13 05:29:19 |
| 5 | before_inc1 | after_full | 2025-08-13 05:56:54 |
| 6 | after_full_2 | after full_2 | 2025-08-13 09:53:23 |
| 8 | 1 | test of PITR | 2025-08-15 07:30:29 |
| 9 | 2 | test of PITR | 2025-08-15 07:34:13 |
+----+--------------+-------------------+---------------------+

・delete文でレコードを削除

上記のid=8と9のレコードを削除する。

# mariadb -Ae "DELETE FROM test_db.test_tb WHERE id = 8 OR id = 9;" -uroot -pP@ssw0rd
# mariadb -Ae "select * from test_db.test_tb;" -uroot -pP@ssw0rd
+----+--------------+-------------------+---------------------+
| id | name | comment | created_at |
+----+--------------+-------------------+---------------------+
| 2 | dagyah | before ful_backup | 2025-08-12 05:44:28 |
| 4 | dagyah0 | after ful_backup | 2025-08-13 05:29:19 |
| 5 | before_inc1 | after_full | 2025-08-13 05:56:54 |
| 6 | after_full_2 | after full_2 | 2025-08-13 09:53:23 |
+----+--------------+-------------------+---------------------+

→削除された

・フルバックアップを取得

# mariabackup --backup -u root -pP@ssw0rd --target-dir /bk/mariabackup_20250815

・数分おきに適当なデータをデータベースに書き込む

# mariadb -Ae "select * from test_db.test_tb;" -uroot -pP@ssw0rd
+----+--------------+-------------------+---------------------+
| id | name | comment | created_at |
+----+--------------+-------------------+---------------------+
| 2 | dagyah | before ful_backup | 2025-08-12 05:44:28 |
| 4 | dagyah0 | after ful_backup | 2025-08-13 05:29:19 |
| 5 | before_inc1 | after_full | 2025-08-13 05:56:54 |
| 6 | after_full_2 | after full_2 | 2025-08-13 09:53:23 |
| 10 | 1 | test of PITR | 2025-08-15 11:47:44 |
| 11 | 2 | test of PITR | 2025-08-15 11:48:30 |
+----+--------------+-------------------+---------------------+

・フルバックアップからリストア

# mariabackup --prepare --target-dir /bk/mariabackup_20250815
# systemctl stop mariadb
※上記の前にアプリケーションサーバ、他のDBとのレプリケーションをすべて停止しておく

# rm -rf /var/lib/mysql/*
# mariabackup --copy-back --target-dir /bk/mariabackup_20250815
# chown -R mysql:mysql /var/lib/mysql/*
# systemctl start mariadb

・確認

# mariadb -Ae "select * from test_db.test_tb;" -uroot -pP@ssw0rd
+----+--------------+-------------------+---------------------+
| id | name | comment | created_at |
+----+--------------+-------------------+---------------------+
| 2 | dagyah | before ful_backup | 2025-08-12 05:44:28 |
| 4 | dagyah0 | after ful_backup | 2025-08-13 05:29:19 |
| 5 | before_inc1 | after_full | 2025-08-13 05:56:54 |
| 6 | after_full_2 | after full_2 | 2025-08-13 09:53:23 |
+----+--------------+-------------------+---------------------+

・ロールフォワード

「2025-08-15 11:48:00」を指定してロールフォワード

※見込みではid=10のレコードだけがバイナリログからリカバリされる。

フルバックアップの整合性が確認されたバイナリログファイルと位置の確認

# cat /bk/mariabackup_20250815/xtrabackup_binlog_info
mariadb-bin.000005 632 0-1-4

上記のバイナリログファイルにはフルバックアップ取得以前に実行したdelete文に相当するSQLが書き込まれているのでこのバイナリログファイルを指定してロールフォワードを実行する。

# mysqlbinlog --stop-datetime="2025-08-15 11:48:00" /var/lib/mysql_bin/mariadb-bin.00000[56] | mysql -uroot -pP@ssw0rd
--------------
BINLOG '
OlSfaBMBAAAAPQAAAAgCAAAAABIAAAAAAAEAB3Rlc3RfZGIAB3Rlc3RfdGIABAMPDxEFMgBkAAAA
sK0hQQ==
OlSfaBkBAAAAUQAAAFkCAAAAABIAAAAAAAEABA/wCAAAAAExDHRlc3Qgb2YgUElUUmifGlXwCQAA
AAEyDHRlc3Qgb2YgUElUUmifGzWVWLoC
'
--------------
ERROR 1032 (HY000) at line 35: Can't find record in 'test_tb'

→のようにエラーになって失敗する。

# mariadb -Ae "select * from test_db.test_tb;" -uroot -pP@ssw0rd
+----+--------------+-------------------+---------------------+
| id | name | comment | created_at |
+----+--------------+-------------------+---------------------+
| 2 | dagyah | before ful_backup | 2025-08-12 05:44:28 |
| 4 | dagyah0 | after ful_backup | 2025-08-13 05:29:19 |
| 5 | before_inc1 | after_full | 2025-08-13 05:56:54 |
| 6 | after_full_2 | after full_2 | 2025-08-13 09:53:23 |
+----+--------------+-------------------+---------------------+

→ロールフォワードされてない。

・DELETE文を実行した時刻を調べる

# mysqlbinlog /var/lib/mysql_bin/mariadb-bin.000005 | fgrep -A2 -B2 "DELETE FROM test_db.test_tb WHERE id = 8 OR
id = 9"
# at 459
#250815 11:37:30 server id 1 end_log_pos 459 CRC32 0xdc6a8411 Annotate_rows:
#Q> DELETE FROM test_db.test_tb WHERE id = 8 OR id = 9
#250815 11:37:30 server id 1 end_log_pos 520 CRC32 0x4121adb0 Table_map: `test_db`.`test_tb` mapped to number 18
# at 520

・上記のDELETE文実行時刻より後の時刻からPITRしたい時刻までを指定してロールフォワード

# mysqlbinlog --start-datetime="2025-08-15 11:38:00" --stop-datetime="2025-08-15 11:48:00" /var/lib/mysql_bin/ma
riadb-bin.000005 | mysql -uroot -pP@ssw0rd

# mariadb -Ae "select * from test_db.test_tb;" -uroot -pP@ssw0rd
+----+--------------+-------------------+---------------------+
| id | name | comment | created_at |
+----+--------------+-------------------+---------------------+
| 2 | dagyah | before ful_backup | 2025-08-12 05:44:28 |
| 4 | dagyah0 | after ful_backup | 2025-08-13 05:29:19 |
| 5 | before_inc1 | after_full | 2025-08-13 05:56:54 |
| 6 | after_full_2 | after full_2 | 2025-08-13 09:53:23 |
| 10 | 1 | test of PITR | 2025-08-15 11:47:44 |
+----+--------------+-------------------+---------------------+

→id=10のレコードだけがバイナリログからリカバリされた。

■「xtrabackup_binlog_info」ファイルで確認したバイナリログファイルと位置を指定してPITR検証

・mariadbをリスタートしてバイナリログを強制的にローテ―ションする

# systemctl restart mariadb
# ls -lh /var/lib/mysql_bin
合計 44K
-rw-rw---- 1 mysql mysql 1.7K 8月 15 07:49 mariadb-bin.000001
-rw-rw---- 1 mysql mysql 1.2K 8月 15 08:08 mariadb-bin.000002
-rw-rw---- 1 mysql mysql 367 8月 15 08:13 mariadb-bin.000003
-rw-rw---- 1 mysql mysql 1.2K 8月 15 11:02 mariadb-bin.000004
-rw-rw---- 1 mysql mysql 1.2K 8月 15 11:52 mariadb-bin.000005
-rw-rw---- 1 mysql mysql 754 8月 15 12:37 mariadb-bin.000006
-rw-rw---- 1 mysql mysql 622 8月 15 12:53 mariadb-bin.000007
-rw-rw---- 1 mysql mysql 933 8月 15 15:00 mariadb-bin.000008
-rw-rw---- 1 mysql mysql 754 8月 15 15:22 mariadb-bin.000009
-rw-rw---- 1 mysql mysql 344 8月 15 15:22 mariadb-bin.000010
-rw-rw---- 1 mysql mysql 380 8月 15 15:22 mariadb-bin.index

・現在のDBの状態

# mariadb -Ae "select * from test_db.test_tb;" -uroot -pP@ssw0rd

+----+--------------+-------------------+---------------------+
| id | name | comment | created_at |
+----+--------------+-------------------+---------------------+
| 2 | dagyah | before ful_backup | 2025-08-12 05:44:28 |
| 4 | dagyah0 | after ful_backup | 2025-08-13 05:29:19 |
| 5 | before_inc1 | after_full | 2025-08-13 05:56:54 |
| 6 | after_full_2 | after full_2 | 2025-08-13 09:53:23 |
| 11 | 1 | test of PITR | 2025-08-15 14:56:35 |
+----+--------------+-------------------+---------------------+

・delete文でレコードを削除

上記のid=11のレコードを削除する。

# mariadb -Ae "DELETE FROM test_db.test_tb WHERE id = 11;" -uroot -pP@ssw0rd
# mariadb -Ae "select * from test_db.test_tb;" -uroot -pP@ssw0rd

+----+--------------+-------------------+---------------------+
| id | name | comment | created_at |
+----+--------------+-------------------+---------------------+
| 2 | dagyah | before ful_backup | 2025-08-12 05:44:28 |
| 4 | dagyah0 | after ful_backup | 2025-08-13 05:29:19 |
| 5 | before_inc1 | after_full | 2025-08-13 05:56:54 |
| 6 | after_full_2 | after full_2 | 2025-08-13 09:53:23 |
+----+--------------+-------------------+---------------------+

→削除された

・フルバックアップを取得

# mariabackup --backup -u root -pP@ssw0rd --target-dir /bk/mariabackup_20250815

・数分おきに適当なデータをデータベースにINSERT文で書き込む

# mariadb -Ae "INSERT INTO test_db.test_tb(name,comment) VALUES('1', 'test of PITR');" -uroot -pP@ssw0rd

# mariadb -Ae "INSERT INTO test_db.test_tb(name,comment) VALUES('2', 'test of PITR');" -uroot -pP@ssw0rd

# mariadb -Ae "select * from test_db.test_tb;" -uroot -pP@ssw0rd
+----+--------------+-------------------+---------------------+
| id | name | comment | created_at |
+----+--------------+-------------------+---------------------+
| 2 | dagyah | before ful_backup | 2025-08-12 05:44:28 |
| 4 | dagyah0 | after ful_backup | 2025-08-13 05:29:19 |
| 5 | before_inc1 | after_full | 2025-08-13 05:56:54 |
| 6 | after_full_2 | after full_2 | 2025-08-13 09:53:23 |
| 12 | 1 | test of PITR | 2025-08-15 15:24:40 |
| 13 | 2 | test of PITR | 2025-08-15 15:27:22 |
+----+--------------+-------------------+---------------------+

・フルバックアップからリストア

# mariabackup --prepare --target-dir /bk/mariabackup_20250815
# systemctl stop mariadb
※上記の前にアプリケーションサーバ、他のDBとのレプリケーションをすべて停止しておく

# rm -rf /var/lib/mysql/*
# mariabackup --copy-back --target-dir /bk/mariabackup_20250815
# chown -R mysql:mysql /var/lib/mysql/*
# systemctl start mariadb

・バイナリログと位置の確認

# cat /bk/mariabackup_20250815/xtrabackup_binlog_info
mariadb-bin.000010 599 0-1-8

・確認

# mariadb -Ae "select * from test_db.test_tb;" -uroot -pP@ssw0rd

+----+--------------+-------------------+---------------------+
| id | name | comment | created_at |
+----+--------------+-------------------+---------------------+
| 2 | dagyah | before ful_backup | 2025-08-12 05:44:28 |
| 4 | dagyah0 | after ful_backup | 2025-08-13 05:29:19 |
| 5 | before_inc1 | after_full | 2025-08-13 05:56:54 |
| 6 | after_full_2 | after full_2 | 2025-08-13 09:53:23 |
+----+--------------+-------------------+---------------------+

・バイナリログファイルの確認

# ll /var/lib/mysql_bin/
合計 40
-rw-rw---- 1 mysql mysql 1739 8月 15 07:49 mariadb-bin.000001
-rw-rw---- 1 mysql mysql 1141 8月 15 08:08 mariadb-bin.000002
-rw-rw---- 1 mysql mysql 367 8月 15 08:13 mariadb-bin.000003
-rw-rw---- 1 mysql mysql 1141 8月 15 11:02 mariadb-bin.000004
-rw-rw---- 1 mysql mysql 1221 8月 15 11:52 mariadb-bin.000005
-rw-rw---- 1 mysql mysql 754 8月 15 12:37 mariadb-bin.000006
-rw-rw---- 1 mysql mysql 622 8月 15 12:53 mariadb-bin.000007
-rw-rw---- 1 mysql mysql 933 8月 15 15:00 mariadb-bin.000008
-rw-rw---- 1 mysql mysql 344 8月 15 15:00 mariadb-bin.000009
-rw-rw---- 1 mysql mysql 1188 8月 15 15:29 mariadb-bin.000010　 ←このバイナリログにロールバックしたいSQLが含まれる
-rw-rw---- 1 mysql mysql 344 8月 15 15:30 mariadb-bin.000011 ←mariadb再起動時にローテーションされて現れた
-rw-rw---- 1 mysql mysql 418 8月 15 15:30 mariadb-bin.index

・ロールフォワード

2025-08-15 27:21より過去にPITRリカバリしたい（id=12を含んでid=13は含まない）

mariadb-bin.000010の最後のエントリを確認

# mysqlbinlog /var/lib/mysql_bin/mariadb-bin.000010 | tail
# at 1134
#250815 15:27:22 server id 1 end_log_pos 1165 CRC32 0x07d43a43 Xid = 30
COMMIT/*!*/;
# at 1165
#250815 15:29:50 server id 1 end_log_pos 1188 CRC32 0x510ec59d Stop
DELIMITER ;
# End of log file
ROLLBACK /* added by mysqlbinlog */;
/*!50003 SET COMPLETION_TYPE=@OLD_COMPLETION_TYPE*/;
/*!50530 SET @@SESSION.PSEUDO_SLAVE_MODE=0*/;

上記より、PITRにはmariadb-bin.000010は必要だが、mariadb-bin.000011は不要であることがわかる。

# mysqlbinlog --start-position=599 --stop-datetime="2025-08-15 15:27:21" /var/lib/mysql_bin/mariadb-bin.000010

| mysql -uroot -pP@ssw0rd

# mariadb -Ae "select * from test_db.test_tb;" -uroot -pP@ssw0rd
+----+--------------+-------------------+---------------------+
| id | name | comment | created_at |
+----+--------------+-------------------+---------------------+
| 2 | dagyah | before ful_backup | 2025-08-12 05:44:28 |
| 4 | dagyah0 | after ful_backup | 2025-08-13 05:29:19 |
| 5 | before_inc1 | after_full | 2025-08-13 05:56:54 |
| 6 | after_full_2 | after full_2 | 2025-08-13 09:53:23 |
| 12 | 1 | test of PITR | 2025-08-15 15:24:40 |
+----+--------------+-------------------+---------------------+

→無事PITRできた。

mariabackup

■フルバックアップとリストア

・必要パッケージのインストール

# yum install MariaDB-backup

・仕込み

バックアップ取得前に以下のデータを挿入する

MariaDB [test_db]> INSERT INTO test_tb(name,comment) VALUES('dagyah', 'before ful_backup');
MariaDB [test_db]> select * from test_tb;
+----+--------+-------------------+---------------------+
| id | name | comment | created_at |
+----+--------+-------------------+---------------------+
| 2 | dagyah | before ful_backup | 2025-08-12 05:44:28 |
+----+--------+-------------------+---------------------+

・フルバックアップ

# mariabackup --backup -u root -pP@ssw0rd --target-dir /bk/mariabackup_$(date '+%Y%m%d')

# ll /bk
合計 0
drwx------. 7 root root 240 8月 12 05:51 mariabackup_20250812

・フルバックアップ後に以下のデータを挿入する

MariaDB [test_db]> INSERT INTO test_tb(name,comment) VALUES('dagyah2', 'after ful_backup');
MariaDB [test_db]> SELECT * FROM test_tb;
+----+---------+-------------------+---------------------+
| id | name | comment | created_at |
+----+---------+-------------------+---------------------+
| 2 | dagyah | before ful_backup | 2025-08-12 05:44:28 |
| 4 | dagyah2 | after ful_backup | 2025-08-12 05:53:51 |
+----+---------+-------------------+---------------------+

・リストア

# mariabackup --prepare --target-dir /bk/mariabackup_$(date '+%Y%m%d')

# systemctl stop mariadb
# rm -rf /var/lib/mysql/*
# mariabackup --copy-back --target-dir /bk/mariabackup_20250812
# chown -R mysql:mysql /var/lib/mysql/*
# systemctl start mariadb

・バックアップ取得直前にリストアされたことの確認

MariaDB [test_db]> select * from test_tb;
+----+--------+-------------------+---------------------+
| id | name | comment | created_at |
+----+--------+-------------------+---------------------+
| 2 | dagyah | before ful_backup | 2025-08-12 05:44:28 |
+----+--------+-------------------+---------------------+

■増分バックアップとリストア

・参照先

Incremental Backup and Restore with mariadb-backup | MariaDB Documentation

mariadb.com

・初回フルバックアップ取得

# mariabackup --backup -u root -pP@ssw0rd --target-dir /bk/full/mariabackup_20250813

・初回フルバックアップ取得後に以下のデータを挿入する

MariaDB [test_db]> INSERT INTO test_tb(name,comment) VALUES('dagyah0', 'after ful_backup');

・第一回増分バックアップ取得前に以下のデータを挿入する

MariaDB [test_db]> INSERT INTO test_tb(name,comment) VALUES('before_inc1', 'after_full');

・第一回増分バックアップ取得

# mariadb-backup --backup --target-dir=/bk/inc1/mariabackup_20250813/ \

--incremental-basedir=/bk/full/mariabackup_20250813/ -uroot -pP@ssw0rd

・第二回増分バックアップ取得前に以下のデータを挿入する

MariaDB [test_db]> INSERT INTO test_tb(name,comment) VALUES('before_inc2', 'after_inc1');

・第二回増分バックアップ取得

# mariadb-backup --backup --target-dir=/bk/inc2/mariabackup_20250813/ \

--incremental-basedir=/bk/inc1/mariabackup_20250813/ -uroot -pP@ssw0rd

・第二回増分バックアップ取得後に以下のデータを挿入する

MariaDB [test_db]> INSERT INTO test_tb(name,comment) VALUES('after_inc2', 'after_inc2');

MariaDB [test_db]> select * from test_tb;
+----+-------------+-------------------+---------------------+
| id | name | comment | created_at |
+----+-------------+-------------------+---------------------+
| 2 | dagyah | before ful_backup | 2025-08-12 05:44:28 |
| 4 | dagyah0 | after ful_backup | 2025-08-13 05:29:19 |
| 5 | before_inc1 | after_full | 2025-08-13 05:56:54 |
| 6 | before_inc2 | after_inc1 | 2025-08-13 06:07:55 |
| 7 | after_inc2 | after_inc2 | 2025-08-13 06:14:37 |
+----+-------------+-------------------+---------------------+

・リストア前にフルバックアップとすべての増分バックアップをバックアップしておく

# cd /bk

# cp -pr full/ full_bk/

# cp -pr inc1/ inc1_bk/

# cp -pr inc2/ inc2_bk/

・フルバックアップ直後にリストア

# mariabackup --prepare --target-dir=/bk/full/mariabackup_20250813

# systemctl stop mariadb
# rm -rf /var/lib/mysql/*
# mariabackup --copy-back --target-dir=/bk/full/mariabackup_20250813
# chown -R mysql:mysql /var/lib/mysql/*
# systemctl start mariadb

※リストアできているか確認

MariaDB [test_db]> SELECT * FROM test_tb;
+----+--------+-------------------+---------------------+
| id | name | comment | created_at |
+----+--------+-------------------+---------------------+
| 2 | dagyah | before ful_backup | 2025-08-12 05:44:28 |
+----+--------+-------------------+---------------------+

※リストア後に新たにフルバックアップ取得に成功するか確認

# mariabackup --backup -u root -pP@ssw0rd --target-dir /tmp/mariabackup_test

ーーー中略ーーー

[00] 2025-08-13 06:48:25 Redo log (from LSN 52236 to 52248) was copied.
[00] 2025-08-13 06:48:25 completed OK!

・第二回増分バックアップ直後にリストア

# cd /bk
# rm -rf full
# cp -pr full_bk/ full/

# mariabackup --prepare --target-dir=/bk/full/mariabackup_20250813
# mariabackup --prepare --target-dir=/bk/full/mariabackup_20250813 \

--incremental-dir=/bk/inc1/mariabackup_20250813
# mariabackup --prepare --target-dir=/bk/full/mariabackup_20250813 \

--incremental-dir=/bk/inc2/mariabackup_20250813

# systemctl stop mariadb
# rm -rf /var/lib/mysql/*
# mariabackup --copy-back --target-dir=/bk/full/mariabackup_20250813
# chown -R mysql:mysql /var/lib/mysql/*
# systemctl start mariadb

※リストアできているか確認

MariaDB [test_db]> SELECT * FROM test_tb;
+----+-------------+-------------------+---------------------+
| id | name | comment | created_at |
+----+-------------+-------------------+---------------------+
| 2 | dagyah | before ful_backup | 2025-08-12 05:44:28 |
| 4 | dagyah0 | after ful_backup | 2025-08-13 05:29:19 |
| 5 | before_inc1 | after_full | 2025-08-13 05:56:54 |
| 6 | before_inc2 | after_inc1 | 2025-08-13 06:07:55 |
+----+-------------+-------------------+---------------------+

※リストア後に新たにフルバックアップ取得に成功するか確認

# mariabackup --backup -u root -pP@ssw0rd --target-dir /tmp/mariabackup_test2

---中略---

[00] 2025-08-13 07:02:41 Redo log (from LSN 55308 to 55320) was copied.
[00] 2025-08-13 07:02:41 completed OK!

・第一回増分バックアップ直後にリストア

# cd /bk
# rm -rf full
# cp -pr full_bk/ full/

# rm -rf inc1

# cp -pr inc1_bk/ inc1/

# mariabackup --prepare --target-dir=/bk/full/mariabackup_20250813
# mariabackup --prepare --target-dir=/bk/full/mariabackup_20250813 \

--incremental-dir=/bk/inc1/mariabackup_20250813

# systemctl stop mariadb
# rm -rf /var/lib/mysql/*
# mariabackup --copy-back --target-dir=/bk/full/mariabackup_20250813
# chown -R mysql:mysql /var/lib/mysql/*
# systemctl start mariadb

※リストアできているか確認

MariaDB [test_db]> SELECT * FROM test_tb;

+----+-------------+-------------------+---------------------+
| id | name | comment | created_at |
+----+-------------+-------------------+---------------------+
| 2 | dagyah | before ful_backup | 2025-08-12 05:44:28 |
| 4 | dagyah0 | after ful_backup | 2025-08-13 05:29:19 |
| 5 | before_inc1 | after_full | 2025-08-13 05:56:54 |
+----+-------------+-------------------+---------------------+

※リストア後に新たにフルバックアップ取得に成功するか確認

# mariabackup --backup -u root -pP@ssw0rd --target-dir /tmp/mariabackup_test1

---中略---

[00] 2025-08-13 07:14:03 Redo log (from LSN 55308 to 55320) was copied.
[00] 2025-08-13 07:14:03 completed OK!

・第一回増分バックアップ直後の状態から再度フルバックアップ、新第１回増分バックアップ、新第２回増分バックアップを取得して新第一回増分バックアップ直後にリストア

新初回フルバックアップ取得

# mariabackup --backup -u root -pP@ssw0rd --target-dir /bk/full/mariabackup_20250813

新第一回増分バックアップ取得前に以下のデータを挿入する

MariaDB [test_db]> INSERT INTO test_tb(name,comment) VALUES('before_inc1', 'after_full');

新第一回増分バックアップ取得

# mariadb-backup --backup --target-dir=/bk/inc1/mariabackup_20250813/ --incremental-basedir=/bk/full/mariabackup_20250813/ -uroot -pP@ssw0rd

新第二回増分バックアップ取得前に以下のデータを挿入する

MariaDB [test_db]> INSERT INTO test_tb(name,comment) VALUES('before_inc2_2', 'after_inc1_2');

新第二回増分バックアップ取得

mariadb-backup --backup --target-dir=/bk/inc2/mariabackup_20250813/ --incremental-basedir=/bk/inc1/mariabackup_20250813/ -uroot -pP@ssw0rd

新第二回増分バックアップ取得後に以下のデータを挿入する

MariaDB [test_db]> INSERT INTO test_tb(name,comment) VALUES('after_inc2_2', 'after_inc2_2');

MariaDB [test_db]> SELECT * FROM test_tb;
+----+---------------+-------------------+---------------------+
| id | name | comment | created_at |
+----+---------------+-------------------+---------------------+
| 2 | dagyah | before ful_backup | 2025-08-12 05:44:28 |
| 4 | dagyah0 | after ful_backup | 2025-08-13 05:29:19 |
| 5 | before_inc1 | after_full | 2025-08-13 05:56:54 |
| 6 | before_inc1_2 | after full_2 | 2025-08-13 09:53:23 |
| 7 | before_inc2_2 | after_inc1_2 | 2025-08-13 09:55:09 |
| 8 | after_inc2_2 | after_inc2_2 | 2025-08-13 10:00:01 |
+----+---------------+-------------------+---------------------+

リストア前にフルバックアップとすべての増分バックアップをバックアップ

# cd /bk

# cp -pr full/ full_bk/

# cp -pr inc1/ inc1_bk/

# cp -pr inc2/ inc2_bk/

新第一回増分バックアップ直後にリストア

# mariabackup --prepare --target-dir=/bk/full/mariabackup_20250813
# mariabackup --prepare --target-dir=/bk/full/mariabackup_20250813 --incremental-dir=/bk/inc1/mariabackup_20250813
# systemctl stop mariadb
# rm -rf /var/lib/mysql/*
# mariabackup --copy-back --target-dir=/bk/full/mariabackup_20250813
# chown -R mysql:mysql /var/lib/mysql/*
# systemctl start mariadb

リストアできているか確認

MariaDB [test_db]> SELECT * FROM test_tb;
+----+---------------+-------------------+---------------------+
| id | name | comment | created_at |
+----+---------------+-------------------+---------------------+
| 2 | dagyah | before ful_backup | 2025-08-12 05:44:28 |
| 4 | dagyah0 | after ful_backup | 2025-08-13 05:29:19 |
| 5 | before_inc1 | after_full | 2025-08-13 05:56:54 |
| 6 | before_inc1_2 | after full_2 | 2025-08-13 09:53:23 |
+----+---------------+-------------------+---------------------+

リストア後に新たにフルバックアップ取得に成功するか確認

# mariabackup --backup -u root -pP@ssw0rd --target-dir /tmp/mariabackup_test1_2

----中略---

[00] 2025-08-13 10:19:07 Redo log (from LSN 56332 to 56344) was copied.
[00] 2025-08-13 10:19:07 completed OK!

※以下のURLにすべてのテーブルのレコード数，チェックサムを出力して、バックアップ・リストア前後でこれらを比較してバックアップ・リストアの正常性を評価する方法が載っている。

Mariabackup による MariaDB Server のバックアップ/リストアMariaDB Server 10.1.23 / 10.2.7 以降，XtraBackup を fork した Mariabackup が利用可能となっています。

mariadb.com