Overview
Troubleshooting reference for errors and issues encountered during device migration.
Resolve migration errors on your own using the articles below. Each article is tied to a KB ID (for example, KB-022208) that may appear in portal logs or support correspondence.
How to find your article
- Note the error message on the device or the module name in the Opsole portal migration log.
- Open the matching article from the table below, or use Search (Ctrl+K) with the KB ID or a keyword from the error.
- Follow Diagnosis, then Resolution, and Recovery Steps in order.
- If the issue persists after all steps, use When to Contact Support in that article.
Each article includes screenshots where applicable for device and portal errors.
For phase-based recovery (Pre-Migrate vs Inter-Migrate and patch.exe), see the Migration Recovery Guide.
Pre-migration (validation and setup)
| KB ID | Issue |
|---|---|
| KB-022201 | API Endpoint or Configuration Retrieval Failed |
| KB-022202 | No Valid License Available |
| KB-022203 | Migration Configuration Missing Parameters |
| KB-022204 | Provisioning Package Not Found |
| KB-022205 | System Reboot Pending |
| KB-022206 | Device Not Joined to a Supported Directory |
| KB-022207 | Device Information Could Not Be Stored |
| KB-022208 | User Profile Collection Failed |
| KB-022209 | User Identity Mapping Failed |
| KB-022216 | Pre-Migration Validation Failed |
Migration execution
| KB ID | Issue |
|---|---|
| KB-022210 | Entra Leave Failed |
| KB-022211 | Domain Leave Failed |
| KB-022212 | Provisioning Package Retrieval or Availability Failed |
| KB-022213 | Intermediate Migration Task Setup Failed |
| KB-022214 | Entra Join Validation Failed |
| KB-022215 | RetrieveVariables Failed |
Post-migration and profile
| KB ID | Issue |
|---|---|
| KB-022217 | Profile Transition Failed |
How is this guide?
Migration Recovery Guide
Recovery procedures for IT administrators when Opsole Migrate fails during Pre-Migrate or Inter-Migrate phases. Use the correct recovery option for the failure phase—do not reimage the device.
KB-022201
Troubleshooting when the device cannot connect to the Opsole API or retrieve migration configuration during pre-migration validation (1%–20%).