QPR Knowledge Base

Appendix D: QPRSettings.dat File

Hide Navigation Pane

Appendix D: QPRSettings.dat File

Previous topic Next topic No expanding text in this topic  

Appendix D: QPRSettings.dat File

Previous topic Next topic JavaScript is required for expanding text Mail us feedback on this topic!  

Comments (...)

This chapter describes the contents of the qprsettings.dat file located in the script installation folder. Note that when using qpr.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.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.

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.

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 CGI Binary Logging

Enabling logging for CGI binary (qpr.exe) operations is usable for temporary troubleshooting. To enable logging, do the following:

1.Copy the log.dll file from <QPR 8 installation root>\Utilities folder to the CGI binary folder
2.Change the value of the LOG_ENABLE key to 1.

 

Note that generating the log files requires that the IIS/Apache process user has write access to the CGI binary folder. Also note that logging should be used only temporarily and in the case there are persistent problems, please contact QPR Customer Care.

Comments (...)