Skip to main content

Illumio Core 25.2.10 Install, Configure, Upgrade

Recovering from Migration Failures

Review these recommendations on how you can recover from possible migration failures.

pcemigrate Failures

  • pcemigrate migrate and pcemigrate sync commands may fail if the object limit is reached on the SaaS PCE or if you have inadequate credentials for certain operations.

    • To identify the cause of the failure, check the pcemigrate.log file. Rerun the command to resume the migration. You can modify this behavior by using the forced-restart option.

venmigrate Failures

If venmigrate migrate fails due to incorrect migration parameters, such as a wrong activation code or incorrect Illumio SaaS details, follow these steps to pair the VEN back to the on-prem PCE.

  1. Double-check the accuracy of the parameters required to pair the VEN with Illumio SaaS before generating the VEN migration parameter file.

  2. Generate a VEN migration parameter file to re-pair VENs with the on-prem PCE, including the necessary parameters: the on-prem PCE FQDN, pairing profile ID, activation code, and org ID.

  3. Deploy the encrypted VEN migration parameter files for both on-prem PCE and Illumio SaaS, along with the venmigrate tool and workload metadata file if needed on VEN hosts.

  4. To re-pair the VEN with the on-prem PCE, rerun the venmigrate command with the file containing the encrypted parameters for the on-prem PCE.

Use the following examples to pair with SaaS and re-pair with the on-prem PCE.

# To migrate the VEN from the on-premise PCE to the Illumio SaaS. 4x2testvc49-to-mnctestvc13-01.enc contains encrypted parameters to paair with Illumio SaaS
> venmigrate migrate --enc-ven-migrate-conf-file 4x2testvc49-to-mnctestvc13-01.enc --workload-meta-data-file workloads-to-migrate-metadata.json --do-not-apply-custom-labels
 
# To pair back the VEN with the on-premise PCE. mnctestvc13-to-4x2testvc49-01.enc contains encrypted parameters to pair with the on-premises PCE
> venmigrate migrate --enc-ven-migrate-conf-file mnctestvc13-to-4x2testvc49-01.enc --workload-meta-data-file workloads-to-migrate-metadata.json --do-not-apply-custom-labels