FQDN アクセスを有効にする

このトピックでは、完全修飾ドメイン名 (FQDN) を使用してクラスタへのアクセスを有効にする方法について説明します。FQDN は、インターネット上でアクセス可能な特定のエンティティの完全なドメイン名です。FQDN は、ホスト名とドメイン名の 2 つの部分で構成されています。

バージョン 2.4 以前では、StarRocks は FEs と BEs へのアクセスを IP アドレス経由でのみサポートしています。FQDN を使用してクラスタにノードを追加しても、最終的には IP アドレスに変換されます。これにより、StarRocks クラスタ内の特定のノードの IP アドレスを変更すると、ノードへのアクセスが失敗する可能性があるため、DBA にとって大きな不便が生じます。バージョン 2.4 では、StarRocks は各ノードをその IP アドレスから切り離しました。これにより、StarRocks 内のノードを FQDN のみで管理できるようになりました。

前提条件

StarRocks クラスタで FQDN アクセスを有効にするには、次の要件を満たしていることを確認してください。

• クラスタ内の各マシンにはホスト名が必要です。

• 各マシンの /etc/hosts ファイルに、クラスタ内の他のマシンの対応する IP アドレスと FQDN を指定する必要があります。

• /etc/hosts ファイル内の IP アドレスは一意でなければなりません。

FQDN アクセスを使用して新しいクラスタをセットアップする

デフォルトでは、新しいクラスタ内の FE ノードは IP アドレスアクセスを介して開始されます。FQDN アクセスを使用して新しいクラスタを開始するには、クラスタを初めて開始する際に次のコマンドを実行して FE ノードを開始する必要があります。

./bin/start_fe.sh --host_type FQDN --daemon

プロパティ --host_type は、ノードを開始するために使用されるアクセス方法を指定します。有効な値には FQDN と IP が含まれます。このプロパティを指定するのは、ノードを初めて開始する際に 1 回だけです。

各 BE ノードは、FE メタデータで定義された BE Address で自分自身を識別します。したがって、BE ノードを開始する際に --host_type を指定する必要はありません。BE Address が FQDN で BE ノードを定義している場合、BE ノードはこの FQDN で自分自身を識別します。

既存のクラスタで FQDN アクセスを有効にする

IP アドレスを介して以前に開始された既存のクラスタで FQDN アクセスを有効にするには、まず StarRocks をバージョン 2.4.0 以降にアップグレードする必要があります。

FE ノードの FQDN アクセスを有効にする

Leader FE ノードの FQDN アクセスを有効にする前に、すべての非 Leader Follower FE ノードの FQDN アクセスを有効にする必要があります。

注意

FE ノードの FQDN アクセスを有効にする前に、クラスタに少なくとも 3 つの Follower FE ノードがあることを確認してください。

非 Leader Follower FE ノードの FQDN アクセスを有効にする

1. FE ノードのデプロイメントディレクトリに移動し、次のコマンドを実行して FE ノードを停止します。

   ./bin/stop_fe.sh

2. MySQL クライアントを使用して次のステートメントを実行し、停止した FE ノードの Alive ステータスを確認します。Alive ステータスが false になるまで待ちます。

   SHOW PROC '/frontends'\G

3. 次のステートメントを実行して、IP アドレスを FQDN に置き換えます。

   ALTER SYSTEM MODIFY FRONTEND HOST "<fe_ip>" TO "<fe_hostname>";

4. 次のコマンドを実行して、FQDN アクセスで FE ノードを開始します。

   ./bin/start_fe.sh --host_type FQDN --daemon

   プロパティ --host_type は、ノードを開始するために使用されるアクセス方法を指定します。有効な値には FQDN と IP が含まれます。このプロパティを指定するのは、ノードを変更した後に再起動する際に 1 回だけです。

5. FE ノードの Alive ステータスを確認します。Alive ステータスが true になるまで待ちます。

   SHOW PROC '/frontends'\G

6. 現在の FE ノードの Alive ステータスが true のときに、他の非 Leader Follower FE ノードの FQDN アクセスを順番に有効にするために、上記の手順を繰り返します。

Leader FE ノードの FQDN アクセスを有効にする

すべての非 Leader FE ノードが正常に変更され、再起動された後、Leader FE ノードの FQDN アクセスを有効にすることができます。

注意

Leader FE ノードの FQDN アクセスが有効になる前に、クラスタにノードを追加するために使用される FQDN は、対応する IP アドレスに変換され続けます。FQDN アクセスが有効になった Leader FE ノードがクラスタのために選出されると、FQDN は IP アドレスに変換されなくなります。

1. Leader FE ノードのデプロイメントディレクトリに移動し、次のコマンドを実行して Leader FE ノードを停止します。

   ./bin/stop_fe.sh

2. MySQL クライアントを使用して次のステートメントを実行し、クラスタのために新しい Leader FE ノードが選出されたかどうかを確認します。

   SHOW PROC '/frontends'\G

   Alive ステータスが true で isMaster が true の FE ノードは、実行中の Leader FE です。

3. 次のステートメントを実行して、IP アドレスを FQDN に置き換えます。

   ALTER SYSTEM MODIFY FRONTEND HOST "<fe_ip>" TO "<fe_hostname>";

4. 次のコマンドを実行して、FQDN アクセスで FE ノードを開始します。

   ./bin/start_fe.sh --host_type FQDN --daemon

   プロパティ --host_type は、ノードを開始するために使用されるアクセス方法を指定します。有効な値には FQDN と IP が含まれます。このプロパティを指定するのは、ノードを変更した後に再起動する際に 1 回だけです。

5. FE ノードの Alive ステータスを確認します。

   SHOW PROC '/frontends'\G

Alive ステータスが true になると、FE ノードは正常に変更され、クラスタに Follower FE ノードとして追加されます。

BE ノードの FQDN アクセスを有効にする

MySQL クライアントを使用して次のステートメントを実行し、IP アドレスを FQDN に置き換えて BE ノードの FQDN アクセスを有効にします。

ALTER SYSTEM MODIFY BACKEND HOST "<be_ip>" TO "<be_hostname>";

注意

FQDN アクセスが有効になった後、BE ノードを再起動する必要はありません。

ロールバック

FQDN アクセスが有効になった StarRocks クラスタを、FQDN アクセスをサポートしていない以前のバージョンにロールバックするには、まずクラスタ内のすべてのノードに対して IP アドレスアクセスを有効にする必要があります。一般的なガイダンスについては 既存のクラスタで FQDN アクセスを有効にする を参照してください。ただし、SQL コマンドを次のように変更する必要があります。

• FE ノードの IP アドレスアクセスを有効にする:

ALTER SYSTEM MODIFY FRONTEND HOST "<fe_hostname>" TO "<fe_ip>";

• BE ノードの IP アドレスアクセスを有効にする:

ALTER SYSTEM MODIFY BACKEND HOST "<be_hostname>" TO "<be_ip>";

クラスタが正常に再起動されると、変更が有効になります。

FAQ

Q: FE ノードの FQDN アクセスを有効にするときにエラーが発生します: "required 1 replica. But none were active with this master". どうすればよいですか？

A: FE ノードの FQDN アクセスを有効にする前に、クラスタに少なくとも 3 つの Follower FE ノードがあることを確認してください。

Q: FQDN アクセスが有効になっているクラスタに IP アドレスを使用して新しいノードを追加できますか？

A: はい。