RetrieveVariables Failed
Troubleshooting when migration configuration cannot be read from the local configuration store after Entra join.
Description
After Entra join confirmation, the application reads migration variables from the local configuration store.
This error occurs when the required configuration values cannot be accessed.
These values were written during earlier phases and are required to continue profile migration and post-migration steps.
At this stage:
- Device has left Active Directory
- Device is confirmed Entra ID joined
- Previous device management state has been cleaned
- Profile migration has not yet started
Quick Reference
| Item | Details |
|---|---|
| Stage | Post-Entra join configuration retrieval |
| Progress | Around 80% |
| Device impact | Migration cannot continue |
| Safe to retry | No |
| Responsibility | Customer IT administrator and Opsole Support |
What You Will See
Lock Screen Message
Migration Failed. Please check logs
Please log in with Local Admin Account
Portal Log
Migration processing failed in module retrieveVariables
Root Cause
The application cannot access required configuration values from the local configuration store.
Common causes:
- Configuration store deleted or missing
- Access blocked by endpoint security
- Registry corruption or lock state
- Process not running with required privileges
Diagnosis
Run the following checks in PowerShell (Administrator):
Step 1 – Check configuration store
Test-Path "HKLM:\SOFTWARE\OpsoleMigrate"
Step 2 – Attempt to read values
Get-ItemProperty "HKLM:\SOFTWARE\OpsoleMigrate" -ErrorAction SilentlyContinue
Step 3 – Check backup availability
Get-ChildItem "C:\ProgramData\OpsoleMigrate\Backup\" -Filter "OpsoleMigrate-*.reg" | Sort-Object LastWriteTime -Descending | Select-Object -First 3
Step 4 – Check application logs
Get-WinEvent -LogName "OpsoleMigrate" -MaxEvents 30 | Select-Object TimeCreated, Message
| Result | Meaning |
|---|---|
| Configuration store missing | Key deleted or removed |
| Read fails | Access blocked by security tooling |
| Backup files present | Configuration can be restored |
Resolution
Configuration Store Missing
Manual recovery required. Contact support.
Access Blocked
Allow access to:
HKLM:\SOFTWARE\OpsoleMigrate
Ensure endpoint security does not block read access.
System Issue
Run:
sfc /scannow
Restart device before proceeding.
Recovery Steps
Do not re-run migration from the beginning.
- Confirm access to configuration values
- Contact Opsole Support
- Migration will be resumed from the current stage
When to Contact Support
Contact support@opsole.com if:
- Configuration store cannot be restored
- Multiple devices show the same issue
Related Logs
- Event Viewer → Application and Services Logs → OpsoleMigrate
- Backup:
C:\ProgramData\OpsoleMigrate\Backup\
How is this guide?