Difference between revisions of "Recital.conf"

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

Latest revision as of 12:09, 9 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 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
#
# 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 longer current.
DB_DEACTIVATEBROWSE="yes"    ;export DB_DEACTIVATEBROWSE
#
# Used to specify which terminals are 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 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 retries performed on a connect.
RSI_RETRIES=30    ;export RSI_RETRIES
#
# Used to specify the number of seconds to wait between retries.
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