Server settings in appsettings.json
The appsettings.json file is the main settings file for the QPR ProcessAnalyzer Server application.
| Setting | Description |
|---|---|
| SqlDatabaseConnectionString | Connection string to configuration database in SQL Server. Check whether you are using the SQL Server default instance or a named instance, and whether the SQL Server authentication or Windows authentication is used.
Connect to SQL Server default instance using SQL Server authentication: Server=myServerAddress;Database=myDataBase;User Id=myUsername;Password=myPassword; Connect to SQL Server default instance using Windows authentication: Server=myServerAddress;Database=myDataBase;Trusted_Connection=True; Connect to SQL Server named instance using SQL Server authentication: Server=myServerName\\myInstanceName;Database=myDataBase;User Id=myUsername;Password=myPassword; Connect to SQL Server named instance using Windows authentication: Server=myServerName\\myInstanceName;Database=myDataBase;Trusted_Connection=True; More information about connections strings: https://www.connectionstrings.com/sqlconnection. |
| LogFilePath | Location of the QPR ProcessAnalyzer Server log file, defined as the full path including the file name. For example: C:\\ProgramData\\QPR Software\\QPR ProcessAnalyzer\\Logs\\PA.log (json escapings are included). |
| CorsOrigins | Defines how QPR ProcessAnalyzer Server responds to the CORS preflight requests. By default, this setting is empty, meaning that CORS is not allowed. To allow CORS from all origins, specify * (note that this is the least secure option). If CORS need to be enabled for a specific site(s), they are defined as a comma separated list to this setting. More about CORS: https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS. |
| UseXForwardedForAsClientIp | If QPR ProcessAnalyzer Server is running behind a web traffic load balancer (e.g. in Amazon Web Services), the following setting needs to be set to True. In that case, the client ip address is fetched from http request X-Forwarded-For (https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/X-Forwarded-For) field instead of the source of the ip packet. Client ip address is needed for logging and as a security confirmation in addition to the session id. When there is no load balancer and thus X-Forwarded-For is not set, it's important to have this setting as False. |
Following settings are used by in-memory models:
| Setting | Description |
|---|---|
| ModelLoadOnStartup | Whether in-memory models having setting LoadOnStartup as true are loaded automatically during the server startup. By default, this setting should be set to True. This setting can be used to temporarily disable automatic model loading for all models when for example automatic model loading causes issues. |
| DropUnusedFiltersAfter |
Duration after which filters that have not been used, are dropped from the memory. Defined in format HH:mm:ss or d.HH:mm:ss, for example 01:00:00 (one hour), 00:30:00 (30 minutes) or 1.00:00:00 (24 hours). When a calculation uses a filter, the filter's last used time is updated (also model's last used time is updated). This setting can be overridden for each model in the model settings. Note that this setting doesn't concern Snowflake models. |
Following settings are for the product activation:
| Setting | Description |
|---|---|
| ProductActivationCode | QPR ProcessAnalyzer Server product license activation code. Ask your organization license activation code from customercare@qpr.com.
QPR ProcessAnalyzer Server automatically activates itself if the code is specified and there is an internet connection in the server computer. If there is no internet access, the activation need to be done manually by using the Activation Utility. |
| FirstName | Contact person first name (in the user organization) (used for QPR ProcessAnalyzer Server activation). |
| LastName | Contact person last name (used for QPR ProcessAnalyzer Server activation). |
| Contact person email address (used for QPR ProcessAnalyzer Server activation). | |
| LicenseFilePath | QPR ProcessAnalyzer Server license file path including the file name. For example C:\\ProgramData\\QPR Software\\QPR ProcessAnalyzer\\pa_service.lf (json escapings are included). The license file is created when the QPR ProcessAnalyzer Server is activated. If changing the activation code, this file needs to be deleted manually to enable reactivation. |
| EMSAddress | Activation server address https://activation.qpr.com/ that is contacted when the QPR ProcessAnalyzer Server is activated. Do not change this setting. |
| UseProxyServer | If needed, define the proxy server for QPR ProcessAnalyzer Server activation. |
| ProxyAddress | If needed, define the proxy server for QPR ProcessAnalyzer Server activation. |
| Country | User country (used for QPR ProcessAnalyzer Server activation). |
| JobTitle | Contact person's job title (used for QPR ProcessAnalyzer Server activation). |
| PhoneNumber | Contact person's phone number (used for QPR ProcessAnalyzer Server activation). |
| Address | User address (used for QPR ProcessAnalyzer Server activation). |
| PostalCode | User postal code (used for QPR ProcessAnalyzer Server activation). |
| Region | User region (used for QPR ProcessAnalyzer Server activation). |
| Organization | User organization (used for QPR ProcessAnalyzer Server activation). |
The appsettings.json needs to be a correctly formatted json file, and thus the backslashes and quotation marks in string values need to be escaped as follows: \ → \\ and " → \".