| Field Name |
Definition |
LicenseActivationCode
|
- Function:
- Specifies the encrypted activation code for the
AgilePoint license. This code is paired with a license key
to enable product activation.
- Accepted Values:
- An appSettings key in the following format:
<add key="LicenseActivationCode" value="[activation code]" />
This value must be supplied by AgilePoint Sales or Customer Support.
- Default Value:
- None
- Example:
- <add key="LicenseActivationCode" value="DFKORh
lBxwvSGlo2R03T7AHnlq729JjpNZHYH6ruF8NmiXGctp2wigeklicXPp+eNaEzHTKKD51z
JJWj17Ejls1OQxGy59eSyKYzlrkV22DtlDSssKCDB6ntTEpfPVlr35Gl2fzCaLdOfd1zPEbMjka6
IlsnQ+36ln7tgnb5wwV7yCqkWCPxtsxYlpBgxBDoycvNr0IYi+NJwvKRaY8wPMwtsy5sFp2h9pNA
DPx9HuYfeJwc8eonlR7002MH9mV9k45Hcnyq/ybs7oEZBzZyyQ8xcBJQgj0qNLtmTZ9mvjJkl7vE
ZIS3w/f40JJ6obEy7MJKr7wRUZQmXreubTf/MdF+udsZjTVg9hjEhU4fiVQNwkVNTa2iP4OdmcVh
lOBUVr4d8nhOtJiR6KBhTdr6FLBW2dk8rC+eSJJceUt9wF2kfLGwSzUzl8P2rAvHNPQopCb3eeiA
sFLqng92o6J/jLdFs7k1xXrTNSIA05gcwOrTQPs+7n1qkU619EGvijSvFBbwLNtFMoD6PQ+5EXSz
V8MuSXnSvrbAaJnh5MdRRL1COiIFXmOzMOZ1++jFnV3IL6TcOka5th2sDk+CnszRxL8iARJyUzdM
0jQkDKCibk7Bm6hMm+EQcBGM7ntN5efsIPNkz0aOGKNH/qkdwL24tFxOI0wdoW0I6FazCY6Zf4IO
gaGrWSWgTwuwUwbRI2LQnVyb/ue+WqeB047nJY1sFV/LRfLmx1c/SoWKzzGImJr9NsRpnrHVH/eR
ptoSjK5DX00QjEZF78ojIcuPu/D0kk98v+hCOekwtF0oXaeEaaHWBsgi7xUgpSbLDnUbbt3F16dA
vrK/cDUKNdNZg06Ve+OB80eUzS9dJBEh/7QS1QgJSZ5bYS95Vx/HLEPUfFqEkNFnpRAoLYmIChnj
xvA5ffZItVt+P6BjXKlBS7staCpllBwO6DkXXpY993mh6vGG7mHyn1JjA0TPQAEYuYqeT0eqS8zG
BQSiIwdMffnG6yWBZXHGsj5cXpfBxn+HP0/RpUKtVzjd2olq4myzSEB8fFWMaoPXGMrH6MHzKRlC
lZjoAzZs3rKqmx+ZaG9qkvDUnczuyZqiLe7PpIjXy3q5FftKvWsEQ9pfN0Z7fnMZLNs+QHpFLj0k
lvsoI/gBmFbjgfDJ8SfOiZYbgifCXFiyYzPXJg+rppP2lhISNSPWpBFpIwS0ntPCwKpqhQ7NLDMA
ZbTnBus+OnEatxfvAVYtAJYGfT/qRhqDFAjGqNJxuysy/X9wmbx1XwL5ERZmRBES5j8Od9FlY2gB
yRK2hS2Cu+8RtcOTa2N/BsxGAkO3R99ztKwn9uGAItmGGKXNgLpLxoen7a4DEwx+iM1n2iWYcpO3
2IdaWphvtlILoxNhCIwsbNq/8KhlyQzjGewixwpnl9IHDEIYDKVTc5QFAMBaXZLzS7ntjTePu3tK
0W2VIwSmXm9A9/+CCkm3mQ2VI96p3kLO1H0u3frI1voRilZJwHUgHGE4nwM1CyV85S5oAQJWCGWT
N7+NAoEei0CYDAAYiOeX8fG1aqlMXBp8Wwlld085iqJDYuwPMB717jH89sKrHndDsQCLqnKzZgdp
bTtvrBL8pRkPI+LfziHoL6EKY1IRo6NVsYsLxTXnXXsCcob0w2sBgnpahVwZXNA5FafounHPHiCm
0B7pACbyXQ+LKWwoYYNJI20cLIgsAcwXgqbXYjqaQQfu0PyKgJ6tZMuzV+fLbA1toq+s7h7LYLj4
FACaKVzYYIxq0cktosg6wOBuukyjwlRzNZVLGiJrXqj0+KKmIIrbc4tsAaP72wRN1PMDRQaGFkT2
1AWs3b/JTFyse0VZNgXgPEDPDUu4wUhIjil5zySahnrnl79x6nwd+2qz8FHIun6/oEhFepu9U0JM
xCqw+gbeysruVrd9zPTtgXBP5HxgPHqxu09MDFdxomCRXxxduSVIAg/hBva97eO5TXovtcYxZl8u
ffF1PWxUupv9tSxiU2WYru/bkyaI5Q==" />
|
bindTo
|
- Function:
- Specifies an IP address for AgilePoint Server in environments
where the CSM component cannot bind to the server using the
machine name.
- Accepted Values:
- An appSettings key in the following format:
<add key="bindTo" value="[IP address using numerals or *]" />
- Default Value:
- None.
For backward compatibility, if this value is not present, the CSM
component uses the AgilePoint Server machine name.
- Example:
- If the full IP address is 197.168.0.9,
any of these example formats can apply:
- <add key="bindTo" value="197.168.0.9" />
- <add key="bindTo" value="197.168.0.*" />
- <add key="bindTo" value="197.*.0.9" />
- <add key="bindTo" value="*.168.0.*" />
- <add key="bindTo" value="197.168.*.*" />
|
LogFileFolder
|
- Function:
- Specifies the location for your AgilePoint Server log file.
- Accepted Values:
- An appSettings key in the following format:
<add key="LogFileFolder" value="[absolute path to your log file folder]" />
- Default Value:
- [AgilePoint Server installation folder]\log
- Example:
- <add key="LogFileFolder" value="c:\Users\Log" />
|
MaxLogFileSize
|
- Function:
- Specifies the maximum file size for your log file.
- Accepted Values:
- An appSettings key in the following format:
<add key="MaxLogFileSize" value="[number of MB]" />
This value is an integer that represents log file size in MB.
- Default Value:
- 50
- Example:
- <add key="MaxLogFileSize" value="150" />
|
AdvancedLoadBalanceCondition
|
- Function:
- Rebalances the process load among AgilePoint Server
machines in a CSM environment when the difference in the
number of processes running on the machines
crosses a specified threshold.
The value of this field specifies this threshold in terms of
a percentage difference in the number of processes.
This is an advanced, optional configuration setting.
- Accepted Values:
- An appSettings key in the following format:
<add key="AdvancedLoadBalanceCondition" value="[percent difference]" />
This value is a decimal number that represents a percentage.
The recommended value is 0.5, or 50 percent.
- Default Value:
- 0.1
This means if the largest difference between the number of
running process instances among multiple machines is
greater than 10 percent, rebalancing starts.
- Example:
- <add key="AdvancedLoadBalanceCondition" value="0.13" />
In this example, load rebalance is triggered when the largest difference
in the number of processes running on the AgilePoint machines is
13 percent or higher.
For example:
- SERVER1 has 1000 running process instances
- SERVER2 has 1500 running process instances
- SERVER3 has 1200 running process instances
- SERVER2 - SERVER1 = 500 (This is the largest difference.)
- SERVER3 - SERVER1 = 200
- SERVER2 - SERVER3 = 300
- Total: SERVER1 + SERVER2 + SERVER2 = 3700
- Percentage: 500/3700 = 13.5%
|
AdvancedLoadBalanceInterval
|
- Function:
- Rebalances the process load among AgilePoint Server
machines in a CSM environment periodically.
The value of this field specifies the
number of minutes for each interval.
This is an advanced, optional configuration setting.
- Accepted Values:
- An appSettings key in the following format:
<add key="AdvancedLoadBalanceInterval" value="[number of minutes]" />
This value is an integer.
The recommended value is 30, which means the load balance is checked
every 30 minutes.
If this value is less than 30, it will cause frequent loading and unloading
among machines.
- Default Value:
- 0
This means AdvancedLoadBalanceInterval is turned off.
If configuration file does not this key, it will not perform advanced balancing.
- Example:
- <add key="AdvancedLoadBalanceInterval" value="20" />
|
database
|
- Function:
- Specifies the connection string for the main AgilePoint database.
- Accepted Values:
- An appSettings key in the following format:
<add key="database"
value="application name=[AgilePoint CSM];server=[SQL Server name];
database=[database name];trusted_Connection=yes"/>
- Default Value:
- None
- Example:
- <add key="database" value="application name=AgilePoint CSM;server=(local);database=ap_licenses;trusted_Connection=yes"/>
|
InitialLeaseTime
|
- Function:
- The number of seconds AgilePoint Server initiates its lease
on Cluster Server Manager once the heartbeat is initiated.
- This is an advanced, optional configuration setting.
- This only applies to CSM
running on a virtual machine under heavy load.
- Accepted Values:
- Any integer greater than or equal to 60, representing a number of seconds.
<add key="InitialLeaseTime" value="[seconds]" />
- Default Value:
- 60
- Example:
- <add key="InitialLeaseTime" value="120" />
|
lock
|
- Function:
- Adds a lock to the database, so that errors do not
occur when AgilePoint tries to communicate with the database
from multiple servers. This setting supports
high availability for the CSM
component independent of AgilePoint Server.
This value is optional,
but you must create it if you want to use it.
- Accepted Values:
- An appSettings key in the following format:
In the
setting for AgilePoint v5.0 R2 SP1 and later,
the brackets ([ ]) in the value [SIMPLIFIED] are literal
and required. In the setting for AgilePoint
v5.0 R2 and earlier, the brackets within the values
(for example, [SQL Server name])
indicate variables. In this case,you must replace the entire value
[SQL Server name], including the brackets, with the actual value for your
environment, such as mydatabaseserver. This
difference is shown in the examples.
AgilePoint BPMS v5.0 R2 SP1 and later:
<add key="lock" value="[SIMPLIFIED]"/>
AgilePoint BPMS v5.0 R2 and earlier:
<add key="lock"
value="application name=[AgilePoint CSM];server=[SQL Server name];
database=[database name];trusted_Connection=yes"/>
- Default Value:
- None
If no lock database value is specified for CSM, CSM uses the same lock
database as AgilePoint Server.
- Example:
- AgilePoint BPMS v5.0 R2 and earlier:
<add key="lock" value="[SIMPLIFIED]"/>
AgilePoint BPMS v5.0 R2 and earlier:
<add key="lock" value="application name=AgilePoint CSM;server=(local);database=lock;trusted_Connection=yes"/>
|
port
|
- Function:
- Specifies the port for TCP/IP communication between
AgilePoint Server and the AgilePoint CSM.
- Accepted Values:
- An appSettings key in the following format:
<add key="port" value="[CSM port number]"/>
- Default Value:
- 13481
- Example:
- <add key="port" value="13481"/>
|
RenewOnCallTime
|
- Function:
- The number of seconds CSM renews the lease for an AgilePoint
Server instance after it makes a call.
- This is an advanced, optional configuration setting.
- This only applies to CSM
running on a virtual machine under heavy load.
- Accepted Values:
- Any integer greater than or equal to 5,
representing a number of seconds.
<add key="RenewOnCallTime" value="[seconds]" />
- Default Value:
- 5
- Example:
- <add key="RenewOnCallTime" value="10" />
|
ServiceName
|
- Function:
- Specifies the name of the AgilePoint CSM Windows
service.
- Accepted Values:
- The following appSettings Key:
<add key="ServiceName" value="AgilePoint Clustering Server Manager"/>
- Default Value:
- AgilePoint Clustering Server Manager
AgilePoint recommends that you do not change this value.
|
