Tips & Troubleshooting — Script Runner

FAQ & tips

  • Always Validate on write scripts before Execute — especially with parallel mode.
  • GO batches matter: Script Runner splits on GO; keep DDL and dependent DML in sensible order.
  • Credentials are stored with Windows DPAPI protection on the local machine — treat exported registration files as sensitive.
  • Prefer read-only inventory scripts in parallel; use serial + stop-on-error for schema migrations.

Data Storage & Security

ItemDetails
Server groups file%LOCALAPPDATA%\DBLenseScriptRunner\servergroups.json
Templates file%LOCALAPPDATA%\DBLenseScriptRunner\templates.json
Settings file%LOCALAPPDATA%\DBLenseScriptRunner\settings.json
Password encryptionWindows DPAPI (CurrentUser scope) — cannot be shared between users/machines
Auto-saveEvery group/server change persisted immediately
Crash logs%LOCALAPPDATA%\DBLenseScriptRunner\CrashLogs\
No telemetryNo operational data sent externally. License/update checks use dblense.com.

System Requirements

ComponentRequirement
OSWindows 10/11 or Windows Server 2016+
Runtime.NET 8.0 (included in self-contained package)
SQL ServerSQL Server 2012+ (any edition including Express)
AzureAzure SQL Database, Azure SQL Managed Instance
InstallationNone → single portable .exe, no admin rights required