Using a script to download symbol files

Symbol files are required for correct custom image deployment. If an error occurred during a template deployment because of missing symbol files, you can download the required symbol files by executing a script as described below.

You can find a sample of a script at:

https://<Kaspersky Research Sandbox address>/Tool/krssymtool.ps1

Here, <Kaspersky Research Sandbox address> is the host name or IP address of the computer on which Kaspersky Research Sandbox is installed.

Symbol files download requires internet access on your computer.

To download symbol files:

  1. On a computer with the Windows operating system, install Debugging Tools for Windows:
    1. Open the Windows SDK and emulator archive page in your browser.
    2. Depending on your operating system version, download the latest version of the Windows 10 SDK or the Windows 8.1 SDK.
    3. Run the downloaded file and at the Select the features you want to install step, clear all check boxes except the Debugging Tools for Windows.
    4. Click Install.
  2. Run the script with the following parameters:

    powershell -executionpolicy bypass "./krssymtool.ps1 -manifest <manifest> -symbols_zip <symbols_zip>"

    Here:

    • manifest—The full path to a custom image manifest file. If a manifest file is not found, the script completes with error.
    • symbols_zip—A full path to download a .zip archive that contains symbol files for the custom image. The default archive name is symbols.zip.

    If a previously downloaded .zip archive is located in the specified folder, you must first delete it before running the script.

After the successful script execution, the symbols.zip archive is downloaded to the specified folder. If the path was not specified, the archive is saved to the same folder, where the script is located.

In case downloading the symbol files fails, please contact your Kaspersky Research Sandbox administrator.

See also:

Using a script to upload symbol files

Obtaining a custom image manifest file

Page top