Documentation

influxd upgrade

Use the influxd upgrade command to upgrade an instance of InfluxDB 1.x to InfluxDB 2.0. This command copies all data in databases and retention policies (used in 1.x) over to buckets (used in 2.0).

Be sure to back up all data before upgrading with influx upgrade.

This command performs the following actions:

  1. Creates the InfluxDB 2.x configuration file using 1.x configuration file options. Unsupported 1.x options are reported to standard output. If the configuration file is not available, the 1.x database folder can be passed via th --v1-dir flag.
  2. Copies and upgrades 1.x database files.

The target 2.x database directory is specified by the --engine-path option. If changed, the bolt path can be specified by the --bolt-path option.

Usage

influxd upgrade [flags]
influxd upgrade [command]

Flags

Flag Description Input type
-m --bolt-path Path for boltdb database (default ~/.influxdbv2/influxd.bolt) string
-b --bucket Primary bucket name string
--config-file Custom InfluxDB 1.x config file path (default ~/.influxdb/influxdb.conf) string
--continuous-query-export-path Path for exported 1.x continuous queries (default ~/continuous_queries.txt) string
-e --engine-path Path for persistent engine files (default ~/.influxdbv2/engine) string
-f --force Skip the confirmation prompt
-h --help Help for influxd upgrade
-c --influx-configs-path Path for 2.x influx CLI configurations file (default ~/.influxdbv2/configs)
--log-level Supported log levels are debug, info, warn, and error (default info) string
--log-path Custom log file path (default ~/upgrade.log) string
-o --org Primary organization name string
--overwrite-existing-v2 Overwrite existing files at the output paths instead of aborting the upgrade process
-p --password Password for username string
-r --retention Duration bucket will retain data (default 0; retains data infinitely) string
-t --token Token for username. If not specified, a token is auto-generated. string
-u --username Primary username string
--v1-dir Path to source 1.x db directory containing meta, data, and wal sub-folders (default ~/.influxdb) string
--v2-config-path Destination path for upgraded 2.x configuration file (default ~/.influxdbv2/config.toml) string
-v --verbose Verbose output

Set your InfluxDB URL

Upgrade to InfluxDB Cloud or InfluxDB 2.0!

InfluxDB Cloud and InfluxDB OSS 2.0 ready for production.