Using a script to upload 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 upload the required symbol files to Kaspersky Research Sandbox, 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.

Windows SDK is required only for downloading the symbols.zip archive. If the archive was previously downloaded and located in the specified folder, you may skip the step 1 in the instruction below.

To upload symbol files to Kaspersky Research Sandbox:

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 -upload -server <server> -username <user name> -password <password> -manifest <manifest> -symbols_zip <symbols_zip>"

   Here:

   • upload—Parameter, which specifies that symbol files upload to Kaspersky Research Sandbox is required.
   • server—The host name or IP address of the computer on which Kaspersky Research Sandbox is installed. If this parameter is not specified, you will be asked to enter it.
   • username—User name for signing in to Kaspersky Research Sandbox.
   • password—User password for signing in to Kaspersky Research Sandbox.
   • manifest—The full path to a custom image manifest file. If a manifest file is not found, the script completes with error.

     In case a .zip archive that contains the symbol files is already downloaded and located in the specified folder, the script attempts to upload symbol files to Kaspersky Research Sandbox despite the occurred error.

   • symbols_zip—A full path to a .zip archive that contains symbol files for the custom image. The default archive name is symbols.zip.

   If you want to download the symbol files again before uploading them to Kaspersky Research Sandbox, make sure the previously downloaded .zip archive is not located in the specified folder before running the script.

   Symbol files download requires internet access on your computer.

After the successful script execution, a .zip archive with symbol files is uploaded to Kaspersky Research Sandbox. If upload error occurs, the script exits with a "Failed to upload" error.

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

See also: Using a script to download symbol files

Page top