Documentation

Install InfluxDB Enterprise meta nodes

InfluxDB Enterprise offers highly scalable clusters on your infrastructure and a management UI (via Chronograf) for working with clusters. The installation process is designed for users looking to deploy InfluxDB Enterprise in a production environment. The following steps will get you up and running with the first essential component of your InfluxDB Enterprise cluster–meta nodes.

Meta node setup and requirements

At least three meta nodes

The installation process sets up three meta nodes, with each meta node running on its own server.

InfluxDB Enterprise clusters require an odd number of at least three meta nodes for high availability and redundancy. We typically recommend three meta nodes. If your servers have chronic communication or reliability issues, you can try adding nodes.

Deploying multiple meta nodes on the same server is strongly discouraged since it creates a larger point of potential failure if that particular server is unresponsive. InfluxData recommends deploying meta nodes on relatively small footprint servers.

See Clustering in InfluxDB Enterprise for more information about cluster architecture.

License key or file

InfluxDB Enterprise requires a license key or a license file to run. Your license key is available at InfluxPortal. Contact support at the email we provided at signup to receive a license file. License files are required only if the nodes in your cluster cannot reach portal.influxdata.com on port 80 or 443.

Networking

Meta nodes communicate over ports 8088, 8089, and 8091.

For licensing purposes, meta nodes must also be able to reach portal.influxdata.com on port 80 or 443. If the meta nodes cannot reach portal.influxdata.com on port 80 or 443, you’ll need to set the license-path setting instead of the license-key setting in the meta node configuration file.

User account

The installation package creates an influxdb user on the operating system. The influxdb user runs the InfluxDB meta service. The influxdb user also owns certain files needed to start the service. In some cases, local policies may prevent the local user account from being created and the service fails to start. Contact your systems administrator for assistance with this requirement.

Set up meta nodes

  1. Add DNS entries
  2. Set up, configure, and start the meta services
    1. Download and install the meta service
    2. Edit the configuration file
    3. Start the meta service
  3. Join meta nodes to the cluster

Add DNS entries

Ensure that your servers’ hostnames and IP addresses are added to your network’s DNS environment. The addition of DNS entries and IP assignment is usually site and policy specific. Contact your DNS administrator for assistance as necessary. Ultimately, use entries similar to the following (hostnames and domain IP addresses are representative).

Record Type Hostname IP
A enterprise-meta-01.mydomain.com <Meta_1_IP>
A enterprise-meta-02.mydomain.com <Meta_2_IP>
A enterprise-meta-03.mydomain.com <Meta_3_IP>

Verify DNS resolution

Before proceeding with the installation, verify on each server that the other servers are resolvable. Here is an example set of shell commands using ping:

ping -qc 1 enterprise-meta-01
ping -qc 1 enterprise-meta-02
ping -qc 1 enterprise-meta-03

We highly recommend that each server be able to resolve the IP from the hostname alone as shown here. Resolve any connectivity issues before proceeding with the installation. A healthy cluster requires that every meta node can communicate with every other meta node.

Set up, configure, and start the meta services

Perform the following steps on each meta server:

  1. Download and install the meta service
  2. Edit the configuration file
  3. Start the meta service

Download and install the meta service

InfluxDB Enterprise 1.11+ provides a standard build and a Federal Information Processing Standards (FIPS)-compliant build. Instructions for both are provided below.

Ubuntu & Debian (64-bit)
wget https://dl.influxdata.com/enterprise/releases/influxdb-meta_1.11.3-c1.11.3-1_amd64.deb
sudo dpkg -i influxdb-meta_1.11.3-c1.11.3-1_amd64.deb
wget https://dl.influxdata.com/enterprise/releases/fips/influxdb-meta_1.11.3-c1.11.3-1_amd64.deb
sudo dpkg -i influxdb-meta_1.11.3-c1.11.3-1_amd64.deb
RedHat & CentOS (64-bit)
wget https://dl.influxdata.com/enterprise/releases/influxdb-meta-1.11.3_c1.11.3-1.x86_64.rpm
sudo yum localinstall influxdb-meta-1.11.3_c1.11.3-1.x86_64.rpm
wget https://dl.influxdata.com/enterprise/releases/fips/influxdb-meta-1.11.3_c1.11.3-1.x86_64.rpm
sudo yum localinstall influxdb-meta-1.11.3_c1.11.3-1.x86_64.rpm

Edit the configuration file

In /etc/influxdb/influxdb-meta.conf:

  • Uncomment hostname and set to the full hostname of the meta node.

  • Uncomment internal-shared-secret in the [meta] section and set it to a long pass phrase to be used in JWT authentication for intra-node communication. This value must the same for all of your meta nodes and match the [meta] meta-internal-shared-secret settings in the configuration files of your data nodes.

  • Set license-key in the [enterprise] section to the license key you received on InfluxPortal OR license-path in the [enterprise] section to the local path to the JSON license file you received from InfluxData.

    The license-key and license-path settings are mutually exclusive and one must remain set to the empty string.

If using a FIPS-compliant InfluxDB Enterprise build, also do the following:

  • Set [enterprise].license-path to the local path to the JSON license file you received from InfluxData.
  • Set [meta].password-hash to pbkdf2-sha256 or pbkdf2-sha512.
# Hostname advertised by this host for remote addresses.  This must be resolvable by all
# other nodes in the cluster
hostname="<enterprise-meta-0x>"

[enterprise]
  # license-key and license-path are mutually exclusive, use only one and leave the other blank
  license-key = "<your_license_key>" # Mutually exclusive with license-path

  # license-key and license-path are mutually exclusive, use only one and leave the other blank
  license-path = "/path/to/readable/JSON.license.file" # Mutually exclusive with license-key

[meta]
  # FIPS-compliant builds do not support bcrypt for password hashing
  password-hash = "pbkdf2-sha512"

Start the meta service

service influxdb-meta start
sudo systemctl start influxdb-meta

Optional: Verify the influxdb-meta service is running

Join meta nodes to the cluster

From one and only one meta node, join all meta nodes including itself. For example, from enterprise-meta-01, run:

influxd-ctl add-meta enterprise-meta-01:8091
influxd-ctl add-meta enterprise-meta-02:8091
influxd-ctl add-meta enterprise-meta-03:8091

Make sure that you specify the fully qualified host name of the meta node during the join process. Please do not specify localhost as this can cause cluster connection issues.

Optional: Verify the meta nodes are added to the cluster

After your meta nodes are part of your cluster, install data nodes.


Was this page helpful?

Thank you for your feedback!


Introducing InfluxDB Clustered

A highly available InfluxDB 3.0 cluster on your own infrastructure.

InfluxDB Clustered is a highly available InfluxDB 3.0 cluster built for high write and query workloads on your own infrastructure.

InfluxDB Clustered is currently in limited availability and is only available to a limited group of InfluxData customers. If interested in being part of the limited access group, please contact the InfluxData Sales team.

Learn more
Contact InfluxData Sales

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:

State of the InfluxDB Cloud Serverless documentation

InfluxDB Cloud Serverless documentation is a work in progress.

The new documentation for InfluxDB Cloud Serverless is a work in progress. We are adding new information and content almost daily. Thank you for your patience!

If there is specific information you’re looking for, please submit a documentation issue.