Table 12-1. refdbdrc
| Variable | Default | Comment |
|---|---|---|
| refdblib | /usr/share/refdb | The path of the directory containing shareable refdb files like DTDs, HTML templates etc. Actually, most of the files are in subdirectories of refdblib. |
| dbsport | 3306 | The port on which the database server listens. Use either 3306 or 5432 for MySQL and PostgreSQL, respectively. This variable is ignored if you use SQLite as your database engine. |
| dbserver | mysql | The database server you want to connect to. Use one of mysql, pgsql, or sqlite to select MySQL, PostgreSQL, or SQLite as your database engine, respectively. |
| dbpath | /usr/share/refdb/db | The directory that contains the database files of an embedded database engine. Leave out the leading slash if you use SQLite on Cygwin (see note above). |
| logdest | 2 | The destination of the log information. 0 = print to stderr (for debugging only, don't use when running as a daemon); 1 = use the syslog facility; 2 = use a custom logfile. The latter needs a proper setting of logfile. |
| logfile | /var/log/refdbd.log | The full path of a custom log file. This is used only if logdest is set appropriately. If you start refdbd from the command line as a regular user, you should specify a file that you have write access to (you may not be allowed to create /var/log/refdbd.log or write to this file as a regular user). |
| loglevel | 6 | The log level up to which messages will be sent. A low setting (0) will notify you only in case of a meltdown, whereas a high setting (7) allows all messages including debug messages (this is a lot). -1 means nothing will be logged. |
| pidfile | /var/log/refdb.pid | The file refdbd writes its process ID to. If you start refdbd from the command line as a regular user, you should specify a file that you have write access to (you may not be allowed to create /var/log/refdbd.pid or write to this file as a regular user). |
| port | 9734 | The port on which refdbd listens. The server and all clients that are supposed to connect to it must agree on the same port. Obviously, this option allows to run several instances of refdbd on the same box if there is a good reason to do so. In this case you should also use separate log and pid files. |
| remoteadmin | f | Set this to 't' to allow remote administration via refdba. Be aware that this is a security risk. |
| serverip | localhost | The IP address or hostname of the machine where the database server runs. Use the default (localhost) address if the database server and refdbd run on the same machine. |
| timeout | 180 | The timeout in seconds. After this time has elapsed, a stalled connection is taken down. Increase this value if you encounter frequent timeout errors due to high network traffic. |
| keep_pnames | t | Set this to 't' to keep periodical names and synonyms if you remove references. If set to 'f', the names will be removed from the database if the last reference using these names is deleted. |
| db_encoding | (none) | Specify the default character encoding for new refdb reference databases. If the database server supports this feature (currently only PostgreSQL does), all new databases will use this encoding unless a different one is specified with the createdb command. |
| in_encoding | ISO-8859-1 | Specify the default character encoding for RIS data being added to databases. |
| dbi_driverdir | (none) | Specify the directory containing the libdbi driver files. As mentioned above, this is only necessary if you use precompiled libdbi binaries in funny locations. |
| keyword_scan | t | Set this to 't' to allow an automatic keyword scan after references are added or updated. 'f' will switch off this feature. |
| upper_citekey | f | Set this to 't' to uppercase all citation keys of newly added references (this makes sure they work with SGML bibliographies). |
| remoteconnect | f | Set this to 't' to allow remote connections to refdbd. By default, refdbd accepts only local connections due to security concerns. |