elasticsearch-reconfigure-node

elasticsearch-reconfigure-node ツールは、RPM または DEB パッケージを通じてインストールされた Elasticsearch ノードを再構成し、セキュリティ機能が有効な既存のクラスターに参加させます。

Synopsis

Shell

  1. bin/elasticsearch-reconfigure-node
  2. [--enrollment-token] [-h, --help] [-E <KeyValuePair>]
  3. [-s, --silent] [-v, --verbose]

Description

DEB または RPM パッケージを使用して Elasticsearch をインストールする際、現在のノードはクラスター内の最初のノードであると見なされます。Elasticsearch はノード上でセキュリティ機能を有効にし、elastic スーパーユーザーのパスワードを生成し、HTTP およびトランスポート層の TLS を構成します。

単一ノードクラスターを形成するのではなく、すでにセキュリティ機能が有効で構成されている既存のクラスターにノードを追加できます。新しいノードを起動する前に、既存のクラスター内の任意のノードで elasticsearch-create-enrollment-token ツールを -s node オプションで実行して、登録トークンを生成します。新しいノードで elasticsearch-reconfigure-node ツールを実行し、登録トークンをパラメータとして渡します。

このツールは、DEB または RPM ディストリビューションの Elasticsearch でのみ使用することを意図しています。

このツールは sudo で実行する必要があり、root:elasticsearch によって所有されている Elasticsearch インストール構成ディレクトリ内の必要なファイルを編集できるようにします。

Parameters

  • --enrollment-token
  • 登録トークンで、既存のセキュリティが有効なクラスター内の任意のノードで生成できます。
  • -E <KeyValuePair>
  • 標準の Elasticsearch または X-Pack 設定を構成します。
  • -h, --help
  • ヘルプ情報を表示します。
  • -s, --silent
  • 最小限の出力を表示します。
  • -v, --verbose
  • 詳細な出力を表示します。

JVM options

CLI ツールは 64MB のヒープで実行されます。ほとんどのツールにとって、この値は問題ありません。ただし、必要に応じて CLI_JAVA_OPTS 環境変数を設定することで上書きできます。たとえば、次のようにして elasticsearch-reconfigure-node ツールで使用されるヒープサイズを 1GB に増やします。

Shell

  1. export CLI_JAVA_OPTS="-Xmx1g"
  2. bin/elasticsearch-reconfigure-node ...

Examples

次の例は、インストールされた Elasticsearch ノードを再構成し、初めて起動する際に既存のクラスターに参加できるようにします。

Shell

  1. sudo /usr/share/elasticsearch/elasticsearch-reconfigure-node --enrollment-token eyJ2ZXIiOiI4LjAuMCIsImFkciI6WyIxOTIuMTY4LjEuMTY6OTIwMCJdLCJmZ3IiOiI4NGVhYzkyMzAyMWQ1MjcyMmQxNTFhMTQwZmM2ODI5NmE5OWNiNmU0OGVhZjYwYWMxYzljM2I3ZDJjOTg2YTk3Iiwia2V5IjoiUy0yUjFINEJrNlFTMkNEY1dVV1g6QS0wSmJxM3hTRy1haWxoQTdPWVduZyJ9