This chapter describes the contents of the qpr .ini settings files.
The QPR .ini files can be found in the following locations:
•QPR_Clients.ini located in the C:\ProgramData\QPR Software\QPR 2019\2019.1\Clients\Settings folder.
•QPR_Servers.ini located in the C:\ProgramData\QPR Software\QPR 2019\2019.1\Servers\Settings\<possible instance folder> folder.
•QPR_Shared.ini located in the C:\ProgramData\QPR Software\QPR 2019\2019.1\Shared\Settings\<possible instance folder> folder.
•QPR_Servers.ini and QPR_Shared.ini located in the QPR 2019 Servers installation folder contains only certain read-only settings. This is used only in the case the files under the ProgramData cannot be found. This file is read-only, so for instance QPR Configuration Manager does not modify this one.
Abbreviations used in the files:
UMS = QPR User Management System
SCS = QPR Metrics Server
SCC = QPR Metrics Client
PGS = QPR BizArchitecture Server
PGC = QPR Modeling Client
WAS = QPR Web Application Server
SCP = QPR Metrics Plugin (i.e. the Web Client)
PGP = QPR Modeling Plugin (i.e. the Web Client)
Settings in QPR_Clients.ini
[UMS Communication] Section
Field |
Field Type |
Description |
---|---|---|
Connections |
String |
A semicolon-separated list of configured server connections. Each connection entry is a comma-separated list of the following values: Order number in the list, flag indicating whether the connection is the default connection (0/1), connection's name, server's host, and port. |
[PGS Communication] Section
Field |
Field Type |
Description |
---|---|---|
Connections |
String |
A semicolon-separated list of configured server connections. Each connection entry is a comma-separated list of the following values: Order number in the list, flag indicating whether the connection is the default connection (0/1), connection's name, server's host, and port. |
[SCS Communication] Section
Field |
Field Type |
Description |
---|---|---|
Connections |
String |
A semicolon-separated list of configured server connections. Each connection entry is a comma-separated list of the following values: Order number in the list, flag indicating whether the connection is the default connection (0/1), connection's name, server's host, and port. |
[SCC Settings] Section
Field |
Field Type |
Description |
---|---|---|
DefaultReportFolder |
String |
Folder where reports are located. |
DefaultReportWWWServer |
String |
URL where published reports will appear. |
HideSplashScreen |
Integer |
Defines whether the splash screen is hidden on QPR Metrics client startup. 0 = splash screen is shown (default), 1 = splash screen is hidden. |
EnableLanguageSpecificContent |
Boolean |
Defines whether multilingual modeling is in use in QPR Metrics client. 0 = multilingual modeling is not in use (default), 1 = multilingual content is in use. |
LoadAllElements |
Boolean |
Defines when Metrics model elements are loaded from the Metrics server. 0 = each element is loaded as needed (default), 1 = all elements are loaded at once when the model is opened. |
[XML Integration] Section
Field |
Field Type |
Description |
---|---|---|
SettingsFile |
String |
The full path and the file name of the last selected task file in XML integration. |
ExportFile |
String |
The full path and the file name of the last selected export file. |
XSLTFile |
String |
The full path and the file name of the last selected XSLT file. |
[PGC Settings] Section
Field |
Field Type |
Description |
---|---|---|
ModelCheckLevel |
Integer |
Flag used in model validation. 0 = no, 1 = yes. |
DefaultTemplate |
String |
Name and location of the default file model template, if used. |
[Settings] Section
Field |
Field Type |
Description |
---|---|---|
TasksDir |
String |
The name of the directory where predefined integration settings files are stored (if this is missing, the application uses the default directory, which is C:\ProgramData\QPR Software\QPR 2019\2019.1\Clients\PGIntegrationTasks. |
DefaultModelingWorkDirectory |
String |
Defines the folder that is opened by default with Open and Save As operations for models. This setting is used until the user uses some other directory for a successful model operation. The new folder will be the default folder for the rest of the client session. In the case this setting is empty, the pgmodels folder under C:\ProgramData\QPR Software\QPR 2019\2019.1\Clients is used by default. |
DefaultModelingScriptDirectory |
String |
Defines the folder that is opened by default when the Run command for scripts is used and populates the Run Script menu by scripts in the folder. This setting is used until the user uses some other folder for opening a script successfully. The new folder will be the default folder for the rest of the client session. In the case this setting is empty, the pgscripts folder under C:\ProgramData\QPR Software\QPR 2019\2019.1\Clients is used by default. |
DefaultMetricsWorkDirectory |
String |
Defines the folder that is opened by default with Import and Export operations for models in QPR Metrics. This setting is used until the user uses some other directory for a successful import or export operation. The new folder will be the default folder for the rest of the client session. |
DefaultMetricsScriptDirectory |
String |
Defines the folder that is opened by default when the Run command for scripts is used in QPR Metrics. This setting is used until the user uses some other folder for opening a script successfully. The new folder will be the default folder for the rest of the client session. In the case this setting is empty, the scscripts folder under C:\ProgramData\QPR Software\QPR 2019\2019.1\Clients is used by default . |
SharePointSiteURLs |
String |
Defines the URL(s) of SharePoint site(s). If multiple sites are defined, the URLs need to be separated with semicolons. If this string is empty, SharePoint actions are disabled. |
CMISServers |
String |
Defines the URL(s) of Content Management Interoperability Services AtomPub endpoint(s) used by various content management systems supporting the CMIS standard. If multiple endpoints are defined, the URLs need to be separated with semicolons. If this string is empty, CMIS actions are disabled. |
Folder |
String |
Defines the folder where all the client logs are stored. |
CacheFolder |
String |
Defines the folder in which cache files created by QPR client components are stored. |
EnableIPv6 |
Integer |
Defines whether Internet Protocol version 6 (IPv6) is used for opening a connection to the server. 0 = IPv6 is not enabled and IPv4 is used to open the connection (the default value), 1 = IPv6 is enabled and the client tries to open the connection to the server with IPv6. |
[ScriptSettings] Section
Field |
Field Type |
Description |
---|---|---|
ScriptTimeout |
Integer |
Defines the default timeout value for QPR scripts that do not contain the setting in the scripts themselves. The value is the interval (in seconds) for displaying a notification about a time-consuming script being executed. Setting this to 0 disables the notification. |
ClientSecurity |
Integer |
Defines how QPR Scripts can be executed. 0 = scripts are not allowed to run, 1 = in clients only, a confirmation is asked, 2 = in clients only, no confirmation, 3 = running scripts is allowed both in clients and in Windows Explorer, 4 = as with 3, in addition Integrated Windows Authentication is allowed. |
SingleInstanceScriptAPI |
Integer |
Defines whether only a single SCApplication COM object (QPR Metrics client instance) should be created. If this is 0 or missing, a new client instance is created for each CreateObject call. If this is 1, an existing instance is used if it exists. |
[SCC Log], [PGC Log], and [UMC Log] Section
Field |
Field Type |
Description |
---|---|---|
Threshold |
Integer |
Defines the log trace mode. 255 = normal trace mode, 6577 = full trace mode. |
MaxSize |
Integer |
The maximum size of the log file in kilobytes. After the maximum size is searched, the old entries are overwritten starting from the oldest entry. |
Enabled |
Integer |
Defines whether logging is on. 0 = no, 1 = yes. |
[Flow Chart Print Settings] Section
Field |
Field Type |
Description |
---|---|---|
BlackAndWhite |
Integer |
Flag indicating whether the diagram is printed in black and white. 0 = no, 1 = yes. |
OrganizationsOnEveryPage |
Integer |
Flag indicating whether organization item headers are reprinted on each page. 0= no, 1 = yes. |
CheckpointsOnEveryPage |
Integer |
Flag indicating whether checkpoint headers are reprinted on each page. 0= no, 1 = yes. |
SeparateSettings |
Integer |
Flag indicating whether the first page uses a separate settings. 0 = no, 1 = yes. |
FixedSize |
Integer |
Flag indicating whether the diagram print is done in fixed size. 0 = no, 1 = yes. |
FitToOnePage |
Integer |
Flag indicating whether the diagram print is fitted to one page. 0 = no, 1 = yes. |
FitToPages |
Integer |
Flag indicating whether the diagram print is fitted to multiple pages. 0 = no, 1 = yes. |
PrintSubprocesses |
Integer |
Flag indicating whether all the child diagrams are printed as well. 0 = no, 1 = yes. |
LeftMargin |
Decimal |
Left margin used in diagram print. |
RightMargin |
Decimal |
Right margin used in diagram print. |
TopMargin |
Decimal |
Top margin used in diagram print. |
BottomMargin |
Decimal |
Bottom margin used in diagram print. |
ZoomTo |
Integer |
Value for fixed size used in diagram print. |
PagesHigh |
Integer |
Number of vertical pages used in diagram print. |
PagesWide |
Integer |
Number of horizontal pages used in diagram print. |
Orientation |
Integer |
Flag indicating default printer orientation. 0 = Landscape, 1 = Portrait. |
[Page1 / Page N Header and Footer Items 0...n] Section
Field |
Field Type |
Description |
---|---|---|
ItemLocation |
Integer |
Location of item, 0 = left, 1 = center, 2= right |
PageItem |
Integer |
Type of the item, 0 = model name, 1 = diagram version, 2 = printing time, 3 = created, 4 = last saved, 5 = page number, 7 = file name, 8 = free text (see below), 9 = status, 10 = subprocess name |
FreeText |
String |
Free text |
FontName |
String |
Font name |
FontSize |
Integer |
Font size |
FontBold |
Integer |
Flag indicating whether the item is bolded. 0 = no, 1 = yes. |
FontItalic |
Integer |
Flag indicating whether the item's is in italic. 0 = no, 1 = yes. |
FontUnderline |
Integer |
Flag indicating whether the item is underlined. 0 = no, 1 = yes. |
FontStrikeout |
Integer |
Flag indicating whether the item is struck out. 0 = no, 1 = yes. |
FontColor |
Integer |
Color number for the item |
FontCharset |
String |
Character set for the page header item font. |
[QPR Custom Colors] Section
Field |
Field Type |
Description |
---|---|---|
Color<A-P> |
String |
User-defined custom colors. |
Settings in QPR_Shared.ini
[CustomerInfo] Section
Field |
Field Type |
Description |
---|---|---|
FirstName |
String |
Customer's first name |
LastName |
String |
Customer's last name |
EntitlementID |
String |
Customer's Product Activation Code |
Organization |
String |
Customer's organization |
JobTitle |
String |
Customer's job title |
String |
Customer's e-mail address |
|
Phone |
String |
Customer's phone number |
AddressLine1 |
String |
First line of the customer's address |
AddressLine2 |
String |
Second line of the customer's address |
ZipCode |
String |
Customer's zip/postal code |
City |
String |
Name of the city the customer lives in |
Region |
String |
Region the customer lives in |
Country |
String |
Name of the country the customer lives in |
Comments |
String |
Customer's comments |
[Proxy] Section
Field |
Field Type |
Description |
---|---|---|
UseProxy |
Integer |
Defines whether proxy server is used in QPR Product Activation. |
Server |
String |
IP address of the proxy server |
Port |
Integer |
Socket port of the proxy |
[Activation] Section
Field |
Field Type |
Description |
---|---|---|
URL |
String |
QPR Activation server URL |
String |
QPR's Customer Care e-mail address for manual product activation instructions |
|
LicencingModes |
String |
Supported licensing modes. |
Helpdesk |
String |
QPR Customer Care contact information. |
SilentFirstActivation |
Boolean |
Defines whether the first product activation is done in a silent mode. |
UseSilentForTransient |
Boolean |
Defines whether transient product activation is done in a silent mode. |
ShowTransientExpirationWarning |
Integer |
Defines how many days before expiration the warning is shown. Default value is 0 meaning no warnings. |
[Servers] Section
Field |
Field Type |
Description |
---|---|---|
Standalone |
Integer |
Defines whether a standalone version is installed. 1 = yes, 0 = no. This setting controls if the corresponding server components are launched when QPR Modeling Client or QPR Metrics client is launched. This option does not affect QPR Web Application Server or QPR Web Services Foundation. |
[Common] Section
Field |
Field Type |
Description |
---|---|---|
EnableGDIPlusGraphs |
Integer |
Defines whether Microsoft Windows GDI+ is used in drawing charts. 1 = yes (default) 0 = no. Disable this setting if you encounter troubles in drawing charts. |
GeneralLogMode |
Integer |
If set, defines the logging mode for all products. 0 = force normal trace mode, 1 = force full trace mode, 2 = custom mode |
EnableGDIPlusBitmapGraphs |
Integer |
Defines whether Microsoft Windows GDI+ is used in drawing charts if UseBitmapTextInGraphicalViews is 1 or the charts have background pictures. 1 = yes (default) 0 = no. Disable this setting if you encounter troubles in drawing charts. |
ClientSocketKeepaliveTimeout |
Integer |
Time in minutes between the sent keepalive messages when client is connected to server. This is necessary in situations where network connections are dropped after some time of inactivity. Default value is 1 minute (Windows default is 120 minutes). |
ClientSocketKeepaliveInterval |
Integer |
Time in seconds between resends in case keepalive messages are not being acknowledged. Default value is 1 second. |
ClientServerCompression |
Integer |
Defines whether compression is used in client - server communication. The possible values are: 0 = no compression is used except for model exports. 1 = if network connection is slower than 10Mb/s, compression is used for packets larger than 512 bytes. 2 = compression is always used for all packets larger than 512 bytes. In the case this key is missing or the value has not been defined, 1 is used by default. This setting is a client-side setting, i.e. the client computer defines the use of compression. |
ForceClearTypeFontSmoothing |
Integer |
Defines whether clear type font smoothing is used in QPR Modeling Client diagrams even if clear type font smoothing has not been enabled in display settings, 0 = off (default), 1 = on. |
[Fonts] Section
Field |
Field Type |
Description |
---|---|---|
UnicodeFontName |
String |
The font used in Unicode user interface controls (currently only translation dialogs for multilingual modeling) of QPR Modeling Client. |
UnicodeFontSize |
Integer |
Size of the Unicode font. |
NavigatorFontName |
String |
Font used in all tree navigator controls in QPR Metrics and QPR Modeling clients. This setting is useful in the case the default font for example does not support all symbols in the language used in the model. |
NavigatorFontSize |
Integer |
Size of the navigator font. |
ChartTitleFontName |
String |
Font used in the history chart title in QPR Metrics. This setting is useful in the case the default font for example does not support all symbols in the language used in the model. |
ChartTitleFontSize |
Integer |
Size of the chart title font. |
LegendFontName |
String |
Font used in the legend of the history chart view in QPR Metrics. This setting is useful in the case the default font for example does not support all symbols in the language used in the model. |
LegendFontSize |
Integer |
Size of the legend font. |
GraphFont |
String |
The font used in Analysis and Simulation graph views. If this setting is not defined, Tahoma is used by default. This setting can be used to correct font problems in some environments such as Thai, where for instance MS Sans Serif works fine. |
GraphFontSize |
Integer |
Size of the graph fonts. |
Settings in QPR_Servers.ini
[QPR Database] Section
Field |
Field Type |
Description |
---|---|---|
DBAlias |
String |
The database alias that is used by all QPR products. |
DBLogin |
String |
QPR database's login information. |
DBPassword |
String |
QPR database's password (encrypted). |
ReconnectInterval |
Integer |
The amount of seconds to wait before trying to re-establish a broken database connection. |
ReconnectRetryTimes |
Integer |
The amount of times the database connection is tried to be restored. |
MassOperationRecordCount |
Integer |
Defines the maximum amount of records that are stored with one SQL query. By default the value is 20. All positive integers from 0 upwards are valid values for this key. This setting can be used only with Microsoft SQL Server and Oracle databases. |
MassOperationMaxBlobSize |
Integer |
Defines the maximum size of blob fields that are stored with mass database operations. By default the value is 10000. All positive integers from 0 upwards are valid values for this key. This setting can be used only with Microsoft SQL Server and Oracle databases. |
TransactionQueueWarningTime |
Integer |
Defines the time (in minutes) after which a warning message is inserted in the relevant log file(s). The warning is triggered in the case a transaction has been in a QPR server component's transaction queue longer than the value defined here. In the case no value has been provided or the key is missing, 120 is used as the default value. |
TransactionQueueMaxTime |
Integer |
Defines the time (in minutes) after which an error message is inserted in the relevant log file(s). The error is triggered in the case a transaction has been in a QPR server component's transaction queue longer than the value defined here. Other database requests receive an error message telling that the database is overloaded until the transaction that triggered the warning is processed. In the case no value has been provided or the key is missing, 600 is used as the default value. |
TransactionQueueMaxTransactions |
Integer |
Defines the maximum amount of transactions in the transaction queue. The default value is 100, but this can be increased to allow very large modeling operations to be done within a short time period with a slow database. The limit for the amount of transactions is meant to restrict loss of data in case the server is terminated before transactions have been committed to the database. |
DBConnectionKeepAlive |
Integer |
This setting defines the interval (in minutes) between simple read operations that are performed to keep the database connection alive. This value is 0 by default (keepalive operations are not performed), but in the case you encounter problems with servers losing database connection after a certain amount of idle time, use this key with a value that's smaller than the idle time limit in your database. |
[WAS Settings] Section
Field |
Field Type |
Description |
---|---|---|
MaximumNumberOfClients |
Integer |
The maximum number of requests that are handled simultaneously by QPR WAS. If the amount of requests exceeds the value defined here, new requests will not be processed until the old ones have been completed.
If you are having problems with a multiprocessor machine, try lowering this value to 1. |
MaximumNumberOfClients_PGPLUGIN |
Integer |
The maximum number of requests that are handled simultaneously by QPR Modeling Plugin (i.e. the Web Client). If the amount of requests exceeds the value defined here, new requests will not be processed until the old ones have been completed. |
MaximumNumberOfClients_QPRPORTAL |
Integer |
The maximum number of requests that are handled simultaneously by QPR Portal. If the amount of requests exceeds the value defined here, new requests will not be processed until the old ones have been completed. |
MaximumNumberOfClients_SCPLUGIN |
Integer |
The maximum number of requests that are handled simultaneously by QPR Metrics Plugin (i.e. the Web Client). If the amount of requests exceeds the value defined here, new requests will not be processed until the old ones have been completed. |
MaximumNumberOfClients_QPRWAS |
Integer |
The maximum number of internal (for example Login procedures and error messages) requests that are handled simultaneously by QPR WAS. If the amount of requests exceeds the value defined here, new requests will not be processed until the old ones have been completed. |
WebContentRoot |
String |
The URL for the Web Contents on the Web server. Note that http://127.0.0.1 cannot be used here if the QPR Web Application Server is accessed from other computers or the web server is installed on some other computer. This must be the IP address or the web server's server name (for example "myserver.com"). |
HostScriptLocation |
String |
The URL for the CGI-binary on the Web server. Note that a localhost address like http://127.0.0.1/cgi-bin/qpr.exe cannot be used here if the QPR Web Application Server is accessed from other computers or the web server is installed on some other computer. This must be the IP address or the web server's server name (for example "myserver.com"). |
SessionExpirationTimeout |
Integer |
The maximum idle time in seconds before the session expires and user is forced to log in again. |
UseDefaultLoginView |
Integer |
Show the default or customized view in the login view. 1 = default, 0 = custom. |
CustomLoginURL |
String |
URL of the view shown in the login view if the default login view is not used. |
TemplateRoot |
String |
Root folder for all the template folders. If this setting has not been defined, the C:\ProgramData\QPR Software\QPR 2019\2019.1\Servers\Templates\WAS folder is used by default. |
ReadOnlyMode |
Integer |
Defines whether Portal is in read-only mode. 0 = no, 1 = yes. |
MaxMemoryUsage |
Integer |
Defines the maximum amount of memory in megabytes QPR Web Application Server is allowed to consume before attempting to free up memory. This setting affects e.g. the amount of models cached in the memory and therefore also for instance searches. Setting this to 0 disables the limit. |
MemoryUsageLimit |
Integer |
Defines the per cent value of the threshold for the MaxMemoryUsage when the memory limit has been exceeded, so that WAS will drop models from memory until memory usage is <value>% under the specified MaxMemoryUsage. The default value is 20. |
IWAEnable |
Integer |
Defines whether Integrated Windows Authentication (IWA) is enabled for QPR Portal. 0 = false, 1 = true. |
IWACGIBinaryIP |
String |
Obsolete. Use IWACGIBinaryHost instead. |
CGIBinaryIP |
String |
Obsolete. Use CGIBinaryHost instead. |
CachePages |
Integer |
Defines whether HTML pages generated by QPR Portal are cached in the browser cache. The following values can be used: 0 = never cache pages, 1 = disabled by default, i.e. pages are not cached unless explicitly requested to do so. 2 = enabled by default, i.e. pages are cached unless explicitly requested not to do so. By default the value is 1. |
ForcePlainTextURLs |
Integer |
Defines whether QPR Portal URLs are encrypted (user account data is always encrypted regardless of this setting). 1 = plain text URLs are used, 0 = URLs are encrypted. By default the value is 1. |
EnableTemplateCaching |
Integer |
Defines whether Portal templates are cached in QPR Web Application Server. Disabling this is helpful when customizing templates, as the templates are refreshed without restarting QPR Web Application Server. 1 = yes, 0 = no. By default the value is 1. |
UIYearOffset |
Integer |
With this key you can define an offset (positive or negative) to be applied to the year values displayed in QPR Portal to accommodate for different calendars. Note that this setting affects only how the values are displayed, so calculations are not affected and two QPR Web Application Servers can utilize the same database with different offsets. However, negative offsets large enough to cause negative year values to be displayed in QPR Portal should not be used.
Note that this setting affects also situations where action attribute values of the type date are inputted. In those cases a reverse offset is applied to the values before inputting them to the database in order to maintain database consistency. |
WebContentPath |
String |
Path where the QPR web contents are installed. |
DefaultPortalMode |
Integer |
Defines the QPR Portal mode that is used for a user that hasn't previously logged into QPR Portal. 0 (default) = Standard Portal, 1 = Mini Portal. |
HidePortalModeChange |
Integer |
Defines whether a button is shown in QPR Portal for changing the Portal mode between Mini Portal and Standard Portal. 0 (default) = button is shown, 1 = button is hidden. |
DefaultDetailsPaneMode |
Integer |
Defines the default mode of the Details Pane in QPR Portal. 0 = disabled, 1 (default) = minimized, 2 = open. Note that this setting is overridden if user-specific Details Pane mode is set in QPR Portal Settings page. |
HideDetailsPaneModeChange |
Integer |
Defines whether it is possible to change the Details Pane mode in QPR Portal or not. 0 (default) = Details Pane mode change is allowed, 1 = Details Pane mode change is not allowed. |
EnableReportingView |
Integer |
Defines whether the Reports tab is available in QPR Portal. 0 = Reports tab not available, 1 (default) = Reports tab is available. |
ReportingFileType |
Integer |
Defines the file types for the reports in QPR Portal. 0 (default) = Word, 1 = PDF. |
StoreSessionIdToCookie |
Integer |
Defines whether session ID is stored in a cookie instead of URL. 0 = session ID not stored in cookie, 1 = session ID stored in cookie (default). |
IWACGIBinaryHost |
String |
Deprecated. CGIBinaryHost is now used, but in the case this key has a value and CGIBinaryHost is undefined, the value of this key is read into the CGIBinaryHost key. |
CGIBinaryHost |
String |
Defines the IP or hostname of the computer where QPR.isapi.dll or QPR.CGI.exe is located. This option needs to be set only when IWAEnable or EnableSSOForPortal (in UMS Settings section) is set to 1. |
AuthenticationService_<1...10> |
String |
Defines the type and the URL of the authentication service to use with Common QPR Authentication. The value is a combination of a service type and the URL to be used, separated by a comma. For the service type, use either "WAS" (QPR Web Application Server) or "WS" (QPR Web Services Server). Example usage: AuthenticationService_1=WAS,https://127.0.0.1/QPR2019-1/Portal/qpr.isapi.dll. Must not point to the WAS URL of the WAS whose .ini file this resides in. |
EnableHtmlEmailNotification |
Boolean |
Defines if notification email templates for QPR Portal use HTML formatting. 0 = HTML formatting not used (default), 1 = HTML formatting used. |
AttachmentFileTypesAllowed |
String |
A semicolon-separated list of file types that are allowed as attachments. If empty, all file types are allowed. AttachmentFileTypesAllowed=.png;.txt; |
MaxUploadedFileLength |
Integer |
Maximum size (in bytes) of a file that is uploaded. Example usage: MaxUploadedFileLength=1048576 |
EnableAntiforgeryTokens |
Boolean |
Defines if cross-site request forgery tokens are in use in post requests. 0 = Tokens are not in use (default), 1 = Tokens are in use. Enabling the tokens may break Portal template customizations. |
UseAuthenticationToken |
Boolean |
Defines whether to use an authentication token instead of the session id as the value for the XSESSION parameter, when Common QPR Authentication is used. 0 = Authentication token not in use, and session id is used as the value for the XSESSION parameter, 1 = Authentication token is used (default). |
[SCP Reports] Section
Field |
Field Type |
Description |
---|---|---|
WebReportPath |
String |
Path where the published reports are stored. |
WebReportURL |
String |
URL where the published reports are found. |
ReportCommands |
Integer |
The amount of report commands |
ReportCommand<0...N> |
String |
Report command's name |
ReportCommandValue<0...N> |
String |
Report command's value. |
FileExtension |
String |
File extension for the report files. |
WebReportCGI |
String |
Path for an external report viewing application. |
UseCGI |
Integer |
Defines whether an external report application is used. 0 = no, 1 = yes. |
RemoveExtraFiles |
Integer |
Defines whether extra files are removed from the web file publishing directory at startup. 0 = no, 1 = yes |
[UMS Communication] Section
Field |
Field Type |
Description |
---|---|---|
ServerName |
String |
Hostname or the IP address of the QPR Foundation Server. |
ServerPort |
Integer |
Socket port of the QPR Foundation Server. |
Password |
String |
QPR User Management System's password (encrypted). |
UseEncryption |
Integer |
Defines whether encryption is used in communication between the QPR Foundation Server and the ser Management Client as well as between the QPR Foundation Server and other QPR server components. 0 = no, 1 = yes. |
[SCS Communication] Section
Field |
Field Type |
Description |
---|---|---|
ServerName |
String |
Hostname or the IP address of the QPR Metrics Server. |
ServerPort |
Integer |
Socket port of the QPR Metrics Server. |
UseEncryption |
Integer |
Defines whether encrypted communication is used. 1 = yes, 0 = no. |
[PGS Communication] Section
Field |
Field Type |
Description |
---|---|---|
ServerName |
String |
Hostname or the IP address of the QPR BizArchitecture Server. |
ServerPort |
Integer |
Socket port of the QPR BizArchitecture Server. |
UseEncryption |
Integer |
Defines whether encrypted communication is used. 1 = yes, 0 = no. |
[WAS Communication] Section
Field |
Field Type |
Description |
---|---|---|
ServerName |
String |
Hostname or the IP address of the QPR WAS. |
ServerPort |
Integer |
Socket port of the QPR WAS. |
[WS Communication] Section
Field |
Field Type |
Description |
---|---|---|
ServerName |
String |
Hostname or the IP address of the QPR Web Service Server. |
ServerPort |
Integer |
Socket port of the QPR Web Service Server. |
[QPR Settings] Section
Field |
Field Type |
Description |
---|---|---|
DefaultLanguage |
Integer |
Default language used by all QPR products. |
DefaultSubLanguage |
Integer |
Default sublanguage used by all QPR products. Used for distinguishing between e.g. Chinese Traditional and Chinese Simplified, which both have the same DefaultLanguage entry. |
QueryResultExpirationTime |
Integer |
Defines the time (in minutes) for how long views with lots of list information (such as Analysis views and actions fields with lots of result rows) are cached. Updated information is guaranteed to appear in QPR Portal only after the time defined in this key has passed after the update. Note that lowering the caching time reduces performance. Setting this to 0 (default) disables the caching of query results. |
QueryExpirationCheckInterval |
Integer |
Defines the maximum interval (in minutes) between checking whether there are query results which have expired as a result of reaching the time defined in QueryResultExpirationTime. If such results are found, they are dropped from the memory. The default value is 5. |
CacheFolder |
String |
Defines the folder in which cache files created by QPR server components are stored. |
EnableIPv6 |
Integer |
Defines whether Internet Protocol version 6 (IPv6) is used for opening a connection to the server. 0 = IPv6 is not enabled and IPv4 is used to open the connection (the default value), 1 = IPv6 is enabled and the client tries to open the connection to the server with IPv6. |
[WAS Blob Cache] Section
Field |
Field Type |
Description |
---|---|---|
OnDisk |
Integer |
Defines whether embedded attachments exceeding the size defined in the Threshold setting are stored in disk instead of memory. 1 = yes, 0 = no. |
Threshold |
Integer |
The maximum size for embedded attachments (in kilobytes) that are stored in the memory. If the size is exceeded, the attachments are stored in hard disk. |
[QPR Service] Section
Field |
Field Type |
Description |
---|---|---|
ServiceInstalled |
Integer |
Defines whether service is installed. 1 = yes, 0 = no. |
WSServiceInstalled |
Integer |
Defines whether web services service is installed. 1 = yes, 0 = no. |
StartupTime |
Integer |
The maximum number of seconds to wait for startup (control semaphore) before terminating the server process. |
StatusCheckInterval |
Integer |
Number of seconds to wait between successive server responsivity checks. |
ResponseTimeoutInterval |
Integer |
Number of seconds to wait for server process to respond to the control message. |
ServerKillTimeout |
Integer |
Number of seconds to wait for the server process to shut down (when the service is being shut down) before terminating the process (if EnableForceKill=1). |
EnableForceKill |
Integer |
Determines whether the server process can be terminated by force if it does not shut down in ServerKillTimeout seconds after the shutdown message has been sent (0 = false, 1 = true). |
ApplicationTitle |
String |
Defines the name that is displayed for the application in the service list. |
MaximumNumberOfStarts |
Integer |
Defines how many times the service tries to start in case of critical error at startup. |
ExternalName |
String |
Name of the service used in dialogs and other user interface objects. Do not modify this value unless instructed to. |
InternalName |
String |
Used for controlling the service. Do not modify this value unless instructed to. |
InternalBaseName |
String |
Used for controlling the service. Do not modify this value unless instructed to. |
[UMS Service, PGS Service, SCS Service, WAS Service, and WS Service] Sections
Field |
Field Type |
Description |
---|---|---|
Enabled |
Integer |
Defines whether service is enabled. 1 = yes, 0 = no. |
ShutDownSemaphore |
String |
Used for controlling the service. Do not modify this value. |
ShutDownMessage |
String |
Used for controlling the service. Do not modify this value. |
ControlSemaphore |
String |
Used for controlling the service. Do not modify this value. |
ControlMessage |
String |
Used for controlling the service. Do not modify this value. |
CloseMessage |
String |
Used for controlling the service. Do not modify this value. |
[PGS Service] Section
See UMS Service
[SCS Service] Section
See UMS Service
[WAS Service] Section
See UMS Service
[WS Service] Section
See UMS Service
[QPR Log] Section
Field |
Field Type |
Description |
---|---|---|
Folder |
String |
Defines the folder where all the server logs are stored. |
AuditFolder |
String |
Defines the folder where all the server audit logs are stored. |
[QPR E-Mail] Section
Field |
Field Type |
Description |
---|---|---|
ReplyAddress |
String |
E-mail address that will be used as the reply address in e-mail notifications. |
AdminAddress |
String |
Administrator's e-mail address. This address will receive alerts and notifications about server functionality. |
SMTPServer |
String |
Name of the SMTP server used for sending the e-mail notifications. |
SMTPServerPort |
Integer |
The SMTP server port number used for sending the e-mail notifications. The default port number is 25. |
SMTPLogin |
String |
Login name for the SMTP server. Used in the case SMTPAuthentication is 1. |
SMTPPassword |
String |
Password for the SMTP server in an encrypted format. Used in the case SMTPAuthentication is 1. |
SMTPAuthentication |
Integer |
Defines whether SMTP server authentication is used. 0 = no, 1 = yes. |
EMailAlertsEnabled |
Integer |
Defines whether e-mail alerts are enabled. 0 = no, 1 = yes. |
AlertCategories |
Integer |
Defines what kinds of events are alerted by e-mail. 1 = System notifications, 2 = Critical errors, 3 = both. |
UseCommonReplyAddressForPortalNotifications |
Integer |
Defines whether the ReplyAddress defined above is used also in e-mail notifications sent in relation to QPR Portal actions and briefing booklets. 0 = Individual user e-mail addresses are used as the sender address; 1 = The common reply address is used as the sender address. |
UseEncryptedConnection |
Integer |
Defines whether TLS 1.2 encryption is used when sending email alerts and notifications. 0 = Encryption is not used; 1 = Encryption is used. |
[UMS Settings] Section
Field |
Field Type |
Description |
---|---|---|
MaximumNumberOfClients |
Integer |
Used internally by UMS. Do not modify. |
AuthenticationMethod |
Integer |
QPR Foundation Server's authentication method. 1 = QPR, 2 = NT, 4 = LDAP, or any combination of the values above. For example QPR + NT = 3 |
AllowProfileChangesForViewers |
Integer |
Defines whether Portal viewer users can change their profile information (e-mail, password, language) in QPR Portal. 0 = no (default), 1 = yes. |
UserGroupManagementMethod |
Integer |
Defines the user group management method. 1 = Synchronized with NT/LDAP, 0 = UMS only |
DefaultUserGroup |
String |
Name of a valid user group in UMS. This group is used as a default group in NT/LDAP syncronization. For more information, refer to the NT & LDAP Authentication chapter. |
UserGroupManagementWithSSO |
Integer |
Defines whether users authenticated via Generic Single Sign-On are added to the default user group in UMS or not. 0 = users are not added (default), 1 = users are added. See also Using Single Sign-On with QPR Products. |
PreviousAlertMsg |
String |
Used internally by UMS. Do not modify. |
AlertCount |
Integer |
Used internally by QPR Foundation Server. Do not modify. |
ExternalObjectCacheExpirationTime |
Integer |
Defines how long user rights for PG and SC model elements are cached for faster opening of action lists under the Actions tab in QPR Portal. Note that changes done to user rights within the expiration time are not applied to QPR Portal until the cache expiration time is reached. The default value is 900 (seconds, i.e. 15 minutes). |
PortalAutoLogin |
Integer |
Defines whether login information is stored to cookies to enable automatic relogin to QPR Portal. 0 = autologin enabled and option at login view selected by default, 1 = autologin enabled, 2 = autologin disabled. |
LimitedUserVisibilityInPortal |
Integer |
This setting affects the users shown in the User Selection dialog in QPR Portal. In the case this is enabled, users without administrative rights to QPR User Management System see only those users who belong to at least one group the user him/herself also belongs to. 0 = disabled (default), 1 = enabled. |
EnableActionChangeLog |
Integer |
Defines whether the change log is enabled for QPR Portal actions. 0 = disabled (default), 1 = enabled. Enabling or disabling the change log for specific action types is done in actiontypes.ini. |
EnableSSOForPortal |
Integer |
Defines whether Single Sign On is enabled for QPR Portal. 0 = no, 1 = yes. |
UpdateUserInfoAtUserSynchronization |
Integer |
Defines whether user information in QPR UMS is updated when a user logs in with an NT or LDAP account. When using LDAP and this setting is enabled, the information is updated also during the next synchronization if the user information has changed on LDAP. The following information is updated in the case this setting is enabled: •Full name •E-mail (LDAP only) •Telephone number (LDAP only) •Description
0 = disabled (default), 1 = enabled. |
SynchronizationMethod |
Integer |
Defines how UMS synchronizes users and groups with LDAP. 0 = no synchronization (default), 1 = users in groups found in both LDAP and UMS are synchronized with a schedule defined in SynchronizationScheduleStartDate and SyncronizationSchedulerInterval keys, 2 = users in groups found in both LDAP and UMS are synchronized similarly as with SyncronizationMethod=1, but obsolete users (i.e. users not found in LDAP anymore) are moved to a group defined by SynchronizationDeletedUsersGroup setting, and in the case the group is not defined, those users are deleted, 3 = users in groups found in both LDAP and UMS are synchronized similarly as with SyncronizationMethod=1, but obsolete users that are re-added in LDAP are moved from the group defined by SynchronizationDeletedUsersGroup setting to a normal group.
WARNING: In the case synchronization is used, changing groups in LDAP may result in users and related data (actions, element owners) being removed from QPR UMS. |
SynchronizationScheduleStartDate |
Datetime (yyyy-MM-dd hh:mm) |
Defines the initial start time of group synchronization which takes place if SynchronizationMethod=1 or SynchronizationMethod=2. |
SynchronizationScheduleInterval |
String (dd:hh:mm) |
Defines the interval between group synchronization operations starting from the time defined in SynchronizationScheduleStartDate. The correct format for this setting is a colon-separated list of days, hours and minutes. For example, if SynchronizationScheduleStartDate=2008-15-01 01:15 and SynchronizationScheduleInterval=01:00:00, the first synchronization takes place on 2008-15-01 01:15 and subsequent synchronizations are done every day at 01:15. |
SynchronizationExcludedGroups |
String |
A comma-separated list of groups which are excluded from synchronization which takes place if SynchronizationMethod=1 or SynchronizationMethod=2. In the case a user belongs to any of the groups listed in this setting, the synchronization does not affect that user. Note that the group name must be contained in double quotes in the case the name contains spaces. |
SynchronizationDeletedUsersGroup |
String |
Name of the group where users not found in LDAP are moved during synchronization (occurs if SynchronizationMethod=2). If this is empty, the affected users are deleted from QPR UMS. By default this is "#Deleted users#". |
EnableClientAuthenticationUsingAccessToken |
Integer |
Defines whether QPR Client application can be opened from QPR Portal for the current QPR Portal user. 0 = disabled (default), 1 = enabled. |
[UMS Log, PGS Log, PGP Log, SCS Log, SCP Log, WAS Log, WS Log, and Portal Log] Sections
Field |
Field Type |
Description |
---|---|---|
Threshold |
Integer |
Defines the log trace mode. 255 = normal trace mode, 6577 = full trace mode. |
MaxSize |
Integer |
The maximum size of the log file in kilobytes. After the maximum size is searched, the old entries are overwritten starting from the oldest entry. |
Enabled |
Integer |
Defines whether logging is on. 0 = no, 1 = yes. |
ThreadPriority |
Integer |
Defines the thread priority for the log writing process. If you wish to fine-tune your Web Application Server performance, you can modify this value. Valid values are 0-6, 0 being normal and 6 is the highest value. |
AuditTrailTrace |
Integer |
This option can be used only in the SCS Log section. Defines whether audit logging is enabled. 0 = no, 1 = yes. |
PerformanceLog |
Integer |
Defines whether a log file about the server's performance is maintained. This option can be used only in the UMS Log, the PGS Log, the SCS Log, and the WAS Log (even though the field is available in the other log sections too). The possible values are: 0 = no performance logging, 1 = performance logging enabled, ending of client operations are logged, and 2 = performance logging enabled, starting and ending of client operations are logged. The performance logs are stored under the Logs folder with the following file names depending on for which servers the logging is enabled: WASPerfLog.txt,BizArchServerPerformanceLog.txt, MetricsServerPerformanceLog.txt, and FoundationServerPerformanceLog.txt.
The logs write also information about the duration of the operation. There are labels for different timeframes to make monitoring of log files easier. The labels are as follows:
TIME_0T = the execution time was 0 ms TIME_1T = the execution time was 1-9 ms TIME_10T = the execution time was 10-99 ms TIME_100T = the execution time was 100-999 ms TIME_1000T = the execution time was 1.000-9.999 ms TIME_10000T = the execution time was 10.000-99.999 ms TIME_100000T = the execution time was 100.000-999.999 ms TIME_1000000T = the execution time was 1.000.000-9.999.999 ms (about 20 minutes - 3 hours) TIME_10000000T = the execution time was 10.000.000-99.999.999 ms (about 3 -30 hours) TIME_100000000T = the execution time was 100.000.000-999.999.999 ms (about more than 30 hours) TIME_NA= execution time could not be determined, error occurred or time was greater than 999.999.999 ms. |
UserRightAuditTrailTrace |
Integer |
This option can be used in the SCS Log, WAS Log, PGS Log, and UMS Log sections (even though the field is available in the other log sections too). Defines whether server user audit logging is enabled for each server separately. 0 = logging is disabled, 1 = basic logging is enabled, 2 = full logging is enabled (the full logging option is available only for UMS Log section). |
DeadlockLog |
Integer |
This option can be used in the UMS Log section. Defines whether browsing the Analysis and Navigator views in QPR Portal causes certain action transaction related entries to be written into the log when full trace logging has been enabled. 0 = action transaction related entries are not written (default), 1 = action transaction related entries are written. |
DebugLogAllWSCalls |
Integer |
This option can be used in the WS Log section. Defines whether all function calls to QPR Web Service Foundation with their parameter values are logged, when full trace logging has been enabled. Useful for troubleshooting purposes, but may cause WSLog.txt to fill up quickly. 0 = No additional debug logging (default), 1 = All function calls to QPR Web Service Foundation with their parameter values are logged to WSLog.txt |
[UMS LDAP] Section
Field |
Field Type |
Description |
---|---|---|
ServerAddress |
String |
Address of the LDAP server. |
SearchBase |
String |
The distinguished name of the entry under which the search is performed on. If left blank, the search starts from the top entry. |
UserName |
String |
The distinguished name of the person entry used if the LDAP component logs in to the LDAP server with a username/password combination. If left blank, an anonymous login is used. |
Password |
String |
The userPassword attribute of the person entry used if the LDAP component logs in to the LDAP server with a username/password combination. Leave this blank if an anonymous login is used. The user password is stored encrypted. |
AlwaysUseSecureConnection |
Integer |
If this is 0, then an insecure connection is used between the LDAP component and LDAP server for all other functions than Authenticate. |
AuthenticateViaSecureConnection |
Integer |
If both this and AlwaysUseSecureConnection are 0, then Authentication is done with insecure connection. If AlwaysUseSecureConnection is 1, then this setting has no effect (i.e. then it automatically defaults to 1). |
ActiveSettingGroup |
Integer |
Identification of the currently active setting group. Each setting group contains technical settings to be adjusted to the LDAP directory used. |
AllowConcurrentCalls |
Integer |
This setting defines whether LDAP calls can be performed concurrently instead of being serialized. 0 = serialized calls, 1 = concurrent calls. In the case this key is missing, 0 is used as a default value. |
[UMS LDAP Setting Groups] Section
Field |
Field Type |
Description |
---|---|---|
<1...N> |
String |
Name of the settings group, numbered in a consecutive order. The settings of the setting groups can be defined in [UMS LDAP <MyNewSetting>] sections similarly as in [UMS LDAP Standard] and [UMS LDAP Active Directory] sections. |
[UMS LDAP Standard] and [UMS LDAP Active Directory] Sections
Field |
Field Type |
Description |
---|---|---|
DistinguishedNameAttribute |
String |
Attribute name of an LDAP directory entry, which identifies the DN of the entry. |
CommonNameAttribute |
String |
Attribute name of an LDAP directory entry, which identifies the full user name of the entry. When importing users, this is mapped as the user name of the user. |
EmailAttribute |
String |
Attribute name of an LDAP directory entry, which identifies the email address of the entry. When importing users, this is mapped as the email address of the user. |
MemberAttribute |
String |
Attribute name of an LDAP directory entry. This attribute identifies one group member. An entry having this attribute represents some kind of group. The entry has one (MemberAttribute, DN of the member) pair for each of its members. |
DescriptionAttribute |
String |
Attribute name of an LDAP directory entry, which identifies the description of the entry. When importing users, this is mapped as the description of the user. |
PersonFullNameAttribute |
String |
Attribute name of an LDAP directory entry, which identifies the full name of the user. If the value is not defined explicitly, the default value is used, i.e. the value set to CommonNameAttribute. If the value is defined, it overrides the default value. |
UIDAttributeName |
String |
Attribute name of an LDAP directory entry, which identifies the user id (login name) of the entry. It is mapped as such when importing users. |
UseADGlobalCatalog |
Integer |
Defines whether Global Catalog searching for Active Directory objects in any domain in the forest is enabled. 1 = enabled, 0 = disabled (default). |
FilterForSearchingGroups |
String |
Groups are retrieved from the LDAP directory using this search filter. |
FilterForSearchingPersons |
String |
Users are retrieved from the LDAP directory using this search filter. |
GroupSearchBase |
String |
The distinguished name of the entry under which the search is performed on. Used when searching for groups in LDAP. If set to <Default>, the value in SearchBase is used. |
[WAS Messages] Section
Field |
Field Type |
Description |
---|---|---|
HTMLErrorTemplate |
String |
Template for a WAS error message. |
HTMLCannotReadRequest |
String |
Template for WAS error message shown when a request cannot be read. |
HTMLCannotProcessRequest |
String |
Template for WAS error message shown when a request cannot be processed. |
HTMLTooManyConnections |
String |
Template for WAS error message shown if there are too many connections to WAS open at the moment. |
HTMLStartupNotComplete |
String |
Template for WAS error message shown if the startup process has not been completed yet. |
[SCS Settings] Section
Field |
Field Type |
Description |
---|---|---|
IWAEnable |
Integer |
Defines whether Integrated Windows Authentication (IWA) is enabled for QPR Metrics client. 0 = false, 1 = true. |
MaxMemoryUsage |
Integer |
Defines the maximum amount of memory in megabytes that QPR Metrics Server is allowed to use before non-critical caches are cleared. Setting this to 0 disables the limit. Setting this to a too low value may lead into Metrics server continuously trying to release more memory than is possible, potentially causing performance issues. |
SchedulerEnable |
Integer |
Defines whether scheduled integration tasks are enabled. 0 = scheduled integration tasks are disabled, 1 = scheduled integration tasks are enabled (default). |
ReleaseLocksInterval |
Integer |
Defines the interval, in minutes, for checking and releasing invalid locks in QPR Metrics models. Default value is 0 = scheduled checking and releasing is not done. |
[SCS Reports] Section
Field |
Field Type |
Description |
---|---|---|
MaintainHierarchies |
Integer |
Enabling this property will accelerate report generating, but it will also slow QPR Metrics Server down a little bit. 0 = no, 1 = yes. |
MaintainHierarchiesRecent |
Integer |
Enabling this property will accelerate report generating, but it will also slow QPR Metrics Server down a little bit. 0 = no, 1 = yes. |
[SCS Thread Priorities] Section
Field |
Field Type |
Description |
---|---|---|
ClientManagerThreadPriority |
Integer |
Thread priority of the Client Manager for Windows. |
DBManagerThreadPriority |
Integer |
Thread priority of the Database Manager for Windows. |
SchedulerThreadPriority |
Integer |
Thread priority of the Scheduler for Windows. |
SocketAcceptThreadPriority |
Integer |
Thread priority of the Socket Accept for Windows. |
[SCS Intermodel References] Section
Field |
Field Type |
Description |
---|---|---|
RefreshStartDate |
String |
Starting date for refreshing intermodel references. Accepted date format is "<d>.<m>.<yyyy>", where <d> is day, <m> month, and <yyyy> year with four digits. |
RefreshStartTime |
String |
Starting time for refreshing intermodel references. Accepted time format is "<hh>:<mm>:<ss>", where <hh> is hours with two digits, <mm> minutes with two digits, and <ss> seconds with two digits. |
RefreshInterval |
Integer |
Determines the refreshing interval in the precision of 5 minutes. The length (in minutes) of the actual interval can be calculated using the following formula: Refresh interval * 5. |
RemoveUnusedReplicaSchemaObjectsRegularly |
Integer |
Defines whether unused replica model objects are scanned and removed regularly. Unused replica model objects are for instance replica element's value settings, which have been duplicated to the target model with earlier versions of QPR ScoreCard but which are unused now. 0 = disabled (default), 1 = enabled. |
[SCS Remote Model Export] Section
Field |
Field Type |
Description |
---|---|---|
RepeatAttempts |
Integer |
Controls remote model updating. 0 = disable updating remote model. 1 = enable updating remote model. |
RepeatInterval |
Integer |
Determines how often model will be updated. The value is in seconds. |
RepeatTime |
Integer |
Determines for how long the QPR Metrics Server will try to update model. The value is in minutes. |
[SCS Value in Range] Section
Field |
Field Type |
Description |
---|---|---|
Title |
String |
Title of the e-mail notification sent when a value enters a certain range in QPR Metrics. |
Text |
String |
Notification text. In the case you need to add linefeeds, use the <NL> tag. |
[SCS Value Missing] Section
Field |
Field Type |
Description |
---|---|---|
Title |
String |
Title of the e-mail notification about a value missing in QPR Metrics. |
Text |
String |
Notification text. In the case you need to add linefeeds, use the <NL> tag. |
[SCS Value Changed] Section
Field |
Field Type |
Description |
---|---|---|
Title |
String |
Title of the e-mail notification sent when a certain value is changed in QPR Metrics. |
Text |
String |
Notification text. In the case you need to add linefeeds, use the <NL> tag. |
[SCS Calculation] Section
Field |
Field Type |
Description |
---|---|---|
CalculationEnabledByDefault |
Integer |
Defines whether calculation is enabled for models by default. In the case calculation is disabled, values can still be input, but formulas are not calculated automatically. 0 = no, 1 = yes (default). |
CalculationEnabledFor |
String |
A comma-separated list of names or IDs of models for which calculation should be enabled in the case calculation is disabled by default. Model names in the list must be in double quotes, and in the case any model name contains double quotes, the quotes inside the name must be preceded by another double quotes. It is also advisable to put the whole list inside double quotes to ensure that the quotes are parsed properly. |
CalculationDisabledFor |
String |
A comma-separated list of names or IDs of models for which calculation should be disabled in the case calculation is enabled by default. Model names in the list must be in double quotes, and in the case any model name contains double quotes, the quotes inside the name must be preceded by another double quotes. It is also advisable to put the whole list inside double quotes to ensure that the quotes are parsed properly. |
CalculatorThreads |
Integer |
Defines how many threads are used for QPR Metrics model calculation. If this value is changed, calculations which are not dependent on the results of other calculations are done in parallel in the defined amount of threads. The default value is 0, and in this case computers with a single processor use one thread for the calculation and computers with multiple processors use two threads. In the case there are less than 100 values to calculate, only one thread is used regardless of this setting. |
ModelRecalculationPeriodChunkSize |
Integer |
Defines how many values (every single value under every period and series in a measure counts as a separate value) are included in one calculation transaction during model recalculation. The default value is 1200000, and reducing this value consumes less memory during recalculation, but makes the calculation slower and vice versa. Note that modifying this value is usually unnecessary unless models are extensively large. |
ThresholdForFullModelRecalculation |
Integer |
Defines a threshold for triggering full model recalculation. The threshold is the amount of invalidated measure values after which instant invalidation of measure values is stopped and full model recalculation is automatically done after the operation which caused the measure value invalidation is completed. This option can be used to address situations where the amount of invalidated measure values causes memory consumption issues on the server. By default this is 0, which makes the option to use the value of the ModelRecalculationPeriodChunkSize key as the threshold. |
TimeDependentFormulaRecalculationMode |
Integer |
Defines the way QPR Metrics Server recalculates time dependent formulas (i.e. formulas whose value depends on the current time, for example formulas that use the Date function) in models. Possible values are: 0 = Time dependent formulas are never calculated automatically, 1 = Time dependent formulas are calculated automatically only when the date is changed, 2 = Time dependent formulas are calculated automatically when the date changes and when QPR Metrics Server loads the model into memory during server startup (default). |
[SCS Scheduler] Section
Field |
Field Type |
Description |
---|---|---|
DeletedObjectsTimeout |
Integer |
The amount of seconds after which deleted objects are finally removed from the server. This should always be several minutes to avoid errors. |
[PGS Model] Section
Field |
Field Type |
Description |
---|---|---|
DaysInCache |
Integer |
Defines the amount of days unused models are stored in cache memory before they are removed. |
OnDisk |
Integer |
Defines whether embedded information items exceeding the size defined in the Threshold setting are cached on disk (1, true) or on memory (0, false). 1 = true, 0 = false. |
Threshold |
Integer |
The maximum size for embedded information items (in kilobytes) that are stored in the memory. If the size is exceeded, the attachments are stored in hard disk. |
MaxMemoryUsage |
Integer |
Maximum memory usage in megabytes. Note that this value can be exceeded temporarily. Setting this to 0 disables the limit. |
ClearDiskCacheAtStartup |
Integer |
Defines whether model cache on disk is cleared at startup. In the case this is 0 (false), old cached files are utilized in the case their contents are up to date, thus resulting in a faster startup. 0 = false (default), 1 = true. |
LoadModelsAtStartup |
Integer |
Defines how models are loaded into the QPR Web Application Server at startup.
0 = Base models and published models that do not have an existing cache file are loaded from database and written to cache. After this models are dropped from the memory.
1 = Base models and published models that do not have an existing cache file are loaded from database and written to cache. Models are dropped from the memory in the case the memory limit is exceeded.
2 = Base models that do not have an existing cache file are loaded from database and written to cache.
3 = No models are loaded from the database. |
[PGS Settings] Section
Field |
Field Type |
Description |
---|---|---|
AuditTrailTrace |
Integer |
Defines whether audit logging is enabled. 0 = no, 1 = yes. |
IWAEnable |
Integer |
Defines whether Integrated Windows Authentication (IWA) is enabled for QPR Modeling Client. 0 = false, 1 = true. |
PortalUpdateMethod |
Integer |
Defines the update method between QPR BizArchitecture Server and QPR Portal. 0 = Immediate, 1 = Scheduled. Default value is 0. If scheduling is used, PortalUpdateScheduleInterval must be defined. Scheduling applies to the following model operations: Save (not Save As), Replace, Rename, and Move (to another folder). However, in the case a new published model is created, models in Portal are updated at the moment the new model is saved. This setting can be used for example to schedule model update operations to occur outside the peak hours in environments with large models. |
PortalUpdateScheduleStartDate |
Datetime (dd.MM.yyyy hh:mm:ss) |
Defines the initial start time of the updating between QPR BizArchitecture Server and QPR Portal if PortalUpdateMethod = 1. If PortalUpdateScheduleStartDate is not defined, the server start date/time is used. |
PortalUpdateScheduleInterval |
String (dd:hh:mm) |
Defines the interval between the updating of QPR BizArchitecture Server and QPR Portal starting from the time defined in PortalUpdateScheduleStartDate. Only one interval is supported. The correct format for this setting is a colon-separated list of days, hours and minutes. For example, if PortalUpdateScheduleStartDate = 12.12.2008 01:30:00 and PortalUpdateScheduleInterval = 01:00:00, the first update takes place on 12.12.2008 01:30 and subsequent updates are done every day at 01:30. |
[PGP Settings] Section
Field |
Field Type |
Description |
---|---|---|
ModelsInMemory |
String |
A comma-separated list of model IDs of models that are loaded to memory when QPR Web Application Server is started. The list is maintained by QPR Web Application Server and contains the models that were in memory when QPR Web Application Server was last shut down. |
LoadModelsToMemory |
String |
A comma-separated list of model IDs of models that are loaded to memory when QPR Web Application Server is started. This setting is maintained only manually, and if the value is empty or missing, the list is considered to be empty. |
LoadAllModelsAtStartup |
Integer |
Defines whether all models are loaded into memory when QPR Web Application Server is started as well as right after the model has changed. With different options this setting either overrides or utilizes the ModelsInMemory and LoadModelsToMemory keys. The options are as follows: 0 = No models are read into memory at startup. 1 = All models are read into memory at startup. 2 = Models listed in the ModelsInMemory key are read into memory at startup, 3= Models listed in the LoadModelsToMemory key are read into memory, 4 = Models listed in ModelsInMemory AND LoadModelsToMemory key are read into memory at startup. For standalone installation the default value is 1, but for other installations the default value is 4. |
LoadModelsFromCacheFiles |
Integer |
Defines whether models in file cache are used during QPR Web Application Server startup in the case the model exists in cache and it is up to date. If the model is not cached or it is not up to date, the model is read from the QPR BizArchitecture Server. 0 = no, 1 = yes. |
HorizontalAttributeList |
Integer |
Defines whether custom attribute types are displayed in the diagram as a horizontal attribute list. This setting is useful for flow charts created in QPR 7.5 since the visualization mode has changed to vertical after that. 1 = show horizontal attribute list, 0 = show vertical attribute list (default). Note that in contrast to the similarly named key in [PGC Settings] section, this is a global key affecting all users of the corresponding instance of QPR Web Application Server, and therefore this should reside in QPR_Servers.ini located in the C:\ProgramData\QPR Software\QPR 2019\2019.1\Servers\Settings\<possible instance folder> folder. |
NoInfoIconForDefaultInfoItem |
Integer |
Defines whether the information item icon is shown in the middle of an information flow, when only one information item is linked to the flow. 0 = icon is shown (default), 1 = icon is not shown. |
[WAS PG Publishing] Section
Field |
Field Type |
Description |
---|---|---|
DaysInRecentList |
Integer |
The maximum number of days for which an event is displayed in the "What's New" page in QPR Portal |
DefaultZoomSize |
String |
Default zoom size used for diagrams. The value should be included also in the ZoomSizes entry. |
ElementTypes |
Binary |
Binary entry that is used to save element type specific web publishing options. |
FlowchartPictureGeneration |
Integer |
Tells when the diagram images are generated (0 = on model load, 1 = when diagram is needed for the first time). |
FlowchartPictureStorage |
Integer |
The storage place of diagram images (0 = memory, 1 = hard disk) |
FooterItemCount |
Integer |
Number of footer items added into generated diagram pictures. |
GraphicsLocation |
String |
The location of the web contents when HTML export is used from ProcessGuide. |
HeaderItemCount |
Integer |
Number of header items added into generated diagram pictures. |
MaxFCSize |
Integer |
Defines the maximum size of diagrams in pixels. Default value is 500000. If the value is 0, the maximum size will not be used. If the maximum size is exceeded, the diagram will be zoomed to the defined maximum size. Note that this setting has an effect on the image size in QPR Portal Process Maps view printing. |
MinRecentEntries |
Integer |
Minimum amount of entries to show at the "What's New" page in QPR Portal. |
MaxRecentEntries |
Integer |
Maximum amount of entries to show at the "What's New" page in QPR Portal. |
MeasureHotSpot |
Integer |
Show measure value hot spot (0 = no, 1 = yes) |
ModelElements |
Binary |
Binary entry that tells what model element information is shown in details window. See discussion below. |
OldModelUsage |
Integer |
Allow the usage of old model version when loading the new version. (0 = no, 1 = yes) |
ShowHierarchy |
Integer |
The hierarchies shown in navigator. Bit 5: diagram hierarchy, bit 4: Organization hierarchy, bit 3: notes hierarchy, bit 2: resource groups hierarchy, bit 1: resource pools hierarchy, bit 0: information hierarchy |
ShowFlowchartLinkInDetailsLinks |
Integer |
Show link to diagram after every diagram object shown in any detail view (0 = no, 1 = yes). |
ShowTransferTypeIcons |
Integer |
Show transfer type icons in the diagram (0 = no, 1 = yes). |
Version |
String |
Version of the PG whose initialization file specifications this file uses. |
ViewTemplateDirectory |
String |
The directory from which the layouts are fetched |
WebPageNameAttribute |
String |
The name of the custom attribute that will be used as filename for generated HTML export pages and name of the view in dynamic web publishing. If WebPageNameAttribute=Name, then object's name will be used. |
ZoomSizes |
String |
List of comma separated zoom sizes shown in the published web pages (numbers should be between 10 and 200). |
[SCP Settings] Section
Field |
Field Type |
Description |
---|---|---|
Cache |
Integer |
Defines whether browser cache is in use. 0 = no, 1 = yes. |
MinRecent |
Integer |
Minimum amount of entries to show in the What's New page in Portal. |
MaxRecent |
Integer |
Maximum amount of entries to show in the What's New page in Portal. |
RecentDays |
Integer |
The maximum amount of days included in the What's New page listing. |
EnableGraphicalViews |
Integer |
Defines whether graphical Scorecard views are enabled. 0 = no, 1 = yes. The element graph layout of the element view is also hidden when this is set to 0. |
RemoveGeneratedGraphicsFiles |
Integer |
Defines whether old *.svg files are removed at startup. 0 = no, 1 = yes. |
GraphicalViewer |
Integer |
Defines which technology is used for graphical views. 0 = SVG (default) 3, 3 = Microsoft Silverlight. |
UseBufferedValueInput |
Integer |
Defines whether value input is allowed when the model is reserved e.g. for recalculation. In the case buffered input is allowed, values can be input when the model is reserved, but the new values are stored in a temporary buffer and applied to the model once the reservation is freed. 0 = disabled (default), 1 = enabled. |
WaitForValueUpdate |
Integer |
Defines the maximum amount of seconds to wait for a buffered value update to finish in QPR Portal. Default is 6 seconds. |
UseBitmapTextInGraphicalViews |
Integer |
Defines whether SVG/Silverlight views display text as bitmap graphics instead of using text capabilities of SVG and Silverlight. This setting is useful e.g. in situations where some language-specific features such as joining characters based on their context doesn't work properly. 0 = disabled (default), 1 = enabled. Note that if this setting is enabled, charts in Element Views are always drawn as PNG images. |
ScorecardHierarchyMode |
Integer |
Defines which scorecards are hidden in the scorecard hierarchy view in QPR Portal when a user doesn't have enough rights. 0 = No scorecards are hidden (default), 1 = Scorecards for which the user has no rights are hidden from the hierarchy, after which the hierarchy is flattened, 2 = If a scorecard for which the user has no rights doesn't have any child scorecards or the user doesn't have rights for all of its children, that scorecard and its children are hidden from the hierarchy. All other scorecards are visible, even if the user had no rights for them, 3 = Scorecards for which the user has no rights and all its children are hidden from the hierarchy, no matter if the user had rights for some of the children, 4 = Scorecards for which the user has no rights are hidden from the hierarchy and their children are attached under the deepest prevailing parent. If a user has no rights for the parents, the children are moved to the top level. |
ScorecardNameMode |
Integer |
Defines how those scorecards for which the user has no rights but still remain visible in the scorecard hierarchy in QPR Portal after ScorecardHierarchyMode is applied are handled. 0 = The names of the scorecards for which the user has no rights are shown, but the links are not clickable (default), 1 = The names of the scorecards for which the user has no rights are not shown. Instead, their names are displayed as "Access Denied". |
EnableHyperlinksForTextValues |
Integer |
Defines whether hyperlinks are created automatically in QPR Portal from URLs entered as text type measure values. 0 = Hyperlinks are not created automatically (default), 1 = Hyperlinks are created automatically. |
RetainViewSettings |
Integer |
Defines whether the selected view settings name is stored when browsing in QPR Portal. When the name is stored and a new dashboard/hierarchy view is opened, a check is made if view settings with the same name as the stored one exists in the opened view. If they exist, then those view settings are selected, otherwise the default view settings are used. 0 = View settings name is not stored (default), 1 = View settings name is stored. |
EnableLanguageSpecificContent |
Boolean |
Defines whether multilingual modeling is in use in QPR Metrics content in QPR Portal. 0 = multilingual modeling is not in use (default), 1 = multilingual content is in use. |
[Portal Settings] Section
Field |
Field Type |
Description |
---|---|---|
PwdChanging |
Integer |
Allow password changing in Portal. 0 = no, 1 = yes. |
UseDefaultHomeView |
Integer |
Defines whether the default home view is used. 0 = custom, 1 = default. |
CustomHomeURL |
String |
Defines the URL of the custom home view if the default view is not used. |
AllowUsersToChangeHomeView |
Integer |
Allow users to customize the view shown in my contents/home. 0 = no, 1 = yes. |
DefaultView |
String |
The tab that is selected by default when logging into the Portal. |
AllowUsersToChangeDefaultTab |
Integer |
Allow users to customize the default tab selected when user logs into the QPR Portal. 0 = no, 1 = yes. |
AllowUsersToChangeDefaultPages |
Integer |
Allow user to customize the default views opened when some tab has been selected. |
CustomCategoryLabelText |
String |
If not empty, determines the text used as label for category attributes in actions. |
ShowViewTitles |
Integer |
Defines whether the Portal windows display the view titles (e.g. Add Action) in the browser window's title bar. 0 = no, 1 = yes. |
PublicBookmarkPositioning |
Integer |
Defines whether public bookmarks are shown after or before the user's own bookmarks. 0 = own - public, 1 = public - own. |
DefaultActionType |
String |
Defines the default type of action. The default type is the type that is initially selected in the action editor when creating a new action. |
DefaultPublishTo |
String |
Defines the default option that is selected in the "Publish to" section when creating a new action. Possible values are: Users of linked elements, Me only, Everyone, and Selected users. |
DefaultNotifyViaEmail |
Integer |
Defines whether the "Notify via e-mail" option is checked by default in the action editor. 0 = no, 1 = yes. |
DefaultAttachmentType |
Integer |
Defines the default type of attachments in the attachment editor. 0 = linked attachments, 1 = embedded attachments. |
EnableBookmarksForViewUsers |
Integer |
Defines whether users with view rights only can create bookmarks in QPR Portal. 0 = disabled, 1 = enabled. |
MaxExportToOfficeSlideCount |
Integer |
Defines the maximum amount of slides that can be added in PowerPoint Export. 0 = disabled (i.e. there is no maximum limit set). Default value is 800. |
MaxSearchResultCount |
Integer |
Defines the maximum number of Portal search results. Default value is 100. |
[WS Settings] Section
Field |
Field Type |
Description |
---|---|---|
SearchServerLocation |
String |
URL of the MS SharePoint Site that contains QPR Search Central (a separate add-on) pages. |
AllowPasswordChanges |
Integer |
Defines whether changing passwords via the QPR Web Service is allowed. 0 = password changing isn't allowed, 1 = password changing is allowed. |
[SCS Log] Section
See UMS Log
[SCP Log] Section
See UMS Log
[PGS Log] Section
See UMS Log
[PGP Log] Section
See UMS Log
[WAS Log] Section
See UMS Log
[WS Log] Section
See UMS Log
[WAS Plugins] Section
Field |
Field Type |
Description |
---|---|---|
ModelingPlugin |
Integer |
Defines whether the Modeling plugin is enabled, i.e. if the "Processes" tab is available in QPR Portal. 0 = disabled, 1 = enabled. |
MetricsPlugin |
Integer |
Defines whether the Metrics plugin is enabled, i.e. if the "Scorecards" tab is available in QPR Portal. 0 = disabled, 1 = enabled. |
[Portal Default Views]
Field |
Field Type |
Description |
---|---|---|
scorecards |
String |
The default view for the Scorecards tab. |
actions |
String |
The default view for the Actions tab. |
processes |
String |
The default view for the Processes tab. |
mycontents |
String |
The default view for the My Contents tab. |