Skip to main content

Install, Configure, and Upgrade Guide for 26.x

About the pcemigrate Tool

The pcemigrate tool helps on-premises customers transition to SaaS by facilitating object migration between two PCEs. It is compatible with Linux (recommended), macOS, and Windows, and provides these features:

  • Exporting and applying managed workload metadata.

  • Generating and encrypting VEN migration parameters in a YAML file.

  • Deleting subsets of unmanaged workloads based on filters.

  • Unpairing managed workloads based on various filters.

  • Persistently storing migration information to resume operations.

The workflow for on-premises PCE-to-SaaS migration involves setting up the organization in SaaS, migrating policy objects and, optionally, management objects, and migrating VENs in sets by creating unmanaged workloads, pairing them, and applying custom labels.

Synchronization of policy objects and workload changes between the two PCEs occurs during VEN migration. After migrating to SaaS, unmanaged workloads are removed from the on-premise PCE, and redundant ones are removed from SaaS.

Note

To download the pcemigrate tool, go to the Illumio Support website. You must log in to the Support portal.

pcemigrate Syntax

pcemigrate command \[flags]

  • command is the specific command to execute. For example, the label-export command exports labels to a JSON file.

  • flags are optional parameters. Some of the parameters are global and can be specified for all commands.

Examples are: --verbose, --debug, --pce.