PD-1651 / 25.04 / PD-1651-update-vm-migration (#3427)

* caveats added * Update MigratingFromCORE.md * Update static/includes/COREMigratesList.md Co-authored-by: DjP-iX <[email protected]> --------- Co-authored-by: DjP-iX <[email protected]>
truenas · Jan 14, 2025 · ee3a8db · ee3a8db
1 parent d7baf48
commit ee3a8db
Show file tree

Hide file tree

Showing 3 changed files with 8 additions and 3 deletions.
diff --git a/content/SCALE/GettingStarted/Migrate/MigratePrep.md b/content/SCALE/GettingStarted/Migrate/MigratePrep.md
@@ -48,7 +48,7 @@ Enterprise customers are encouraged to contact Support for assistance with the p
 
    <input type="checkbox"> Deprecated services - Record the settings for [services deprecated in newer TrueNAS versions](#deprecated-services).
 
-   <input type="checkbox"> VMs - If you have virtual machines configured, write down or screenshot network and other setting information.
+   <input type="checkbox"> VMs - If you have virtual machines configured, write down or screenshot network, bootloader, and other setting information.
 
    <input type="checkbox"> Plugins or jails - Plugins and jails do not migrate. Record settings for each plugin/jail and back up the data associated with each.
 

diff --git a/content/SCALE/GettingStarted/Migrate/MigratingFromCORE.md b/content/SCALE/GettingStarted/Migrate/MigratingFromCORE.md
@@ -116,7 +116,7 @@ After uploading the config file, review each area of the UI previously configure
 See [Component Naming]({{< relref "ComponentNaming.md" >}}) for more information.
 {{< /hint >}}
 
-Use the information gathered during your preparation to migrate to restore settings, tasks, VMs, credentials, etc. not present after uploading the config file.
+Use the information gathered during your preparation to migrate to restore settings, tasks, VMs configured using the GRUB bootloader, credentials, etc. not present after uploading the config file.
 
 ## Recreating the Admin User Account
 

diff --git a/static/includes/COREMigratesList.md b/static/includes/COREMigratesList.md
@@ -28,7 +28,12 @@ These are the items that do not migrate:
   Usernames must begin with a letter or an underscore.
   Before attempting migration, review the local user accounts and rename or replace any accounts that begin with a numeric character (`0`-`9`).
 
-VM storage and its basic configuration transfer over during a migration, but you need to double-check the VM configuration and the network interface settings specifically before starting the VM.
+TrueNAS 13.X and earlier support VMs with UEFI and GRUB bootloaders.
+TrueNAS 22.02 and later does not support the GRUB bootloader.
+VMs configured with the UEFI bootloader can migrate.
+VMs configured with the GRUB bootloader are unable to migrate. 
+
+It is important for all users to double-check the VM configuration and network interface settings before starting the VM.
 
 {{< hint type=info title="VM Networking" >}}
 {{< include file="static/includes/ABridgeToSellYou.md" >}}