anastasis

Credential backup and recovery protocol and service
Log | Files | Refs | Submodules | README | LICENSE

using-anastasis-config.rst (1451B)


      1 Using anastasis-config
      2 ----------------------
      3 
      4 The tool ``anastasis-config`` can be used to extract or manipulate
      5 configuration values; however, the configuration use the well-known INI
      6 file format and can also be edited by hand.
      7 
      8 Run
      9 
     10 .. code-block:: console
     11 
     12    $ anastasis-config -s $SECTION
     13 
     14 to list all of the configuration values in section ``$SECTION``.
     15 
     16 Run
     17 
     18 .. code-block:: console
     19 
     20    $ anastasis-config -s $section -o $option
     21 
     22 to extract the respective configuration value for option ``$option`` in
     23 section ``$section``.
     24 
     25 Finally, to change a setting, run
     26 
     27 .. code-block:: console
     28 
     29    $ anastasis-config -s $section -o $option -V $value
     30 
     31 to set the respective configuration value to ``$value``. Note that you
     32 have to manually restart the Taler backend after you change the
     33 configuration to make the new configuration go into effect.
     34 
     35 Some default options will use $-variables, such as ``$DATADIR`` within
     36 their value. To expand the ``$DATADIR`` or other $-variables in the
     37 configuration, pass the ``-f`` option to ``anastasis-config``. For example,
     38 compare:
     39 
     40 .. code-block:: console
     41 
     42    $ anastasis-config -s ACCOUNT-bank \
     43                   -o WIRE_RESPONSE
     44    $ anastasis-config -f -s ACCOUNT-bank \
     45                   -o WIRE_RESPONSE
     46 
     47 While the configuration file is typically located at
     48 ``$HOME/.config/taler.conf``, an alternative location can be specified
     49 to ``taler-merchant-httpd`` and ``anastasis-config`` using the ``-c``
     50 option.