SymphonyElectron/docs/features/silent-installation-windows.md

# Intro
Electron supports silent installation on Windows using the standard "msiexec" command from the command prompt / powershell

# Platforms Supported
Windows 7, Windows 10 (64-bit and 32-bit)

# Purpose
To help admins push installation to their users' systems silently using msiexec command.

# Details
The Symphony Desktop Client can be automatically installed from the command line. The supported but optional parameters appear below. If you do not supply these parameters you will get an “only for me” install that points to the public pod at https://my.symphony.com.

Important Note - that you must uninstall the previous version before installing the latest version as the unattended installation

- POD_URL (required for private pods) – The URL to your private pod such as https://abccorp.symphony.com. If you are using SSO you can bypass the blue SSO sign-in button by entering https://abccorp.symphony.com/login/sso/initsso or by using a “IdP initiated SSO” link. See your SSO administrator for the latter.
- APPDIR (optional) - Change the install folder to one different from the default folder.
- ALLUSERS (optional) – Do not include for an “Everybody” installation as that is the default. Note that “Everybody” installations require admin privileges. For an “Only for me” install set ALLUSERS=””

# Examples
### Remove current version
```msiexec /x "current_version.msi" /q /l* symphony_uninstall.log```

### Install to all users for a specific pod
```msiexec /i "new_version.msi" /q POD_URL="https://example.symphony.com" /l* symphony_install.log```

### Install to all users for a specific pod with custom config values
```msiexec /i "new_version.msi" /q POD_URL="https://example.symphony.com" ALWAYS_ON_TOP="true" AUTO_LAUNCH="false" /l* symphony_install.log```

### Install to my user only for a specific pod
```msiexec /i "new_version.msi" /q ALLUSERS="" POD_URL="https://example.symphony.com" /l* symphony_install.log```

Some handy troubleshooting tips.
If the install doesn’t work or quickly exits, then replace the “/q” with “/qf” to see the human interface during the install. Sometimes a popup can interfere with the auto-installation.
Use “/x“ instead of “/i“ to uninstall
Add “/l* symphony_install.log” to get debug information from the install written to a file on disk
#### Config values that can be altered as listed below:
- POD_URL (String)
- ALWAYS_ON_TOP (Boolean)
- AUTO_LAUNCH (Boolean)
- MINIMIZE_ON_CLOSE (Boolean)
- BRING_TO_FRONT (Boolean)
- MEDIA (Boolean)
- LOCATION (Boolean)
- NOTIFICATIONS (Boolean)
- MIDI_SYSEX (Boolean)
- FULL_SCREEN (Boolean)
- POINTER_LOCK (Boolean)
- OPEN_EXTERNAL (Boolean)
- DEV_TOOLS_ENABLED (Boolean)
- AUTO_LAUNCH_PATH (String)
- OVERRIDE_USER_AGENT (Boolean)
You'll need to quote the Boolean values when passing from the command line.

#### Check-boxes (in the installer UI) that can be altered are listed below:
- ALWAYS_ON_TOP_CB (Boolean)
- BRING_TO_FRONT_CB (Boolean)
- MINIMIZE_ON_CLOSE_CB (Boolean)
- AUTO_START_CB (Boolean)
- CUSTOM_TITLE_BAR_CB (Boolean)
- DEV_TOOLS_CB (Boolean)
- MEDIA_CB (Boolean)
- POINTER_LOCK_CB (Boolean)
- LOCATION_CB (Boolean)
- FULL_SCREEN_CB (Boolean)
- MIDI_SYSEX_CB (Boolean)
- OPEN_EXTERNAL_CB (Boolean)
To uncheck an already checked checkbox, the argument should be blank quotes, for example:
```Symphony.msi MINIMIZE_ON_CLOSE_CB=""```

To check an unchecked checkbox, you can pass any value to the property, for example:
```Symphony.msi ALWAYS_ON_TOP="true"```

### Custom Auto Launch Path

The auto launch path can be obtained from holding down the shift key and right clicking on any of the application and select Copy as path

```msiexec /i "new_version.msi" AUTO_LAUNCH_PATH="C:\Program Files\internet explorer\iexplore.exe"```


# Other Info
When msiexec is used, you can generate logs using the "/l* abc.log" option as part of the command prompt. This is useful in case of troubleshooting failed installations.