Upgrade from InfluxDB OSS 2.x to InfluxDB Cloud

To upgrade from InfluxDB OSS 2.x to InfluxDB Cloud:

1. Create an InfluxDB Cloud account
2. Create an All-Access API token
3. Set up influx CLI connection configurations
4. Use templates to migrate InfluxDB resources
5. Migrate DBRP mappings
6. Dual write to InfluxDB 2.x and InfluxDB Cloud
7. Migrate time series data
8. Collaborate with other users

Create an InfluxDB Cloud account

Do one of the following to create an InfluxDB Cloud account:

• Subscribe through InfluxData and start for free.
• Subscribe through your cloud provider.

Create an All-Access API token

InfluxDB API tokens are unique to each organization. Create an All-Access token in your InfluxDB Cloud user interface (UI) to use for the upgrade process.

1. Click Data (Load Data) > Tokens in the left navigation bar.

   Load Data

2. Click Generate, and then select All-Access Token.

3. Enter a description for the token, and then click Save.

For more information about managing tokens and token types, see Manage tokens.

Set up influx CLI connection configurations

The influx command line interface (CLI) lets you create connection configurations that automatically provides host, organization, and API token credentials to CLI commands. Use the influx CLI packaged with InfluxDB 2.x and the influx config create command to set up the connection configurations for both your InfluxDB Cloud instance and your InfluxDB 2.x instance.

Include the following flags for each configuration:

• --config-name: Unique name for the connection configuration. The examples below use cloud and oss respectively.
• --host-url: InfluxDB Cloud region URL or InfluxDB 2.x URL.
• --org: InfluxDB organization name. The default organization name in InfluxDB Cloud is the email address associated with your account.
• --token: API token to use to connect to InfluxDB.
  • InfluxDB Cloud: Provide an All-Access token.
  • InfluxDB OSS 2.x: Provide an Operator token.

Create an InfluxDB Cloud connection configuration

# Example cloud connection configuration
influx config create \
  --config-name cloud \
  --host-url https://cloud2.influxdata.com \
  --org your.email@example.com \
  --token mY5uP3rS3cRe7Cl0uDt0K3n

Create an InfluxDB 2.x connection configuration

# Example 2.x connection configuration
influx config create \
  --config-name oss \
  --host-url http://localhost:8086 \
  --org example-org \
  --token mY5uP3rS3cRe70S5t0K3n

Use templates to migrate InfluxDB resources

InfluxDB templates let you export InfluxDB resources such as buckets, dashboards, labels, tasks, and more and import them into another InfluxDB instance. Export resources from your InfluxDB 2.x instance and migrate them to your InfluxDB Cloud instance.

• To migrate all resources from an InfluxDB 2.x organization to an InfluxDB Cloud organization:
  Use the influx export all command and pipe the output into the influx apply command. Use the --active-config flag with each command to specify which connection configuration to use:

  influx export all --active-config oss | influx apply --active-config cloud
  

• To migrate specific resources from an InfluxDB 2.x organization to an InfluxDB Cloud organization:
  Use the influx export command with lists of specific resources to export or the influx export all command with filters. Pipe the output into the influx apply command. Use the --active-config flag with each command to specify which connection configuration to use:

  Migrate specific resources Migrate all with filters

  influx export \
    --active-config oss \
    --buckets 0Xx0oox00XXoxxoo1,0Xx0oox00XXoxxoo2 \
    --labels o0x0oox0Xxoxx001,o0x0oox0Xxoxx002 \
    --dashboards 0XxXooXoo0xooXo0X1,0XxXooXoo0xooXo0X2 | \
  influx apply --active-config cloud
  

  influx export all \
    --active-config oss \
    --filter=resourceKind=Bucket \
    --filter=resourceKind=Dashboard \
    --filter=labelName=Foo | \
  influx apply --active-config cloud
  

  For more export command examples, see the influx export and influx export all documentation.

  Update hardcoded InfluxDB URLs

  If any of your migrated resources contain hardcoded InfluxDB URLs (http://localhost:8086), do one of the following to update these URLs to your InfluxDB Cloud region URL:

  • Migrate your resources to InfluxDB Cloud, and then update URLs in the InfluxDB Cloud UI.
  • Save your template to a file, update URLs in the file, and then apply the template to your InfluxDB Cloud instance.

Migrate DBRP mappings

InfluxDB database and retention policy (DBRP) mappings let you query InfluxDB Cloud buckets with InfluxQL and the InfluxDB 1.x DBRP convention. If you have DBRP mappings in your InfluxDB 2.x instance, migrate them to your InfluxDB Cloud instance.

Dual write to InfluxDB 2.x and InfluxDB Cloud

Update external clients to write to your InfluxDB Cloud instance. We recommend writing data to both InfluxDB 2.x and InfluxDB Cloud until you finish migrating your existing time series data. For step-by-step instructions, see Dual write.

Migrate time series data

To migrate your time series data from your InfluxDB 2.x instance to your InfluxDB Cloud instance, do the following:

1. Use the influx bucket list command to view a list of your InfluxDB 2.x buckets and their IDs.

   influx bucket list --active-config oss
   

2. Use the influxd inspect export-lp command to export data from a bucket in your InfluxDB 2.x instance as line protocol. Include the following flags:

   • --bucket-id: Bucket ID to export
   • --engine-path: InfluxDB engine path
   • --output-path: Output file path
   • --compress: (Optional) Gzip the exported line protocol
   • --start: (Optional) Earliest timestamp to export
   • --end: (Optional) Latest timestamp to export

   influxd inspect export-lp \
     --bucket-id 12ab34cd56ef \
     --engine-path ~/.influxdbv2/engine \
     --compress \
     --output-path path/to/bucket-export.lp
   

3. Use the influx write command to write your exported line protocol to your InfluxDB Cloud instance. Provide the following.

   • --bucket: Target bucket name
     OR
     --bucket-id: Target bucket ID
   • --compression: (Optional) gzip if the exported line protocol is compressed
   • --file: Import file path

   influx write \
     --active-config cloud \
     --bucket example-bucket \
     --compression gzip \
     --file path/to/bucket-export.lp
   

4. Repeat steps 2-3 for each bucket.

Migrate system buckets

InfluxDB system buckets contain data related to the InfluxDB monitoring and alerting system. Although the retention period for system buckets in both InfluxDB Cloud and InfluxDB 2.x is only seven days, if you want to migrate this data, use the same method described above to migrate time series data.

Export and write data in a single command

If your data and rate limits allow, you can export and write data in a single command without writing a line protocol export file to disk. The influxd inspect export-lp command can output to stdout and the influx write command accepts line protocol from stdin.

influxd inspect export-lp \
  --bucket-id 12ab34cd56ef \
  --engine-path ~/.influxdbv2/engine \
  --compress \
  --output-path - | \
influx write \
  --active-config cloud \  
  --bucket example-bucket \
  --compression gzip \
  --rate-limit "5MB/5min"

Collaborate with other users

To collaborate with other users in your InfluxDB Cloud organization, invite users to join your organization.