influxd upgrade
- Usage
- Flags

influxd upgrade

This page documents an earlier version of InfluxDB. InfluxDB v2.7 is the latest stable version. View this page in the v2.7 documentation.

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

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

This command performs the following actions:

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.
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