taler-docs

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

taler-auditor-sync.1.rst (2377B)

      1 taler-auditor-sync(1)
      2 #####################
      3 
      4 .. only:: html
      5 
      6    Name
      7    ====
      8 
      9    **taler-auditor-sync** - create a "safe" synchronized copy of a Taler exchange database for an audit
     10 
     11 
     12 Synopsis
     13 ========
     14 
     15 **taler-auditor-sync**
     16 [**-s** *FILENAME* | **--source-configuration=**\ ‌\ *FILENAME*]
     17 [**-d** *FILENAME* | **--destination-configuration=**\ ‌\ *FILENAME*]
     18 [**-h** | **--help**]
     19 [**-b** *SIZE* | **--batch=**\ ‌\ *SIZE*]
     20 [**-t** | **--terminate-when-synchronized**]
     21 [**-v** | **--version**]
     22 [**-L** *LOGLEVEL* | **--loglevel=**\ ‌\ *LOGLEVEL*]
     23 
     24 Description
     25 ===========
     26 
     27 **taler-auditor-sync** is a command-line tool to synchronize the
     28 Taler auditor's database in a safe way from a Taler exchange
     29 database. If the exchange database violates the assumed database
     30 invariants (as expressed by database constraints) or attempts to
     31 DELETE or UPDATE tables (at least those that the auditor relies
     32 upon), **taler-auditor-sync** will not replicate those changes
     33 and instead halt with an error.
     34 
     35 Its options are as follows:
     36 
     37 **-s** *FILENAME* \| **--source-configuration=**\ ‌\ *FILENAME*
     38    Use the configuration in *FILENAME* to access the original (source) exchange
     39    database to copy records from.
     40 
     41 **-d** *FILENAME* \| **--destination-configuration=**\ ‌\ *FILENAME*
     42    Use the configuration in *FILENAME* to access the target (destination) exchange
     43    database to copy records to.
     44 
     45 **-t** \| **--terminate-when-synchronized**
     46    The program should exit once the two databases are in sync, instead of continuously
     47    copying more records when the source database is updated.
     48 
     49 **-h** \| **--help**
     50    Print short help on options.
     51 
     52 **-L** *LOGLEVEL* \| **--loglevel=**\ ‌\ *LOGLEVEL*
     53    Specifies the log level to use. Accepted values are: ``DEBUG``, ``INFO``,
     54    ``WARNING``, ``ERROR``.
     55 
     56 **-b** *SIZE* \| **--batch=**\ ‌\ *SIZE*
     57    Target number of records to copy in one transaction. Once the databases are
     58    in sync, the batch size is used to determine how long the process sleeps before
     59    trying to again synchronize the two databases. Not useful if **-t** is used.
     60 
     61 **-v** \| **--version**
     62    Print version information.
     63 
     64 See Also
     65 ========
     66 
     67 taler-auditor(1), taler-auditor.conf(5), taler-exchange.conf(5), taler-exchange-dbinit(1).
     68 
     69 Bugs
     70 ====
     71 
     72 Report bugs by using https://bugs.taler.net/ or by sending electronic
     73 mail to <taler@gnu.org>.