Table 12-1. refdbdrc
| Variable | Default | Comment |
|---|---|---|
| refdblib | (none) | The path of the directory containing shareable refdb files like DTDs, HTML templates etc. |
| dbsport | 3306 | The port on which the database server listens. Use either 3306 or 5432 for MySQL and PostgreSQL, respectively. |
| 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/local/share/refdb/db | The directory that contains the database files of an embedded database engine. |
| 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/refdb.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) allows only the most important messages, a high setting (7) allows all messages including debug messages. -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/refdb.pid or write to this file as a regular user). |
| port | 9734 | The port on which refdbd listens. |
| remoteadmin | f | Set this to 't' to allow remote administration via refdba. |
| 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 | 60 | 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. |
| 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. |