TALER-EXCHANGE-DBINIT(1)

NAME
taler-exchange-dbinit - initialize Taler exchange database

SYNOPSIS

taler-exchange-dbinit [-a | --inject-auditor] [-c FILENAME | --config=‌FILENAME] [-d SCHEMA | --disable-customization=‌SCHEMA] [-e SCHEMA | --enable-customization=‌SCHEMA] [-g | --gc] [-h | --help] [-L LOGLEVEL | --loglevel=‌LOGLEVEL] [-l FILENAME | --logfile=‌FILENAME] [-r | --reset] [-s | --shardunlock] [-v | --version]

DESCRIPTION

taler-exchange-dbinit is a command-line tool to initialize the Taler exchange database. It creates the necessary tables and indices for the Taler exchange to operate.

Its options are as follows:

-a | --inject-auditor
    Installs triggers to notify real-time auditors of relevant changes to the database state.

-c FILENAME | --config=‌FILENAME
    Use the configuration and other resources for the exchange to operate from FILENAME.

-d SCHEMA | --disable-customization=‌SCHEMA
    Remove rules from a customization schema from an exchange database. Note that doing so may result in an irrevocable loss of statistics, depending on how the rules are written.

-e SCHEMA | --enable-customization=‌SCHEMA
    Load a customization schema to inject deployment-specific rules into an exchange database. Used to add operator-specific AML rules and statistics via triggers defined in their own schema.

-g | --gc
    Garbage collect database. Deletes all unnecessary data in the database.

-h | --help
    Print short help on options.

-L LOGLEVEL | --loglevel=‌LOGLEVEL
    Specifies the log level to use. Accepted values are: DEBUG, INFO, WARNING, ERROR.

-l FILENAME | --logfile=‌FILENAME
    Send logging output to FILENAME.

-r | --reset
    Drop tables. Dangerous, will delete all existing data in the database before creating the tables.

-s | --shardunlock
    Clears the (revolving) shards table. Needed to clear locks that may be held after a crash (of taler-exchange-aggregator or the operating system, say due to power outage) or if the AGGREGATOR_SHARD_SIZE option is changed in the configuration file.

-v | –version
    Print version information.

SEE ALSO

taler-exchange-httpd(1), taler-exchange-offline(1), taler-exchange-dbconfig(1), taler-exchange.conf(5).

BUGS

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

AUTHOR
GNU Taler contributors

COPYRIGHT
2014-2025 Taler Systems SA (GPLv3+ or GFDL 1.3+)