taler-docs

Documentation for GNU Taler components, APIs and protocols
Log | Files | Refs | README | LICENSE

taler-exchange-dbinit.1.rst (2766B)

      1 taler-exchange-dbinit(1)
      2 ########################
      3 
      4 .. only:: html
      5 
      6    Name
      7    ====
      8 
      9    **taler-exchange-dbinit** - initialize Taler exchange database
     10 
     11 
     12 Synopsis
     13 ========
     14 
     15 **taler-exchange-dbinit**
     16 [**-a** | **--inject-auditor**]
     17 [**-c** *FILENAME* | **--config=**\ ‌\ *FILENAME*]
     18 [**-d** *SCHEMA* | **--disable-customization=**\ ‌\ *SCHEMA*]
     19 [**-e** *SCHEMA* | **--enable-customization=**\ ‌\ *SCHEMA*]
     20 [**-g** | **--gc**]
     21 [**-h** | **--help**]
     22 [**-L** *LOGLEVEL* | **--loglevel=**\ ‌\ *LOGLEVEL*]
     23 [**-l** *FILENAME* | **--logfile=**\ ‌\ *FILENAME*]
     24 [**-r** | **--reset**]
     25 [**-s** | **--shardunlock**]
     26 [**-v** | **--version**]
     27 
     28 Description
     29 ===========
     30 
     31 **taler-exchange-dbinit** is a command-line tool to initialize the Taler
     32 exchange database. It creates the necessary tables and indices for the
     33 Taler exchange to operate.
     34 
     35 Its options are as follows:
     36 
     37 **-a** \| **--inject-auditor**
     38    Installs triggers to notify real-time auditors of relevant changes to the database state.
     39 
     40 **-c** *FILENAME* \| **--config=**\ ‌\ *FILENAME*
     41    Use the configuration and other resources for the exchange to operate
     42    from *FILENAME*.
     43 
     44 **-d** *SCHEMA* \| **--disable-customization=**\ ‌\ *SCHEMA*
     45    Remove rules from a customization schema from an exchange database.
     46    Note that doing so may result in an irrevocable loss of statistics,
     47    depending on how the rules are written.
     48 
     49 **-e** *SCHEMA* \| **--enable-customization=**\ ‌\ *SCHEMA*
     50    Load a customization schema to inject deployment-specific rules into an
     51    exchange database.  Used to add operator-specific AML rules and statistics
     52    via triggers defined in their own schema.
     53 
     54 **-g** \| **--gc**
     55    Garbage collect database. Deletes all unnecessary data in the
     56    database.
     57 
     58 **-h** \| **--help**
     59    Print short help on options.
     60 
     61 **-L** *LOGLEVEL* \| **--loglevel=**\ ‌\ *LOGLEVEL*
     62    Specifies the log level to use. Accepted values are: ``DEBUG``, ``INFO``,
     63    ``WARNING``, ``ERROR``.
     64 
     65 **-l** *FILENAME* \| **--logfile=**\ ‌\ *FILENAME*
     66    Send logging output to *FILENAME*.
     67 
     68 **-r** \| **--reset**
     69    Drop tables. Dangerous, will delete all existing data in the database
     70    before creating the tables.
     71 
     72 **-s** \| **--shardunlock**
     73    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.
     74 
     75 **-v** \| **–version**
     76    Print version information.
     77 
     78 See Also
     79 ========
     80 
     81 taler-exchange-httpd(1), taler-exchange-offline(1),
     82 taler-exchange-dbconfig(1), taler-exchange.conf(5).
     83 
     84 Bugs
     85 ====
     86 
     87 Report bugs by using https://bugs.taler.net or by sending electronic
     88 mail to <taler@gnu.org>.