Troubleshoot Blob storage issues for an Azure Stack Edge device

APPLIES TO: Yes for Pro GPU SKUAzure Stack Edge Pro - GPUYes for Pro 2 SKUAzure Stack Edge Pro 2Yes for Pro R SKUAzure Stack Edge Pro RYes for Mini R SKUAzure Stack Edge Mini R                  

This article describes how to troubleshoot issues with Blob storage for your Azure Stack Edge device.

Errors for Blob storage on device

Here are the errors related to Blob storage for an Azure Stack Edge device.

Issue / Errors Resolution
Unable to retrieve child resources. The value for one of the HTTP headers is not in the correct format. From the Edit menu, select Target Azure Stack APIs. Then, restart Azure Storage Explorer.
getaddrinfo ENOTFOUND <accountname>.blob.<serialnumber>.microsoftdatabox.com Check that the endpoint name <accountname>.blob.<serialnumber>.microsoftdatabox.com is added to the hosts file at this path, C:\Windows\System32\drivers\etc\hosts, on Windows, or at /etc/hosts on Linux.
Unable to retrieve child resources.
Details: self-signed certificate
Import the SSL certificate for your device into Azure Storage Explorer:
  1. Generate and download the certificate.
  2. From the Edit menu, select SSL Certificates and then select Import Certificates.
AzCopy command appears to stop responding for a minute before displaying this error:
Failed to enumerate directory https://… The remote name could not be resolved <accountname>.blob.<serialnumber>.microsoftdatabox.com
Check that the endpoint name <accountname>.blob.<serialnumber>.microsoftdatabox.com is added to the hosts file at: C:\Windows\System32\drivers\etc\hosts.
AzCopy command appears to stop responding for a minute before displaying this error:
Error parsing source location. The underlying connection was closed: Could not establish trust relationship for the SSL/TLS secure channel.
Import the SSL certificate for your device into Azure Storage Explorer:
  1. Generate and download the certificate.
  2. From the Edit menu, select SSL Certificates and then select Import Certificates.
AzCopy command appears to stop responding for 20 minutes before displaying this error:
Error parsing source location https://<accountname>.blob.<serialnumber>.microsoftdatabox.com/<cntnr>. No such device or address.
Check that the endpoint name <accountname>.blob.<serialnumber>.microsoftdatabox.com is added to the hosts file at: /etc/hosts.
AzCopy command appears to stop responding for 20 minutes before displaying this error:
Error parsing source location… The SSL connection could not be established.
Import the SSL certificate for your device into Azure Storage Explorer:
  1. Generate and download the certificate.
  2. From the Edit menu, select SSL Certificates and then select Import Certificates.
AzCopy command appears to stop responding for 20 minutes before displaying this error:
Error parsing source location https://<accountname>.blob.<serialnumber>.microsoftdatabox.com/<cntnr>. No such device or address
Check that the endpoint name <accountname>.blob.<serialnumber>.microsoftdatabox.com is added to the hosts file at: /etc/hosts.
AzCopy command appears to stop responding for 20 minutes before displaying this error: Error parsing source location… The SSL connection could not be established. Import the SSL certificate for your device into the system's certificate store. For more information, see Download the certificate.
The value for one of the HTTP headers is not in the correct format. The installed version of the Microsoft Azure Storage Library for Python is not supported by Azure Stack Edge. For supported library versions, see Supported Azure client libraries.
… [SSL: CERTIFICATE_VERIFY_FAILED] … Before running Python, set the REQUESTS_CA_BUNDLE environment variable to the path of the Base64-encoded SSL certificate file (see how to Download the certificate). For example, run:
export REQUESTS_CA_BUNDLE=/tmp/mycert.cer
python
Alternately, add the certificate to the system's certificate store, and then set this environment variable to the path of that store. For example, on Ubuntu, run:
export REQUESTS_CA_BUNDLE=/etc/ssl/certs/ca-certificates.crt
python
The connection times out. Sign in on your device, and then check whether it's unlocked. Anytime the device restarts, it stays locked until someone signs in.
Could not create or update storageaccount. Ensure that the access key for your storage account is valid. If needed, update the key on the device. Sync the storage account keys. Follow the steps outlined here.

Next steps