Agent Settings
  • 18 Nov 2024
  • 4 Minutes to read
  • Dark
    Light
  • PDF

Agent Settings

  • Dark
    Light
  • PDF

Article summary

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.

Workspace Agent

To configure the Workspace Agent on a Windows machine, see Agent Configuration.

Liquit Launcher section

Modify the behaviour of the Liquit Launcher.

OptionDescriptionagent.json setting
Enable Liquit LauncherIf Liquit Launcher should be enabledlauncher\enabled
Open Liquit Launcher at startupDefines when Liquit Launcher is started:
  • Enabled - Start when device is connected to the zone or offline is available. (Config setting: Auto)
  • Only when connected - Start when device is connected to the zone. (Config setting: Connected)
  • Disabled - Liquit Launcher is disabled (Config setting: Disabled)
launcher\start
Use tiles interfaceWhen enabled, Liquit Launcher uses the tile-themed skin.launcher\tiles
Hide menu headerWhen 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 menuWhen enabled, the context menu is available across Liquit Launcher.launcher\contextMenu
Closable Liquit LauncherIf 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.

OptionDescriptionagent.json setting
Enable user loginThis controls whether the user should be prompted for loginlogin\enabled
Use Single Sign OnWhen enabled, the Liquit Universal Agent will use the configured Identity Source to facilitate SSO.login\sso
Show login dialog after silent login timeoutThe 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.

OptionDescriptionagent.json setting
Enable tray iconWhen disabled, the tray icon is hidden from the user.icon\enabled
Enable quit menu optionWhen 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.

OptionDescriptionagent.json setting
Enable manual refreshWhen disabled, the refresh option from the icon's context menu in the system tray is hidden.refresh\manual
Automatic refresh intervalThis 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.

OptionDescriptionagent.json setting
Collect and store eventsWhen enabled, event data is uploaded from the agent to the server.events\enabled
Push events intervalThe 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.

OptionDescriptionagent.json setting
Enable native iconsAllow 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 sessionWhen 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.

OptionDescriptionagent.json setting
Enable triggersAllow Liquit Workspace to execute events like refresh or login for example.triggers\enabled
Only enable triggers for primary user sessionWhen enabled, events will be triggered only for the zone defined in the Agent.json file.triggers\primary

Web Socket

OptionDescriptionagent.json setting
Enable Web Socket supportThis 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.

OptionDescriptionagent.json setting
Enable cachingWhen 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 modeWhen 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 automaticallyIf enabled, the stale content from the local cache of devices is automatically deleted if one of the following conditions are met:
  • the content is superseded by a new version.
  • the content is no longer entitled to a user and the period of time set in the Expire content has passed.
cache\autoClean
Expire contentThe 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

Was this article helpful?

What's Next