commit 75adf67bcd18c0cf131e36816b8107f762d3b631
parent 2e03169b957084fcce18960d96ae2f0926df01c4
Author: Christian Grothoff <christian@grothoff.org>
Date: Thu, 2 Mar 2023 12:57:44 +0100
do not have duplicated and outdated installation instructions in exchange setup guide
Diffstat:
2 files changed, 9 insertions(+), 47 deletions(-)
diff --git a/taler-exchange-manual.rst b/taler-exchange-manual.rst
@@ -280,6 +280,7 @@ system users. The configuration does not contain any sensitive information.
+.. _ExchangeInstallation:
Installation
============
diff --git a/taler-exchange-setup-guide.rst b/taler-exchange-setup-guide.rst
@@ -1,7 +1,7 @@
..
This file is part of GNU Taler.
- Copyright (C) 2021 Taler Systems SA
+ Copyright (C) 2021-2023 Taler Systems SA
GNU Taler is free software; you can redistribute it and/or modify it under the
terms of the GNU Affero General Public License as published by the Free Software
@@ -63,58 +63,18 @@ Information to write down during the installation:
Installation
============
-We assume that the system is a minimal installation of Ubuntu 20.04 LTS.
-Ideally, you should have two hosts, ``exchange-online`` and
-``exchange-offline``. It is also possible to run the HTTPS nginx server or
-the PostgreSQL database on yet another host, but in these instructions we will
-assume that only two hosts are used. Alas, the instructions will also work if
-you run everything on one system, but then you have the security drawback of
-not keeping the high-security private keys disconnected from the Internet.
-
-To install the exchange, first make sure that your system is up-to-date
-and that the ``gnupg`` package has been installed.
-
-.. code-block:: shell-session
-
- [root@exchange-online]# apt-get update
- [root@exchange-online]# apt-get upgrade
-
-Next, add the ``focal-fossa`` apt repository provided by Taler Systems S.A. to
-your package sources:
-
-.. code-block:: shell-session
+Please see the chapter on `exchange installation <ExchangeInstallation>`_ for
+various ways to install a GNU Taler exchange.
- [root@exchange-online]# cat > /etc/apt/sources.list.d/taler.list <<EOF
- deb https://deb.taler.net/apt/ubuntu focal-fossa main
- EOF
- [root@exchange-online]# dpkg --remove-architecture i386
-
-The second command is optional. It tells ``apt-get update`` to not
-bother with the ``i386`` architecture (thus avoiding a warning, later).
-If you use this, make sure you do not use any 32-bit applications.
-
-Before installing Taler packages, you need to add the Taler Systems S.A. package
-signing key to your list of trusted keys and update the package index:
+Note that it is possible to run the HTTPS reverse proxy or
+the PostgreSQL database on yet another host, but in these instructions we will
+assume that only two hosts are used. Note that in addition to the exchange
+you will thus need to install an HTTPS reverse proxy and the database:
.. code-block:: shell-session
- [root@exchange-online]# wget -O - https://taler.net/taler-systems.gpg.key | apt-key add -
[root@exchange-online]# apt-get update
-
-Finally, the required packages can be installed:
-
-.. code-block:: shell-session
-
[root@exchange-online]# apt-get install -y nginx postgresql
- [root@exchange-online]# apt-get install -y taler-exchange taler-exchange-offline
- [root@exchange-online]# apt-get install -y taler-merchant taler-wallet-cli
-
-By default, all installed services will be disabled. You need to enable
-and start them later.
-
-While ``taler-merchant`` and ``taler-wallet-cli`` are not required to operate an
-exchange, they are useful for testing. When asked about using dbconfig to configure
-the merchant's database, select ``yes``.
Configuration Basics
@@ -215,6 +175,7 @@ checks on the current GNU Taler exchange deployment:
.. code-block:: shell-session
+ [root@exchange-online]# apt install taler-wallet-cli
[root@exchange-online]# taler-wallet-cli deployment lint-exchange
You can optionally pass the ``--debug`` option to get more verbose output, and
