InfluxDB Enterprise

This guide will help you set up an InfluxDB Enterprise cluster, which includes both meta and data nodes.

How to Use

Add this to your requirements.yml file:

- src: influxdata.influxdb-enterprise
  name: influxdb-enterprise

To install it in your roles directory, run:

$ ansible-galaxy install -r requirements.yaml

Next, include it in your Playbooks (check this example for more details):

---
# site.yml

- hosts: influxdb
  become: yes

  roles:
  - { role: 'influxdb-enterprise', influx_node_type: meta }
  - { role: 'influxdb-enterprise', influx_node_type: data }

  vars:
  influx_cluster_auto_join: true
  influx_meta_cluster_leader: influxdb_001
  influx_enterprise_license_key: XXX-XXX-XXX
  influx_queries:
    - "CREATE DATABASE test"
    - "CREATE RETENTION POLICY testrp ON test DURATION 24h REPLICATION 2 default"
    - "ALTER RETENTION POLICY autogen ON test DURATION 666h REPLICATION 2 default"

Note: When starting the cluster for the first time, it’s a good idea to use --skip-tags=influxdb-cluster to ensure all hosts are running before forming a cluster. Also, start with the first meta-node using the --limit option. We will improve this process in the future.

Requirements

• You need an InfluxDB Enterprise License Key. You can get a free trial here.
• Ansible is required; check getting started for more details.
• Vagrant (needed for testing and evaluation only).

How to Contribute

Feel free to submit pull requests!

To run a full test suite, use these commands:

 $ export INFLUX_ENTERPRISE_LICENSE_KEY=XXX-XXX-XXX
 $ vagrant up
 $ ansible-playbook tests/cluster.yml -vvvv