The following parameters control the behavior of the PerformanceGuard web interface. They’re set in one of these places:
[PerformanceGuard installation folder]\Settings.ini: ports and the database connection. See Server Settings Ini.- ADMINISTRATION → Setup → Parameters in the PerformanceGuard web interface, on the Display tab. The values are stored in the PerformanceGuard database.
[PerformanceGuard installation folder]\display\conf\performanceguard.xml: a few advanced parameters. By default, the file doesn’t contain these parameters. Add a line in this format inside the <Context> element: <Parameter name="accessLogEnabled" value="true"/>.
Restart the PerformanceGuard Web Server services after you change Settings.ini or performanceguard.xml.
| MERLINPORT |
|
| Set in |
Settings.ini |
| Type |
Number |
| Default value |
80 |
| Description |
TCP/IP listener port of the PerformanceGuard web interface (the PerformanceGuard Web Server 2 service). |
| PGUARDPORT |
|
| Set in |
Settings.ini |
| Type |
Number |
| Default value |
81 |
| Description |
TCP/IP listener port of the PerformanceGuard Web Server service, which serves the classic pages that the web interface shows. |
| PGUARDSECURE |
|
| Set in |
Settings.ini |
| Type |
True/false |
| Default value |
false |
| Description |
Set to true when the web interface uses HTTPS. See SSL Server Certificate for HTTPS. |
These parameters control the maximum number of rows to show on a page. If the actual number of rows exceeds the parameter value, navigation links are added to the page. You find them in the Miscellaneous section of the Display tab.
| Protocol Page Size |
|
| Set in |
Display tab under ADMINISTRATION → Setup → Parameters |
| Type |
Number |
| Default value |
500 |
| Description |
Maximum number of ports to concurrently show on the port management page. |
| Server Page Size |
|
| Set in |
Display tab under ADMINISTRATION → Setup → Parameters |
| Type |
Number |
| Default value |
500 |
| Description |
Maximum number of servers to concurrently show on the server management page. |
| Report Page Size |
|
| Set in |
Display tab under ADMINISTRATION → Setup → Parameters |
| Type |
Number |
| Default value |
50 |
| Description |
Maximum number of reports to concurrently show on the report management page. |
These parameters control image format and refreshing intervals for generated graphs.
| Refresh Interval |
|
| Set in |
Display tab under ADMINISTRATION → Setup → Parameters |
| Type |
Seconds |
| Default value |
120 |
| Description |
Time (sec) between automatic refreshing of the Time View, Server/Port and Server/Agent graphs. A value of 0 disables automatic refreshing. |
| Image Format |
|
| Set in |
Display tab under ADMINISTRATION → Setup → Parameters |
| Type |
String. “image/jpeg” or “image/png” |
| Default value |
“image/jpeg” |
| Description |
Graph image format. PNG is smaller in size, but takes approximately 1-2 seconds longer to generate. JPEG is about three times the size of a PNG, and the quality of the image isn’t as good as PNG |
| Moving Average |
|
| Set in |
Display tab under ADMINISTRATION → Setup → Parameters |
| Type |
Number |
| Default value |
10 |
| Description |
The number of samples to use when calculating moving averages in graphs. The value must be larger than 1. |
These parameters control which status color agents will have on the agent search and agent management pages.
| Client inactivity minutes yellow |
|
| Set in |
Display tab under ADMINISTRATION → Setup → Parameters |
| Type |
Minutes |
| Default value |
30 |
| Description |
Minutes of inactivity before an agent’s status color changes from green to yellow. |
| Client inactivity minutes red |
|
| Set in |
Display tab under ADMINISTRATION → Setup → Parameters |
| Type |
Minutes |
| Default value |
1440 (that is 24 hours) |
| Description |
Minutes of inactivity before an agent’s status color changes from yellow to red. |
These parameters control the database connection.
| BE_JDBC_CONNECTSTRING |
|
| Set in |
Settings.ini |
| Type |
String |
| Description |
JDBC connection string for the PerformanceGuard backend database. |
| BE_DB_USER |
|
| Set in |
Settings.ini |
| Type |
String |
| Description |
PerformanceGuard backend database user name. The password is set in BE_DB_PASSWORD. |
| JDBC_DRIVER |
|
| Set in |
Settings.ini |
| Type |
JDBC driver class |
| Default value |
com.microsoft.sqlserver.jdbc.SQLServerDriver |
| Description |
JDBC driver for access to the PerformanceGuard database. |
| jdbc.prefetch.size |
|
| Set in |
performanceguard.xml |
| Type |
Integer |
| Default value |
20 |
| Description |
JDBC row prefetch size, applies to all prepared statements. |
| In performanceguard.xml |
<Parameter name="jdbc.prefetch.size" value="20"/> |
| demo.mode |
|
| Set in |
The PerformanceGuard database. The Demo Mode check box on the Common tab under ADMINISTRATION → Setup → Parameters shows the current value, but you can’t change it there. |
| Type |
Integer |
| Default value |
0 |
| Description |
Set demo.mode to 1 to activate demo mode. When demo mode is activated, the internal clock in the PerformanceGuard web interface will be stopped and reset to the time stamp of the last delivered sample. When in demo mode PerformanceGuard won’t accept incoming data from agents, and it won’t delete old data (the cleanup job is stopped). |
Access logging, that is logging of who accesses the PerformanceGuard system, is by default not enabled. When access logging has been enabled, you can view the access log in the folder [PerformanceGuard installation folder]\display\accesslogs. The files are named jetty-<yyyy_mm_dd>.request.log, with one file per day.
| accessLogEnabled |
|
| Set in |
performanceguard.xml |
| Type |
True/false |
| Default value |
False |
| Description |
Determines whether access logging is enabled or not. |
| In performanceguard.xml |
<Parameter name="accessLogEnabled" value="true"/> |
| accessLogRetainDays |
|
| Set in |
performanceguard.xml |
| Type |
Number of days |
| Default value |
7 |
| Description |
Determines how many days the access log is kept, if access logging is enabled. The value 0 (zero) will keep the log forever. We don’t recommend that you keep the log forever because it will take up more and more disk space. |
| In performanceguard.xml |
<Parameter name="accessLogRetainDays" value="7"/> |
