Progress and reports
Checking entity status
Run --status on any entity command at any time to view its migration progress. The output shows a count summary (MIGRATED / PENDING / MIGRATING / FAILED) and lists any entities that need attention.
migrate.py --organization --status
migrate.py --role --status
migrate.py --member --status
migrate.py --trust_store --status
migrate.py --identity_store --status
migrate.py --domain --status
migrate.py --api_definition --status
migrate.py --error_set --status
--status is not supported for --export_tokens or --import_tokens.
Status values
The following table describes each --status value and the action to take:
| --status | Description | What to do |
|---|---|---|
| MIGRATED | Successfully migrated. | No action needed. Skipped on re-run. |
| PENDING | Recorded but not yet processed. | Will be processed on the next run. |
| MIGRATING | In progress, or stuck if the pod was restarted. | Re-run the command. Recovers automatically. |
| FAILED | Failed with an error. | Re-run the command. Check the error message in the status output and the log file for details (for example, 400 Bad Request: Failed to create member — username: That username is not available). |
Log files
Each entity writes its migration history to /mnt/data/logs/migration_<entity>.log. For today's run only, check /mnt/data/logs/migration_<entity>_YYYY-MM-DD.log. If an entity fails, check the relevant log file for details. To list all log files, run ls /mnt/data/logs/.
CSV reports
After every --status run, a report is written to /mnt/data/reports/migration_report_<entity>.csv. It contains one row per entity with the source and target UUIDs, status, and timestamps.
Use this report to verify that all entities were successfully migrated or to troubleshoot issues after migration.
To copy a report out of the pod, run the following command:
# Kubernetes
kubectl cp migration-pod:/mnt/data/reports/migration_report_domain.csv ./migration_report_domain.csv
# Docker Swarm
docker cp <container-name>:/mnt/data/reports/migration_report_domain.csv ./migration_report_domain.csv
