Agent Settings
  • 18 Oct 2023
  • 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 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 enabled, the local cache will persist even after the session ended.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 set to true, the stale content from the local cache of devices is automatically deleted:
  • all content superseded by a new version is deleted immediately.
  • all content that is inactive for a certain period of time is automatically deleted at the end of the period set in the expireContent key.
cache\autoClean
Expire contentThe period after which the inactive content from the local cache of devices is deleted automatically. For example, if a user does not log in to the device for at least 90 days, the local cache content of the user is deleted automatically.cache\expireContent

Was this article helpful?

What's Next