# Web Interface Configuration

> The parameters that control the web interface, set in the config_params table or in performanceguard.xml.

Source: https://docs.capaone.com/performanceguard/technical-reference/web-interface/web-interface-configuration/  
Product: PerformanceGuard — a separate CapaSystems product; do not apply this page to any other.

The following parameters control the behavior of the PerformanceGuard web interface. They can be set either in the config\_params database table or in the file performanceguard.xml (the default location of the file is \\[PerformanceGuard installation folder\\]\display\conf)

## **Service Settings**

This parameter controls the PerformanceGuard Web Server service.

| **Port**                    |                                                                                            |
|:----------------------------|:-------------------------------------------------------------------------------------------|
| **Set in**                  | performanceguard.xml                                                                       |
| **Type**                    | Number                                                                                     |
| **Default value**           | 80                                                                                         |
| **Description**             | TCP/IP listener port for the PerformanceGuard Web Server service. Default is HTTP port 80. |
| **In performanceguard.xml** | ```text<br/><Parameter name="port" override="false" value="80"/><br/>```                   |

## **Page Sizes**

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.

| **Protocol.Page.Size**   |                                                                           |
|:-------------------------|:--------------------------------------------------------------------------|
| **Set in**               | config\_params database table                                             |
| **Type**                 | Number                                                                    |
| **Default value**        | 500                                                                       |
| **Description**          | Maximum number of ports to concurrently show on the port management page. |

| **Server.Page.Size**   |                                                                               |
|:-----------------------|:------------------------------------------------------------------------------|
| **Set in**             | config\_params database table                                                 |
| **Type**               | Number                                                                        |
| **Default value**      | 500                                                                           |
| **Description**        | Maximum number of servers to concurrently show on the server management page. |

| **Report.Page.Size**   |                                                                               |
|:-----------------------|:------------------------------------------------------------------------------|
| **Set in**             | config\_params database table                                                 |
| **Type**               | Number                                                                        |
| **Default value**      | 50                                                                            |
| **Description**        | Maximum number of reports to concurrently show on the report management page. |

## **Graph Parameters**

These parameters control image format and refreshing intervals for generated graphs.

| **Refresh.interval**   |                                                                                                                                            |
|:-----------------------|:-------------------------------------------------------------------------------------------------------------------------------------------|
| **Set in**             | config\_params database table                                                                                                              |
| **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**         | config\_params database table                                                                                                                                                                      |
| **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**           | config\_params database table                                                                             |
| **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. |

## **Client Activity**

These parameters control which status color agents will have on the agent search and agent management pages.

| **ClientInactivityMinutesYellow**   |                                                                                    |
|:------------------------------------|:-----------------------------------------------------------------------------------|
| **Set in**                          | config\_params database table                                                      |
| **Type**                            | Minutes                                                                            |
| **Default value**                   | 30                                                                                 |
| **Description**                     | Minutes of inactivity before an agent's status color changes from green to yellow. |

| **ClientInactivityMinutesred**   |                                                                                  |
|:---------------------------------|:---------------------------------------------------------------------------------|
| **Set in**                       | config\_params database table                                                    |
| **Type**                         | Minutes                                                                          |
| **Default value**                | 1440 (that is 24 hours)                                                          |
| **Description**                  | Minutes of inactivity before an agent's status color changes from yellow to red. |

## **Database Connection**

These parameters control database connection.

| **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** | ```text<br/><Parameter name="jdbc.prefetch.size" override="false" value="20"/><br/>``` |

| **sql.folder**    |                                                                                                                                                               |
|:------------------|:--------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **Set in**        | performanceguard.xml                                                                                                                                          |
| **Type**          | Folder name                                                                                                                                                   |
| **Default value** | local/                                                                                                                                                        |
| **Description**   | The SQL statements used in the application are defined in various files in this folder. <br/>⚠️ This value should only be changed by a CapaSystems consultant |

| **JdbcDriver**              |                                                                                                        |
|:----------------------------|:-------------------------------------------------------------------------------------------------------|
| **Set in**                  | performanceguard.xml                                                                                   |
| **Type**                    | JDBC driver class                                                                                      |
| **Default value**           | com.microsoft.sqlserver.jdbc.SQLServerDriver                                                           |
| **Description**             | JDBC driver for access to the PerformanceGuard database                                                |
| **In performanceguard.xml** | ⚠️ Parameter name="JdbcDriver" override="false" value="com.microsoft.sqlserver.jdbc.SQLServerDriver"/> |

| **JdbcConnectString**       |                                                                                                              |
|:----------------------------|:-------------------------------------------------------------------------------------------------------------|
| **Set in**                  | performanceguard.xml                                                                                         |
| **Type**                    | String                                                                                                       |
| **Default value**           | jdbc:sqlserver://localhost                                                                                   |
| **Description**             | Database connection string.                                                                                  |
| **In performanceguard.xml** | ```text<br/>Parameter name="JdbcConnectString" override="false" value="jdbc:sqlserver://localhost"/><br/>``` |

| **User**                    |                                                                              |
|:----------------------------|:-----------------------------------------------------------------------------|
| **Set in**                  | performanceguard.xml                                                         |
| **Type**                    | String                                                                       |
| **Default value**           | pguard                                                                       |
| **Description**             | PerformanceGuard backend server database user name.                          |
| **In performanceguard.xml** | ```text<br/><Parameter name="User" override="false" value="pguard"/><br/>``` |

| **Password**                |                                                                                                                                                                              |
|:----------------------------|:-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **Set in**                  | performanceguard.xml                                                                                                                                                         |
| **Type**                    | String                                                                                                                                                                       |
| **Default value**           | pguard                                                                                                                                                                       |
| **Description**             | PerformanceGuard backend server database password.                                                                                                                           |
| **In performanceguard.xml** | ```text<br/><Parameter name="Password" override="false" value="[encrypted password]"/> <br/>]]><br/>``` ⚠️ The password is stored in encrypted form in performanceguard.xml. |

| **Connection.pool.size**    |                                                                                                                                                                                              |
|:----------------------------|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **Set in**                  | performanceguard.xml                                                                                                                                                                         |
| **Type**                    | Number of connections                                                                                                                                                                        |
| **Default value**           | 15                                                                                                                                                                                           |
| **Description**             | The number of simultaneous connections to the PerformanceGuard database. If an SQL error occurs on one of the connections in the pool, the application tries to re-establish the connection. |
| **In performanceguard.xml** | ⚠️ \<Parameter name="Connection.pool.size" override="false" value="15"/\>                                                                                                                      |

:::tip
If required, you can make PerformanceGuard services use Windows Authentication on to the PerformanceGuard SQL Server databases. See [Windows Authentication for PerformanceGuard Services](/performanceguard/administration/more-setup/windows-authentication-for-performanceguard-services/).
:::

## **Demo Mode**

| **demo.mode**     |                                                                                                                                                                                                                                                                                                                                                 |
|:------------------|:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **Set in**        | config\_params database table                                                                                                                                                                                                                                                                                                                   |
| **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**

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.

| **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" override="false" value="False"/\> |

| **accessLogRetainDays**     |                                                                                                                                                                                                                                        |
|:----------------------------|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **Set in**                  | performanceguard.xml                                                                                                                                                                                                                   |
| **Type**                    | Number of days                                                                                                                                                                                                                         |
| **Default value**           | 7                                                                                                                                                                                                                                      |
| **Description**             | Determines how the log access log is kept for if access logging is enabled. <br/>⚠️ 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** | ```text<br/><Parameter name="accessLogRetainDays" override="false" value="7"/><br/>```                                                                                                                                                 |
