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

FQDN アクセスを有効にする

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

バージョン 2.4 以前では、StarRocks は FE と BE へのアクセスを IP アドレス経由でのみサポートしていました。FQDN を使用してクラスタにノードを追加しても、最終的には IP アドレスに変換されます。これにより、特定のノードの IP アドレスを変更すると、StarRocks クラスタ内のノードへのアクセスが失敗する可能性があるため、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 が含まれます。このプロパティは、ノードを初めて開始する際に一度だけ指定する必要があります。

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 アクセスを有効にする前に、すべての非リーダー Follower FE ノードの FQDN アクセスを有効にする必要があります。

注意

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

非リーダー 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 のときに、他の非リーダー Follower FE ノードの FQDN アクセスを順番に有効にするために、上記の手順を繰り返します。

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

すべての非リーダー 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 アドレスアクセスを有効にする必要があります。一般的なガイダンスについては Enable FQDN access in an existing cluster を参照してください。ただし、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: はい。