summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorThien-Thi Nguyen <ttn@gnuvola.org>2021-08-06 22:18:49 -0400
committerThien-Thi Nguyen <ttn@gnuvola.org>2021-08-06 22:18:49 -0400
commit96475488928ea09e28844cc47111d2d2806dfbed (patch)
treed490d07b946e86877d7ac08c1b33d9a1f9a21a01
parent19f70dba125076f57f07422d45f357ca63b89001 (diff)
downloaddocs-96475488928ea09e28844cc47111d2d2806dfbed.tar.gz
docs-96475488928ea09e28844cc47111d2d2806dfbed.tar.bz2
docs-96475488928ea09e28844cc47111d2d2806dfbed.zip
add period at end of sentence
-rw-r--r--taler-exchange-setup-guide.rst76
1 files changed, 38 insertions, 38 deletions
diff --git a/taler-exchange-setup-guide.rst b/taler-exchange-setup-guide.rst
index 379d98a4..c17ac6f3 100644
--- a/taler-exchange-setup-guide.rst
+++ b/taler-exchange-setup-guide.rst
@@ -93,7 +93,7 @@ signing key to your list of trusted keys and update the package index:
..
FIXME: this happens after the update.
- N: Skipping acquire of configured file 'main/binary-i386/Packages' as repository 'https://deb.taler.net/apt/ubuntu focal-fossa InRelease' doesn't support architecture 'i386'
+ N: Skipping acquire of configured file 'main/binary-i386/Packages' as repository 'https://deb.taler.net/apt/ubuntu focal-fossa InRelease' doesn't support architecture 'i386'.
Finally, the required packages can be installed:
@@ -155,14 +155,14 @@ Services, users, groups and file system hierarchy
The *taler-exchange-httpd* package will create several system users
to compartmentalize different parts of the system:
-* taler-exchange-httpd: runs the HTTP daemon with the core business logic
-* taler-exchange-secmod-rsa: manages the RSA private online signing keys
-* taler-exchange-secmod-eddsa: manages the EdDSA private online signing keys
-* taler-exchange-closer: closes idle reserves by triggering wire transfers that refund the originator
-* taler-exchange-aggregator: aggregates deposits into larger wire transfer requests
-* taler-exchange-wire: performs wire transfers with the bank (via libeufin/nexus)
-* postgres: runs the Postgres database (from *postgres* package)
-* www-data: runs the frontend HTTPS service with the TLS keys (from *nginx* package)
+* taler-exchange-httpd: runs the HTTP daemon with the core business logic.
+* taler-exchange-secmod-rsa: manages the RSA private online signing keys.
+* taler-exchange-secmod-eddsa: manages the EdDSA private online signing keys.
+* taler-exchange-closer: closes idle reserves by triggering wire transfers that refund the originator.
+* taler-exchange-aggregator: aggregates deposits into larger wire transfer requests.
+* taler-exchange-wire: performs wire transfers with the bank (via libeufin/nexus).
+* postgres: runs the Postgres database (from *postgres* package).
+* www-data: runs the frontend HTTPS service with the TLS keys (from *nginx* package).
.. note::
@@ -172,35 +172,35 @@ to compartmentalize different parts of the system:
The exchange setup uses the following system groups:
-* taler-exchange-db: group for all Taler users with direct database access, specifically taler-exchange-httpd, taler-exchange-wire, taler-exchange-closer and taler-exchange-aggregator
-* taler-exchange-secmod: group for processes with access to online signing keys; this group must have three users: taler-exchange-secmod-rsa, taler-exchange-secmod-eddsa and taler-exchange-httpd
-* taler-exchange-offline: group for the access to the offline private key (only used on the offline host and not used on the online system)
+* taler-exchange-db: group for all Taler users with direct database access, specifically taler-exchange-httpd, taler-exchange-wire, taler-exchange-closer and taler-exchange-aggregator.
+* taler-exchange-secmod: group for processes with access to online signing keys; this group must have three users: taler-exchange-secmod-rsa, taler-exchange-secmod-eddsa and taler-exchange-httpd.
+* taler-exchange-offline: group for the access to the offline private key (only used on the offline host and not used on the online system).
The package will deploy systemd service files in
``/usr/lib/systemd/system/`` for the various components:
-* taler-exchange-aggregator.service: service that schedules wire transfers which combine multiple deposits to the same merchant
-* taler-exchange-closer.service: service that watches for reserves that have been abandoned and schedules wire transfers to send the money back to the originator
-* taler-exchange-httpd.service: main Taler exchange logic with the public REST API
-* taler-exchange-httpd.socket: systemd socket activation for the Taler exchange HTTP daemon
-* taler-exchange-secmod-eddsa.service: software security module for making EdDSA signatures
-* taler-exchange-secmod-rsa.service: software security module for making RSA signatures
-* taler-exchange-transfer.service: service that triggers outgoing wire transfers (pays merchants)
-* taler-exchange-wirewatch.service: service that watches for incoming wire transfers (first step of withdraw)
-* taler-exchange.target: Main target for the Taler exchange to be operational
+* taler-exchange-aggregator.service: service that schedules wire transfers which combine multiple deposits to the same merchant.
+* taler-exchange-closer.service: service that watches for reserves that have been abandoned and schedules wire transfers to send the money back to the originator.
+* taler-exchange-httpd.service: main Taler exchange logic with the public REST API.
+* taler-exchange-httpd.socket: systemd socket activation for the Taler exchange HTTP daemon.
+* taler-exchange-secmod-eddsa.service: software security module for making EdDSA signatures.
+* taler-exchange-secmod-rsa.service: software security module for making RSA signatures.
+* taler-exchange-transfer.service: service that triggers outgoing wire transfers (pays merchants).
+* taler-exchange-wirewatch.service: service that watches for incoming wire transfers (first step of withdraw).
+* taler-exchange.target: Main target for the Taler exchange to be operational.
The deployment creates the following key locations in the system:
-* /etc/taler/: configuration files
-* /var/run/taler/: contains the UNIX domain sockets for inter-process communication (IPC)
+* /etc/taler/: configuration files.
+* /var/run/taler/: contains the UNIX domain sockets for inter-process communication (IPC).
* /var/lib/taler/: serves as the $HOME for all Taler users and contains sub-directories
with the private keys; which keys are stored here depends on the host:
- * online system: exchange-secmod-eddsa and exchange-secmod-rsa keys
- * offline system: exchange-offline keys
+ * online system: exchange-secmod-eddsa and exchange-secmod-rsa keys.
+ * offline system: exchange-offline keys.
Setup Linting
@@ -264,7 +264,7 @@ This section will walk through (1) installing and configuring LibEuFin and
If you do not have a bank account with EBICS but want to test these instructions,
you can use the EBICS sandbox as described in the
- :doc:`LibEuFin Tutorial <libeufin/nexus-tutorial>`
+ :doc:`LibEuFin Tutorial <libeufin/nexus-tutorial>`.
Installation and Basic Configuration
@@ -609,7 +609,7 @@ and create payment initiations with a Taler wire gateway facade:
..
FIXME: the two commands above output a empty JSON object
when successful. Possibly, we should suppress that (just like
- the other commands do)
+ the other commands do).
The list of all granted permissions can be reviewed:
@@ -644,7 +644,7 @@ exchange processes should not have access to this information.
enable_credit = yes
enable_debit = yes
- # Account identifier in the form of an RFC-8905 payto:// URI
+ # Account identifier in the form of an RFC-8905 payto:// URI.
# For SEPA, looks like payto://sepa/$IBAN
payto_uri =
@@ -849,7 +849,7 @@ operational. To make the exchange HTTP service operational, the following
steps involving the offline signing machine must be completed:
1. The public keys of various online keys used by the exchange service are exported
- via a management HTTP API
+ via a management HTTP API.
2. The offline signing system validates this request and signs it.
Additionally, the offline signing system signs policy messages
to configure the exchange's bank accounts and associated fees.
@@ -886,10 +886,10 @@ a merchant backend is not required, as the wallet acts as a merchant.
.. code-block:: shell-session
# This will now output a payto URI that money needs to be sent to in order to allow withdrawal
- # of taler coins
+ # of taler coins.
$ taler-wallet-cli advanced withdraw-manually --exchange $EXCHANGE_URL --amount EUR:10.50
- # Show the status of the manual withdrawal operation
+ # Show the status of the manual withdrawal operation.
$ taler-wallet-cli transactions
#
@@ -898,17 +898,17 @@ a merchant backend is not required, as the wallet acts as a merchant.
# as instructed by the wallet after the first step.
#
- # Check whether the exchange received an incoming bank transfer
+ # Check whether the exchange received an incoming bank transfer.
[root@exchange-online]# taler-exchange-wire-gateway-client --section exchange-accountcredentials-1 --credit-history
- # Once the transfer has been made, try completing the withdrawal
+ # Once the transfer has been made, try completing the withdrawal.
$ taler-wallet-cli run-pending
- # Check status of transactions and show balance
+ # Check status of transactions and show balance.
$ taler-wallet-cli transactions
$ taler-wallet-cli balance
- # Now, directly deposit coins with the exchange into a target account
+ # Now, directly deposit coins with the exchange into a target account.
# (Usually, a payment is made via a merchant. The wallet provides
# this functionality for testing.)
$ taler-wallet-cli deposit create EUR:5 payto://sepa/$IBAN
@@ -921,10 +921,10 @@ a merchant backend is not required, as the wallet acts as a merchant.
# The "deposit group id" can be found in the output of the transactions list.
$ taler-wallet-cli deposit track $DEPOSIT_GROUP_ID
- # Check whether the exchange sent an outgoing transfer
+ # Check whether the exchange sent an outgoing transfer.
[root@exchange-online]# taler-exchangewire-gateway-client --section exchange-account-1 --debit-history
- # After enough time has passed, the money should arrive at the specified IBAN
+ # After enough time has passed, the money should arrive at the specified IBAN.
FIXMEs
@@ -938,4 +938,4 @@ FIXMEs
N: Skipping acquire of configured file 'main/binary-i386/Packages' as
repository 'https://deb.taler.net/apt/ubuntu focal-fossa InRelease' doesn't
- support architecture 'i386'
+ support architecture 'i386'.