Inifile

<< Click to display Table of Contents >>

Navigation:  Client Applications > The Cordaware Infoclient > Configuration >

Inifile

The file Infoclient.ini is located in the installation directory of the Infoclient Cordaware/bestinformed/ directory. In this file, the basic settings of the Infoclient are defined. Administrators can determine whether users can modify these settings or not. Settings which are effected in the quick configuration menu as well as settings hidden from the user are saved in this file.

 


The following settings need to be stored in the [General] section.

 

Following settings can be made in the Inifile:

 

General settings:

 

Setting

Default value / Example

Function

Address

Address=infoserver

Enter the Infoservers address.

Port

Port=8431

Enter here the desired port. The port 8431 is used for SSL-Connections and the default port.

Speed

Speed=20

Here you can set the speed of the ticker. The lower the value, the faster the Infoband "runs".

Color

Color=clInfoBk

Sets the color of the ticker. Enter the colors in the form clBlue or $ 808080. Do not use the colors in RGB format. The colors blue, green, red are valid.

Font

Font=String which contains the information of your font type and color.

The option Font contains the information on default font-size and font-type in hexadecimal encryption. Modifications of these settings can be made in the quick configuration menu. Click on this symbol Infoclient_trayicon in the taskbar and configure your desired settings.

ShowOnTaskbar

ShowOnTaskbar=True/False

(Default= True)

Here you can define, whether the red Infoclient taskbar symbol shall be shown on the clients computer or not. Set the variable to "False" if you want to hide the symbol from the taskbar.

ShowNewInfosInTaskbar

ShowNewInfosInTaskbar=False/True

(Default= False)

With this setting you can define, if the infogrid shall be displayed in the taskbar upon receiving a new info.

Taskbar

Taskbar=True/False

(Default= True)

This setting defines whether the ticker shall be shown as a taskbar, or if the ticker shall overlap all running applications and active windows.

 

C-K_01

Bottom

Bottom=True/False

(Default= False)

This settings defines, whether the ticker shall be shown on the bottom of the screen. If you want to display the ticker on the bottom of the screen, set the variable to True.

InfoStartFullVisible

InfoStartFullVisible=True/False

(Default= False)

Start the ticker completely full visible on the user display

 

 

The following values can not be changed via the Infoclient window. They only can be changed manually or via the client configuration.

 

Settings regarding Channels:

 

Setting

Default value / Example

Function

ShowChannelsOnTaskbar

ShowChannelsOnTaskbar=True/False

(Default= False)

Defines, whether the Channels-icon will be displayed on the taskbar.

 

UseDynamic

UseDynamic=True/False

(Default= True)

With this option, you can enable or disable the use of dynamic Channels on the Infoclient.

DynamicPipe

DynamicPipe=True/False

(Default= True)

With this option, you can define the use of the Dynamic Pipe in dynamic Channels.

DynamicPipeTimeout

DynamicPipeTimeout=1000

(Default: 1000)

With this option, you can set an execution timeout in ms for a request in the Dynamic Pipe.

 

WatchProcesses

WatchProcesses=True/False

(Default= True)

With this option, you can control the access to the process list in dynamic Channels and dynamic InfoclientValues.

WatchConnections

WatchConnections=True/False

(Default: True)

With this option, you can deactivate the access to the connection list in dynamic Channels and dynamic Infoclientvalues.

 

 

Infoband settings:

 

Setting

Default value / Example

Function

BottomWinlogon

Bottom=True/False

(Default= False)

If you set this option on "True", the Infoband will be displayed on the bottom of the winlogon screen.

 

DefaultUrlColor

DefaultUrlColor=clBlue

Here you can change the default color of the hyperlink.

Moving

Moving=True/False

(Default= True)

By setting this option to "True", the user receives the possibility to move the ticker.

 

MovingWinlogon

MovingWinlogon=True/False

(Default= False)

Allows the user to move the Infoband on the winlogon screen, when this option is set to "True".

 

WaitOnHyperLink

WaitOnHyperLink=10

Defines the value in seconds, which the ticker stops, when the mouse is hovering over the link.

RepaintOnNewInfo

RepaintOnNewInfo=True/False

(Default= True)

New Infos will be displayed immediately, otherwise they will wait until the current Info has passed through.

RepaintOnCancel

RepaintOnCancel=True/False

(Default= True)

Indicates, whether the ticker immediately stops displaying an info, if an info is canceled by clicking on a hyperlink.

RepaintOnServerCancel

RepaintOnServerCancel=True/False

(Default= True)

Repaint the Infoband on cancel by Infoserver, means canceled Info disappears immediately.

LastInfoFirst

LastInfoFirst=True/False

(Default= False)

On "True", new Infos appears first otherwise add on the end.

LeftToRight

LeftToRight=True/False

(Default= False)

Direction, of the ticker, from left to right.

 

ScrollAmount

ScrollAmount=1

The number of pixels for which the ticker progresses.

 

Please note: When entering large values, the ticker optically seems to tear apart!

UseResizeButtons

UseResizeButtons=True/False

(Default= True)

Here you can enable or disable the buttons on the Infoband, which can resize the

Infoband to half-size (time limited).

ResizedTime

ResizedTime=10

Time, in seconds, to realign the Infoband after being resized.

Separator

Separator=+++

The separator is the string, which is displayed for the separation of the messages.

 

Graphic as separator:

 

In order to add an image as a separator, proceed as follows:

 

1. Upload the desired image via the app Content (Contents -> Content).

 

2. Open the app Configuration (Clients -> Configuration) and go the the field Separator.

 

3. Here you can enter the path to the image via a <IMG> HTML Tag:

 


Example:

 

<IMG src="http://localhost:8000/Images/Companylogo.png"/>

 

4. Optionally, you can choose the recipients of the configuration and send it out afterwards. The separator will be changed on all recipient computers.

PresentationOverlapped

PresentationOverlapped=True/False

(Default=True)

Defines, if the ticker is to be displayed during active slide shows. When set to false, the ticker won't be displayed.

UseDesktopWorkArea

UseDesktopWorkArea=True/False

(Default= False)

This option moves the Infoband so, that the taskbar is not overlapped, even if the Infoband is not displayed as a taskbar (Taskbar=False).

WaitOnStopTicker

WaitOnStopTicker=10

Time in seconds how long the Infoband should be stopped by right-clicking on the Infoband. If you set the value to 0, the Infoband is stopped limitless. The Infoband starts his movement with a second click again. This function can be deactivated by setting the value to -1.

 

 

Settings regarding the Info preview:

 

Setting

Default value / Example

Function

PreviewOnlyOnUserDesktop

PreviewOnlyOnUserDesktop=True/False

(Default= False)

If you set the value to true, any info that is received on the user desktop will be displayed as an info preview. This ignores the info settings that affect the user desktop.

PreviewOnlyOnWinlogonDesktop

PreviewOnlyOnWinlogonDesktop=True/False

(Default= False)

If you set the value to true, any info that is received on the winlogon desktop will be displayed as an info preview. This ignores the info settings that affect the winlogon desktop.

PreviewDisplayTime

PreviewDisplayTime=10 (default)

Here you can set the time for the duration of the Info preview.

PreviewColor

PreviewColor=clWhite (default)

Here you can set the start color of the vertical background-color gradient of the Info preview.

PreviewColorTo

PreviewColorTo=clWhite (default)

This option defines the target color of the vertical background-color gradient of the Info preview.

 

 

Info history settings:

 

Setting

Default value / Example

Function

ShowNewInfosDoubleClickPlaysAllActiveInfos

ShowNewInfosDoubleClickPlaysAllActiveInfos=True

With a double click on the Infogrid icon, active Infos will be started again .

ShowNewInfosHint

ShowNewInfosHint=True

Show hint-text when new Infos are available in the Infogrid.

ShowNewInfosHintText

ShowNewInfosHintText=YourText

Hint text of the Infogrid icon, for example: "Double click plays all active Infos again".

ShowNewInfosMenu

ShowNewInfosMenu=True/False

(Default= True)

Show/hide the menu of the Infoclient history (Infogrid).

HistorySameSize

HistorySameSize=True/False

(Default= True)

Defines, if the Infos in the Infogrid are to be displayed with uniform font-size.

 

HistoryAllowExpanding

HistoryAllowExpanding=True/False

(Default= False)

Defines, if the detail-view in the Infogrid is permitted.

FlashNewInfosIcon

FlashNewInfosIcon=True/False

(Default = False)

If enabled, the Infogrid tray-icon in the taskbar will flash when a new Info is available. The icon flashes, until the Infogrid is opened.

UseInfoHistoryCaption

UseInfoHistoryCaption=True/False

(Default = False)

If enabled, the caption of an info will be displayed in the infogrid additionally to the info.

 

 

Popups settings:

 

Setting

Default value / Example

Function

SetFocusToPopup

SetFocusToPopup=True/False

(Default = False)

If this option is set to false, incoming popups will not be focused automatically.

PopupCaption

PopupCaption=

In this entry, you can set the Caption, which will be shown in popups. For this option the variable {Creator} is available. This specifies the creator of this message. This entry will be helpful, if you are using an InfoStartScript.

UseScreenForPopups

UseScreenForPopups=True/False

(Default = False)

This option allows you to set whether a non-full-screen popup is displayed only on the primary monitor, or on clients with multimonitors. The default setting (False) displays the popup only on the primary screen. If the value is set to true, the popup is distributed on all screens. For computers with only one monitor, this option is irrelevant.

PopupOnlyOnUserDesktop

PopupOnlyUserDesktop=True/False

(Default = False)

As long this setting is set on "True", the Info wil appear on the user desktop as a popup.

PopupOnlyOnWinlogonDesktop

PopupOnlyOnWinlogonDesktop=True/False

(Default = False) 

If this value set to "True", the Info will be displayed on the winlogon desktop as a popup.

 

 

 

Settings regarding to StatusInfos:

 

Setting

Default value / Example

Function

ShowStatusInfosOnFirstTimeUD

ShowStatusInfosOnFirstTimeUD=True/False

(Default = True)

StatusInfo-Display for the Userdesktop (user desktop).

 

ShowStatusInfosOnFirstTimeWD

ShowStatusInfosOnFirstTimeWD=True/False

(Default = True)

StatusInfo-Display for the Winlogondesktop (log in desktop).

 

SetFocusToStatusInfo

SetFocusToStatusInfo=True/False

(Default = False)

If this option set to "True", the Info will be automatically focused when a StatusInfo appears.

 

 

 

Settings regarding to the passive mode (virtual):

 

Setting

Default value / Example

Function

Passive

Passive=True/False

(Default = False)

With this option, you can set the Infoclient in the passive mode.

TempActiveAllowed

TempActiveAllowed=True/False

(Default = True)

With this option, you can set, that the Infoclient will be active temporary, if a passive mode is set.

 

PassiveOnPublishedApplicationOnly

PassiveOnPublishedApplicationOnly=True/False

(Default = False)

With this option, you can set, that the Infoclient only in a published application session get started active (i. e. Citrix).

StartInfoclientOnRemoteSessionOnly

StartInfoclientOnRemoteSessionOnly=True/False (Default= False)

With this option, you can set, that the Infoclient only on remote session get started, i. e. on desktop virtualizations (VDI).

PassiveModeOnLocalSession

PassiveModeOnLocalSession=True/False

(Default = False)

With this option, you can set the Infoclient in local sessions of a virtual desktop in the passive mode. This option is only working, when StartInfoclientOnRemoteSessionOnly is set to "False". Otherwise the Infoclient will not be started in local sessions.

PassiveModeOnLocalDisconnectedSession

PassiveModeOnLocalDisconnectedSession=True/False

(Default = False)

PassiveModeOnLocalDisconnectedSession enables you to set Infoclients in the passive mode after a user switch happend on the client. A client in the passive mode will not be count as an active connection for the licensing.

 

 

Proxy settings:

 

Setting

Default value / Example

Function

ProxyEnabled

ProxyEnabled=True/False

(Default = False)

Enable or disable the use of a proxy server.

 

ProxyHost

ProxyHost=IP-Address

Here you can enter the host-name or the ip address of the proxy server.

ProxyPort

ProxyPort=Port

Enter the port of the proxy server for SOCKS here.

ProxyUsername

ProxyUsername=Username

Enter the username for the proxy server, if a username is required here.

ProxyPassword

ProxyPassword=Password

If a password is required, it needs to be entered here.

ProxyNotUseList

 

Host-name or IP-addresses need to be separated with ",". The entered host-names / IP-addresses in this list will not create a connection to the proxyserver.

 

 

More settings:

 

Setting

Default value / Example

Function

Debug

Debug=True/False

(Default = False)

Switches on/off the debug mode - creates the InfoclientDebug.log - helpful when looking for errors.

 

ShowTaskbarOnWinlogon

ShowTaskbarOnWinlogon=True/False

(Default = True)

Show Taskbar on winlogon desktop, helpful using StatusInfos.

 

UserDesktopOnly

UserDesktopOnly=True/False

(Default = True)

Infoclient on user desktop only, running on terminalservers

ShowInfoClientValuesOnTaskBar

ShowInfoClientValuesOnTaskBar=True/False

(Default = False)

Shows the Infoclientvalues icon on taskbar.

 

TimerResolution

TimerResolution=1

Resolution of scroll timer, in ms, must at least half value of speed or 1.

BottomWinlogon

BottomWinlogon=True

If this option set on "True", the Infoband on the winlogon desktop can be align to the bottom of the screen.

OffsetOnNewInfo

OffsetOnNewInfo=False/Zahlenwert

(Default = False)

Defines the offset in pixel, which stays empty on the left side. This makes reading new Infos easier.

 

If the value is set to the width of the monitor, e.g. 1920, then the Infoticker is "emptied" as soon as a new info sent. The reason for this is that as soon as the Infoticker is re-executed with the new info, all Infos starts 1920 pixels away from the left edge of the screen.

OnlyQueryIfOnline

OnlyQueryIfOnline=True/False

(Default=False)

The connection to the Infoserver only happens, when Online. Very useful for notebooks with automatic dialing.

IgnoreIPs

192.168.2.125;192.168.2.170

Defines a list of IP-addresses separated with ";". The IP addresses in this list will be ignored when determining the online state.

DComGroupName

DComGroupName=Groupname

If the rights for the DComServer are forgiven explicitly, the DComServer on the clients side, will after the autoupdate not work anymore. Enter here a groupname (domaingroup i. e. users), which hold execute rights.

AdditionalInfoServers

AdditionalInfoServers=Server1:8431; Server2:8431;

List of Infoserver hosts or addresses, format Host:Port, no http://. If the value for port is missing, so the default port of 8431 will be used, separated with ";". The Infoclients will be start immediately, after the configuration.

NoDefaultShell

NoDefaultShell=True/False

(Default= False)

This setting must be set, when you do not use a default shell on the client computer, i. e. Citrix terminalserver and "published Application", otherwise the ticker will not appear.

ScreensaverOff

ScreensaverOff=True/False

(Default = True)

Defines, if the Infoclient is to automatically deactivate a running screensaver upon receiving a new Info.

Serverlist

Serverlist=infoserver1.mycompany.org,192.168.1.23

List of alternative Infoservers, to which the client tries to connect when the connection to the host specified in Address is lost.

ResetServerListOnStart

ResetServerListOnStart=True/False (Default = False)

This setting causes that when restarting the Infoclient and using the server list, the connection attempt starts at the first address in the server list and not at the address entered under "Address".

IAmFatClient

IAmFatClient=True/False

This option is intended for use on computers with a Windows Vista or Windows 7 operating system. By setting the value true, you can exclude these computers from the rule defined in NotAllowedDuplicateUserList.

TaskbarCaption

 

Here you can enter a text, which will be displayed on the logon screen (ShowTaskBarOnWinlogon=true). You will find further information in the chapter Creation of a Taskbar Caption.

NoDisplaySleep

NoDisplaySleep=True/False

(Default = False)

With this option you can define, if an incoming Info can reactivate the PC's display from energy-save mode, respectively keep the display from falling into energy-save mode while an Info is running.

NoSystemSleep

NoSystemSleep=True/False

(Default = False)

With this option you can define, if an incoming Info can keep the PC from falling into system-sleep mode while an Info is running.

CancelAllInfosOnHostChange

CancelAllInfosOnHostChange=True/False

(Default = False)

In case the Infoclient changes connection to one of the servers defined in Serverlist, then all previously active Infos will be cancelled on the client.

UseSSL

UseSSL=True/False

(Default = False)

Defines whether the Infoclient shall explicitly (UseSSL=true) connect to the Infoserver using SSL, or if the Infoclient is set to auto-detect SSL secured connection (UseSSL=false).

BalloonHintOnNewInfos

BalloonHintOnNewInfos=True/False

(Default = False)

If enabled, the Infoclient tray-icon will display a balloon when a new Info is received.

 

BalloonHintOnNotConnected

BalloonHintOnNotConnected=True/False

(Default = False)

If enabled, the Infoclient tray-icon will display a balloon in case no connection to the Infoserver can be established.

WatchDesktopState

WatchDesktopState=True/False

(Default= False)

With this option, you can enable the Infoclient to send information on the current state of the client-computer (screensaver active/workstation locked) to the Infoserver. This information is available in the connectionoverview in the columns PCLocked and ScreenSaverON.

ShowDisconnectStatusIcon

ShowDisconnectStatusIcon=True/False

(Default=False)

If you change this value to "True", an icon will be shown in the taskbar, when the Infoclient is not connected.

 

C-K_02

DisconnectStatusIconHint

DisconnectStatusIconHint=Not connected

Here you can set a custom text which appears on mouse over.

 

infoclient_trayicon_notconnected

SilentOnUserDesktop

SilentOnUserDesktop=True/False

(Default= False)

If you set this option to "True", the user will always receive Infos as SilentInfos on the userdesktop.

 

SilentOnWinlogonDesktop

SilentOnWinlogonDesktop=True/False

(Default= False)

When set to "True" the logon desktop will receive infos only as SilentInfos.

SilentMenu

SilentMenu=True/False

(Default = False)

When this option is set to "True",the user receives the possibility, to set the Infoclient in the Silent-mode. The User can also revert this action.

NoAutoupdate

NoAutoupdate=True/False

(Default = False)

If this option set to "True", the autoupdate function will be deactivated. Starting with Infoclient Version 6.2.2.6, this function can be set to "True" via the app configuration and thus activated. In order to deactivate the setting a software distribution is needed to distribute a new Infoclient.ini or the setting is changed with local administrators permissions in the Infoclient.ini file. The setting can not be reset to "False" via the app configuration.

NoScript

NoScript=True/False

(Default= False)

This setting (NoScript=True) deactivates the function, to execute scripts on the recipient computer. Since the Infoclient version 6.2.2.6, this option can be set on "True" and activated via the configuration app. Otherwise the setting can be changed in the Infoclient.ini by using local administrator permissions. This option can not be set to "False" via the configuration app.

CheckSSLCRL

CheckSSLCRL=True/False

(Default= True)

Specifies whether the secured client connection should be checked for the certificate revocation list that is stored in the certificate.

If the certificate is no longer available, no connection will be established from the Infoclient to the Infoserver.

Further information regarding the certificate revocation list can be found here.

CheckSSLOCSP

CheckSSLOCSP=True/False

(Default= True)

For the trusted client connection, specifies whether the certificate should be checked, or not

If the certificate is no longer valid, no connection will be established from the Infoclient to the Infoserver.

Further information on the Online Certificate Status Protocol (OCSP) can be found here.

PlayMasterInfoAllowed

PlayMasterInfoAllowed=True/False

(Default= False)

Specifies, if the user can play a masterinfo (Info which closes every Info on the Infoclient) via the Infogrid.

OpenLinkUseReg

OpenLinkUseReg=True/False

(Default=True)

Defines with which application hyperlinks should be opened in the Infoclient. If this setting is set to "False", the default browser defined in the Windows settings is used. Otherwise the system default (usually Internet Explorer) is used.

NoGuardian

NoGuardian=True/False

(Default=False)

Disables the Guardian function on the Infoclient.

ClientCertificate

ClientCertificate=username.hostname / computername.domainname / commonname / hostname /  CUSTOM_CERTIFICATE_CN

(Default=username.hostname)

If the client certificate has been given a user-defined CN, then this must be explicitly specified here. Without this entry, the client certificate names are dynamically tailored to each user automatically.

 

By default, this setting is set to username.hostname.

 


Example:

 

If the Windows login name is e.g. max.mustermann and the hostname of the server is cordaware.firma.local, then the Infoclient will expect a client certificate which has max.mustermann.cordaware.firma.local as CN.

 

ClientCertificateStorageAccessTypes

ClientCertificateStorageAccessTypes=CurrentService / CurrentUser / CurrentUserGroupPolicy / LocalMachine / LocalMachineEnterprise / LocalMachineGroupPolicy / Services / Users (Default=CurrentUser)

Defines the certificate storage that is accessed by Cordaware bestinformed.

ClientCertificateSystemStores

ClientCertificateSystemStores=MY, CA, ROOT, SYSTEM (Default=MY)

Defines the location of the system where the certificates are stored.

UsePSK

UsePSK=True/False

(Default=True)

Sets whether the PSK mechanism is used.

 

 

Settings for disabling the option of the Infoclient:

 

The possibility of editing single items of the Quick Configuration can be disabled. For this, the item DisabledItems= is available in the Infoclient.ini. Disabling items has the effect, that they still will be displayed, but are not editable by the user. The individual items, that are to be disabled, have to be provided as keywords in a comma-separated list. Following keywords are available:

 

DisabledItems=

 

List of components which can be deactivated:

 

Component

Description

stAddress

Textfield "Infoserver Address".

stPort

Textfield "Infoserver Port".

stSpeed

Numberfield "Infoband speed".

stBackground

Button "Background-color of the Infoband".

stFont

Button "Font settings".

stinTaskbar

Checkbox "Show in taskbar" (Infoclient-Icon).

stNewInfo

Checkbox "New Infos in taskbar".

stasTaskbar

Checkbox "As taskbar".

stBottom

Checkbox "Align to bottom".

stHotKeys

Button for the Hotkeys-configuration.

stChannels

Button for the Channels-configuration.

stClientValues

Button for the InfoclientValues-configuration.

stConfig

Hyperlink "Configuration".

stHome

Hyperlink to www.cordaware.com.

 

 

Settings for workstations with several monitors:

 

 

Monitor=

Display

all (=Default value)

on all monitors

primary

on the main monitor

Numbers of the monitors separated by a comma. Begins with 0 (i . e. Monitor=0,1)

 

 

on the monitors 1 and 2

 

Please note: 1 does not have to be primary. The numbers of the monitors can be configured in the display-settings of Windows.

 

 


Please note: The Monitor= setting only works for the Info ticker. Settings concerning popups, can be found here.