- 18 Nov 2024
- 4 Minutes to read
- Print
- DarkLight
- PDF
Agent Settings
- Updated on 18 Nov 2024
- 4 Minutes to read
- Print
- DarkLight
- PDF
This feature is available only for the Universal Agent.
Agent settings can be configured globally here, and exceptions can be set at the context level. This allows for easy management of the agent’s behaviour after it has been deployed on devices.
If settings are configured to Local agent configuration they will adhere to the settings defined in the agent.json. See Agent Configuration for all options in the agent.json file.
To configure the Workspace Agent on a Windows machine, see Agent Configuration.
Liquit Launcher section
Modify the behaviour of the Liquit Launcher.
Option | Description | agent.json setting |
---|---|---|
Enable Liquit Launcher | If Liquit Launcher should be enabled | launcher\enabled |
Open Liquit Launcher at startup | Defines when Liquit Launcher is started:
| launcher\start |
Use tiles interface | When enabled, Liquit Launcher uses the tile-themed skin. | launcher\tiles |
Hide menu header | When enabled, the Side Menu and tabs (Workspace, Contacts, Catalog, Manage) are hidden. Only the toolbar without the side menu toggler is displayed. | launcher\minimal |
Enable context menu | When enabled, the context menu is available across Liquit Launcher. | launcher\contextMenu |
Closable Liquit Launcher | If disabled, the X close button of the Liquit Launcher window is disabled and the quit option from the icon's context menu in the system tray is hidden. | launcher\close |
User login section
Modify the behaviour of the user's login process.
Option | Description | agent.json setting |
---|---|---|
Enable user login | This controls whether the user should be prompted for login | login\enabled |
Use Single Sign On | When enabled, the Liquit Universal Agent will use the configured Identity Source to facilitate SSO. | login\sso |
Show login dialog after silent login timeout | The timeout in seconds after which the user will be prompted for login credentials if SSO could not be performed. | login\timeout |
Icon section
Modify the behaviour of the system/tray icon.
Option | Description | agent.json setting |
---|---|---|
Enable tray icon | When disabled, the tray icon is hidden from the user. | icon\enabled |
Enable quit menu option | When disabled, the quit option from the icon's context menu in the system tray is hidden. The quit option will always be disabled if the launcher is enabled and is not allowed to close. | icon\exit |
Time to wait for Windows File Explorer (seconds) | The number of seconds Liquit Workspace waits for the Windows shell to load in order to display the system tray icon. Note that there is no maximum time limit. | icon\timeout |
Refresh section
Modify the behaviour of the agent refresh process.
Option | Description | agent.json setting |
---|---|---|
Enable manual refresh | When disabled, the refresh option from the icon's context menu in the system tray is hidden. | refresh\manual |
Automatic refresh interval | This value represents the time interval between Liquit Workspace refreshes. | refresh\interval |
Events section
Configure how event data is uploaded to server when the Agent triggers the event.
Option | Description | agent.json setting |
---|---|---|
Collect and store events | When enabled, event data is uploaded from the agent to the server. | events\enabled |
Push events interval | The time interval in seconds when the event data is uploaded from the agent to the server. | event\interval |
Native icons section
Modify the behaviour of the native icons configured for package entitlements that allow you to display Liquit Workspace icons on certain locations within the device's operating system.
Option | Description | agent.json setting |
---|---|---|
Enable native icons | Allow Liquit Workspace to push native icons configured for package entitlements to the operating system of devices. | nativeIcons\enabled |
Only enable native icons for primary user session | When enabled, only the icons from the zone defined in the Agent.json file will be pushed. | nativeIcons\primary |
Triggers section
Modify the behaviour of the events configured for package entitlements.
Option | Description | agent.json setting |
---|---|---|
Enable triggers | Allow Liquit Workspace to execute events like refresh or login for example. | triggers\enabled |
Only enable triggers for primary user session | When enabled, events will be triggered only for the zone defined in the Agent.json file. | triggers\primary |
Web Socket
Option | Description | agent.json setting |
---|---|---|
Enable Web Socket support | This protocol allows a more efficient way of handling data. This option is mandatory for the push event feature described in the Events section. | webSocket\enabled |
Cache section
Modify the behaviour of the Agent caching.
Option | Description | agent.json setting |
---|---|---|
Enable caching | When an identity is entitled to a package, the package is automatically downloaded and cached on the end-user device. It will remain there even after the session ends, as long as the end-user is entitled to it. When the entitlement is removed, the cache is cleaned depending on how Clear cache automatically and Expire content are configured. | cache\enabled |
Enable offline mode | When enabled, offline mode will be available for devices. When disabled, packages marked offline will not be automatically downloaded and the Liquit Launcher won't switch to offline mode. | cache\offline |
Clear cache automatically | If enabled, the stale content from the local cache of devices is automatically deleted if one of the following conditions are met:
| cache\autoClean |
Expire content | The period after which the local cache of devices is deleted automatically if it meets one of the conditions defined above for the Clear cache automatically. | cache\expireContent |