Troubleshoot disk unlocking issues in Azure Data Box Disk
This article applies to Azure Data Box Disk and describes the workflows used to troubleshoot any issues when using the unlock tool.
Data Box Disk Unlock tool errors
| Error message/Tool behavior | Recommendations |
|---|---|
| The current .NET Framework isn't supported. The supported versions are 4.5 and later. Tool exits with a message. |
.NET 4.5 isn't installed. Install .NET 4.5 or later on the host computer that runs the Data Box Disk unlock tool. |
| Couldn't unlock or verify any volumes. Contact Azure Support. The tool fails to unlock or verify any locked drive. |
The tool couldn't unlock any of the locked drives with the supplied passkey. Contact Azure Support for next steps. |
| Following volumes are unlocked and verified. Volume drive letters: E: Couldn't unlock any volumes with the following passkeys: werwerqomnf, qwerwerqwdfda The tool unlocks some drives and lists the successful and failed drive letters. |
Partially succeeded. Couldn't unlock some of the drives with the supplied passkey. Contact Azure Support for next steps. |
| Couldn't find locked volumes. Verify disk received from Azure is connected properly and is in locked state. | The tool fails to find any locked drives. Either the drives are already unlocked or not detected. Ensure that the drives are connected and are locked. You may also see this error if you have formatted your disks. If you have formatted your disks, these are now unusable. Contact Microsoft Support for next steps. |
| Fatal error: Invalid parameter Parameter name: invalid_arg USAGE: DataBoxDiskUnlock /PassKeys:<passkey_list_separated_by_semicolon> Example: DataBoxDiskUnlock /PassKeys:passkey1;passkey2;passkey3 Example: DataBoxDiskUnlock /SystemCheck Example: DataBoxDiskUnlock /Help /PassKeys: Get this passkey from Azure DataBox Disk order. The passkey unlocks your disks. /Help: This option provides help on cmdlet usage and examples. /SystemCheck: This option checks if your system meets the requirements to run the tool. Press any key to exit. |
Invalid parameter entered. The only allowed parameters are /SystemCheck, /PassKey, and /Help. |
Unlock issues for disks when using a Windows client
This section details some of the top issues faced during deployment of Data Box Disk when using a Windows client for data copy.
Issue: Couldn't unlock drive from BitLocker
Cause
You have used the password in the BitLocker dialog and trying to unlock the disk via the BitLocker unlock drives dialog. This wouldn't work.
Resolution
To unlock the Data Box Disks, you need to use the Data Box Disk Unlock tool and provide the password from the Azure portal. For more information, go to Tutorial: Unpack, connect, and unlock Azure Data Box Disk.
Issue: Couldn't unlock or verify some volumes. Contact Azure Support.
Cause
You may see the following error in the error log and are not able to unlock or verify some volumes.
Exception System.IO.FileNotFoundException: Could not load file or assembly 'Microsoft.Management.Infrastructure, Version=1.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35' or one of its dependencies. The system cannot find the file specified.
This indicates that you're likely missing the appropriate version of Windows PowerShell on your Windows client.
Resolution
You can install Windows PowerShell v 5.0 and retry the operation.
If you're still not able to unlock the volumes, copy the logs from the folder that has the Data Box Disk Unlock tool and contact Azure Support.
Next steps
- Learn how to troubleshoot validation issues.