This chapter describes the contents of the qprsettings.dat file located in the script installation folder. Note that when using QPR.ISAPI.dll with Microsoft IIS, restarting only QPR Web Application Server is not sufficient to get qprsettings.dat changes into use, but you also need to restart IIS e.g. by running iisreset.
The following settings can be defined in the qprsettings.dat file:
Key |
Type |
Description |
---|---|---|
HOST_ADDR |
String |
TCP/IP address of the QPR Web Application Server computer. |
HOST_PORT |
Integer |
Socket port number of the QPR Web Application Server. |
MAX_UPLOADED_FILE_LENGTH |
Integer |
The maximum allowed size of uploaded files in bytes. |
MSG_PAGE_HEADER |
String |
This is the text that is shown in the error message window title. Note also that this parameter has the start tags for the created error page. |
MSG_CONNECTION_FAILED |
String |
This is the message that is shown to the user if CGI binary cannot open connection to QPR Web Application Server. |
MSG_REQUEST_FAILED |
String |
This is the message that is shown if the user request could not be processed (invalid format, connection to QPR WAS lost in the middle of processing, etc) |
MSG_RESPONSE_FAILED |
String |
This is the message that is shown if the response to user's request could not be processed (invalid format, illegal data, or some other error) |
MSG_UPLOADED_FILE_TOO_LONG |
String |
This is the message that is shown if the file that is being uploaded into QPR Portal exceeds the limit set for the size of the uploaded files. |
MSG_PAGE_FOOTER |
String |
This shows the possible footer text for the error message. Note that it also has the end tags for the created error message page. |
LOG_ENABLE |
Boolean |
Defines whether logging is enabled for QPR.ISAPI.dll or QPR.CGI.exe. See below for other requirements concerning logging. 1 = yes, 0 = no. |
LOG_THRESHOLD |
Integer |
Defines what entries are written into the log file. If threshold is 255 or below, only errors are logged. With threshold of 511 or below both errors and warnings are logged, and with threshold of 65535 or below, notifications, warnings and errors are logged. |
LOG_MAX_SIZE |
Integer |
Maximum size of the log file in kilobytes. |
LOG_FILE_NAME |
String |
Name of the log file. This value can be either a path + file name or just file name. When only a file name is defined, logs are generated to the same folder as QPR.ISAPI.dll or QPR.CGI.exe. In those cases you may need to reconfigure permissions, i.e. make sure that the account which is configured as the identity for the application pool under which QPR.ISAPI.dll runs has write access to the folder. |
LOG_RESPONSE_ENABLE |
Integer |
Defines whether HTTP headers qpr.exe sends to web server are written to the log. 0 = no headers are written, 1 = headers are written into the cgibinresponse.txt file, 2 = headers and full content are written into the cgibinresponse.txt file. This log file will be written to the same folder as the log file defined in LOG_FILE_NAME setting and same restrictions (i.e. application pool identity) apply also here. |
HOST_OVERRIDE |
String |
Overrides the host set into HTTP headers of the request received by web server and CGI binary (qpr.exe). This is useful e.g. in situations where an authentication system modifies the headers and causes unnecessary redirects to QPR Web Application Server. These kinds of issues can be solved by setting this to the same host as defined in the Script location setting in QPR Configuration Manager. |
HDR_VAR_USR |
String |
Name of the HTTP header variable that stores the login name of an authenticated user when using Single Sign On (SSO) authentication with QPR Portal |
PROTOCOL_OVERRIDE |
String |
Overrides the protocol of the request QPR Web Application Server receives. This setting is useful in preventing redirect loops in environments where the protocol of the original request changes (and as a result no longer matches the protocol configured in the Script location settings in QPR Configuration Manager) before it reaches QPR Web Application Server due to proxy configuration. |
ENABLE_IP_V6 |
Integer |
Defines the Internet Protocol version to be used for the 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. If an IPv6 connection cannot be opened, a connection error is given. |
CONNECTION_POOL_SIZE |
Integer |
Size of the connection pool used for reusing existing socket connections between ISAPI DLL and Web Application Server. After the pool is filled with the number of socket connections defined here, no new connections are created if there is a free connection available in the pool. Proper size is case dependent and should be adjusted to what gives the best performance. |
SECURE_COOKIES |
Integer |
Defines whether the Secure attribute is set for HTTP cookies. 0 = Secure attribute is not set, 1 = Secure attribute is set, 2 = Secure attribute is set if HTTPS connection is in use. |
Enable ISAPI.dll / CGI Binary Logging
Enabling logging for QPR.ISAPI.dll or QPR.CGI operations is usable for temporary troubleshooting. To enable logging, do the following:
1. | Copy the log.dll file from <QPR 2019 installation root>\Utilities folder to the folder where QPR.ISAPI.dll/QPR.CGI.exe is installed. |
2. | Change the value of the LOG_ENABLE key to 1. |
Note that generating the log files requires that the Apache process user or the IIS Application Pool identity has write access to the folder where QPR.ISAPI.dll/QPR.CGI.exe is installed. Also note that logging should be used only temporarily and in the case there are persistent problems, please contact QPR Customer Care.