startMigrationStep

Creates the first migration step, which imports legacy authenticator data through the provided LegacyStorageProvider.

Execution order within this step:

1. Calls LegacyStorageProvider.isMigrationRequired — returns ABORT immediately if false (clean install or already migrated).

2. Calls LegacyStorageProvider.getMigrationData to load LegacyExportedData.

3. Returns ABORT if the mechanisms list is empty; otherwise stores the list in the migration state and returns CONTINUE.

Any exception thrown by LegacyStorageProvider.getMigrationData is wrapped in an IllegalArgumentException and re-thrown, which causes the migration framework to emit a com.pingidentity.migration.MigrationProgress.Error event and stop the pipeline.

Parameters

See also