Skip to content

Conversation

@Yu-Jack
Copy link
Collaborator

@Yu-Jack Yu-Jack commented Jan 9, 2026

@Yu-Jack Yu-Jack self-assigned this Jan 9, 2026
Copilot AI review requested due to automatic review settings January 9, 2026 06:47
Copy link

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

This PR adds documentation for a known issue where VMs cannot be live migrated to a specific target node after upgrading from Harvester v1.5.x to v1.6.x. The documentation explains that VMs are migrated to a random node instead and provides a workaround by restarting the VM.

  • Adds a new section (### 7) documenting the VM migration issue after upgrade
  • Updates subsequent section numbering from 7 to 8 for VLAN behavior changes
  • Includes reference to the related GitHub issue #9739

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 4 comments.

File Description
versioned_docs/version-v1.7/upgrade/v1-5-x-to-v1-6-x.md Adds VM migration issue documentation and renumbers subsequent section
versioned_docs/version-v1.6/upgrade/v1-5-x-to-v1-6-x.md Adds VM migration issue documentation and renumbers subsequent section
docs/upgrade/v1-5-x-to-v1-6-x.md Adds VM migration issue documentation, renumbers subsequent section, and adds trailing newline

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Signed-off-by: Jack Yu <jack.yu@suse.com>
@github-actions
Copy link

github-actions bot commented Jan 9, 2026

Name Link
🔨 Latest commit d7c7ec4
😎 Deploy Preview https://69646b12efd14164888943b3--harvester-preview.netlify.app

Copy link
Contributor

@ihcsim ihcsim left a comment

Choose a reason for hiding this comment

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

Can we also update the 1.6 live migration document at https://docs.harvesterhci.io/v1.6/vm/live-migration/#starting-a-migration, under the existing 'note' section with something like:

Due to a limitation in the workload rollout strategy implementation, virtual machines that are pending restart may get live-migrated to a random node, instead of the specified target node. The virtual machines must be restarted for all subsequent targeted live migration to work.

### 7. Change in Default VLAN Behavior for Secondary Pod Interfaces
### 7. Virtual Machine Cannot Be Live Migrated to the Target Node
After upgrading Harvester to v1.6.x, virtual machines from v1.5.x cannot be live migrated to a user-specified target node. Instead, the virtual machines are migrated to a random node. This issue occurs because of the `RestartRequired` condition, which indicates that the virtual machines require a restart.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
After upgrading Harvester to v1.6.x, virtual machines from v1.5.x cannot be live migrated to a user-specified target node. Instead, the virtual machines are migrated to a random node. This issue occurs because of the `RestartRequired` condition, which indicates that the virtual machines require a restart.
After upgrading Harvester to v1.6.x, KubeVirt may report that some virtual machines are pending restart. These virtual machines cannot be live migrated to a user-specified target node from the UI, until they are restarted. Once restarted, subsequent node-specific live migrations will work.

Here and elsewhere - thanks.

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

Added. I changed some description and made it more synced between them.

Signed-off-by: Jack Yu <jack.yu@suse.com>
Copy link
Contributor

@jillian-maroket jillian-maroket left a comment

Choose a reason for hiding this comment

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

Just a few nits

Comment on lines +259 to +261
After upgrading Harvester to v1.6.x, KubeVirt may report that some virtual machines are pending restart. These virtual machines cannot be live migrated to a user-specified target node from the UI, until they are restarted. Once restarted, subsequent node-specific live migrations will work.
The workaround is to restart the virtual machine.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
After upgrading Harvester to v1.6.x, KubeVirt may report that some virtual machines are pending restart. These virtual machines cannot be live migrated to a user-specified target node from the UI, until they are restarted. Once restarted, subsequent node-specific live migrations will work.
The workaround is to restart the virtual machine.
Following an upgrade to v1.6.x, some virtual machines may remain in a _pending restart_ state. These virtual machines cannot be live migrated to the specified target node until they are restarted.
The workaround is to restart the virtual machines. Once restarted, subsequent node-specific live migrations will work.

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants