YSoft SafeQ configuration files

About

This page describes basic information about configuration files of YSoft SafeQ

Unlike previous versions, YSoft SafeQ 5 does not include file system-based configuration. All user/administrator configurable options are stored in the YSoft SafeQ database and configurable only via the YSoft SafeQ Web Interface (see System Settings page).

The SafeQ home directory still includes a conf folder, but available configuration options are very limited and are focused on low-level system configuration instead of user options.

Configuration options:

  • Configuration options are stored in the CML database and are synchronized with other system components.

  • Each configuration option includes description, internal name, default value, and distribution flags (if the options will be distributed to another CML server, to an ORS, or to Terminal Server).

  • Terminal Server always loads the configuration from the central YSoft SafeQ CML server immediately after startup.

  • The ORS downloads the current configuration from the CML after connection and caches the data into a persistent disk cache.

  • Several configuration options (especially Advanced and Expert) require restart of individual components.

CML configuration files

Unlike previous versions, YSoft SafeQ 5 does not include file system-based configuration. All user/administrator configurable options are stored in the YSoft SafeQ database and configurable only via the YSoft SafeQ Web Interface (see System Settings page).

Location and Name

Description

<SAFEQ_DIR>\conf\cmldb.conf

Contains database connection information

<SAFEQ_DIR>\conf\cmldb-cluster.conf

Contains database connection information for sync user

<SAFEQ_DIR>\conf\cmldb-sqdw.conf

Contains database connection information for datawarehouse

<SAFEQ_DIR>\conf\startup.conf

Contains the minimum configuration settings required for the system to start up, such as disk folders, database validation, and system IP addresses.

<SAFEQ_DIR>\conf\modules\safeQ.fwupdate.conf

Contains emergency firmware update configuration for hardware terminals. Normal updates have been moved to the Terminals page of the Web interface.

<SAFEQ_DIR>\tomcat\conf\server.xml

Contains Web Server start-up information.

<SAFEQ_DIR>\terminalserver\TerminalServer.exe.config

Contains information necessary for Terminal Server.

<SAFEQ_DIR>\conf\update.conf

Created manually for changing multiple configuration options in DB. Configuration in update.conf can be different among nodes.

ORS configuration files

Location and Name

Description

<SAFEQ_DIR>\conf\modules\guid.conf

Local GUID settings for current ORS

<SAFEQ_DIR>\conf\modules\ors.conf

ORS settings for connection to CML, spooler settings, etc.

<SAFEQ_DIR>\conf\modules\safeQ.fwupdate.conf

Contains emergency firmware update configuration for hardware terminals. Normal updates have been moved to the Terminals page of the Web interface.

<SAFEQ_DIR>\terminalserver\TerminalServer.exe.config

Contains information necessary for Terminal Server.

Note: You can enforce local configuration in ors.conf which will supersede global configuration. To do so, add required configuration to ors.conf and restart ORS services (e.g. to specify different card conversion method, add and specify conversion configuration property)

CRS configuration files

Location and Name

Description

<SAFEQ_DIR>\conf\modules\crs.conf

CRS settings

<SAFEQ_DIR>\conf\crsdb.conf

Contains database connection information