MaxScale を CentOS 7 にインストール
MariaDB MaxScale は非常に高機能な DB Proxy で,BSL(Business Source License) 1.1 でライセンスされており,主に以下のような機能を備えています。
- Read/Write Splitting
- レプリケーションクラスタ自動フェイルオーバー
- transaction_replay
- マスキング・フィルター
- firewall
今回は MaxScale 最新版 を CentOS 7 にインストールする手順を解説いたします。
実行環境
- CentOS 7.6.1810
- MaxScale 2.3.8
レポジトリ設定
以下のワンライナーを実行することで,MariaDB Server / MaxScale / Tools のレポジトリ設定を行うことができます。
curl -sS https://downloads.mariadb.com/MariaDB/mariadb_repo_setup | sudo bash
ref: https://staging-mdb.com/kb/en/library/mariadb-package-repository-setup-and-usage/
/etc/yum.repos.d/mariadb.repo が以下のように生成されます。
[mariadb-main] name = MariaDB Server baseurl = https://downloads.mariadb.com/MariaDB/mariadb-10.4/yum/rhel/$releasever/$basearch gpgkey = file:///etc/pki/rpm-gpg/MariaDB-Server-GPG-KEY gpgcheck = 1 enabled = 1 [mariadb-maxscale] name = MariaDB MaxScale baseurl = https://downloads.mariadb.com/MaxScale/2.3/centos/$releasever/$basearch gpgkey = file:///etc/pki/rpm-gpg/MariaDB-MaxScale-GPG-KEY gpgcheck = 1 enabled = 1 [mariadb-tools] name = MariaDB Tools baseurl = https://downloads.mariadb.com/Tools/rhel/$releasever/$basearch gpgkey = file:///etc/pki/rpm-gpg/MariaDB-Enterprise-GPG-KEY gpgcheck = 1 enabled = 1
MaxScale のインストール
以下の yum コマンドで MaxScale をインストールできます。
sudo yum -y install maxscale
サンプル設定 : /etc/maxscale.cnf
MaxScale の設定ファイルはデフォルトでは /etc/maxscale.cnf となります。3インスタンスでPrimary-Replicaレプリケーションを行う場合の設定例を以下に記載します。
[maxscale] threads=auto [MariaDB-Monitor] type=monitor module=mariadbmon servers=server1,server2,server3 user=maxuser password=maxpwd auto_failover=true auto_rejoin=true [Splitter-Service] type=service router=readwritesplit servers=server1,server2,server3 user=maxuser password=maxpwd # 2.3 master_failure_mode=error_on_write master_reconnection=true transaction_replay=true causal_reads=false [Splitter-Listener] type=listener service=Splitter-Service protocol=mariadbclient port=3306 [server1] type=server address=192.168.2.101 port=3306 protocol=mariadbbackend [server2] type=server address=192.168.2.102 port=3306 protocol=mariadbbackend [server3] type=server address=192.168.2.103 port=3306 protocol=mariadbbackend
この設定では Primary x1, Replica x2 のレプリケーションクラスタにおいて,以下の機能を有効にしています。
- MariaDB Monitor : auto_failover(自動フェイルオーバー) / auto_rejoin
- Read/Write split : transaction_replay / causal_reads
MaxScale がバックエンドの MariaDB Server にアクセスするために必要なユーザ名(maxuser)/パスワード(maxpwd)は,プロダクション環境では適宜安全なものに変更願います。
この管理用ユーザは各 MariaDB Server インスタンス上で作成しておく必要があります。レプリケーション開始後であれば,Primary でユーザ作成すれば,Replica にもユーザが複製されます。
MaxScale の起動
MaxScale のサービス maxscale.service を有効化/開始するには以下のコマンドを実行します。
systemctl enable maxscale systemctl start maxscale
動作確認
MaxScale では,maxctrl というCLIベースの管理コマンドが提供されています。
https://staging-mdb.com/kb/en/mariadb-maxscale-23-maxctrl/
よく利用される maxctrl のサブコマンドの例を以下に記載します。
# maxctrl list servers ┌─────────┬───────────────┬──────┬─────────────┬─────────────────┬─────────┐ │ Server │ Address │ Port │ Connections │ State │ GTID │ ├─────────┼───────────────┼──────┼─────────────┼─────────────────┼─────────┤ │ server1 │ 192.168.2.101 │ 3306 │ 0 │ Master, Running │ 0-101-4 │ ├─────────┼───────────────┼──────┼─────────────┼─────────────────┼─────────┤ │ server2 │ 192.168.2.102 │ 3306 │ 0 │ Slave, Running │ 0-101-4 │ ├─────────┼───────────────┼──────┼─────────────┼─────────────────┼─────────┤ │ server3 │ 192.168.2.103 │ 3306 │ 0 │ Slave, Running │ 0-101-4 │ └─────────┴───────────────┴──────┴─────────────┴─────────────────┴─────────┘
MariaDB Monitor(Galera Clusterの場合は Galera Monitor) でモニタリングされている各 MariaDB インスタンスのステータスを確認することが可能です。
# maxctrl list monitors ┌─────────────────┬─────────┬───────────────────────────┐ │ Monitor │ State │ Servers │ ├─────────────────┼─────────┼───────────────────────────┤ │ MariaDB-Monitor │ Running │ server1, server2, server3 │ └─────────────────┴─────────┴───────────────────────────┘
MaxScale の各モニタのステータスが確認できます。
# maxctrl list services ┌──────────────────┬────────────────┬─────────────┬───────────────────┬───────────────────────────┐ │ Service │ Router │ Connections │ Total Connections │ Servers │ ├──────────────────┼────────────────┼─────────────┼───────────────────┼───────────────────────────┤ │ Splitter-Service │ readwritesplit │ 1 │ 1 │ server1, server2, server3 │ └──────────────────┴────────────────┴─────────────┴───────────────────┴───────────────────────────┘
MaxScale の各サービスの利用状況を確認できます。
ライセンス
MaxScale 2.x は Business Source License BSL 1.1 でライセンスされており,MaxScale 2.3 であれば,2022-01-01 に GPL v2 に移行します。
https://github.com/mariadb-corporation/MaxScale/blob/2.3/LICENSE.TXT
2022-01-01 以前は MariaDB Server / ColumnStore インスタンス数が 2 以下であれば,プロダクション環境においてもライセンス購入は不要です。
例: Primary x1 – Replica x 1 でのレプリケーション
MariaDB Server / ColumnStore インスタンス数が 3 以上となると MariaDB Platform X3 サブスクリプションの購入が必要となります。
まとめ
MariaDB Corporation で開発されている高機能DB Proxy, MaxScale の基本的なインストール/設定を解説させて頂きました。下記の MaxScale タグで過去の MaxScale 関連のブログ投稿がご覧いただけますので,こちらもあわせて参考にして頂ければと存じます。