Documentation

influxd-ctl join

The influxd-ctl join command joins a meta or data node data node to an InfluxDB Enterprise cluster. The command searches for influxd and influxd-meta processes running on the local machine bound to specific ports and determines if that process is an InfluxDB meta or data node.

  • 8088: Data node
  • 8091: Meta node

If the InfluxDB data or meta processes are running on non-default ports, the join operation cannot detect them.

Usage

influxd-ctl join [flags] <meta-node-http-bind-address>

Arguments

  • meta-node-http-bind-address: HTTP bind address of a meta node in an existing cluster. Use this argument to add un-joined meta or data node to an existing cluster.

Flags

Flag Description
-p Add the data node as a passive node
-v Print verbose information when joining

Examples

Join a meta and data node into a cluster

In the following example, influxd-ctl join command detects a meta node process running at cluster-node-03:8091 and a data node process running at cluster-node-03:8088 and joins them into a new cluster.

influxd-ctl join
Command output
Joining meta node at localhost:8091
Searching for meta node on cluster-node-03:8091...
Searching for data node on cluster-node-03:8088...

Successfully created cluster

  * Added meta node 1 at cluster-node-03:8091
  * Added data node 2 at cluster-node-03:8088

  To join additional nodes to this cluster, run the following command:

  influxd-ctl join cluster-node-03:8091

Join a meta and data node to an existing cluster

In the following example, influxd-ctl join detects a meta node process running at cluster-node-03:8091 and a data node process running at cluster-node-03:8088. It uses the meta node running at cluster-meta-node-02:8091 in an existing cluster to join the newly detected meta and data nodes to the cluster.

influxd-ctl join cluster-meta-node-02:8091
Command output
Joining meta node at cluster-meta-node-02:8091
Searching for meta node on cluster-node-03:8091...
Searching for data node on cluster-node-03:8088...

Successfully joined cluster

  * Added meta node 3 at cluster-node-03:8091
  * Added data node 4 at cluster-node-03:8088

Join a meta node to an existing cluster

In the following example, influxd-ctl join detects a meta node process running at cluster-meta-node-03:8091, but does not detect a data node process. It uses the meta node running at cluster-meta-node-02:8091 in an existing cluster to join the newly detected meta node to the cluster.

influxd-ctl join cluster-meta-node-02:8091
Command output
Joining meta node at cluster-meta-node-02:8091
Searching for meta node on cluster-meta-node-03:8091...
Searching for data node on cluster-meta-node-03:8088...

Successfully joined cluster

  * Added meta node 18 at cluster-meta-node-03:8091
  * No data node added.  Run with -v to see more information

Troubleshoot influxd-ctl join

Common problems when attempting to join nodes to InfluxDB Enterprise clusters:

  • The influxd or influxd-meta processes are using non-standard ports and can’t be detected.
  • The influxd or influxd-meta processes are not running. Check the logs for startup errors.

Was this page helpful?

Thank you for your feedback!


The future of Flux

Flux is going into maintenance mode. You can continue using it as you currently are without any changes to your code.

Flux is going into maintenance mode and will not be supported in InfluxDB 3.0. This was a decision based on the broad demand for SQL and the continued growth and adoption of InfluxQL. We are continuing to support Flux for users in 1.x and 2.x so you can continue using it with no changes to your code. If you are interested in transitioning to InfluxDB 3.0 and want to future-proof your code, we suggest using InfluxQL.

For information about the future of Flux, see the following: