メインコンテンツまでスキップ
バージョン: 3.1

FQDN アクセスを有効にする

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

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

前提条件​

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 が含まれます。このプロパティは、ノードを初めて開始する際に一度だけ指定する必要があります。

StarRocks のインストール方法についての詳細な手順は、Deploy StarRocks を参照してください。

各 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 が含まれます。このプロパティは、ノードを変更した後に再起動する際に一度だけ指定する必要があります。

  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 で 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 が含まれます。このプロパティは、ノードを変更した後に再起動する際に一度だけ指定する必要があります。

  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: はい、可能です。