Recital.conf

From Recital Documentation Wiki
Revision as of 10:19, 3 March 2010 by Yvonnemilne (Talk | contribs)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

Sample recital.conf system-wide configuration file.

  1. !/bin/sh
  2. ==============================================================================
  3. This is the main Recital configuration file. It contains the global
  4. configuration directives for all Recital products. Variables defined here
  5. may be overwritten by each products local profile file. Also each products
  6. profile file may contain variables specific to its operation.
  7. ==============================================================================
  8. ==============================================================================
  9. The following environment variables configure the Recital engine
  10. ==============================================================================
  11. Used to define the date format for the license expiry date.

DB_DATE="american" ;export DB_DATE

  1. Used for increased SCO FoxPlus compatibility.

DB_FOXPLUSBUGS="no"  ;export DB_FOXPLUSBUGS

  1. Used to define the interal heap size, should not be changed

DB_HEAPSIZE=32  ;export DB_HEAPSIZE

  1. Used to specify the number of multiple log files to be kept.

DB_LOGVER=10 ;export DB_LOGVER

  1. Used to define the maximum number of available workareas.

DB_MAXWKA=100 ;export DB_MAXWKA

  1. Used to determine whether the evaluation of logical expressions should be
  2. optimized.

DB_OPTLOG="OFF"  ;export DB_OPTLOG

  1. Used to determine whether the printer eject command is issued by
  2. SET PRINT OFF.

DB_PRINTEREJECT="no"  ;export DB_PRINTEREJECT

  1. Used to define check for and report errors in Linux/UNIX printing scripts.

DB_PRINTERROR="no"  ;export DB_PRINTERROR

  1. Used to enable support of Samba locking.

DB_SAMBA="no"  ;export DB_SAMBA

  1. Used to Enable/Disable Multi Processor Sleep Loop (helps with deadlocks).

DB_SLEEP="no" ;export DB_SLEEP

  1. Used to define the number of preallocated symbols for memory variables.

DB_SYMBOLS=200 ;export DB_SYMBOLS

  1. Used to determine whether calls to operating system commands should be
  2. enabled or disabled.

DB_RUNLOG="FALSE"  ;export DB_RUNLOG

  1. Used to determine whether the Linux/UNIX PATH should be included in the
  2. SET PATH list.

DB_UNIXPATH="no"  ;export DB_UNIXPATH

  1. ------------------------------------------------------------------------------
  2. location of directories and important files
  3. ------------------------------------------------------------------------------
  4. system wide configuration file for Recital

DB_CONFIG="${DB_ROOT}conf/config.db" ;export DB_CONFIG

  1. Used to define a directory for Recital config files.

DB_CONFIGDIR="${DB_ROOT}conf/" ;export DB_CONFIGDIR

  1. Used to define a default directory for backing up Recital databases.

DB_BACKUPDIR="${DB_ROOT}backup/" ;export DB_BACKUPDIR

  1. Location of JAVA class files used to create new objects in the 4GL.

DB_CLASSDIR="${DB_ROOT}javalib/" ;export DB_CLASSDIR

  1. Used to define the default color file.

DB_COLOR="${DB_ROOT}default.col"  ;export DB_COLOR

  1. Used to define the language and database compatiblity

DB_COMPAT="${DB_ROOT}/conf/compat.db" ;export DB_COMPAT

  1. Used to define a default debug directory for Recital

DB_DEBUGDIR="${DB_ROOT}debug/"  ;export DB_DEBUGDIR

  1. Used to define a default data directory for Recital databases.

DB_DATADIR="${DB_ROOT}data/" ;export DB_DATADIR

  1. Used to define a default error directory for Recital

DB_ERRORDIR="${DB_ROOT}error/" ;export DB_ERRORDIR

  1. Used to define the directory where the shared libraries are loaded.

DB_LIBDIR="${DB_ROOT}extensions/"  ;export DB_LIBDIR

  1. Used to specify the directory in which log files should be created.

DB_LOGDIR=${DB_ROOT}log/ ;export DB_LOGDIR

  1. Used to specify the full path name of a directory for temporary printer
  2. file creation.

DB_SPOOLDIR="" ;export DB_SPOOLDIR

  1. Used to specify the full path name of a directory or folder for temporary
  2. file creation.

DB_TMPDIR="/usr/tmp/"  ;export DB_TMPDIR

  1. Used to specify a directory and filename to which user specific logging
  2. information should be written.

DB_USERLOG="${DB_ROOT}log/${LOGNAME}.log"  ;export DB_USERLOG

  1. Used to define a default directory for Recital licenses.

DB_LICENSE="${DB_ROOT}licenses/" ;export DB_LICENSE

  1. ==============================================================================
  2. The following environment variables configure Recital Replication
  3. ==============================================================================
  4. This file describes the names of the tables which will be replicated if
  5. REPLICATION is SET ON

DB_REP_ALLOW="${DB_ROOT}conf/replication.allow" ;export DB_REP_ALLOW

  1. This file describes the names of the tables which will NOT be replicated if
  2. REPLICATION is SET ON

DB_REP_DENY="${DB_ROOT}conf/replication.deny" ;export DB_REP_DENY

  1. ==============================================================================
  2. The following environment variables configure Recital
  3. ==============================================================================
  4. Used to specify optional printer commands when using the ">" as the printer
  5. output.

DB_PRINTOPT="" ;export DB_PRINTOPT

  1. Used to define the terminal definition.

DB_TERM=${DB_TERM:-$TERM} ;export DB_TERM

  1. Used to deactivate a browse window if it's no long current.

DB_DEACTIVATEBROWSE="yes" ;export DB_DEACTIVATEBROWSE

  1. Used to specify which terminals a Xwindows.

DB_XTERMS="XTERM,XTERM-COLOR,AIXTERM,DTTERM,SCOTERM,HPTERM";export DB_XTERMS

  1. Used to issue an stty command after leaving Recital to execute a RUN command.
  2. DB_RUNOPTS="stty echo icrnl" ;export DB_RUNOPTS
  3. Used to issue an stty command before returning to Recital after executing a
  4. RUN command.
  5. DB_RUNOPTS2="stty -echo -icrnl" ;export DB_RUNOPTS2
  6. ------------------------------------------------------------------------------
  7. location of directories and important files
  8. ------------------------------------------------------------------------------
  9. location of terminal definition files

DB_TERMDIR="${DB_ROOT}terminals/" ;export DB_TERMDIR

  1. location of the help files

DB_HELPDIR="${DB_ROOT}doc/" ;export DB_HELPDIR

  1. location to store SAVED screen image files.

DB_IMGDIR="" ;export DB_IMGDIR

DB_TERMTAB="/etc/ttytype" ;export DB_TERMTAB

  1. printer file

DB_PRINT="${DB_ROOT}bin/print.unix " ;export DB_PRINT

  1. external PDF command

DB_GUIHELP="xpdf" ;export DB_GUIHELP

  1. Xbase configuration file name.
  2. Uncomment to process working directory config files as native Xbase
  3. DB_XCONFIG="config.db;config.fp" ;export DB_XCONFIG
  4. ==============================================================================
  5. The following environment variables configure Recital Server
  6. ==============================================================================
  7. ------------------------------------------------------------------------------
  8. configurable parameters
  9. ------------------------------------------------------------------------------
  10. Used to specify optional printer commands when using the ">" as the printer
  11. output.

DB_PRINTOPT="-onobanner -c" ;export DB_PRINTOPT

  1. Used to define the terminal definition.

DB_TERM=${DB_TERM:-$TERM} ;export DB_TERM

  1. Used to determine whether the Recital Database and Recital Mirage Servers
  2. allow local connections from specific non-authenticated users.

DB_LOCAL_LOGIN=yes ;export DB_LOCAL_LOGIN

  1. Used to determine whether the Recital Database and Recital Mirage Servers
  2. expect username and password information in connection strings to be
  3. encrypted.

DB_ENCRYPTION=no ;export DB_ENCRYPTION

  1. Used to determine if the Firecat Web Server will run when the recital server is
  2. started.

DB_HTTP_ENABLED="true"  ;export DB_HTTP_ENABLED

  1. Used to demermine if the Firecat Web Server will also listen on port 80.

DB_PORT80_ENABLED="false"  ;export DB_PORT80_ENABLED

  1. Used to specify a default user account that firecat will run as.
  2. DB_WWWACCOUNT="root"  ;export DB_WWWACCOUNT
  3. Used to specify the default web page that will be displayed.

DB_WWWDEFAULT="default.rsp"  ;export DB_WWWDEFAULT

  1. Used to specify the password for the default user. This is stored in base 64.
  2. DB_WWWPASSWORD=""  ;export DB_WWWPASSWORD
  3. Used to specify the file that contains the base 64 encypted password to use
  4. for the default login user. Use the dbadmin command to manage this file.

DB_WWWPWFILE="${DB_ROOT}users/passwd.db" ;export DB_WWWPWFILE

  1. Used to determine if the firecat web server can run as a guest account.

DB_WWWRUNASGUEST="true" ;export DB_WWWRUNASGUEST

  1. Used to define the output file for JAVA logging for the JDBC server.

DB_JAVAOUT="jni.txt" ;export DB_JAVAOUT

  1. Used to disable PAM (Pluggable Authentication Module) user authentication.
  2. If this is disabled then ftp will be used for user authentication.

DB_NOPAM="FALSE" ;export DB_NOPAM

  1. Used to determine if how linger is set on the connected sockets.

DB_SET_LINGER="TRUE" ;export DB_SET_LINGER

  1. Network protocol for Recital Server Interface.

RSI_PROTOCOL=TCPIP ;export RSI_PROTOCOL

  1. Used to specify the number of reties performed on a connect.

RSI_RETRIES=30 ;export RSI_RETRIES

  1. Used to specify the number of seconds to wait between reties.

RSI_TIMEOUT=1 ;export RSI_TIMEOUT

  1. Used to specify the number of seconds waited for the server to start.

RSI_SPAWNWAIT=10 ;export RSI_SPAWNWAIT

  1. ------------------------------------------------------------------------------
  2. location of directories and important files
  3. ------------------------------------------------------------------------------
  4. The root location where Firecat files are stored.

DB_WWWROOT=${DB_ROOT}webroot/ ;export DB_WWWROOT

  1. Used to define the directory or folder containing the mirage_styles.conf
  2. configuration file.

DB_MIRAGE="${DB_ROOT}" ;export DB_MIRAGE

  1. Used to define a global file search path for Recital Mirage applications.

DB_MIRAGEROOT="${DB_ROOT}mirage/" ;export DB_MIRAGEROOT

  1. Used to specify the name of a file containing IP addresses allowed to
  2. connect to the Recital Database and Recital Mirage Servers.

DB_UAS_ALLOW="${DB_CONFIGDIR}hosts.allow" ;export DB_UAS_ALLOW

  1. Used to specify the name of a file containing IP addresses denied from
  2. connecting to the Recital Database and Recital Mirage Servers.

DB_UAS_DENY="${DB_CONFIGDIR}hosts.deny" ;export DB_UAS_DENY

  1. Used to specify the name of a file containing IP addresses allowed to
  2. connect to the Recital Firecat Web Server.

DB_HTTP_ALLOW="${DB_CONFIGDIR}hosts.allow" ;export DB_HTTP_ALLOW

  1. Used to specify the name of a file containing IP addresses denied from
  2. connecting to the Recital Firecat Web Server.

DB_HTTP_DENY="${DB_CONFIGDIR}hosts.deny" ;export DB_HTTP_DENY

  1. ------------------------------------------------------------------------------
  1. ------------------------------------------------------------------------------
  2. configurable replication parameters
  3. ------------------------------------------------------------------------------
  4. Every system that will publish data for replication must have a unique
  5. publication ID. Once assigend for a system it should not be changed
  6. This publication ID is used by all Recital products running on this system.

DB_PUBLICATIONID=1  ;export DB_PUBLICATIONID

  1. Used to enable/disable adding a unique number for replication to each row
  2. of a table. If this is set to TRUE then the first time a table is opened
  3. all the rows will be updated with a replication number.

DB_SYNCNUM=TRUE  ;export DB_SYNCNUM

  1. Used to define the mode that the subscriber service will operate in
  2. when it starts. This variable is only used by the subscriber service.
  3. using -t PEER | MASTER | SLAVE on the command line when starting
  4. the Service will overwrite this setting.

DB_REPTYPE=SLAVE  ;export DB_REPTYPE

  1. Used to specify the publisher that subscriber service will connect to
  2. when it starts. This variable is only used by the subscriber service.

DB_PUBLISHER=localhost  ;export DB_PUBLISHER

  1. Used to specify a comma separated list of replication peer systems that
  2. have data to publish. This variable is only used by the publisher service.
  3. once the publisher service is started it will get data to publish from
  4. list of servers specified.

DB_PEERS=localhost  ;export DB_PEERS

  1. Used to specify the delay in seconds that the replication service will wait
  2. before checking for new transactions.
  3. Using -d seconds on the command line when starting the service will overwrite
  4. this setting.
  5. if no value is specified here or on the command line, then the default value
  6. will be 60 seconds.

DB_REPDELAY=60  ;export DB_REPDELAY

  1. This is the directory that the services will access files it requires.
  2. It must be the SAME path on all system.

DB_REPDIR=/opt/recital-10.0.rc8/data/replication/  ;export DB_REPDIR