Applies to

StifleR general

Information

The following sections are settings that can be configured in the StifleR.Service.exe.config file.

DefaultStifleRAdmins

2PINT\StifleR Global Admins

DefaultStifleRRead

2PINT\StifleR Global Read

AllowAnonymousRead

1

EnableDebugLog

0

StifleR.Engine.DebugLogPath

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

DataPath

%PROGRAMDATA%\2Pint Software\StifleR\Server

ListenToUrl *

http://*:1414/

LocationWSListenToUrl

http://*:9000

NonRedLeaderBITSBandwidth

8

NonRedLeaderDOBandwidth

32

DefaultRoamingBandwidth

0

SaveElectionData

1

ExpectedRedLeaderCheckInInterval

2000

RedLeaderAssignmentInterval

10000

RedLeaderElectionInterval

30000

BingMapKey

Key GUID

RogueLeaderInterval

120

AutoAddLocations

1

BandwidthTuning

7

LatencyWarningDecreaseDuration

10000

LatencyWarningDecreaseFactor

1.4

LatencyWarningIncreaseDuration

10000

LatencyWarningIncreaseFactor

5

LowBandwidthWarningIncreaseDuration

10000

LowBandwidthWarningIncreaseFactor

5

HighBandwidthWarningDecreaseDuration

10000

HighBandwidthWarningDecreaseFactor

1.4

HighBandwidthWarningIncreaseDuration

10000

HighBandwidthWarningIncreaseFactor

5

RedLeaderCacheSizeFactor

1.2

RedLeaderForceCacheSizeFactor

4

EnableStifleREngineWMI

1

UseWMIEnumerator

1

UseDataQueue

1

GenerateNewLocationsWithPowerShell

0

PowerShellExtensionLocationCreateScriptPath

="%PROGRAMDATA%\2Pint Software\StifleR\Server\GenerateLocation.ps1

ModifyNewLocationsWithPowerShell

0

PowerShellExtensionLocationModifyScriptPath

%PROGRAMDATA%\2Pint Software\StifleR\Server\ModifyLocation.ps1

SignalRFW and WSAPIFW

1

 * Specifies the URL that the OWIN Instance connects to. Can be http or https and with * or + signs. You can read more about the url registration in the following links:

http://technet.microsoft.com/en-us/library/bb630429.aspx
http://technet.microsoft.com/en-us/library/bb677364.aspx

Identity of the Global Administrators group

   <add key="DefaultStifleRAdmins" value="2PINT\StifleR Global Admins"/>

 Identity of the Global Read group

   <add key="DefaultStifleRRead" value="2PINT\StifleR Global Read"/>

 Allow or disallow anonymous Read access

   <add key="AllowAnonymousRead" value="1"/>

Optional level of debug logging. 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="StifleR.Engine.DebugLogPath" value="%PROGRAMDATA%\2Pint Software\StifleR\StifleRServerDebug.log"

Where temporary data will be stored, like locations.xml and other data items. 

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

Which Data binding to use to listen for incoming client connections, this should be https:// in a production environment.

    <add key="ListenToUrl" value="http://*:1414"

Which Data binding to use for the web API used by dashboards or scripts, this should be https:// in a production environment.

    <add key="LocationWSListenToUrl" value="http://*:9000/"

Which Data speed should non- Red Leader machines have for BITS jobs.

    <add key="NonRedLeaderBITSBandwidth" value="8"

Which Data speed should non- Red Leader machines have for DO jobs.

    <add key="NonRedLeaderDOBandwidth" value="32"

Whether to keep election data or not, we save max 100 elections per subnet. 

    <add key="SaveElectionData" value="1"

 If a Red Leader has not checked in within this time period, another one will be elected. Value in msec.

    <add key="ExpectedRedLeaderCheckInInterval" value="2000"

 How often do we reiterate the Red Leader list to communicate with Red Leaders. Value in msec.

    <add key="RedLeaderAssignmentInterval" value="10000"

 How long do we wait before informing Red Leaders that they should stay Red Leaders. Value in msec.

    <add key="RedLeaderElectionInterval" value="30000"

 Key to use for BING Map Support

    <add key="BingMapKey" value="Ara2uFBv4Nmsgw8b94t4AirPSv4dfAH5_Q27NEnDmATB0SaJ2MuERfLXXLnTngVK"

Raise event if Red Leader has still checked in, i.e. server cannot talk to client but client can talk back. Detect bad RL that does not post back RL info. This then sets the NotLeaderMaterial = true; Value in sec

    <add key="RogueLeaderInterval" value="120"

Whether or not clients that report on from unknown locations or not should be automatically added. 1 = true, 0 = false

    <add key="AutoAddLocations" value="1"

Bit flag decimal value for which bandwidth tuning functions to use. 0 = no band width tuning

    <add key="BandwidthTuning" value="7"

Number of milliseconds before a latency decrease WMI event is signalled. I.e. if latency has been lower existing * LatencyWarningDecreaseFactor than target for 10seconds an WMI event is triggered. Value in msec.

    <add key="LatencyWarningDecreaseDuration" value="10000"

Factor used to calculate whether or not to signal an event. 1.4 equals a decrease by 40%.

    <add key="LatencyWarningDecreaseFactor" value="1.4"

Number of milliseconds before a latency increase WMI event is signalled. I.e. if latency has been higher than target * LatencyWarningIncreaseFactor for 10seconds an WMI event is triggered. Value in msec.

    <add key="LatencyWarningIncreaseDuration" value="10000"

Factor used to calculate whether or not to signal an event. Calculated as: if TunedBandwidth + (TargetBandwidth / LatencyWarningIncreaseFactor) > TargetBandwidth

        <add key="LatencyWarningIncreaseFactor" value="5"

Not used currently.

    <add key="LowBandwidthWarningIncreaseDuration" value="10000"

When a latency warning has been lifted, this value specifies how much more to increase the value. 100/5 = 20% increase from the throttled value.

    <add key="LowBandwidthWarningIncreaseFactor" value="5"

How long we wait before lowering the bandwidth usage again if limit has not been reached.

    <add key="HighBandwidthWarningDecreaseDuration" value="10000"

How much we lower the bandwidth if the location is still using too much bandwidth. 1.4 = a 40% decrease.

    <add key="HighBandwidthWarningDecreaseFactor" value="1.4"

If a Red Leader has been below the allocated banwidth for this period of time, we increase the bandwidth usage by HighBandwidthWarningIncreaseFactor

    <add key="HighBandwidthWarningIncreaseDuration" value="10000"

When a high bandwidth usage warning has been lifted, this value specifies how much more to increase the value. 100/5 = 20% increase from the throttled value.

    <add key="HighBandwidthWarningIncreaseFactor" value="5"

Percentage of larger size of Cache, i.e. we switch Red Leader if a new client has 20% larger cache size. This forces large disk machines to be Red Leaders. 1.2 = 20% etc.

    <add key="RedLeaderCacheSizeFactor" value="1.2"

Percentage of larger size of Cache, i.e. we switch Red Leader if a new client has 4x cache size. Even is other things like NIC speed is slower.

    <add key="RedLeaderForceCacheSizeFactor" value="4"

Whether the WMI provider should be enabled or not. 1 = true, 0 = false

    <add key="EnableStifleREngineWMI" value="1"

Enables the WMI Enumerator function to get WMI data. 1 = true, 0 = false

    <add key="UseWMIEnumerator" value="1"

Uses in memory queue system instead of updating internal data lists for every message, recommended. 1 = true, 0 = false

    <add key="UseDataQueue" value="1"

Generate New Locations with PowerShell

    <add key="GenerateNewLocationsWithPowerShell" value="0"

Path to script for PS Generation of Sites

     <add key="PowerShellExtensionLocationCreateScriptPath" value="%PROGRAMDATA%\2Pint Software\StifleR\Server\GenerateLocation.ps1"

 Modify New Locations with PowerShell

    <add key="ModifyNewLocationsWithPowerShell" value="0"

 Path to script for PS modification

    <add key="PowerShellExtensionLocationModifyScriptPath" value="%PROGRAMDATA%\2Pint Software\StifleR\Server\ModifyLocation.ps1"

 Automatically Configure Firewall Exceptions

    <add key="SignalRFW" value="1"

    <add key="WSAPIFW" value="1"