This is archived documentation for InfluxData product versions that are no longer maintained. For newer documentation, see the latest InfluxData documentation.
InfluxDB Enterprise offers highly scalable clusters on your infrastructure and a management UI (using Chronograf for working with clusters. The Production 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: the meta nodes.
If you want to evaluate InfluxDB Enterprise in a non-production environment, feel free to follow the instructions outlined in the QuickStart Installation section. Please note that if you install InfluxDB Enterprise with the QuickStart Installation process, you will need to reinstall InfluxDB Enterprise with the Production Installation process before using the product in a production environment.
Meta node setup description and requirements
The Production Installation process sets up three meta nodes
and each meta node runs on its own server.
You must have a minimum of three meta nodes in a cluster. InfluxDB Enterprise clusters require at least three meta nodes and an odd number of meta nodes for high availability and redundancy. We do not recommend having more than three meta nodes unless your servers and/or the communication between the servers have chronic reliability issues.
Note: that there is no requirement for each meta node to run on its own server. But, obviously, deploying multiple meta nodes on the same server creates a larger point of potential failure if that particular node is unresponsive. Best practice is to deploy the meta nodes on relatively small footprint servers.
See the Clustering Guide for more on 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
Meta nodes communicate over ports
For licensing purposes, meta nodes must also be able to reach
If the meta nodes cannot reach
portal.influxdata.com on port
you’ll need to set the
license-path setting instead of the
setting in the meta node configuration file.
Meta node setup
Step 1: Modify the
Add your servers’ hostnames and IP addresses to each cluster server’s
file (the hostnames below are representative).
<Meta_1_IP> enterprise-meta-01 <Meta_2_IP> enterprise-meta-02 <Meta_3_IP> enterprise-meta-03
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 -qc 1 enterprise-meta-01 ping -qc 1 enterprise-meta-02 ping -qc 1 enterprise-meta-03
If there are any connectivity issues resolve them before proceeding with the installation. A healthy cluster requires that every meta node can communicate with every other meta node.
Step 2: Set up, configure, and start the meta services
Perform the following steps on each meta server.
I. Download and install the meta service
Ubuntu & Debian (64-bit)
wget https://dl.influxdata.com/enterprise/releases/influxdb-meta_1.3.8-c1.3.8_amd64.deb sudo dpkg -i influxdb-meta_1.3.8-c1.3.8_amd64.deb
RedHat & CentOS (64-bit)
wget https://dl.influxdata.com/enterprise/releases/influxdb-meta-1.3.8_c1.3.8.x86_64.rpm sudo yum localinstall influxdb-meta-1.3.8_c1.3.8.x86_64.rpm
II. Edit the configuration file
- uncomment and set
hostnameto the full hostname of the meta node
[enterprise]section to the license key you received on InfluxPortal OR
[enterprise]section to the local path to the JSON license file you received from InfluxData.
license-path settings are mutually exclusive and one must remain set to the empty string.
# 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
III. Start the meta service
On sysvinit systems, enter:
service influxdb-meta start
On systemd systems, enter:
sudo systemctl start influxdb-meta
Check to see that the process is running by entering:
ps aux | grep -v grep | grep influxdb-meta
You should see output similar to:
influxdb 3207 0.8 4.4 483000 22168 ? Ssl 17:05 0:08 /usr/bin/influxd-meta -config /etc/influxdb/influxdb-meta.conf
Note: It is possible to start the cluster with a single meta node but you must pass the
-single-server flagwhen starting the single meta node. Please note that a cluster with only one meta node is not recommended for production environments.
Step 3: Join the meta nodes to the cluster
From one and only one meta node, join all meta nodes including itself.
In our example, from
influxd-ctl add-meta enterprise-meta-01:8091 influxd-ctl add-meta enterprise-meta-02:8091 influxd-ctl add-meta enterprise-meta-03:8091
Note: Please make sure that you specify the hostname and port of the meta node during the join process. Do not specify
localhostas this can cause cluster connection issues.
The expected output is:
Added meta node x at enterprise-meta-0x:8091
Issue the following command on any meta node:
The expected output is:
Data Nodes ========== ID TCP Address Version Meta Nodes ========== TCP Address Version enterprise-meta-01:8091 1.3.8-c1.3.8 enterprise-meta-02:8091 1.3.8-c1.3.8 enterprise-meta-03:8091 1.3.8-c1.3.8
Note that your cluster must have at least three meta nodes. If you do not see your meta nodes in the output, please retry adding them to the cluster.
Once your meta nodes are part of your cluster move on to the next steps to set up your data nodes. Please do not continue to the next steps if your meta nodes are not part of the cluster.