MariaDB 10.2 Xtrabackup で発生する "WSREP_SST_OPT_PORT: unbound variable" エラーの解決方法
2024-04-02
MariaDB 10.2 Xtrabackup に関するエラーメッセージ解説
MariaDB 10.2 Xtrabackup. /usr//bin/wsrep_sst_xtrabackup-v2 WSREP_SST_OPT_PORT: unbound variable
概要:
このエラーメッセージは、MariaDB 10.2 の Xtrabackup ツールを使用中に発生する可能性があります。Xtrabackup は、MariaDB クラスタのオンラインバックアップと復元を可能にするツールです。
原因:
このエラーメッセージは、WSREP_SST_OPT_PORT 環境変数が設定されていないことが原因です。この変数は、Xtrabackup が SST (State Snapshot Transfer) を実行するために必要なポート番号を指定します。
解決策:
このエラーメッセージを解決するには、WSREP_SST_OPT_PORT 環境変数を設定する必要があります。以下の手順で設定できます。
- 以下のコマンドを実行して、現在の環境変数を確認します。
env | grep WSREP_SST_OPT_PORT
WSREP_SST_OPT_PORT環境変数が設定されていない場合は、以下のコマンドを実行して設定します。
export WSREP_SST_OPT_PORT=3306
- Xtrabackup ツールを再度実行します。
補足:
WSREP_SST_OPT_PORT環境変数のデフォルト値は3306です。- SST は、MariaDB クラスタのすべてのノードに最新のデータと状態を転送するプロセスです。
- Xtrabackup ツールに関する詳細は、MariaDB 公式ドキュメントを参照してください。
- このエラーメッセージは、他の原因によっても発生する可能性があります。上記の手順で解決できない場合は、MariaDB のフォーラムやサポートに問い合わせてください。
日本語での解説:
このエラーメッセージは日本語で表示されていないため、理解しにくい場合があります。上記の説明は、このエラーメッセージの原因と解決策を日本語で分かりやすく解説することを目的としています。
# 環境変数を設定
export WSREP_SST_OPT_PORT=3306
# Xtrabackup ツールを実行
xtrabackup --backup --target-dir=/backup/db
# または
xtrabackup --prepare --target-dir=/backup/db
このコードは、/backup/db ディレクトリに MariaDB データベースのバックアップを作成します。
注意事項:
- このコードは、MariaDB 10.2 を使用していることを前提としています。
- バックアップディレクトリは、十分な空き容量があることを確認してください。
WSREP_SST_OPT_PORT 設定の他の方法
my.cnf ファイルに wsrep_sst_opt_port オプションを追加することで、WSREP_SST_OPT_PORT 環境変数を設定できます。
[mysqld]
wsrep_sst_opt_port=3306
MariaDB コマンドラインを使用して、WSREP_SST_OPT_PORT 環境変数を設定できます。
mysql> SET GLOBAL wsrep_sst_opt_port=3306;
xtrabackup --backup --target-dir=/backup/db --wsrep-sst-opt-port=3306
mariadb
