Difference between revisions of "Recital.conf"

From Recital Documentation Wiki
Jump to: navigation, search
Line 1: Line 1:
 
Sample recital.conf system-wide configuration file.
 
Sample recital.conf system-wide configuration file.
  
<pre>
+
&#035;!/bin/sh
#!/bin/sh
+
&#035;==============================================================================
#==============================================================================
+
&#035; This is the main Recital configuration file.  It contains the global
# This is the main Recital configuration file.  It contains the global
+
&#035; configuration directives for all Recital products. Variables defined here
# configuration directives for all Recital products. Variables defined here
+
&#035; may be overwritten by each products local profile file. Also each products
# may be overwritten by each products local profile file. Also each products
+
&#035; profile file may contain variables specific to its operation.
# profile file may contain variables specific to its operation.
+
&#035;==============================================================================
#==============================================================================
+
&#035;
#
+
&#035;==============================================================================
#==============================================================================
+
&#035; The following environment variables configure the Recital engine
# The following environment variables configure the Recital engine
+
&#035;==============================================================================
#==============================================================================
+
&#035; Used to define the date format for the license expiry date.
# Used to define the date format for the license expiry date.
+
 
DB_DATE="american" ;export DB_DATE
 
DB_DATE="american" ;export DB_DATE
#
+
&#035;
# Used for increased SCO FoxPlus compatibility.
+
&#035; Used for increased SCO FoxPlus compatibility.
 
DB_FOXPLUSBUGS="no"                            ;export DB_FOXPLUSBUGS
 
DB_FOXPLUSBUGS="no"                            ;export DB_FOXPLUSBUGS
#
+
&#035;
# Used to define the interal heap size, should not be changed
+
&#035; Used to define the interal heap size, should not be changed
 
DB_HEAPSIZE=32                                  ;export DB_HEAPSIZE
 
DB_HEAPSIZE=32                                  ;export DB_HEAPSIZE
#
+
&#035;
# Used to specify the number of multiple log files to be kept.
+
&#035; Used to specify the number of multiple log files to be kept.
 
DB_LOGVER=10 ;export DB_LOGVER
 
DB_LOGVER=10 ;export DB_LOGVER
#
+
&#035;
# Used to define the maximum number of available workareas.
+
&#035; Used to define the maximum number of available workareas.
 
DB_MAXWKA=100 ;export DB_MAXWKA
 
DB_MAXWKA=100 ;export DB_MAXWKA
#
+
&#035;
# Used to determine whether the evaluation of logical expressions should be
+
&#035; Used to determine whether the evaluation of logical expressions should be
# optimized.
+
&#035; optimized.
 
DB_OPTLOG="OFF"                                ;export DB_OPTLOG
 
DB_OPTLOG="OFF"                                ;export DB_OPTLOG
#
+
&#035;
# Used to determine whether the printer eject command is issued by
+
&#035; Used to determine whether the printer eject command is issued by
# SET PRINT OFF.
+
&#035; SET PRINT OFF.
 
DB_PRINTEREJECT="no"                            ;export DB_PRINTEREJECT
 
DB_PRINTEREJECT="no"                            ;export DB_PRINTEREJECT
#
+
&#035;
# Used to define check for and report errors in Linux/UNIX printing scripts.
+
&#035; Used to define check for and report errors in Linux/UNIX printing scripts.
 
DB_PRINTERROR="no"                              ;export DB_PRINTERROR
 
DB_PRINTERROR="no"                              ;export DB_PRINTERROR
#
+
&#035;
# Used to enable support of Samba locking.
+
&#035; Used to enable support of Samba locking.
 
DB_SAMBA="no"                                  ;export DB_SAMBA
 
DB_SAMBA="no"                                  ;export DB_SAMBA
#
+
&#035;
# Used to Enable/Disable Multi Processor Sleep Loop (helps with deadlocks).
+
&#035; Used to Enable/Disable Multi Processor Sleep Loop (helps with deadlocks).
 
DB_SLEEP="no" ;export DB_SLEEP
 
DB_SLEEP="no" ;export DB_SLEEP
#
+
&#035;
# Used to define the number of preallocated symbols for memory variables.
+
&#035; Used to define the number of preallocated symbols for memory variables.
 
DB_SYMBOLS=200 ;export DB_SYMBOLS
 
DB_SYMBOLS=200 ;export DB_SYMBOLS
#
+
&#035;
# Used to determine whether calls to operating system commands should be
+
&#035; Used to determine whether calls to operating system commands should be
# enabled or disabled.
+
&#035; enabled or disabled.
 
DB_RUNLOG="FALSE"                              ;export DB_RUNLOG
 
DB_RUNLOG="FALSE"                              ;export DB_RUNLOG
#
+
&#035;
# Used to determine whether the Linux/UNIX PATH should be included in the
+
&#035; Used to determine whether the Linux/UNIX PATH should be included in the
# SET PATH list.
+
&#035; SET PATH list.
 
DB_UNIXPATH="no"                                ;export DB_UNIXPATH
 
DB_UNIXPATH="no"                                ;export DB_UNIXPATH
#
+
&#035;
#------------------------------------------------------------------------------
+
&#035;------------------------------------------------------------------------------
# location of directories and important files
+
&#035; location of directories and important files
#------------------------------------------------------------------------------
+
&#035;------------------------------------------------------------------------------
# system wide configuration file for Recital
+
&#035; system wide configuration file for Recital
 
DB_CONFIG="${DB_ROOT}conf/config.db"          ;export DB_CONFIG
 
DB_CONFIG="${DB_ROOT}conf/config.db"          ;export DB_CONFIG
#
+
&#035;
# Used to define a directory for Recital config files.
+
&#035; Used to define a directory for Recital config files.
 
DB_CONFIGDIR="${DB_ROOT}conf/"          ;export DB_CONFIGDIR
 
DB_CONFIGDIR="${DB_ROOT}conf/"          ;export DB_CONFIGDIR
#
+
&#035;
# Used to define a default directory for backing up Recital databases.
+
&#035; Used to define a default directory for backing up Recital databases.
 
DB_BACKUPDIR="${DB_ROOT}backup/"              ;export DB_BACKUPDIR
 
DB_BACKUPDIR="${DB_ROOT}backup/"              ;export DB_BACKUPDIR
#
+
&#035;
# Location of JAVA class files used to create new objects in the 4GL.
+
&#035; Location of JAVA class files used to create new objects in the 4GL.
 
DB_CLASSDIR="${DB_ROOT}javalib/"              ;export DB_CLASSDIR
 
DB_CLASSDIR="${DB_ROOT}javalib/"              ;export DB_CLASSDIR
#
+
&#035;
# Used to define the default color file.
+
&#035; Used to define the default color file.
 
DB_COLOR="${DB_ROOT}default.col"                ;export DB_COLOR
 
DB_COLOR="${DB_ROOT}default.col"                ;export DB_COLOR
#
+
&#035;
# Used to define the language and database compatiblity
+
&#035; Used to define the language and database compatiblity
 
DB_COMPAT="${DB_ROOT}/conf/compat.db"        ;export DB_COMPAT
 
DB_COMPAT="${DB_ROOT}/conf/compat.db"        ;export DB_COMPAT
#
+
&#035;
# Used to define a default debug directory for Recital
+
&#035; Used to define a default debug directory for Recital
 
DB_DEBUGDIR="${DB_ROOT}debug/"                  ;export DB_DEBUGDIR
 
DB_DEBUGDIR="${DB_ROOT}debug/"                  ;export DB_DEBUGDIR
#
+
&#035;
# Used to define a default data directory for Recital databases.
+
&#035; Used to define a default data directory for Recital databases.
 
DB_DATADIR="${DB_ROOT}data/"                  ;export DB_DATADIR
 
DB_DATADIR="${DB_ROOT}data/"                  ;export DB_DATADIR
#
+
&#035;
# Used to define a default error directory for Recital
+
&#035; Used to define a default error directory for Recital
 
DB_ERRORDIR="${DB_ROOT}error/" ;export DB_ERRORDIR
 
DB_ERRORDIR="${DB_ROOT}error/" ;export DB_ERRORDIR
#
+
&#035;
# Used to define the directory where the shared libraries are loaded.
+
&#035; Used to define the directory where the shared libraries are loaded.
 
DB_LIBDIR="${DB_ROOT}extensions/"              ;export DB_LIBDIR
 
DB_LIBDIR="${DB_ROOT}extensions/"              ;export DB_LIBDIR
#
+
&#035;
# Used to specify the directory in which log files should be created.
+
&#035; Used to specify the directory in which log files should be created.
 
DB_LOGDIR=${DB_ROOT}log/ ;export DB_LOGDIR
 
DB_LOGDIR=${DB_ROOT}log/ ;export DB_LOGDIR
#
+
&#035;
# Used to specify the full path name of a directory for temporary printer
+
&#035; Used to specify the full path name of a directory for temporary printer
# file creation.
+
&#035; file creation.
 
DB_SPOOLDIR="" ;export DB_SPOOLDIR
 
DB_SPOOLDIR="" ;export DB_SPOOLDIR
#
+
&#035;
# Used to specify the full path name of a directory or folder for temporary
+
&#035; Used to specify the full path name of a directory or folder for temporary
# file creation.
+
&#035; file creation.
 
DB_TMPDIR="/usr/tmp/"                          ;export DB_TMPDIR
 
DB_TMPDIR="/usr/tmp/"                          ;export DB_TMPDIR
#
+
&#035;
# Used to specify a directory and filename to which user specific logging
+
&#035; Used to specify a directory and filename to which user specific logging
# information should be written.
+
&#035; information should be written.
 
DB_USERLOG="${DB_ROOT}log/${LOGNAME}.log"      ;export DB_USERLOG
 
DB_USERLOG="${DB_ROOT}log/${LOGNAME}.log"      ;export DB_USERLOG
#
+
&#035;
# Used to define a default directory for Recital licenses.
+
&#035; Used to define a default directory for Recital licenses.
 
DB_LICENSE="${DB_ROOT}licenses/"              ;export DB_LICENSE
 
DB_LICENSE="${DB_ROOT}licenses/"              ;export DB_LICENSE
#
+
&#035;
#==============================================================================
+
&#035;==============================================================================
# The following environment variables configure Recital Replication
+
&#035; The following environment variables configure Recital Replication
#==============================================================================
+
&#035;==============================================================================
# This file describes the names of the tables which will be replicated if  
+
&#035; This file describes the names of the tables which will be replicated if  
# REPLICATION is SET ON
+
&#035; REPLICATION is SET ON
 
DB_REP_ALLOW="${DB_ROOT}conf/replication.allow" ;export DB_REP_ALLOW
 
DB_REP_ALLOW="${DB_ROOT}conf/replication.allow" ;export DB_REP_ALLOW
#
+
&#035;
# This file describes the names of the tables which will NOT be replicated if  
+
&#035; This file describes the names of the tables which will NOT be replicated if  
# REPLICATION is SET ON
+
&#035; REPLICATION is SET ON
 
DB_REP_DENY="${DB_ROOT}conf/replication.deny"  ;export DB_REP_DENY
 
DB_REP_DENY="${DB_ROOT}conf/replication.deny"  ;export DB_REP_DENY
#
+
&#035;
#==============================================================================
+
&#035;==============================================================================
# The following environment variables configure Recital  
+
&#035; The following environment variables configure Recital  
#==============================================================================
+
&#035;==============================================================================
# Used to specify optional printer commands when using the ">" as the printer
+
&#035; Used to specify optional printer commands when using the ">" as the printer
# output.
+
&#035; output.
 
DB_PRINTOPT="" ;export DB_PRINTOPT
 
DB_PRINTOPT="" ;export DB_PRINTOPT
#
+
&#035;
# Used to define the terminal definition.
+
&#035; Used to define the terminal definition.
 
DB_TERM=${DB_TERM:-$TERM} ;export DB_TERM
 
DB_TERM=${DB_TERM:-$TERM} ;export DB_TERM
#
+
&#035;
# Used to deactivate a browse window if it's no long current.
+
&#035; Used to deactivate a browse window if it's no long current.
 
DB_DEACTIVATEBROWSE="yes" ;export DB_DEACTIVATEBROWSE
 
DB_DEACTIVATEBROWSE="yes" ;export DB_DEACTIVATEBROWSE
#
+
&#035;
# Used to specify which terminals a Xwindows.
+
&#035; Used to specify which terminals a Xwindows.
 
DB_XTERMS="XTERM,XTERM-COLOR,AIXTERM,DTTERM,SCOTERM,HPTERM";export DB_XTERMS
 
DB_XTERMS="XTERM,XTERM-COLOR,AIXTERM,DTTERM,SCOTERM,HPTERM";export DB_XTERMS
#
+
&#035;
# Used to issue an stty command after leaving Recital to execute a RUN command.
+
&#035; Used to issue an stty command after leaving Recital to execute a RUN command.
#DB_RUNOPTS="stty echo icrnl" ;export DB_RUNOPTS
+
&#035;DB_RUNOPTS="stty echo icrnl" ;export DB_RUNOPTS
#
+
&#035;
# Used to issue an stty command before returning to Recital after executing a
+
&#035; Used to issue an stty command before returning to Recital after executing a
# RUN command.
+
&#035; RUN command.
#DB_RUNOPTS2="stty -echo -icrnl" ;export DB_RUNOPTS2
+
&#035;DB_RUNOPTS2="stty -echo -icrnl" ;export DB_RUNOPTS2
#
+
&#035;
#------------------------------------------------------------------------------
+
&#035;------------------------------------------------------------------------------
# location of directories and important files
+
&#035; location of directories and important files
#------------------------------------------------------------------------------
+
&#035;------------------------------------------------------------------------------
# location of terminal definition files
+
&#035; location of terminal definition files
 
DB_TERMDIR="${DB_ROOT}terminals/" ;export DB_TERMDIR
 
DB_TERMDIR="${DB_ROOT}terminals/" ;export DB_TERMDIR
#
+
&#035;
# location of the help files
+
&#035; location of the help files
 
DB_HELPDIR="${DB_ROOT}doc/" ;export DB_HELPDIR
 
DB_HELPDIR="${DB_ROOT}doc/" ;export DB_HELPDIR
#
+
&#035;
# location to store SAVED screen image files.
+
&#035; location to store SAVED screen image files.
 
DB_IMGDIR=""              ;export DB_IMGDIR
 
DB_IMGDIR=""              ;export DB_IMGDIR
#
+
&#035;
 
DB_TERMTAB="/etc/ttytype" ;export DB_TERMTAB
 
DB_TERMTAB="/etc/ttytype" ;export DB_TERMTAB
#
+
&#035;
# printer file
+
&#035; printer file
 
DB_PRINT="${DB_ROOT}bin/print.unix " ;export DB_PRINT
 
DB_PRINT="${DB_ROOT}bin/print.unix " ;export DB_PRINT
#
+
&#035;
# external PDF command
+
&#035; external PDF command
 
DB_GUIHELP="xpdf" ;export DB_GUIHELP
 
DB_GUIHELP="xpdf" ;export DB_GUIHELP
#
+
&#035;
# Xbase configuration file name.
+
&#035; Xbase configuration file name.
# Uncomment to process working directory config files as native Xbase
+
&#035; Uncomment to process working directory config files as native Xbase
#DB_XCONFIG="config.db;config.fp" ;export DB_XCONFIG
+
&#035;DB_XCONFIG="config.db;config.fp" ;export DB_XCONFIG
#
+
&#035;
#==============================================================================
+
&#035;==============================================================================
# The following environment variables configure Recital Server
+
&#035; The following environment variables configure Recital Server
#==============================================================================
+
&#035;==============================================================================
#
+
&#035;
#------------------------------------------------------------------------------
+
&#035;------------------------------------------------------------------------------
# configurable parameters
+
&#035; configurable parameters
#------------------------------------------------------------------------------
+
&#035;------------------------------------------------------------------------------
# Used to specify optional printer commands when using the ">" as the printer
+
&#035; Used to specify optional printer commands when using the ">" as the printer
# output.
+
&#035; output.
 
DB_PRINTOPT="-onobanner -c" ;export DB_PRINTOPT
 
DB_PRINTOPT="-onobanner -c" ;export DB_PRINTOPT
#
+
&#035;
# Used to define the terminal definition.
+
&#035; Used to define the terminal definition.
 
DB_TERM=${DB_TERM:-$TERM} ;export DB_TERM
 
DB_TERM=${DB_TERM:-$TERM} ;export DB_TERM
#
+
&#035;
# Used to determine whether the Recital Database and Recital Mirage Servers
+
&#035; Used to determine whether the Recital Database and Recital Mirage Servers
# allow local connections from specific non-authenticated users.
+
&#035; allow local connections from specific non-authenticated users.
 
DB_LOCAL_LOGIN=yes ;export DB_LOCAL_LOGIN
 
DB_LOCAL_LOGIN=yes ;export DB_LOCAL_LOGIN
#
+
&#035;
# Used to determine whether the Recital Database and Recital Mirage Servers
+
&#035; Used to determine whether the Recital Database and Recital Mirage Servers
# expect username and password information in connection strings to be
+
&#035; expect username and password information in connection strings to be
# encrypted.
+
&#035; encrypted.
 
DB_ENCRYPTION=no ;export DB_ENCRYPTION
 
DB_ENCRYPTION=no ;export DB_ENCRYPTION
#
+
&#035;
# Used to determine if the Firecat Web Server will run when the recital server is
+
&#035; Used to determine if the Firecat Web Server will run when the recital server is
# started.
+
&#035; started.
 
DB_HTTP_ENABLED="true"                          ;export DB_HTTP_ENABLED
 
DB_HTTP_ENABLED="true"                          ;export DB_HTTP_ENABLED
#
+
&#035;
# Used to demermine if the Firecat Web Server will also listen on port 80.
+
&#035; Used to demermine if the Firecat Web Server will also listen on port 80.
 
DB_PORT80_ENABLED="false"                      ;export DB_PORT80_ENABLED
 
DB_PORT80_ENABLED="false"                      ;export DB_PORT80_ENABLED
#
+
&#035;
# Used to specify a default user account that firecat will run as.
+
&#035; Used to specify a default user account that firecat will run as.
#DB_WWWACCOUNT="root"                          ;export DB_WWWACCOUNT
+
&#035;DB_WWWACCOUNT="root"                          ;export DB_WWWACCOUNT
#
+
&#035;
# Used to specify the default web page that will be displayed.
+
&#035; Used to specify the default web page that will be displayed.
 
DB_WWWDEFAULT="default.rsp"                    ;export DB_WWWDEFAULT
 
DB_WWWDEFAULT="default.rsp"                    ;export DB_WWWDEFAULT
#
+
&#035;
# Used to specify the password for the default user. This is stored in base 64.
+
&#035; Used to specify the password for the default user. This is stored in base 64.
#DB_WWWPASSWORD=""                              ;export DB_WWWPASSWORD
+
&#035;DB_WWWPASSWORD=""                              ;export DB_WWWPASSWORD
#
+
&#035;
# Used to specify the file that contains the base 64 encypted password to use
+
&#035; Used to specify the file that contains the base 64 encypted password to use
# for the default login user.  Use the dbadmin command to manage this file.
+
&#035; for the default login user.  Use the dbadmin command to manage this file.
 
DB_WWWPWFILE="${DB_ROOT}users/passwd.db" ;export DB_WWWPWFILE
 
DB_WWWPWFILE="${DB_ROOT}users/passwd.db" ;export DB_WWWPWFILE
#
+
&#035;
# Used to determine if the firecat web server can run as a guest account.
+
&#035; Used to determine if the firecat web server can run as a guest account.
 
DB_WWWRUNASGUEST="true"                        ;export DB_WWWRUNASGUEST
 
DB_WWWRUNASGUEST="true"                        ;export DB_WWWRUNASGUEST
#
+
&#035;
# Used to define the output file for JAVA logging for the JDBC server.
+
&#035; Used to define the output file for JAVA logging for the JDBC server.
 
DB_JAVAOUT="jni.txt" ;export DB_JAVAOUT
 
DB_JAVAOUT="jni.txt" ;export DB_JAVAOUT
#
+
&#035;
# Used to disable PAM (Pluggable Authentication Module) user authentication.
+
&#035; Used to disable PAM (Pluggable Authentication Module) user authentication.
# If this is disabled then ftp will be used for user authentication.
+
&#035; If this is disabled then ftp will be used for user authentication.
 
DB_NOPAM="FALSE" ;export DB_NOPAM
 
DB_NOPAM="FALSE" ;export DB_NOPAM
#
+
&#035;
# Used to determine if how linger is set on the connected sockets.
+
&#035; Used to determine if how linger is set on the connected sockets.
 
DB_SET_LINGER="TRUE" ;export DB_SET_LINGER
 
DB_SET_LINGER="TRUE" ;export DB_SET_LINGER
  
# Network protocol for Recital Server Interface.
+
&#035; Network protocol for Recital Server Interface.
 
RSI_PROTOCOL=TCPIP ;export RSI_PROTOCOL
 
RSI_PROTOCOL=TCPIP ;export RSI_PROTOCOL
#
+
&#035;
# Used to specify the number of reties performed on a connect.
+
&#035; Used to specify the number of reties performed on a connect.
 
RSI_RETRIES=30 ;export RSI_RETRIES
 
RSI_RETRIES=30 ;export RSI_RETRIES
#
+
&#035;
# Used to specify the number of seconds to wait between reties.
+
&#035; Used to specify the number of seconds to wait between reties.
 
RSI_TIMEOUT=1 ;export RSI_TIMEOUT
 
RSI_TIMEOUT=1 ;export RSI_TIMEOUT
#
+
&#035;
# Used to specify the number of seconds waited for the server to start.
+
&#035; Used to specify the number of seconds waited for the server to start.
 
RSI_SPAWNWAIT=10 ;export RSI_SPAWNWAIT
 
RSI_SPAWNWAIT=10 ;export RSI_SPAWNWAIT
#
+
&#035;
#------------------------------------------------------------------------------
+
&#035;------------------------------------------------------------------------------
# location of directories and important files
+
&#035; location of directories and important files
#------------------------------------------------------------------------------
+
&#035;------------------------------------------------------------------------------
# The root location where Firecat files are stored.
+
&#035; The root location where Firecat files are stored.
 
DB_WWWROOT=${DB_ROOT}webroot/                  ;export DB_WWWROOT
 
DB_WWWROOT=${DB_ROOT}webroot/                  ;export DB_WWWROOT
#
+
&#035;
# Used to define the directory or folder containing the mirage_styles.conf
+
&#035; Used to define the directory or folder containing the mirage_styles.conf
# configuration file.
+
&#035; configuration file.
 
DB_MIRAGE="${DB_ROOT}" ;export DB_MIRAGE
 
DB_MIRAGE="${DB_ROOT}" ;export DB_MIRAGE
#
+
&#035;
# Used to define a global file search path for Recital Mirage applications.
+
&#035; Used to define a global file search path for Recital Mirage applications.
 
DB_MIRAGEROOT="${DB_ROOT}mirage/" ;export DB_MIRAGEROOT
 
DB_MIRAGEROOT="${DB_ROOT}mirage/" ;export DB_MIRAGEROOT
#
+
&#035;
# Used to specify the name of a file containing IP addresses allowed to
+
&#035; Used to specify the name of a file containing IP addresses allowed to
# connect to the Recital Database and Recital Mirage Servers.
+
&#035; connect to the Recital Database and Recital Mirage Servers.
 
DB_UAS_ALLOW="${DB_CONFIGDIR}hosts.allow" ;export DB_UAS_ALLOW
 
DB_UAS_ALLOW="${DB_CONFIGDIR}hosts.allow" ;export DB_UAS_ALLOW
#
+
&#035;
# Used to specify the name of a file containing IP addresses denied from
+
&#035; Used to specify the name of a file containing IP addresses denied from
# connecting to the Recital Database and Recital Mirage Servers.
+
&#035; connecting to the Recital Database and Recital Mirage Servers.
 
DB_UAS_DENY="${DB_CONFIGDIR}hosts.deny" ;export DB_UAS_DENY
 
DB_UAS_DENY="${DB_CONFIGDIR}hosts.deny" ;export DB_UAS_DENY
#
+
&#035;
# Used to specify the name of a file containing IP addresses allowed to
+
&#035; Used to specify the name of a file containing IP addresses allowed to
# connect to the Recital Firecat Web Server.
+
&#035; connect to the Recital Firecat Web Server.
 
DB_HTTP_ALLOW="${DB_CONFIGDIR}hosts.allow" ;export DB_HTTP_ALLOW
 
DB_HTTP_ALLOW="${DB_CONFIGDIR}hosts.allow" ;export DB_HTTP_ALLOW
#
+
&#035;
# Used to specify the name of a file containing IP addresses denied from
+
&#035; Used to specify the name of a file containing IP addresses denied from
# connecting to the Recital Firecat Web Server.
+
&#035; connecting to the Recital Firecat Web Server.
 
DB_HTTP_DENY="${DB_CONFIGDIR}hosts.deny" ;export DB_HTTP_DENY
 
DB_HTTP_DENY="${DB_CONFIGDIR}hosts.deny" ;export DB_HTTP_DENY
#
+
&#035;
#------------------------------------------------------------------------------
+
&#035;------------------------------------------------------------------------------
  
#
+
&#035;
#------------------------------------------------------------------------------
+
&#035;------------------------------------------------------------------------------
# configurable replication parameters
+
&#035; configurable replication parameters
#------------------------------------------------------------------------------
+
&#035;------------------------------------------------------------------------------
# Every system that will publish data for replication must have a unique
+
&#035; Every system that will publish data for replication must have a unique
# publication ID. Once assigend for a system it should not be changed
+
&#035; publication ID. Once assigend for a system it should not be changed
# This publication ID is used by all Recital products running on this system.
+
&#035; This publication ID is used by all Recital products running on this system.
 
DB_PUBLICATIONID=1                          ;export DB_PUBLICATIONID
 
DB_PUBLICATIONID=1                          ;export DB_PUBLICATIONID
# Used to enable/disable adding a unique number for replication to each row
+
&#035; Used to enable/disable adding a unique number for replication to each row
# of a table. If this is set to TRUE then the first time a table is opened
+
&#035; of a table. If this is set to TRUE then the first time a table is opened
# all the rows will be updated with a replication number.
+
&#035; all the rows will be updated with a replication number.
 
DB_SYNCNUM=TRUE                          ;export DB_SYNCNUM
 
DB_SYNCNUM=TRUE                          ;export DB_SYNCNUM
# Used to define the mode that the subscriber service will operate in
+
&#035; Used to define the mode that the subscriber service will operate in
# when it starts. This variable is only used by the subscriber service.
+
&#035; when it starts. This variable is only used by the subscriber service.
# using -t PEER | MASTER | SLAVE on the command line when starting
+
&#035; using -t PEER | MASTER | SLAVE on the command line when starting
# the Service will overwrite this setting.
+
&#035; the Service will overwrite this setting.
 
DB_REPTYPE=SLAVE                          ;export DB_REPTYPE
 
DB_REPTYPE=SLAVE                          ;export DB_REPTYPE
# Used to specify the publisher that subscriber service will connect to
+
&#035; Used to specify the publisher that subscriber service will connect to
# when it starts. This variable is only used by the subscriber service.
+
&#035; when it starts. This variable is only used by the subscriber service.
 
DB_PUBLISHER=localhost                          ;export DB_PUBLISHER
 
DB_PUBLISHER=localhost                          ;export DB_PUBLISHER
# Used to specify a comma separated list of replication peer systems that
+
&#035; Used to specify a comma separated list of replication peer systems that
# have data to publish. This variable is only used by the publisher service.
+
&#035; have data to publish. This variable is only used by the publisher service.
# once the publisher service is started it will get data to publish from
+
&#035; once the publisher service is started it will get data to publish from
# list of servers specified.
+
&#035; list of servers specified.
 
DB_PEERS=localhost                          ;export DB_PEERS
 
DB_PEERS=localhost                          ;export DB_PEERS
# Used to specify the delay in seconds that the replication service will wait
+
&#035; Used to specify the delay in seconds that the replication service will wait
# before checking for new transactions.
+
&#035; before checking for new transactions.
# Using -d seconds on the command line when starting the service will overwrite
+
&#035; Using -d seconds on the command line when starting the service will overwrite
# this setting.
+
&#035; this setting.
# if no value is specified here or on the command line, then the default value
+
&#035; if no value is specified here or on the command line, then the default value
# will be 60 seconds.
+
&#035; will be 60 seconds.
 
DB_REPDELAY=60                          ;export DB_REPDELAY
 
DB_REPDELAY=60                          ;export DB_REPDELAY
</pre>
+
&#035; This is the directory that the services will access for files they require.<br>
&#035; This is the directory that the services will access files it requires.<br>
+
 
&#035; It must be the SAME path on all system.<br>
 
&#035; It must be the SAME path on all system.<br>
 
[[DB_REPDIR]]=/opt/recital/data/replication/ ;export DB_REPDIR
 
[[DB_REPDIR]]=/opt/recital/data/replication/ ;export DB_REPDIR

Revision as of 10:35, 3 March 2010

Sample recital.conf system-wide configuration file.

#!/bin/sh #============================================================================== # This is the main Recital configuration file. It contains the global # configuration directives for all Recital products. Variables defined here # may be overwritten by each products local profile file. Also each products # profile file may contain variables specific to its operation. #============================================================================== # #============================================================================== # The following environment variables configure the Recital engine #============================================================================== # Used to define the date format for the license expiry date. DB_DATE="american" ;export DB_DATE # # Used for increased SCO FoxPlus compatibility. DB_FOXPLUSBUGS="no"  ;export DB_FOXPLUSBUGS # # Used to define the interal heap size, should not be changed DB_HEAPSIZE=32  ;export DB_HEAPSIZE # # Used to specify the number of multiple log files to be kept. DB_LOGVER=10 ;export DB_LOGVER # # Used to define the maximum number of available workareas. DB_MAXWKA=100 ;export DB_MAXWKA # # Used to determine whether the evaluation of logical expressions should be # optimized. DB_OPTLOG="OFF"  ;export DB_OPTLOG # # Used to determine whether the printer eject command is issued by # SET PRINT OFF. DB_PRINTEREJECT="no"  ;export DB_PRINTEREJECT # # Used to define check for and report errors in Linux/UNIX printing scripts. DB_PRINTERROR="no"  ;export DB_PRINTERROR # # Used to enable support of Samba locking. DB_SAMBA="no"  ;export DB_SAMBA # # Used to Enable/Disable Multi Processor Sleep Loop (helps with deadlocks). DB_SLEEP="no" ;export DB_SLEEP # # Used to define the number of preallocated symbols for memory variables. DB_SYMBOLS=200 ;export DB_SYMBOLS # # Used to determine whether calls to operating system commands should be # enabled or disabled. DB_RUNLOG="FALSE"  ;export DB_RUNLOG # # Used to determine whether the Linux/UNIX PATH should be included in the # SET PATH list. DB_UNIXPATH="no"  ;export DB_UNIXPATH # #------------------------------------------------------------------------------ # location of directories and important files #------------------------------------------------------------------------------ # system wide configuration file for Recital DB_CONFIG="${DB_ROOT}conf/config.db" ;export DB_CONFIG # # Used to define a directory for Recital config files. DB_CONFIGDIR="${DB_ROOT}conf/" ;export DB_CONFIGDIR # # Used to define a default directory for backing up Recital databases. DB_BACKUPDIR="${DB_ROOT}backup/" ;export DB_BACKUPDIR # # Location of JAVA class files used to create new objects in the 4GL. DB_CLASSDIR="${DB_ROOT}javalib/" ;export DB_CLASSDIR # # Used to define the default color file. DB_COLOR="${DB_ROOT}default.col"  ;export DB_COLOR # # Used to define the language and database compatiblity DB_COMPAT="${DB_ROOT}/conf/compat.db" ;export DB_COMPAT # # Used to define a default debug directory for Recital DB_DEBUGDIR="${DB_ROOT}debug/"  ;export DB_DEBUGDIR # # Used to define a default data directory for Recital databases. DB_DATADIR="${DB_ROOT}data/" ;export DB_DATADIR # # Used to define a default error directory for Recital DB_ERRORDIR="${DB_ROOT}error/" ;export DB_ERRORDIR # # Used to define the directory where the shared libraries are loaded. DB_LIBDIR="${DB_ROOT}extensions/"  ;export DB_LIBDIR # # Used to specify the directory in which log files should be created. DB_LOGDIR=${DB_ROOT}log/ ;export DB_LOGDIR # # Used to specify the full path name of a directory for temporary printer # file creation. DB_SPOOLDIR="" ;export DB_SPOOLDIR # # Used to specify the full path name of a directory or folder for temporary # file creation. DB_TMPDIR="/usr/tmp/"  ;export DB_TMPDIR # # Used to specify a directory and filename to which user specific logging # information should be written. DB_USERLOG="${DB_ROOT}log/${LOGNAME}.log"  ;export DB_USERLOG # # Used to define a default directory for Recital licenses. DB_LICENSE="${DB_ROOT}licenses/" ;export DB_LICENSE # #============================================================================== # The following environment variables configure Recital Replication #============================================================================== # This file describes the names of the tables which will be replicated if # REPLICATION is SET ON DB_REP_ALLOW="${DB_ROOT}conf/replication.allow" ;export DB_REP_ALLOW # # This file describes the names of the tables which will NOT be replicated if # REPLICATION is SET ON DB_REP_DENY="${DB_ROOT}conf/replication.deny" ;export DB_REP_DENY # #============================================================================== # The following environment variables configure Recital #============================================================================== # Used to specify optional printer commands when using the ">" as the printer # output. DB_PRINTOPT="" ;export DB_PRINTOPT # # Used to define the terminal definition. DB_TERM=${DB_TERM:-$TERM} ;export DB_TERM # # Used to deactivate a browse window if it's no long current. DB_DEACTIVATEBROWSE="yes" ;export DB_DEACTIVATEBROWSE # # Used to specify which terminals a Xwindows. DB_XTERMS="XTERM,XTERM-COLOR,AIXTERM,DTTERM,SCOTERM,HPTERM";export DB_XTERMS # # Used to issue an stty command after leaving Recital to execute a RUN command. #DB_RUNOPTS="stty echo icrnl" ;export DB_RUNOPTS # # Used to issue an stty command before returning to Recital after executing a # RUN command. #DB_RUNOPTS2="stty -echo -icrnl" ;export DB_RUNOPTS2 # #------------------------------------------------------------------------------ # location of directories and important files #------------------------------------------------------------------------------ # location of terminal definition files DB_TERMDIR="${DB_ROOT}terminals/" ;export DB_TERMDIR # # location of the help files DB_HELPDIR="${DB_ROOT}doc/" ;export DB_HELPDIR # # location to store SAVED screen image files. DB_IMGDIR="" ;export DB_IMGDIR # DB_TERMTAB="/etc/ttytype" ;export DB_TERMTAB # # printer file DB_PRINT="${DB_ROOT}bin/print.unix " ;export DB_PRINT # # external PDF command DB_GUIHELP="xpdf" ;export DB_GUIHELP # # Xbase configuration file name. # Uncomment to process working directory config files as native Xbase #DB_XCONFIG="config.db;config.fp" ;export DB_XCONFIG # #============================================================================== # The following environment variables configure Recital Server #============================================================================== # #------------------------------------------------------------------------------ # configurable parameters #------------------------------------------------------------------------------ # Used to specify optional printer commands when using the ">" as the printer # output. DB_PRINTOPT="-onobanner -c" ;export DB_PRINTOPT # # Used to define the terminal definition. DB_TERM=${DB_TERM:-$TERM} ;export DB_TERM # # Used to determine whether the Recital Database and Recital Mirage Servers # allow local connections from specific non-authenticated users. DB_LOCAL_LOGIN=yes ;export DB_LOCAL_LOGIN # # Used to determine whether the Recital Database and Recital Mirage Servers # expect username and password information in connection strings to be # encrypted. DB_ENCRYPTION=no ;export DB_ENCRYPTION # # Used to determine if the Firecat Web Server will run when the recital server is # started. DB_HTTP_ENABLED="true"  ;export DB_HTTP_ENABLED # # Used to demermine if the Firecat Web Server will also listen on port 80. DB_PORT80_ENABLED="false"  ;export DB_PORT80_ENABLED # # Used to specify a default user account that firecat will run as. #DB_WWWACCOUNT="root"  ;export DB_WWWACCOUNT # # Used to specify the default web page that will be displayed. DB_WWWDEFAULT="default.rsp"  ;export DB_WWWDEFAULT # # Used to specify the password for the default user. This is stored in base 64. #DB_WWWPASSWORD=""  ;export DB_WWWPASSWORD # # Used to specify the file that contains the base 64 encypted password to use # for the default login user. Use the dbadmin command to manage this file. DB_WWWPWFILE="${DB_ROOT}users/passwd.db" ;export DB_WWWPWFILE # # Used to determine if the firecat web server can run as a guest account. DB_WWWRUNASGUEST="true" ;export DB_WWWRUNASGUEST # # Used to define the output file for JAVA logging for the JDBC server. DB_JAVAOUT="jni.txt" ;export DB_JAVAOUT # # Used to disable PAM (Pluggable Authentication Module) user authentication. # If this is disabled then ftp will be used for user authentication. DB_NOPAM="FALSE" ;export DB_NOPAM # # Used to determine if how linger is set on the connected sockets. DB_SET_LINGER="TRUE" ;export DB_SET_LINGER

# Network protocol for Recital Server Interface. RSI_PROTOCOL=TCPIP ;export RSI_PROTOCOL # # Used to specify the number of reties performed on a connect. RSI_RETRIES=30 ;export RSI_RETRIES # # Used to specify the number of seconds to wait between reties. RSI_TIMEOUT=1 ;export RSI_TIMEOUT # # Used to specify the number of seconds waited for the server to start. RSI_SPAWNWAIT=10 ;export RSI_SPAWNWAIT # #------------------------------------------------------------------------------ # location of directories and important files #------------------------------------------------------------------------------ # The root location where Firecat files are stored. DB_WWWROOT=${DB_ROOT}webroot/ ;export DB_WWWROOT # # Used to define the directory or folder containing the mirage_styles.conf # configuration file. DB_MIRAGE="${DB_ROOT}" ;export DB_MIRAGE # # Used to define a global file search path for Recital Mirage applications. DB_MIRAGEROOT="${DB_ROOT}mirage/" ;export DB_MIRAGEROOT # # Used to specify the name of a file containing IP addresses allowed to # connect to the Recital Database and Recital Mirage Servers. DB_UAS_ALLOW="${DB_CONFIGDIR}hosts.allow" ;export DB_UAS_ALLOW # # Used to specify the name of a file containing IP addresses denied from # connecting to the Recital Database and Recital Mirage Servers. DB_UAS_DENY="${DB_CONFIGDIR}hosts.deny" ;export DB_UAS_DENY # # Used to specify the name of a file containing IP addresses allowed to # connect to the Recital Firecat Web Server. DB_HTTP_ALLOW="${DB_CONFIGDIR}hosts.allow" ;export DB_HTTP_ALLOW # # Used to specify the name of a file containing IP addresses denied from # connecting to the Recital Firecat Web Server. DB_HTTP_DENY="${DB_CONFIGDIR}hosts.deny" ;export DB_HTTP_DENY # #------------------------------------------------------------------------------

# #------------------------------------------------------------------------------ # configurable replication parameters #------------------------------------------------------------------------------ # Every system that will publish data for replication must have a unique # publication ID. Once assigend for a system it should not be changed # This publication ID is used by all Recital products running on this system. DB_PUBLICATIONID=1 ;export DB_PUBLICATIONID # Used to enable/disable adding a unique number for replication to each row # of a table. If this is set to TRUE then the first time a table is opened # all the rows will be updated with a replication number. DB_SYNCNUM=TRUE ;export DB_SYNCNUM # Used to define the mode that the subscriber service will operate in # when it starts. This variable is only used by the subscriber service. # using -t PEER | MASTER | SLAVE on the command line when starting # the Service will overwrite this setting. DB_REPTYPE=SLAVE ;export DB_REPTYPE # Used to specify the publisher that subscriber service will connect to # when it starts. This variable is only used by the subscriber service. DB_PUBLISHER=localhost ;export DB_PUBLISHER # Used to specify a comma separated list of replication peer systems that # have data to publish. This variable is only used by the publisher service. # once the publisher service is started it will get data to publish from # list of servers specified. DB_PEERS=localhost ;export DB_PEERS # Used to specify the delay in seconds that the replication service will wait # before checking for new transactions. # Using -d seconds on the command line when starting the service will overwrite # this setting. # if no value is specified here or on the command line, then the default value # will be 60 seconds. DB_REPDELAY=60 ;export DB_REPDELAY # This is the directory that the services will access for files they require.
# It must be the SAME path on all system.
DB_REPDIR=/opt/recital/data/replication/ ;export DB_REPDIR