influxdata / influxdata/influxdb

[v2] Upgrading to 2.8 prevents clean downgrade path

Open
#27,378 0 comments 0 reactions 0 assignees View on GitHub
area/2.x
Dominant language
Rust
Stars
31.7k
Forks
3.7k
Avg merge
13h 37m
Merged PRs (30d)
8

Description

__Steps to reproduce:__
List the minimal actions needed to reproduce the behaviour.

1. Work with 2.7
2. Upgrade to 2.8
3. Downgrade back to 2.7

__Expected behaviour:__
It should maintain a compatible DB and not break it.

__Actual behaviour:__
Downgrade fails.

__Environment info:__

Running on docker. I cannot run `influxd downgrade` because I just switch between images.

__Logs:__
```
E 2026-04-26T09:40:14.692494180Z info found existing boltdb file, skipping setup wrapper {"system": "docker", "bolt_path": "/var/lib/influxdb2/influxd.bolt"}
E 2026-04-26T09:40:14.748595353Z info found existing boltdb file, skipping setup wrapper {"system": "docker", "bolt_path": "/var/lib/influxdb2/influxd.bolt"}
I ts=2026-04-26T09:40:14.932983Z lvl=info msg="Welcome to InfluxDB" log_id=12UIQRq0000 version=v2.7.12+SNAPSHOT.6584e05ad3 commit=6584e05ad3 build_date=2026-03-23T08:54:05Z log_level=info
W ts=2026-04-26T09:40:14.933131Z lvl=warn msg="nats-port argument is deprecated and unused" log_id=12UIQRq0000
I ts=2026-04-26T09:40:14.935727Z lvl=info msg="Resources opened" log_id=12UIQRq0000 service=bolt path=/var/lib/influxdb2/influxd.bolt
I ts=2026-04-26T09:40:14.936097Z lvl=info msg="Resources opened" log_id=12UIQRq0000 service=sqlite path=/var/lib/influxdb2/influxd.sqlite
E ts=2026-04-26T09:40:14.938000Z lvl=error msg="Failed to apply KV migrations" log_id=12UIQRq0000 error="up: reading migrations: DB contains record of unknown migration \"create authorizationhashedindexv1 bucket\" - if you are downgrading from a more recent version of influxdb, please run the \"influxd downgrade\" command from that version to revert your metadata to be compatible with this version prior to starting influxd."
E Error: up: reading migrations: DB contains record of unknown migration "create authorizationhashedindexv1 bucket" - if you are downgrading from a more recent version of influxdb, please run the "influxd downgrade" command from that version to revert your metadata to be compatible with this version prior to starting influxd.
E See 'influxd -h' for help
```

Contributor guide

Open the contributing guide

Research direction

Start by reproducing the upgrade and downgrade sequence with the 2.7 and 2.8 Docker images, using the reported influxd migration error as the entry point. Investigate how the authorizationhashedindexv1 migration is recorded and handled; done means a database upgraded to 2.8 can return to 2.7 without breaking compatibility.

Written by the indexing model from the issue text.

Assessment

Tech stack
docker
Domain
databases, devops
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.