From 207adf498816ab5b033b8c1f51c94aeeb6a6d344 Mon Sep 17 00:00:00 2001 From: Thien-Thi Nguyen Date: Fri, 11 Dec 2020 00:52:20 -0500 Subject: add frag: using-taler-config.rst --- frags/using-taler-config.rst | 53 ++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 53 insertions(+) create mode 100644 frags/using-taler-config.rst (limited to 'frags') diff --git a/frags/using-taler-config.rst b/frags/using-taler-config.rst new file mode 100644 index 00000000..d7c28b23 --- /dev/null +++ b/frags/using-taler-config.rst @@ -0,0 +1,53 @@ +.. _Using-taler_002dconfig-exchange: + +Using taler-config +------------------ + +The tool ``taler-config`` can be used to extract or manipulate +configuration values; however, the configuration use the well-known INI +file format and can also be edited by hand. + +Run + +.. code-block:: console + + $ taler-config -s $SECTION + +to list all of the configuration values in section ``$SECTION``. + +Run + +.. code-block:: console + + $ taler-config -s $section -o $option + +to extract the respective configuration value for option ``$option`` in +section ``$section``. + +Finally, to change a setting, run + +.. code-block:: console + + $ taler-config -s $section -o $option -V $value + +to set the respective configuration value to ``$value``. Note that you +have to manually restart the Taler backend after you change the +configuration to make the new configuration go into effect. + +Some default options will use $-variables, such as ``$DATADIR`` within +their value. To expand the ``$DATADIR`` or other $-variables in the +configuration, pass the ``-f`` option to ``taler-config``. For example, +compare: + +.. code-block:: console + + $ taler-config -s ACCOUNT-bank \ + -o WIRE_RESPONSE + $ taler-config -f -s ACCOUNT-bank \ + -o WIRE_RESPONSE + +While the configuration file is typically located at +``$HOME/.config/taler.conf``, an alternative location can be specified +to ``taler-merchant-httpd`` and ``taler-config`` using the ``-c`` +option. + -- cgit v1.2.3