Updates to the Migration Tool
The Migration Toolkit has been updated with bug fixes and feature enhancements. Review these updates before you use the migration tool.
What's New and Resolved Issues in Version 4.17
Updated March 6, 2026
Illumio resolved these issues in this release.
pcemigrate migrate --import-rbacsuccessful completionThe
pcemigrate migrate --import-rbaccommand was failing during the migration. This fix ensures the RBAC import completes successfully, allowing you to continue your migration workflow without any interruptions.pcemigrate migratecommand panicThe
pcemigrate migratecommand panicked with a nil-pointer dereference when workloads on the target PCE lacked hostnames. This fix ensures that the migration completes without interruptions even when some workloads lack hostname data.pcemigrate wild-exportandwkld-importsupport for complex filter filesThe
pcemigrate wild-exportandwkld-importcommands did not support complex filter files. This fix allows users to filter by hostnames, names, hrefs, and external datasets to streamline migration tasks.venmigrateand AIX workload labelsThe
venmigratecommand did not apply labels to AIX workloads. This fix ensures labels are correctly applied during migration, keeping your AIX workloads organized and consistent.venmigrateand costly queries to the PCEThe
venmigratecommand used queries to the PCE instead of referencing the workload UUID. This fix improves migration performance and helps you manage workloads more efficiently.pcemigratebase directory consistencyThe
pcemigratebase directory depended on the directory from which the command was executed. This fix ensures the command uses a consistent base directory so migration workflows run reliably from any location.
What's New and Resolved Issues in Version 4.16
Updated February 13, 2026
pcemigrate version output
The tool is now more resilient to user errors. The pcemigrate sync no longer proceeds when required migration data is missing or inconsistent.
Resolved issues in version 4.16
The
pcemigrate synccommand may continue updating some workloads on the target PCE even when no further changes are present on the source PCE.Previously, if a policy object already synchronized to the target PCE was deleted on the source PCE and replaced with a new object with the same name, running
pcemigrate syncwould delete the object on the target PCE.This issue has been resolved. The target PCE now updates the existing object with the content of the newly created object from the source PCE.
The tool may panic when
pcemigrate migrate --only-import-objectsis executed.
What's New and Resolved Issues in Version 4.15
Updated January 28, 2026
pcemigrate sync may fail to provision policy objects on the SaaS PCE
may fail to provision policy objects on the SaaS PCE if the content has not actually changed. The update is triggered by the object being provisioned on-prem, or by the absence of a map file, or by an empty map file while there are objects on-prem.
What's New and Resolved Issues in Version 4.14
Updated January 26, 2026
Improved Reliability for Policy Object Deletions
Resolved an issue where deleting certain policy objects—or provisioning them—could fail without triggering a
pcemigratesyncfailure.More Resilient Handling of HTTP 5xx Errors
Enhanced error-handling logic to better manage transient server-side (5xx) responses.
Unified Version Display
Tool version, commit ID, and timestamp now appear together on a single line for easier reference.
Stability Fix for Policy Object Removal
Addressed a condition that could cause the tool to panic when all objects of a specific policy type were deleted across on‑prem and SaaS environments.
What's New and Resolved Issues in Version 4.13
Updated January 22, 2026
An issue in the
pcemigratesync tool would cause it to stop unexpectedly when all policy objects of a specific type were deleted from the source PCE. This could prevent some policy objects from syncing. This issue is resolved, and pcemigrate sync now continues reliably in this scenario.
Updated January 9, 2026
In custom migration scenarios, an issue was resolved in which the
transplant-vens-statuscommand failed to generate CSV output on Windows systems. The tool now correctly creates CSV files on Windows environments.Previously, rules that contained unmanaged workloads without hostnames were pruned or dropped from rulesets during policy sync from on-prem to SaaS. The migration sync tool now correctly handles unmanaged workload references, ensuring that valid rules are preserved and not dropped.
What's New in Version 4.12
Custom Migration CLI Updates
The Migration Toolkit version 4.12 includes command-line updates to: pcemigrate
transplant- vens-statusThe command used to check the VEN transplant status is updated. The
--csv_output_fileoption is replaced with--csv_output_file_dir.
Note
This applies to both the standard and custom migrations.
pcemigrate sync – Draft policy objects
pcemigrate sync no longer supports syncing draft versions of policy objects.
Draft policy objects must be either provisioned or deleted before you run the pcemigrate sync.
Note
This applies to both the standard and custom migrations.
What's New in Version 4.11
Published: November 26, 2025
This version includes support for large-scale migrations (more than 20,000 workloads).
Added tooling enhancements and workflows to support custom migration for large customers.
Introduced VEN transplant capabilities using pcemigrate, which enables bulk VEN migration without requiring venmigrate.