--- title: Upgrade InfluxDB Enterprise clusters aliases: - /enterprise/v1.7/administration/upgrading/ menu: enterprise_influxdb_1_7: name: Upgrade weight: 50 parent: Administration --- To successfully upgrade InfluxDB Enterprise clusters to {{< latest-patch >}}, complete the following steps: 1. [Back up your cluster](#back-up-your-cluster). 2. [Upgrade meta nodes](#upgrade-meta-nodes). 3. [Upgrade data nodes](#upgrade-data-nodes). > ***Note:*** To downgrade to an earlier version, complete the following procedures, replacing the version numbers with the version that you want to downgrade to. ## Back up your cluster Before performing an upgrade, create a full backup of your InfluxDB Enterprise cluster. Also, if you create incremental backups, trigger a final incremental backup. > ***Note:*** For information on performing a final incremental backup or a full backup, > see [Back up and restore InfluxDB Enterprise clusters](/enterprise_influxdb/v1.7/administration/backup-and-restore/). ## Upgrade meta nodes Complete the following steps to upgrade meta nodes: 1. [Download the meta node package](#download-the-meta-node-package). 2. [Install the meta node package](#install-the-meta-node-package). 3. [Update the meta node configuration file](#update-the-meta-node-configuration-file). 4. [Restart the `influxdb-meta` service](#restart-the-influxdb-meta-service). 5. Repeat steps 1-4 for each meta node in your cluster. 6. [Confirm the meta nodes upgrade](#confirm-the-meta-nodes-upgrade). ### Download the meta node package ##### Ubuntu and Debian (64-bit) ```bash wget https://dl.influxdata.com/enterprise/releases/influxdb-meta_{{< latest-patch >}}-c{{< latest-patch >}}_amd64.deb ``` ##### RedHat and CentOS (64-bit) ```bash wget https://dl.influxdata.com/enterprise/releases/influxdb-meta-{{< latest-patch >}}_c{{< latest-patch >}}.x86_64.rpm ``` ### Install the meta node package ##### Ubuntu and Debian (64-bit) ```bash sudo dpkg -i influxdb-meta_{{< latest-patch >}}-c{{< latest-patch >}}_amd64.deb ``` ##### RedHat and CentOS (64-bit) ```bash sudo yum localinstall influxdb-meta-{{< latest-patch >}}_c{{< latest-patch >}}.x86_64.rpm ``` ### Update the meta node configuration file Migrate any custom settings from your previous meta node configuration file. To enable HTTPS, you must update the meta node configuration file (`influxdb-meta.conf`). For information, see [Enable HTTPS within the configuration file for each Meta Node](/enterprise_influxdb/v1.7/guides/https_setup/#setup-https-in-an-influxdb-enterprise-cluster). ### Restart the `influxdb-meta` service ##### sysvinit systems ```bash service influxdb-meta restart ``` ##### systemd systems ```bash sudo systemctl restart influxdb-meta ``` ### Confirm the meta nodes upgrade After upgrading _**all**_ meta nodes, check your node version numbers using the `influxd-ctl show` command. The [`influxd-ctl` utility](/enterprise_influxdb/v1.7/administration/cluster-commands/) is available on all meta nodes. ```bash ~# influxd-ctl show Data Nodes ========== ID TCP Address Version 4 rk-upgrading-01:8088 1.7.x_c1.7.y 5 rk-upgrading-02:8088 1.7.x_c1.7.y 6 rk-upgrading-03:8088 1.7.x_c1.7.y Meta Nodes ========== TCP Address Version rk-upgrading-01:8091 {{< latest-patch >}}_c{{< latest-patch >}} # {{< latest-patch >}}_c{{< latest-patch >}} = 👍 rk-upgrading-02:8091 {{< latest-patch >}}_c{{< latest-patch >}} rk-upgrading-03:8091 {{< latest-patch >}}_c{{< latest-patch >}} ``` Ensure that the meta cluster is healthy before upgrading the data nodes. ## Upgrade data nodes Complete the following steps to upgrade data nodes: 1. [Download the data node package](#download-the-data-node-package). 2. [Stop traffic to data nodes](#stop-traffic-to-the-data-node). 3. [Install the data node package](#install-the-data-node-package). 4. [Update the data node configuration file](#update-the-data-node-configuration-file). 5. For Time Series Index (TSI) only. [Rebuild TSI indexes](#rebuild-tsi-indexes). 6. [Restart the `influxdb` service](#restart-the-influxdb-service). 7. [Restart traffic to data nodes](#restart-traffic-to-data-nodes). 8. Repeat steps 1-7 for each data node in your cluster. 9. [Confirm the data nodes upgrade](#confirm-the-data-nodes-upgrade). ### Download the data node package ##### Ubuntu and Debian (64-bit) ```bash wget https://dl.influxdata.com/enterprise/releases/influxdb-data_{{< latest-patch >}}-c{{< latest-patch >}}_amd64.deb ``` ##### RedHat and CentOS (64-bit) ```bash wget https://dl.influxdata.com/enterprise/releases/influxdb-data-{{< latest-patch >}}_c{{< latest-patch >}}.x86_64.rpm ``` ### Stop traffic to the data node - If you have access to the load balancer configuration, use your load balancer to stop routing read and write requests to the data node server (port 8086). - If you cannot access the load balancer configuration, work with your networking team to prevent traffic to the data node server before continuing to upgrade. ### Install the data node package When you run the install command, you're prompted to keep or overwrite your current configuration file with the file for version {{< latest-patch >}}. Enter `N` or `O` to keep your current configuration file. You'll make the configuration changes for version {{< latest-patch >}}. in the next procedure, [Update the data node configuration file](#update-the-data-node-configuration-file). ##### Ubuntu and Debian (64-bit) ```bash sudo dpkg -i influxdb-data_{{< latest-patch >}}-c{{< latest-patch >}}_amd64.deb ``` ##### RedHat & CentOS (64-bit) ```bash sudo yum localinstall influxdb-data-{{< latest-patch >}}_c{{< latest-patch >}}.x86_64.rpm ``` ### Update the data node configuration file Migrate any custom settings from your previous data node configuration file. - To enable HTTPS, see [Enable HTTPS within the configuration file for each Data Node](/enterprise_influxdb/v1.7/guides/https_setup/#setup-https-in-an-influxdb-enterprise-cluster). - To enable TSI, open `/etc/influxdb/influxdb.conf`, and then adjust and save the settings shown in the following table. | Section | Setting | | --------| ----------------------------------------------------------| | `[data]` |