Protocol Application Installation on Windows

This article describes specifics of installing protocol application on Windows.

Protocol App Installation Privileges

The protocol application supports dual-mode installation, providing 'Only for me' option to perform per-user installation and the 'Anyone who uses this computer' option for per-machine install.

  • In case of the 'Only for me' option the protocol application can be installed by the account with ‘Standard User’ permissions. Administrative privileges are NOT required (unless the Web Client service needs to be started on Windows 7, see below).
  • In case of the 'Anyone who uses this computer' option the administrative privileges are required. Note that administrative privileges are required only to install the protocol application. To use the installed application and open documents, the administrative privileges are NOT required.

Web Client Windows Service

The protocol application on Windows requires Web Client Windows service to be running when opening documents.

On Windows 8.1 and later: In case the Web Client is stopped, it will be automatically started when opening a document. Administrative privileges are NOT required.

On Windows 7: The Web Client would NOT start automatically if it is stopped. Instead the protocol app installer and protocol application itself (when opening a document) verifies the status of the Web Client service and offers to start the service in case it is not running. Starting the Web Client service requires administrative privileges, including when installing with the 'Only for me' option. The Web Client service will be also configured to automatically start when Windows starts.

Note that the Web Client service must not be disabled. If it is in disabled mode it will not start neither automatically nor via installer/protocol app and the document opening fails.

Protocol App Installer Parameters

Protocol application installer provides the following installer parameters:

WEBCLIENTAUTOSTART - Specifies if Web Client Windows service must be started during install and configured to autostart.

Values: "1" - start and configure autostart. "0" - do not start and configure autostart. Default is "1".

MSIINSTALLPERUSER - Installs protocol app for current user ('Only for me' option) or for all users ('Anyone who uses this computer' option).

Values: "1" - for current user. "" - for all users. Default is "1".

ALLUSERSEDGEPOLICYMODIFY - Specifies if Edge policy must be updated during install. Required to install Edge extensions for all users in case installation is performed for all users (with MSIINSTALLPERUSER="1" parameter).

Values: "1" - change Edge policies to install an extension for all users, "" - do not change Edge policies and install an extension for current user only. Default is "".

Unattended Install

To run unattended installation use the following commands:

To install for all users. Administrative privileges are required. The below example will install application for all users, enable Edge extension for all users, starts Web Client Windows service if required and configure Web Client service auto-start.

msiexec /i ITHitEditDocumentOpener.msi /qb MSIINSTALLPERUSER="" ALLUSERSEDGEPOLICYMODIFY="1" WEBCLIENTAUTOSTART="1"

To install with 'Only for me' option. Administrative privileges are NOT required, unless the Web Client service needs to be started on Windows 8.1 and earlier, see above. The below example will install application for current user, enable Edge extension for current user only, check that Web Client Windows service is running, will try to start service if required and configure Web Client service auto-start:

msiexec /i ITHitEditDocumentOpener.msi /qb MSIINSTALLPERUSER="1" ALLUSERSEDGEPOLICYMODIFY="" WEBCLIENTAUTOSTART="1"

Note that in case Web Client failed to start during installation for any reason the installer completes successfully. The Web Client service can be started at any time after installation.

Removing Mounted File Systems

If yo experience any issues with opening documents you can try to remove all mounted file systems using 'net use' command.

To list mounted file systems:

net use

To unmount all file systems use the following command:

net use * /DELETE

See Also: