Agent Configuration

´╗┐The agent.xml file allows for configuration of the Liquit agent.
Below you will find a complete agent.xml configuration.
The agent.xml is normally found at: C:\Program Files (x86)\Liquit\Agent\Agent.xml

Custom Server

    <Server>https://company.liquit.com/</Server>
    <CustomServer>False</CustomServer>

Server

Contains the FQDN of the Liquit Workspace server

CustomServer

When set to true at serverside, the FQDN of the Liquit Workspace Server won't be automatically inserted into the agent.xml generated by the MSI.

Register

    <Register>
        <Type>1</Type>
        <Username><![CDATA[LOCAL\wksimport]]></Username>
        <Password>wksimport</Password>
    </Register>

Deployments

These settings allow you to utilize deployments, see the documentation on deployments at the following link: Deployments

    <Deployment>
        <Enabled>True</Enabled>
        <Start>True</Start>
        <Cancel>True</Cancel>
        <Events>False</Events>
        <AutoStart>
            <Enabled>True</Enabled>
            <Timer>30</Timer>
            <Deployment>test</Deployment>
        </AutoStart>
    </Deployment>

Enabled

This tag can be either true or false, when set to true Liquit will enable the deployment process on this machine. (default: false)

Start

If this value is true the process of deployments is automatically started, meaning that the process will be run the first time userhost is run (default: true)

Cancel

If this value is true the deployment process can be cancelled (default: true)

Events

If this vaue is true, the Liquit events (refresh/ login) can still be executed (default: false)

Autostart

Enabled

This tag can be either true or false, when set to true Liquit will automatically start the deployment process.

Timer

This tag accepts an integer and represents the number of seconds Liquit will wait before automatically starting the deployment.

Deployment

Provide the targeted deployment in this tag.

Log

The Liquit agent logs events initiated by the Liquit agent.

    <Log Id="agent">
        <Level>Debug</Level>
        <Path>Agent.log</Path>
        <RotateCount>5</RotateCount>
        <RotateSize>1048576</RotateSize>
    </Log>

Log Id

The Log Id attribute in the Log tag can be either set to agent or userhost and both should be set.
The agent log can typically be found at the following location: C:\Program Files (x86)\Liquit Workpsace\Agent\Agent.log.
The userhost log can be found at the following location: C:\User\\%appdata%\Local\Liquit\UserHost.log.

Level

This tag is used to define the level of logging. Liquit distinguishes between two logging levels:

  • Info
    This level is basic logging level, only errors and faiures will be reported.

  • Debug
    The debug level will make the agent report all errors, failures and actions performed by either the agent or the userhost.

Path

An alternate path for the log files can be defined by entering it in the Path tag.

RotateCount

Defines the number of logfiles that will be kept on archive.

RotateSize

Defines the limit of logfile size, when this limit a new logfile will be created and the old file will be archived.

Content

This tag contains configuration for the way Liquit handles files form the content store

    <Content>
        <Hash>True</Hash>
    </Content>

Hash

If this tag is set to true Liquit will use a hash to check if files in the content store have been changed in comparison to the local content. Unchanged files will not be downloaded.

Login

This tag controls the login behavior for the Liquit agent.

    <Login>
        <Enabled>True</Enabled>
        <SSO>True</SSO>
        <IdentitySource>LIQUIT</IdentitySource>
    </Login>

Enabled

This controls whether the user

SSO

Accepts either True or False, when this is set to True the Liquit Agent will use the configured Identity Source to facilitate SSO.

IdentitySource

Defines the default IdentitySource used to log in the user. Use the name of the identity Source as you defined it within Liquit.

Icon

Controls which buttons are enabled on the caption bar.

    <Icon>
        <Exit>True</Exit>
    </Icon>

Close

Can be either true or false. If this tag is set to False the close option on the tray icon menu will be disabled.

Cache

This tag controls settings for Cache

    <Cache>
        <Persistent>True</Persistent>
    </Cache>

Persistent

When this tag is set to True the local cache will persist even after the session ended.

NativeIcons

Control wether or not Liquit is allowed to influence windows icons (startmenu/dekstop).

    <NativeIcons>
        <Enabled>True</Enabled>
        <Primary>False</Primary>
    </NativeIcons>

Enabled

Allow Liquit to push icons to the operating system.

Primary

If this value is true only icons from the zone defined in the agent.xml will be pushed.

Events

    <Events>
        <Enabled>True</Enabled>
        <Primary>False</Primary>
    </Events>

Enabled

Allow Liquit to execute events (refresh, login etc.)

Primary

If this value is true only events will be triggered in the agent (launcher).

Refresh

    <Refresh>
        <Manual>True</Manual>
        <Interval>3600</Interval>
    </Refresh>

Manual

Can be set to either true or false, this controls wether the user can refresh the workspace by manual action.

Interval

This value represents the time in which the workspace will be refeshed (i.e. the latest packages are downloaded).

Launcher

    <Launcher>
        <State>0</State>
        <Close>True</Close>
        <Start>True</Start>
        <Minimal>False</Minimal>
        <Tiles>False</Tiles>
        <StartConnected>False</StartConnected>
        <ContextMenu>True</ContextMenu>
        <SideMenu>categories</SideMenu>
    </Launcher>

State

Defines how the launcher will be shown on start up (0:A default sized window. , 1:A minimized window. , 2: A maximized window.)

Close

Can be set to either True or False. Defines wether or not the launcher window can be closed.

Start

Launcher will automatically be started with the agent.

Minimal

Can be set to either True or False. When set to true Liquit will be run in minimal mode (icons only).

Tiles

Can be set to either True or False. When set to True Liquit will start will use the tile-themed skin by default.

StartConnected

Launcher will only be shown when the Liquit Workspace server is available on the Network (default:false)

ContextMenu

Can be set to either True or False. When set to True the contextmenu will be available in Liquit.

SideMenu

This tag controls the default selected SideMenu, the following options are available:

  • catalog

  • categories

  • launcher

  • teams