Installing enaio® webclient as a desktop application
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:
Uninstalling
enaio® webclient as a desktop application is uninstalled via the uninstall program in the application directory.