Chapter 5. refdbd administration

Table of Contents

Create a database
Delete a database
Add or remove a user
Add users
Remove users
Configure the application server
Configuration at startup
Reconfiguring a running refdbd process
Add, edit, or delete bibliography styles
Logging data
What to log
Log levels
Interpreting the log information
Security issues
Database server access control
How to run several refdb instances
Backup your data
Creating a risx dump
Creating a SQL dump

This chapter will explain the usage of refdba for the administration of refdbd. Please refer to the reference chapter about refdba to learn about command-line switches and interactive commands of this application.

Create a database

Create new databases with the refdba command createdb foo. The new database will be empty initially. If you start adding datasets, the first dataset will have the ID 1.

In order to access the new database, users need to have their access rights set accordingly.

Due to restrictions of the database servers and of the way database names are encoded in refdb SGML/XML/LaTeX documents, the names of the databases should be treated as case-insensitive and should not contain colons (':').

Some database engines support different character encodings. In this case you can use the -E option to select an appropriate encoding. See the documentation of your database engine for available encodings.


Your SQL database server may manage more databases than your refdb databases. In this case it may be prudent to use a common prefix for all refdb reference databases that you create. By providing a simple regular expression to the listdb command, the execution time may drop considerably.