24.60. taler-exchange-dbconfig(1)

24.60.1. Name

taler-exchange-dbconfig - configure Taler exchange database

24.60.2. Synopsis

taler-exchange-dbconfig [–dry] [-c FILENAME] [-h] [-n NAME] [-r] [-s] [-u USER]

24.60.3. Description

taler-exchange-dbconfig is a simple shell script that configures a Postgresql database for use by the GNU Taler exchange.

Its options are as follows:

–dry

Report pending role/database creation, permission setup, and schema or stored-procedure migrations without changing PostgreSQL state. Existing databases are inspected by invoking the corresponding dbinit tool with --dry as the configured service user. Root and the service operating system account are still required, as for normal dbconfig operation.

If the database or PostgreSQL role does not exist, report its creation followed by full initialization. Individual migrations are not enumerated until the target can be inspected. With -s, omit initialization; combining --dry with -r is an error.

Output is empty when current. Exit status is 0 when current, 2 when work is pending, and 1 on error. Database inspection failures are errors, not evidence that a database or role is missing.

-c FILENAME

Write the database configuration to FILENAME. The tool will append the required CONFIG option for the Postgresql access to the respective file.

-h

Print short help on options.

-n DBNAME

Use DBNAME for the name of the created database.

-r

Reset any existing database. Looses all existing data. DANGEROUS.

-s

Skip database initialization. Useful if you want to run taler-exchange-dbinit manually.

-u USER

Specifies the (main) exchange user that will access the database.

24.60.4. See Also

taler-exchange-dbinit(1), taler-exchange.conf(5).

24.60.5. Bugs

Report bugs by using https://bugs.taler.net or by sending electronic mail to <taler@gnu.org>.