Troubleshooting problems with VHD upload using CSUPLOAD Tool

While uploading VHD for your VM Role using CSUPLOAD tool, if you experience issues, you can use the following methods to troubleshoot the problems:


Verifying Connectivity Settings:

To verify your connection string you can use the "csupload get-connection" command and you will see the connection settings as below:


C:\Program Files\Windows Azure SDK\v1.4\bin>csupload.exe get-connection


Windows(R) Azure(TM) Upload Tool

for Microsoft(R) .NET Framework 3.5

Copyright (c) Microsoft Corporation. All rights reserved.


ConnectionString          : SubscriptionId=***********;CertificateThumbprint=**************;ServiceManagementEndpoint=

SubscriptionId            : *********************

CertificateSubjectName    : CN=<Certificate_Subject_Name>

CertificateThumbprint     : <Certificate_Thumbprint>

ServiceManagementEndpoint :


Network Connectivity Issues:


To verify that connection from your machine to Windows Azure Management portal, run "csupload get-location" command and if you see the output like below, it will prove that network connectivity from your machine to Windows Azure management portal is working.


c:\Program Files\Windows Azure SDK\v1.4\bin>csupload get-location


Windows(R) Azure(TM) Upload Tool

for Microsoft(R) .NET Framework 3.5

Copyright (c) Microsoft Corporation. All rights reserved.


Using the saved connection string...

Location : Anywhere US

Location : South Central US

Location : North Central US

Location : Anywhere Europe

Location : North Europe

Location : West Europe

Location : Anywhere Asia

Location : Southeast Asia

Location : East Asia

A total of 9 record(s) were found.

c:\Program Files\Windows Azure SDK\v1.4\bin>


Verifying Browser connection to Windows Azure Management Portal:


             Create a URL similar to as below using you Subscription ID:<Your_Subscription_ID>/locations

             Open this URL in IE and if network connection is established, you should get a "Dialog asking to choose a certificate"

             If you have any networking issue you will an error (most probably 403: Forbidden).


Getting more output in Command Window:


You can create a new Environment Variable as below:




After that open a new Command Prompt Window in Administrator mode and use the CSUPLOAD command. You will see lot more details are available on Command window.  


Generating detailed activity log:


To generate detailed log file to collect more details with regard to CSUPLOAD command activity, please remove the following highlighted lines from the csupload.exe.config file, this file is located in the same folder as csupload.exe

  <!-- uncomment to help debug errors -->




      <source name="Microsoft.WindowsAzure.ServiceManagementClient"

              switchName="Microsoft.WindowsAzure.ServiceManagementClient" >


          <add name="Debug"/>



       <source name="csupload"

              switchName="csupload" >


          <add name="Debug"/>





      <add name="Microsoft.WindowsAzure.ServiceManagementClient" value="Verbose"/>

      <add name="csupload" value="Verbose"/>



      <add name="Debug"


      initializeData="csupload.log.txt"  />


    <trace autoflush="true"/>




After above change, please open new command window to run the same test. You will see csupload.log.txt file is created which will have detailed log related with CSUPLOAD command activity



Comments (1)

Skip to main content