Merge pull request 'Update README' (#2) from devel into main

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

truenas_migrate/migrate.py

@@ -386,24 +386,21 @@ async def _migrate_iscsi_targets(
             summary.iscsi_targets_skipped += 1
             continue
 
-        # Filter out groups whose portal or initiator could not be mapped (e.g. portal
+        # Verify all referenced portals and initiators were successfully mapped
-        # creation failed).  Warn per dropped group but still create the target — a
+        missing = []
-        # target without every portal group is valid and preferable to no target at all.
-        valid_groups = []
         for g in target.get("groups", []):
-            unmapped = []
             if g.get("portal") not in portal_id_map:
-                unmapped.append(f"portal id={g['portal']}")
+                missing.append(f"portal id={g['portal']}")
             if g.get("initiator") not in initiator_id_map:
-                unmapped.append(f"initiator id={g['initiator']}")
+                missing.append(f"initiator id={g['initiator']}")
-            if unmapped:
+        if missing:
-                log.warning("   %s dropping group with unmapped %s",
+            msg = f"iSCSI target {name!r}: cannot remap {', '.join(missing)}"
-                            _yellow("WARN"), ", ".join(unmapped))
+            log.error("   %s: %s", _bold_red("SKIP"), msg)
-            else:
+            summary.iscsi_targets_failed += 1
-                valid_groups.append(g)
+            summary.errors.append(msg)
+            continue
 
-        payload = _iscsi_target_payload({**target, "groups": valid_groups},
+        payload = _iscsi_target_payload(target, portal_id_map, initiator_id_map)
-                                        portal_id_map, initiator_id_map)
         log.debug("   payload: %s", json.dumps(payload))
 
         if dry_run: