Troubleshoot issues with Migration Center discovery client CLI
Stay organized with collections
Save and categorize content based on your preferences.
This page shows you how to resolve issues with the Migration Center discovery client CLI.
Upgrade issue
When you upgrade the mcdc CLI to the latest version, it
performs an internal database schema upgrade which automatically creates a
backup of collected and assessed data by the previous version.
In rare cases, the mcdc CLI upgrade doesn't complete
successfully due to a failure in upgrading the local database. This might happen
due to a malfunction during the database upgrade which corrupts the database,
and therefore, the previously collected data is lost.
After upgrading the mcdc CLI, when you run the latest
version, if you see an error which indicates that the database upgrade failed,
you can use the recover-db command to restore the database to a previous
working version then downgrade to the previous mcdc CLI
version.
Perform the following steps:
Restore the database to a previous working version:
./mcdcdiscoverrecover-db
Download the
the mcdc CLI version you used before the upgrade.
While installing an older version the mcdc CLI, don't
remove the mcdc CLI directory that is created by the
current version.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-29 UTC."],[],[],null,["# Troubleshoot issues with Migration Center discovery client CLI\n\nThis page shows you how to resolve issues with the Migration Center discovery client CLI.\n\nUpgrade issue\n-------------\n\nWhen you upgrade the `mcdc` CLI to the latest version, it\nperforms an internal database schema upgrade which automatically creates a\nbackup of collected and assessed data by the previous version.\n\nIn rare cases, the `mcdc` CLI upgrade doesn't complete\nsuccessfully due to a failure in upgrading the local database. This might happen\ndue to a malfunction during the database upgrade which corrupts the database,\nand therefore, the previously collected data is lost.\n\nAfter upgrading the `mcdc` CLI, when you run the latest\nversion, if you see an error which indicates that the database upgrade failed,\nyou can use the `recover-db` command to restore the database to a previous\nworking version then downgrade to the previous `mcdc` CLI\nversion.\n\nPerform the following steps:\n\n1. Restore the database to a previous working version:\n\n ./mcdc discover recover-db\n\n2. [Download](/migration-center/docs/download-collector-cli) the\n the `mcdc` CLI version you used before the upgrade.\n\n While installing an older version the `mcdc` CLI, don't\n remove the `mcdc` CLI directory that is created by the\n current version.\n | **Note:** On Linux machines, the lowest version of `mcdc` CLI that you can downgrade to is version 2.0.0."]]
