Downloading debug symbols

If internet access is not configured for the server on which the virtual machine with the custom image is installed, you must download the Microsoft debug symbols to correctly complete the virtual machine installation.

You can download debug symbols during virtual machine installation in the Templates window or after the virtual machine receives the Failed status in the list of virtual machines.

For debug symbols to download correctly, the operating system used for the virtual machine template must have Windows Debug Tools installed and the name of the host connected to the network (hostname) must contain only Latin letters, numerals, and special characters.

To download debug symbols during virtual machine installation in the Templates window:

1. In the Sandbox web interface window, select the Templates & Storage section.
2. Go to the Templates section.
3. Select the relevant template.
4. In the window with the No internet access error, click Download manifesto.

   The Download manifesto is not available until the virtual machine gets the Failed status.

   An archive is downloaded to your computer.

5. Unpack the downloaded archive.
6. Run the sbsymtool.ps1 using Windows PowerShell.

   The archive with debug symbols is downloaded to the folder where this file is located.

7. In the Sandbox web interface window, select the Templates & Storage section.
8. Go to the Templates section.
9. Select the template for which you have downloaded debug symbols.
10. In the Actions drop-down list, select Upload symbols.
11. This opens a window; in that window, select the archive with the debug symbols and click Open.

Debug symbols are downloaded. The virtual machine is installed and displayed in the list of virtual machines running custom operating systems.

To download debug symbols after a virtual machine has received the Failed status in the list of virtual machines:

1. In the Sandbox web interface window, select the Templates & Storage section.
2. Go to the Templates section.
3. Select the relevant template.
4. In the Actions drop-down list, select Download manifesto.

   An archive is downloaded to your computer.

5. Unpack the downloaded archive.
6. Run the sbsymtool.ps1 using Windows PowerShell.

   The archive with debug symbols is downloaded to the folder where this file is located.

7. In the Templates window, expand the Actions list and select Upload symbols.
8. This opens a window; in that window, select the archive with the debug symbols and click Open.

Debug symbols are downloaded. The virtual machine is installed and displayed in the list of virtual machines running custom operating systems.

Page top