Installing enaio® webclient as a desktop application

enaio® 9.10 »

By default, enaio® webclient allows users to download enaio® webclient as a desktop application via the user menu.

It can be installed for the user only or globally for all users. Global installation requires administrator rights.

The path can be specified during installation.

If there is also an update for enaio® webclient as a desktop application after enaio® webclient has been updated, then an update will be performed automatically when enaio® webclient as a desktop application is started.

Global installations are only automatically updated for users with administrator rights.

The webclient-updates endpoint must be entered in the application-prod.yml configuration file of enaio® gateway in order for the update feature to work:

proxy:
defaultEntryPoint: '/osweb'
services:
 endpoints:
 - endpoint:
	name: webclient-updates
	url: 'http://<host>:<port>/webclient-updates'

The enaio® webclient download feature can be disabled in the administration console using the com.os.osdrt.disable.desktop.app.download parameter.

Installing via MSI Package

enaio® webclient as a desktop application can be installed by an administrator via an MSI package. The MSI packages are located in the installation data in the \Win32\Disk1\OSWEB\Desktop-App directory.

To perform a global installation that is available to all users, specify an installation directory using the WEBCLIENT_INSTALLDIR parameter in the command line.

Example: C:\>D:\enaio-webclient-app-x64.msi WEBCLIENT_INSTALLDIR="D:\enaioapp"

Without this parameter, the installation will be performed for the specific user only.

A configuration file with profiles for connecting and logging in can also be distributed for user-specific installations. The configuration file must have the name init-profiles.json and must be placed in the directory of the MSI package. Existing enaio® webclient as a desktop application profiles will not be overwritten; the profiles of the configuration file are also provided.

enaio® webclient as a desktop application deletes the init-profiles.json file from the configuration directory C:\Users\<User name>\AppData\Roaming\enaio-webclient of enaio® webclient as a desktop application after the profiles have been transferred.

In the case of global installations, a configuration file containing profiles cannot be distributed with the installation. After global installation is complete, a configuration file with corresponding applications can be copied to the user directories.

Parameters of the init-profiles.json Configuration File:

profiles

Multiple profiles can be specified.
activate

true/false

If several profiles have this property, the most recent one from the configuration is preselected in the dialog.

url URL to enaio® gateway
username

User name

Useful only for DEMO installations

password

Unencrypted password

Useful only for DEMO installations

autologin

true/false

Enable/disable automatic login

authType

NTLM_SYSTEM for Windows login

BASIC_AUTH for login using enaio® data

A NTLM_SYSTEM login with automatic login enabled allows the Windows user to login automatically.

A configuration file that you can use as a template is available for download:

init-profiles.json

Uninstalling

enaio® webclient as a desktop application is uninstalled via the uninstall program in the application directory.