StifleR Client Settings | 2pint Knowledge Base

StifleR Client Settings

 

The following table shows settings that can be configured in the StifleR.ClientApp.exe.config file. Values shown are defaults.

EnableDebugLog

0

DebugLogPath

%PROGRAMDATA%\2Pint Software\StifleR\Debug.log    

DataPath

%PROGRAMDATA%\2Pint Software\StifleR\Client

UseStiflerServer

1

StiflerServers

http://StifleRServerFQDN:1414

SleepBeforeSwitchingServer

60000

SendGeoData

1

UpdateRulesTimerInSec

604800

StifleRulezURL

http://2pintsoftware.com/wp-content/uploads/StifleRulez.xml

UseBITSForRulezDownload

0

AlternativeLatencyHostName

YOUR.SERVER.FQDN

InterVLANprefix

http://*:81/

v1MaxSizeLimit

1048576

NotLeaderMaterial

0

CheckInterval

10000

NoJobIntervalMultiplier

10

NoProgressTimeout

300

MaxPolicyChangeTime

30

MaxPokeBandwidth

8

DefaultNonRedLeaderDOPolicy

2

DefaultNonRedLeaderBITSPolicy

2

DefaultDisconnectedDOPolicy

64

DefaultDisconnectedBITSPolicy

64

ExpectedRedLeaderIntervalMultiplier

1

UpdateScreenInterval

2000

Features

TcbStats, AckJobs, DOPolicy, RedLeader, BlueLeader, NotRedLeader, InterVlan, CreateBITSJobs, ExecutePowerShell ,RunCmdLine, ModifyJobs, Notify, WOL, UpdateServers, UpdateRules

Notifications

Administrator

ReportOnly

0

EnableDebugTelemetry

0 (for 2Pint Support Debug Only!)

 

Notes and explanations as follows:

Whether to enable debug logging or not. Setting may be from 1 (Errors) to 6 (Super Verbose). Super Verbose means what it says, so remember to set back to "0" to switch it off afterwards. Ensure that the service account has access to the path if no log is appearing.

    add key="EnableDebugLog" value="0"

Path to the debug log.

   add key="DebugLogPath" value="%PROGRAMDATA%\2Pint Software\StifleR\Client.log"

Path to the client data files

    add key="DataPath" value="%PROGRAMDATA%\2Pint Software\StifleR\Client"

Licensed Version

    add key="UseStiflerServer" value="1"

List of servers, comma separated (,) and we start with the first server in the list.

    add key="StiflerServers" value=”http://yourserverfqdn:1414 https://yourotherserverfqdn:1415”

Milliseconds to sleep before checking a new server, i.e. if we lose connection to server we wait 60 seconds + random to connect back. If no server accepted we move to a new server in the list.

    add key="SleepBeforeSwitchingServer" value="60000"

Enable client to use the Windows Location services to send the location coordinates at the time of connection.

    add key="SendGeoData" value="1"

Enable automatic updates of the rules. Not a lot of data, but may need controlling if required. 0 = disabled, 604800 = Once a week

    add key="UpdateRulesTimerInSec" value="”600”"

Set to your own server URL please and DL from us instead from an IIS server

    add key="StifleRulezURL" value=http://2pcm.2pint.local/StiflerRules/StifleRulez.xml

Set to 1 to use BITS for downloading new definition files, otherwise HTTP will be used. BITS requires Content-Length which some NAS/Apache servers don’t to by default.

    add key="UseBITSForRulezDownload" value="0"

The FQDN of an alternative host to use for time based calculations.

    add key="AlternativeLatencyHostName" value=""

Binding information for Blue Leader HTTP server that redirects the BranchCache data.

    add key="InterVLANprefix" value="http://*:81/"

Data chunk size for BranchCache version 1 cache content generation.

    add key="v1MaxSizeLimit" value="1048576"

Whether this machine should never be elected as Red Leader. 1 = never Red Leader, 0 = can be Red Leader

    add key="NotLeaderMaterial" value="0"

How often to report in when we are not Red Leader but are transferring data. Value in msec.

    add key="CheckInterval" value="10000"

How often to report in when we are not Red Leader and don’t have any job running. Default NoJobIntervalMultiplier(3) * CheckInterval(10000) = 30000 milliseconds

    add key="NoJobIntervalMultiplier" value="10"

If a BITS job has not moved in this period of time, we set a random BITS policy in order to zap the job into order. Value in sec, 300/60 = 5min

    add key="NoProgressTimeout" value="300"

Limits the policy changes during this period of time, i.e. a value of 30 ensures that only a single policy can be set during this period of time.

    add key="MaxPolicyChangeTime" value="30"

The poke bandwidth used when a job is not moving or doing to much data from the server and not peer-to-peering. Used in conjuction with NoProgressTimeout. Value in Kbit/s.

    add key="MaxPokeBandwidth" value="8"

Default Delivery Optimization bandwidth used when a client is not a Red Leader

    add key="DefaultNonRedLeaderDOPolicy" value="2"

Default BITS bandwidth used when a client is not a Red Leader

    add key="DefaultNonRedLeaderBITSPolicy" value="16"

Default Delivery Optimization bandwidth used when a client is disconnected from a server 

    add key="DefaultDisconnectedDOPolicy" value="64"

Default BITS bandwidth used when a client is disconnected from a server

    add key="DefaultDisconnectedBITSPolicy" value="64"

Multiplier of the expected server interval time used by client to unassign itself as Red Leader. If Server has not checked back for ExpectedRedLeaderInterval * ExpectedRedLeaderIntervalMultiplier times the expected time, i.e. we have missed several packets, or something else is up, we unassing the Red Leader role.

    add key="ExpectedRedLeaderIntervalMultiplier" value="3"

How often to update the screen in interactive mode.

    add key="UpdateScreenInterval" value="2000"

Comma separated list of client side features to enable.

    add key="Features" value="TcbStats, AckJobs, DOPolicy, RedLeader, BlueLeader, NotRedLeader, InterVlan, CreateBITSJobs, ExecutePowerShell ,RunCmdLine, ModifyJobs, Notify, WOL, UpdateServers, UpdateRules"

Comma separated list of client side of Notifications features to enable.

    add key="Notifications" value="Administrator"

Set the client into Read Only mode, i.e. do not change any Policy on client. Can be used like this for a StifleR Visualization installation.

    add key="ReportOnly" value="0"

Enabled Telemetry debugging information to be saved to the log folder. 1 to enable, 0 to disable.

    add key="EnableDebugTelemetry" value="0"