This is archived documentation for InfluxData product versions that are no longer maintained. For newer documentation, see the latest InfluxData documentation.
This page outlines process for upgrading from:
Upgrading from 0.12 to 0.13
Download InfluxDB version 0.13
Update the configuration file
Export a default configuration file and manually migrate customizations into it before launching version 0.13.
Check out the new features outlined in Differences between InfluxDB 0.13 and 0.12
Upgrading from 0.10 or 0.11 to 0.13
Note: 0.10 users will need to convert any remaining
b1
andbz1
shards toTSM
format before following the instructions below. InfluxDB 0.13 cannot read non-TSM
shards. Check for non-TSM
shards in your data directory:
- Non-
TSM
shards are files of the form:data/<database>/<retention_policy>/<shard_id>
`TSM
shards are files of the form:data/<database>/<retention_policy>/<shard_id>/<file>.tsm
In versions prior to 0.12, InfluxDB stores
metastore information in
raft.db
via the raft services.
In versions 0.12+, InfluxDB stores metastore information in meta.db
, a binary
protobuf file.
The following steps outline how to transfer metastore information to the new format. They also outline when to upgrade the binary to 0.13 and when to generate a new configuration file.
To start out, you must be working with version 0.10 or 0.11 (don’t upgrade the
influxd
binary yet!).
If you’ve already upgraded the binary to 0.13, reinstall 0.11;
InfluxDB 0.13 will yield an error
(run: create server: detected /var/lib/influxdb/meta/raft.db. [...]
) if you
attempt to start the process without completing the steps below.
The examples below assume you are working with a version of linux.
Before you start, we recommend making a copy of the entire 0.10 or 0.11
meta
directory in case you experience problems with the upgrade. The upgrade process removes theraft.db
andnode.json
files from themeta
directory:cp -r <path_to_meta_directory> <path_to_011_meta_directory_backup>
Example:
Create a copy of the 0.10 or 0.11
meta
directory inbackups/
:~# cp -r /var/lib/influxdb/meta backups/
1. While still running 0.10 or 0.11, export the metastore data to a different directory:
influxd backup <path_to_metastore_backup>
The directory will be created if it doesn’t already exist.
Example:
Export the 0.10 or 0.11 metastore to /tmp/backup
:
~# influxd backup /tmp/backup/
2016/04/01 15:33:35 backing up metastore to /tmp/backup/meta.00
2016/04/01 15:33:35 backup complete
2. Stop the influxdb
service:
sudo service influxdb stop
3. Upgrade the influxd
binary to 0.13. but do not start the service.
4. Upgrade your metastore to the 0.13 store by performing a restore
with
the backup you created in step 1.
influxd restore -metadir=<path_to_013_meta_directory> <path_to_metastore_backup>
Example:
Restore /tmp/backup
to the meta directory in /var/lib/influxdb/meta
:
~# influxd restore -metadir=/var/lib/influxdb/meta /tmp/backup
Using metastore snapshot: /tmp/backup/meta.00
5. Generate a new configuration file.
InfluxDB 0.13 has several new settings in the configuration file.
The influxd config
command prints out a new TOML-formatted configuration with all the available configuration options set to their default values.
On POSIX systems, a new configuration file can be generated by redirecting the output of the command to a file.
influxd config > /etc/influxdb/influxdb_013.conf.generated
Compare your old configuration file against the newly generated InfluxDB 0.13 file and manually update any defaults with your localized settings.
6. Start the 0.13 service:
sudo service influxdb start
7. Confirm that your metastore data is present.
The 0.13 output from the queries SHOW DATABASES
,SHOW USERS
and
SHOW RETENTION POLICIES ON <database_name>
should match the 0.10 or 0.11
output.
If your metastore data do not appear to be present, stop the service, reinstall
InfluxDB 0.10 or 0.11, restore the copy you made of the entire 0.10 or 0.11 meta
directory to
the meta
directory, and try working through these steps again.
8. Check out the new features outlined in Differences between InfluxDB 0.13 and 0.12.