Note: It is not recommended to change any of these settings without prior consultation with PKS Support.

RippleDown/rippledown/properties/database.properties

Setting Description Example
DATA_DIR The location of RippleDown databases. This should be set to a local disk for reliability and performance reasons. DATA_DIR= C:/Program Files/PKS/RippleDown/projects/
BACKUP_DIR During housekeeping (once a day), the RippleDown databases are closed and copied to an alternate directory where they can be backed up. The location of the backup directory is given by the BACKUP_DIR setting. This may be set to a network drive if required. If no setting is provided, the setting shown in the  example will be used. BACKUP_DIR= C:/Program Files/PKS/RippleDown/projects/backup

 

RippleDown/rippledown/properties/server.properties

Setting Description Example
CUSTOMER_ID The name of your site. This is used for to identify support emails. CUSTOMER_ID=ACT
BACKUP_TIME The time when the server will commence its housekeeping tasks each day. Depending on the performance of the server computer, and the number of databases, this process may take up to 1 hour. BACKUP_TIME= 02:00
LIS_PROXY_PAUSE For a GE Ultra interface only. This specifies a pause in millisecs after the communications input directory is read. The reason for the pause is to reduce the  frequency of directory calls made to a Samba mount used for Ultra / RippleDown file sharing in order to reduce the Samba processing load on the Unix system. LIS_PROXY_PAUSE= 2000
SERVER_INFO_SHELF

_LIFE

When a client application polls the server for project  status information, this setting determines whether the status information needs to be refreshed or not. It will be refreshed if it is older than this timeout (in millisecs). SERVER_INFO_SHELF_LIFE= 10000
HEARTBEAT_PERIOD The time in millisecs between heartbeat emails sent from the server to the PKS support facility. Normally set to about 15 minutes. HEARTBEAT_PERIOD= 1000000
ULTRA_LIB_FORMAT For a GE Ultra interface only. This is a template indicating the format of library code messages to Ultra. ULTRA_LIB_FORMAT= |1|1|30/10/97||LABWIZARD||||||||Short String|||*|*||||
INTERFACE_TYPE The type of communications  interface used between the LIS and RippleDown. This is set at the time of installation and must not be changed. The options are: hl7, ultra, ultra_reporting, bmd_hl7, bmd_dicom_hologic, query_hl7, socket, phadia, INTERFACE_TYPE= hl7
WEB_SERVICES_

ADDRESS

The phadia interface uses Web Services (SOAP). This setting defines the Internet address where the service can be accessed. If no setting is supplied, the default address will be set to “http://localhost:8090/Interpret?WSDL“. If the address that is specified cannot be accessed by the RippleDown server, the server will not start. WEB_SERVICES_ADDRESS= http://192.168.1.114:80/Interpret?WSDL
LOCK_PORT An optional setting defining the TCP port used by the server to ensure that only one instance of the server can be started on the one computer. The default value is shown in the example. LOCK_PORT=32111
IMAGE_PROFILE_PORT An optional setting defining the TCP port used by an ImageLink client to listen for requests by the Validator or Auditor to display the request form. A value of -1 means this facility is not enabled. IMAGE_PROFILE_PORT=2001
COMPACT_DATABASES_IN_

HOUSEKEEPING

An optional setting determining whether databases are compacted and repaired during housekeeping. The default value is true. COMPACT_DATABASES_IN_

HOUSEKEEPING= true.

CLEANUP_CASE_ARCHIVE An optional setting determining whether case archives that are older than 30 days should be deleted (in order to conserve space). The default value is false. CLEANUP_CASE_ARCHIVE=false
AUTO_COMMIT_PERIOD An optional setting determining the time in millisecs between database commits of all outstanding transactions. The default value is about 15 minutes. AUTO_COMMIT_PERIOD=1000000
FOLDER_FOR_LIST_ATTRIBUTE

_UPDATE_FILES

An optional setting determining the directory in which to place text files that are used to automatically update List Attributes. See Editing a list attribute

If no setting is supplied, the default folder is DATA_DIR/lists where DATA_DIR is as defined in database.properties, e.g. C:/Program Files/PKS/RippleDown/projects/lists

FOLDER_FOR_LIST_ATTRIBUTE_UPDATE_FILES=

z:/pks/lists

 

RippleDown/CommunicatorSettings.txt

CommunicatorAddress For TCP/IP interfaces only. The address on which the server will listen for connection from the LIS in order to receive cases (i.e. request for interpretation messages). This is normally the IP address of the RippleDown server. CommunicatorAddress=127.0.0.1
CommunicatorPort For TCP/IP interfaces only. The port(s) on which the server will listen for connection from the LIS.

Multiple ports may be defined, separated by a colon as in the example. This allows several LIS’ to connect to RippleDown simultaneously. If there are multiple CommunicatorPorts corresponding to serveral connections to RippleDown, there should be multiple LisAddress and multiple LisPort values also. See Configuring RippleDown for multiple interfaces and Configuring the Auditor Interface

CommunicatorPort=5678

CommunicatorPort=5678 : 6789

LisAddress For TCP/IP interfaces only. The address(es) on which the LIS will listen for connection from the RippleDown server in order to receive interpretation messages.

Multiple ports may be defined, separated by a colon as in the example

LisAddress=127.0.0.1

LisAddress=127.0.0.1 : 127.0.0.2

LisPort For TCP/IP interfaces only. The port(s) on which the LIS will listen for connection from the RippleDown server.

Multiple ports may be defined, separated by a colon as in the example

LisPort=5679

LisPort=5679 : 5680

MaximumResends For TCP/IP interfaces only. The maximum number of times the server will attempt to send a NAK’d interpretation message to the LIS before logging an error and moving the message to the error directory. MaximumResends=3
Communicator_pk_in For file-based interfaces only. The directory from which the server will read case files (i.e. request for interpretation files) written by the LIS. Communicator_pk_in=C:LabWizcommrequests
Communicator_pk_out For file-based interfaces only. The directory from which the LIS will read interpretation files written by the server. Communicator_pk_out=C:LabWizcomminterps
Communicator_pk_rej For file-based interfaces only. The directory from which the server will read rejected case files written by the LIS. These are cases where the interpretation was changed by a reviewer using the LIS validation facilities. Communicator_pk_rej=C:LabWizcommupdates
Communicator_view For Ultra file-based interfaces only. The directory from which the LIS will read *.view files written by the server. Communicator_view=C:LabWizcommview
SocketTimeout For TCP/IP interfaces only. The send timeout in millisecs. SocketTimeout=180000
ReceiverSocketTimeout For TCP/IP interfaces only. The receive timeout in millisecs. ReceiverSocketTimeout=180000