What commands do I use to deploy the SuperNova or Dolphin ScreenReader MSI packages?

SuperNova and Dolphin ScreenReader can be silently deployed across networks eliminating the need to manually install to individual devices

Disclaimer: Dolphin Computer Access Ltd. cannot guarantee that problems resulting from the incorrect use of Registry Editor can be solved. Use Registry Editor at your own risk. Before attempting the following, create a backup copy of your Windows Registry and a system restore point. Failure to do this may result in a non-recoverable system.

What license do I need to deploy SuperNova and Dolphin ScreenReader MSI files?

You require a SuperNova Professional or Enterprise license to deploy the editions via MSI.

For more information on SuperNova Professional and Enterprise visit: https://yourdolphin.com/SuperNova/Business

What commands can I use to silently install all components?

All of the MSI files in the package can be deployed with the switch commands /quiet /qn /norestart to silently install without user intervention required.

The Visual C++ redistributable (vc_redist.x86.exe) can be deployed with a /Q command.

The Microsoft Web View 2 component (MicrosoftEdgeWebView2RuntimeInstallerX64.exe) can be silently deployed with the /silent /install switch commands

Example installation batch file

Find below a sample batch file to install all of the required components applicable to SuperNova and Dolphin ScreenReader Version 22 and later:

REM Install 3rd party components
"<Path to MSI package>\3rdParty\vc_redist.x86.exe" /Q
"<Path to MSI package>\3rdParty\MicrosoftEdgeWebView2RuntimeInstallerX64.exe" /silent /install

REM Install Synthesiser Access Manager
MSIEXEC /i "<Path to MSI package>\Sam\Sam.msi" /quiet /qn /norestart
MSIEXEC /i "<Path to MSI package>\Sam\Sam64Addon.msi" /quiet /qn /norestart

REM Install SuperNova
MSIEXEC /i "<Path to MSI package>\SuperNova\SnovaSuite.msi" /quiet /qn /norestart

REM Install Additional Voices
MSIEXEC /i "<Path to MSI package>\Voices\VocExprCommonFiles.msi" /quiet /qn /norestart
MSIEXEC /i "<Path to MSI package>\English_GB_Serena.msi" /quiet /qn /norestart
MSIEXEC /i "<Path to MSI package>\Voices\English_GB_Oliver.msi" /quiet /qn /norestart
MSIEXEC /i "<Path to MSI package>\Voices\English_GB_Kate.msi" /quiet /qn /norestart
MSIEXEC /i "<Path to MSI package>\English_GB_Daniel.msi" /quiet /qn /norestart

REM Update user settings key (assumes this has been configured - see below)
REG COPY HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Dolphin\SuperNova2204 HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Dolphin\SuperNova2301
REG DELETE HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Dolphin\SuperNova2204 /f

How do the users retain their existing settings when upgrading?

  1. Use the following knowledge base article to specify a location for users settings, and to force the path to be read from HKEY_LOCAL_MACHINE rather than HKEY_CURRENT_USER: https://kb.yourdolphin.com/knowledge/settings-location
  2. Ensure that you create and deploy the Enterprise Configuration Utility Settings with each upgrade - the path to these settings in the registry are version specific.
  3. When upgrading add the following command to your script/process to rename the product version number of the Settings registry key, for example:

REG COPY HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Dolphin\SuperNova<Installed version> HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Dolphin\SuperNova<Upgrade version>

REG DELETE HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Dolphin\SuperNova<Installed version> /f

If upgrading from 22.04 to 23.01 you would use the two commands

REG COPY HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Dolphin\SuperNova2204 HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Dolphin\SuperNova2301

REG DELETE HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Dolphin\SuperNova2204 /f