QPR Knowledge Base 2017.1

Appendix D: QPRSettings.dat File

Appendix D: QPRSettings.dat File

Previous topic Next topic No directory for this topic  

Appendix D: QPRSettings.dat File

Previous topic Next topic Topic directory requires JavaScript Mail us feedback on this topic!  

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.

 

 

 

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 2017 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.