Skip to content

docs: fix up incorrect upgrade advice for 3.5 -> 3.6 upgrade#1117

Open
alam0rt wants to merge 1 commit intoetcd-io:mainfrom
alam0rt:main
Open

docs: fix up incorrect upgrade advice for 3.5 -> 3.6 upgrade#1117
alam0rt wants to merge 1 commit intoetcd-io:mainfrom
alam0rt:main

Conversation

@alam0rt
Copy link
Copy Markdown

@alam0rt alam0rt commented Feb 4, 2026

It is not true that *NOTE:** If the --enable-v2 flag is not configured or is set to false, no further action is required.. V2 Store data will continue to be propagated to followers if it exists.

@k8s-ci-robot
Copy link
Copy Markdown

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by: alam0rt
Once this PR has been reviewed and has the lgtm label, please assign wenjiaswe for approval. For more information see the Code Review Process.

The full list of commands accepted by this bot can be found here.

Details Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@k8s-ci-robot
Copy link
Copy Markdown

Hi @alam0rt. Thanks for your PR.

I'm waiting for a etcd-io member to verify that this patch is reasonable to test. If it is, they should reply with /ok-to-test on its own line. Until that is done, I will not automatically test new commits in this PR, but the usual testing commands by org members will still work. Regular contributors should join the org to skip this step.

Once the patch is verified, the new status will be reflected by the ok-to-test label.

I understand the commands that are listed here.

Details

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository.

Is it possible that custom data exists in v2store despite v2store not being enabled. Before upgrading to 3.6, make sure that you run the `etcdutl check v2store` utility as it prevent 3.6 running.
{{% /alert %}}

1. If there is data in the v2store that needs to be migrated to the v3store, follow the [v2 migration guide](../../../v3.4/op-guide/v2-migration/) to migrate the data.
Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Not sure if this is recommended since we'd need to downgrade to 3.4 right?

Signed-off-by: alam0rt <sam@samlockart.com>

If `--enable-v2` or the environment variable `ETCD_ENABLE_V2="true"` **is** configured, additional steps are required to handle the v2store data:
{{% alert title="Important" color="warning" %}}
Is it possible that custom data exists in v2store despite v2store not being enabled. Before upgrading to 3.6, make sure that you run the `etcdutl check v2store` utility as it prevent 3.6 running.
Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I know this is true because I am experiencing it as we speak haha. Stuck on 3.5 with v2store data. Compounded by not being able to tolerate downtime + v2 API not being accessible etcd-io/etcd#21249

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think we need to understand the issue you're hitting better, because all of the v2store data issues were supposed to be fixed.

@ronaldngounou
Copy link
Copy Markdown
Member

/ok-to-test

@ronaldngounou
Copy link
Copy Markdown
Member

/retest
/lgtm

@jberkus
Copy link
Copy Markdown
Contributor

jberkus commented Apr 3, 2026

@alam0rt Yes, this sounds more like a bug than a required doc change. Let's put this on hold until the bug is evaluated.

/hold

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants