目的
本ドキュメントで紹介する内容は CVIM 3.2.1および3.2.2 に基づいています。その他のバージョンでは内容が異なる場合があります。
Cisco VIM (CVIM) では OpenStack の各サービスが使用しているリソースやステータスなどの情報は Controllerノード上の MariaDB に保持されており、3台の Controllerノード上の MariaDB は Galera Cluster によって同期されています。本ドキュメントでは Galera Cluster や Controller ノードで何らかの問題が発生した場合の各 Controllerノード上で稼働中の MariaDB の同期状態を確認する方法を紹介しています。
方法
(1) はじめに、Managementノードにログインして、MariaDBの Password Value を確認します。Password Value は Managementノード の /root/openstack-configs/secrets.yaml ファイルの"DB_ROOT_PASSWORD"に定義されてます。
[root@mgmt-node openstack-configs]# grep DB_ROOT /root/openstack-configs/secrets.yaml
DB_ROOT_PASSWORD: abcdefghijklmnop
[root@mgmt-node openstack-configs]#
表示されたパスワードを書き留めます。
(2) 次に1台目の Controllerノードにログインして、mariadb docker コンテナにログインします。CVIM では各種コンテナにログインするために alias コマンドが用意されていますので、mariadb docker コンテナにログインする場合は mariadb を実行します。
[root@cntl-node1 ~]# mariadb
mariadb_19767 [mysql@cntl-node1 /]$
(3) mariadb コンテナにログインした後、mysql コマンドでデータベースにアクセスし、SHOW STATUS 構文を使って同期状態を確認します。mysql コマンドを実行時にパスワードを求められますので、先に書き留めたパスワードを入力します。
mariadb_19767 [mysql@cntl-node1 /]$ mysql -u root -p -e "show status like 'wsrep_%';"
Enter password:
+------------------------------+----------------------------------------------------------+
| Variable_name | Value |
+------------------------------+----------------------------------------------------------+
| wsrep_apply_oooe | 0.000000 |
| wsrep_apply_oool | 0.000000 |
| wsrep_apply_window | 1.000000 |
| wsrep_causal_reads | 0 |
| wsrep_cert_deps_distance | 33.604687 |
| wsrep_cert_index_size | 98 |
| wsrep_cert_interval | 0.083559 |
| wsrep_cluster_conf_id | 6 |
| wsrep_cluster_size | 3 |
| wsrep_cluster_state_uuid | da0311bf-ac98-11ea-9877-d36ca24441b9 |
| wsrep_cluster_status | Primary |
| wsrep_commit_oooe | 0.000000 |
| wsrep_commit_oool | 0.000000 |
| wsrep_commit_window | 1.000000 |
| wsrep_connected | ON |
| wsrep_desync_count | 0 |
| wsrep_evs_delayed | |
| wsrep_evs_evict_list | |
| wsrep_evs_repl_latency | 0.000231806/0.000231806/0.000231806/0/1 |
| wsrep_evs_state | OPERATIONAL |
| wsrep_flow_control_paused | 0.000001 |
| wsrep_flow_control_paused_ns | 2744100485 |
| wsrep_flow_control_recv | 20 |
| wsrep_flow_control_sent | 20 |
| wsrep_gcomm_uuid | 3231ceef-aec0-11ea-a47e-7b21cc18dcd4 |
| wsrep_incoming_addresses | 172.21.190.73:3306,172.21.190.71:3306,172.21.190.72:3306 |
| wsrep_last_committed | 8197636 |
| wsrep_local_bf_aborts | 0 |
| wsrep_local_cached_downto | 8073675 |
| wsrep_local_cert_failures | 0 |
| wsrep_local_commits | 0 |
| wsrep_local_index | 0 |
| wsrep_local_recv_queue | 0 |
| wsrep_local_recv_queue_avg | 0.028146 |
| wsrep_local_recv_queue_max | 53 |
| wsrep_local_recv_queue_min | 0 |
| wsrep_local_replays | 0 |
| wsrep_local_send_queue | 0 |
| wsrep_local_send_queue_avg | 0.000000 |
| wsrep_local_send_queue_max | 1 |
| wsrep_local_send_queue_min | 0 |
| wsrep_local_state | 4 |
| wsrep_local_state_comment | Synced |
| wsrep_local_state_uuid | da0311bf-ac98-11ea-9877-d36ca24441b9 |
| wsrep_protocol_version | 7 |
| wsrep_provider_name | Galera |
| wsrep_provider_vendor | Codership Oy <info@codership.com> |
| wsrep_provider_version | 3.16(r5c765eb) |
| wsrep_ready | ON |
| wsrep_received | 7730680 |
| wsrep_received_bytes | 7224163351 |
| wsrep_repl_data_bytes | 0 |
| wsrep_repl_keys | 0 |
| wsrep_repl_keys_bytes | 0 |
| wsrep_repl_other_bytes | 0 |
| wsrep_replicated | 0 |
| wsrep_replicated_bytes | 0 |
| wsrep_thread_count | 2 |
+------------------------------+----------------------------------------------------------+
mariadb_19767 [mysql@cntl-node1 /]$
出力結果の中から、同期に関連する主なステータス値を抜粋してみます。
mariadb_19767 [mysql@cntl-node1 /]$ mysql -u root -p -e "show status where Variable_name = 'wsrep_local_state_comment' or Variable_name = 'wsrep_cluster_status' or Variable_name = 'wsrep_incoming_addresses' or Variable_name = 'wsrep_cluster_size' or Variable_name = 'wsrep_last_committed' or or Variable_name = 'wsrep_ready';"
Enter password:
+---------------------------+----------------------------------------------------------+
| Variable_name | Value |
+---------------------------+----------------------------------------------------------+
| wsrep_cluster_size | 3 |
| wsrep_cluster_status | Primary |
| wsrep_incoming_addresses | 172.21.190.73:3306,172.21.190.71:3306,172.21.190.72:3306 |
| wsrep_last_committed | 8194964 |
| wsrep_local_state_comment | Synced |
| wsrep_ready | ON |
+---------------------------+----------------------------------------------------------+
mariadb_19767 [mysql@cntl-node1 /]$
各ステータス値については以下の通りです。
| ステータス値 |
説明 |
| wsrep_cluster_size |
クラスタ内の現在のメンバー数。3台の Controllerノードで構成されているため通常 "3" が表示されます。 |
| wsrep_cluster_status |
このクラスタ・コンポーネントのステータス。つまり、そのノードが PRIMARY コンポーネントの一部であるか NON_PRIMARY コンポーネントの一部であるかを示しています。 |
| wsrep_incoming_addresses |
クラスタコンポーネント内の受信サーバアドレスのリストです。通常は3台の Controllerノード のIPアドレスが表示されています。 |
| wsrep_last_committed |
最後にコミットされたトランザクションのシーケンス番号です。処理の更新ともに番号は増加します。 |
| wsrep_local_state_comment |
現在の同期状態を示しています。通常、同期状態にあるので"Synced"が表示されます。 |
| wsrep_ready |
ONは、アクティブなクラスタと通信していることを意味します。OFFは、クエリを受け付けていないことを意味します。 |
(4) 残り2台の Controllerノードでも同じ方法でステータスを確認して同期の状態を確認します。
いずれかのノードでこれらのステータスに異常がみられる場合、mariadb のノード間の同期に何らかの問題が生じている可能性があります。同期に関連する問題を調査する場合は、これらのステータスをご確認頂くとともに、TACで調査が必要な場合にはこれらの情報をご提供ください。
