Skip to content

Conversation

OdedNeuhaus
Copy link

@OdedNeuhaus OdedNeuhaus commented Aug 11, 2025

I was migrating my Rancher 2.10.1 instance to a new cluster running RKE2 (the original local cluster was running RKE1), I followed the steps as described in:
https://ranchermanager.docs.rancher.com/how-to-guides/new-user-guides/backup-restore-and-disaster-recovery/migrate-rancher-to-new-cluster

I found out that after I made the change on my DNS server - all the clusters that were connected to my original Rancher server - were stuck on updating in the new Rancher server.

I figured out that the cattle-cluster-agents were still communicating with the old Rancher server, and had to fail their connection with it (or had to be restarted) - in order to make them communicate with the new Rancher server.

After I scaled down the the original Rancher server, the clusters became in Running state in the new Rancher server.
This is a very important step that wasn't mentioned in the migration guide.

I assume that more Rancher users can experience this problem when migrating their Rancher environment between clusters, and I think this addition to the Rancher migration guide will make their migrating operation easier (and possible).

I was migrating my Rancher instance to a new cluster running RKE2 (the original local cluster was running RKE1),
if followed the steps as described in https://ranchermanager.docs.rancher.com/how-to-guides/new-user-guides/backup-restore-and-disaster-recovery/migrate-rancher-to-new-cluster

I found out that after i made the change on my DNS server - all the clusters that were registrated to my original Rancher server - were stuck on updating in the new Rancher server.

I figured out that the cattle-cluster-agents were still communicating with the old Rancher server, and had to be restarted, or fail their connection with it - in order to make them communicate with the new Rancher server.

I assume that more Rancher users can experience this problem, and this add to the Rancher migration guide will make their migrating operation easier.
@OdedNeuhaus OdedNeuhaus changed the title Update migrate-rancher-to-new-cluster.md Scale down the original Rancher server Aug 11, 2025
Copy link
Contributor

@pmkovar pmkovar left a comment

Choose a reason for hiding this comment

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

Thanks for your PR! Just a few nitpicks.

OdedNeuhaus and others added 3 commits August 21, 2025 23:31
…-recovery/migrate-rancher-to-new-cluster.md

Co-authored-by: Petr Kovar <[email protected]>
…-recovery/migrate-rancher-to-new-cluster.md

Co-authored-by: Petr Kovar <[email protected]>
@OdedNeuhaus
Copy link
Author

Okay, thank you very much for the reply :)
So is there anything else i need to do now?

@pmkovar
Copy link
Contributor

pmkovar commented Aug 21, 2025

That should be it, thanks again.

@pmkovar pmkovar added the port/community-product Triggers a GitHub action to file a community sync issue for rancher-product-docs. label Sep 29, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
port/community-product Triggers a GitHub action to file a community sync issue for rancher-product-docs.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants