DLP upgrade migration fails during Phase 1

Products

• Data Loss Prevention Enforce

Issue/Introduction

DLP Software for the new version was successfully installed.  The migrateEnforce batch file is started, but the upgrade stops with an error message "Failed to execute migration actions."

Aug 24, 2021 8:54:31 AM com.symantec.dlp.migrationcommon.MigrationActionsExecutor executeMigrationActions
SEVERE: Failed to execute migration actions. Please refer to the log file for details
com.symantec.dlp.migrationcommon.MigrationException: Failed to run migration action "VerifyURTZipIsExtracted"
 at com.symantec.dlp.migrationcommon.MigrationActionsExecutor.runMigrationAction(MigrationActionsExecutor.java:72)
 at com.symantec.dlp.migrationcommon.MigrationActionsExecutor.executeMigrationActions(MigrationActionsExecutor.java:118)
 at com.symantec.dlp.migrationcommon.MigrationUtility.runMigrationUtility(MigrationUtility.java:168)
 at com.symantec.dlp.migrationcommon.MigrationUtility.runMigrationUtility(MigrationUtility.java:106)
 at com.symantec.dlp.migrationcommon.MigrationUtility.runMigrationUtility(MigrationUtility.java:112)
 at com.symantec.dlp.enforceservermigrationutility.EnforceServerMigrationUtility.runMigration(EnforceServerMigrationUtility.java:37)
Caused by: com.symantec.dlp.migrationcommon.MigrationException: Please ensure Upgrade Readiness tool is extracted. File not found: /opt/Symantec/DataLossPrevention/EnforceServer/15.8.00000/Protect/Migrator/URT/prechecker.properties.
 at com.symantec.dlp.enforceservermigrationutility.actions.VerifyExtractedURTMigrationAction.runAction(VerifyExtractedURTMigrationAction.java:64)
 at com.symantec.dlp.migrationcommon.MigrationActionsExecutor.runMigrationAction(MigrationActionsExecutor.java:65)
 ... 5 more

Environment

DLP 15.8

DLP 16.x

Cause

The migrator is looking for the Update Readiness Tool in the \Program Files\Symantec\DataLossPrevention\EnforceServer\<DLPVersion>\Protect\Migrator\URT directory.

Resolution

Extract the Upgrade Readiness Tool to the URT directory under the \Program Files\Symantec\DataLossPrevention\EnforceServer\<DLPVersion>\Protect\Migrator directory.