Upgrading from Previous Versions

Upgrading from version 1.2.5 to 1.3.3

Version 1.3.3 is a drop-in replacement for version 1.2.5 with no data migration required.

Version 1.3.3 introduces changes to the data node configuration file. Please update that configuration file to avoid any unnecessary downtime. The steps below outline the upgrade process and include a list of the required configuration changes.

Step 0: Back up your cluster before upgrading to version 1.3.

It is recommended to create a full backup of your cluster prior to executing the upgrade. If you are already have incremental backups being created as part of your standard operating procedures, you should trigger a final incremental backup before proceeding with the upgrade.

Note that you need to ensure you have sufficient disk space before triggering the backup.
The following command uses the version 1.2 backup syntax to create an incremental backup of your cluster and it stores that backup in the current directory.

influxd-ctl backup .

Otherwise, you should create a full backup before proceeding. The following command uses the version 1.2 backup syntax to create a full backup of your cluster and it stores that backup in the current directory.

influxd-ctl backup -full .

Step 1: Download the 1.3.3 packages

Meta node package download

Ubuntu & Debian (64-bit)

wget https://dl.influxdata.com/enterprise/releases/influxdb-meta_1.3.3-c1.3.3_amd64.deb

RedHat & CentOS (64-bit)

wget https://dl.influxdata.com/enterprise/releases/influxdb-meta-1.3.3_c1.3.3.x86_64.rpm

Data node package download

Ubuntu & Debian (64-bit)

wget https://dl.influxdata.com/enterprise/releases/influxdb-data_1.3.3-c1.3.3_amd64.deb

RedHat & CentOS (64-bit)

wget https://dl.influxdata.com/enterprise/releases/influxdb-data-1.3.3_c1.3.3.x86_64.rpm

Step 2: Install the 1.3.3 packages

Meta node package Install

Ubuntu & Debian (64-bit)

sudo dpkg -i influxdb-meta_1.3.3-c1.3.3_amd64.deb

RedHat & CentOS (64-bit)

sudo yum localinstall influxdb-meta-1.3.3_c1.3.3.x86_64.rpm

Data node package install

When you run the install command, your terminal asks if you’d like to keep your current configuration file or overwrite your current configuration file with the file for version 1.3.3. Please keep your current configuration file by entering N or O; we update the configuration file with the necessary changes for version 1.3.2 in step 3.

Ubuntu & Debian (64-bit)

sudo dpkg -i influxdb-data_1.3.3-c1.3.3_amd64.deb

RedHat & CentOS (64-bit)

sudo yum localinstall influxdb-data-1.3.3_c1.3.3.x86_64.rpm

Step 3: Update the data node configuration file

Add:

Remove:

  • max-remote-write-connections from the [cluster] section
  • the [admin] section

Update:

The new configuration options are set to their default settings. Follow the links for more information about those options.

Step 4: Restart the processes

Meta node restart

sysvinit systems

service influxdb-meta restart

systemd systems

sudo systemctl restart influxdb-meta

Data node Restart

sysvinit systems

service influxdb restart

systemd systems

sudo systemctl restart influxdb

Step 5: Confirm the upgrade

Check your nodes’ version numbers using the influxd-ctl show command. The influxd-ctl tool is available on all meta nodes.

~# influxd-ctl show

Data Nodes
==========
ID	TCP Address		Version
4	rk-upgrading-01:8088	1.3.3_c1.3.3   # 1.3.3_c1.3.3 = 👍
5	rk-upgrading-02:8088	1.3.3_c1.3.3
6	rk-upgrading-03:8088	1.3.3_c1.3.3

Meta Nodes
==========
TCP Address		Version
rk-upgrading-01:8091	1.3.3_c1.3.3
rk-upgrading-02:8091	1.3.3_c1.3.3
rk-upgrading-03:8091	1.3.3_c1.3.3

If you have any issues upgrading your cluster, please do not hesitate to contact support at the email provided to you when you received your InfluxEnterprise license.

This documentation is open source. See a typo? Please, open an issue.


Need help getting up and running? Get Support