summaryrefslogtreecommitdiff
path: root/taler-merchant-manual.rst
diff options
context:
space:
mode:
authorChristian Grothoff <christian@grothoff.org>2023-02-20 16:36:17 +0100
committerChristian Grothoff <christian@grothoff.org>2023-02-20 16:36:17 +0100
commit559514aee334782face75959db91a148177e6e8a (patch)
tree5aaab2e17c0a731370b695e289ca5700c5594570 /taler-merchant-manual.rst
parent15a1d8057083ee51550c22b8b9778ba8c84fbbd0 (diff)
downloaddocs-559514aee334782face75959db91a148177e6e8a.tar.gz
docs-559514aee334782face75959db91a148177e6e8a.tar.bz2
docs-559514aee334782face75959db91a148177e6e8a.zip
update installation instructions
Diffstat (limited to 'taler-merchant-manual.rst')
-rw-r--r--taler-merchant-manual.rst143
1 files changed, 16 insertions, 127 deletions
diff --git a/taler-merchant-manual.rst b/taler-merchant-manual.rst
index f568ef15..f00f6b82 100644
--- a/taler-merchant-manual.rst
+++ b/taler-merchant-manual.rst
@@ -271,80 +271,43 @@ This chapter describes how to install the GNU Taler merchant backend.
.. _Generic-instructions:
-Generic instructions for installation from source
--------------------------------------------------
+Installing from source
+----------------------
-This section provides generic instructions for the merchant backend
-installation independent of any particular operating system. Operating
-system specific instructions are provided in the following sections. You
-should follow the operating system specific instructions if those are
-available, and only consult the generic instructions if no
-system-specific instructions are provided for your specific operating
-system.
+The following instructions will show how to install a GNU Taler
+merchant backend from source.
-.. _Installation-of-dependencies:
-
-Installation of dependencies
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-The following packages need to be installed before we can compile the
-backend:
-
-.. include:: frags/list-of-dependencies.rst
-
-- GNU Taler exchange (see `release announcement <https://mail.gnu.org/archive/cgi-bin/namazu.cgi?query=taler&idxname=info-gnu&max=20&result=normal&sort=date:late>`__)
-
-Except for the last two, these are available in most GNU/Linux distributions
-and should just be installed using the respective package manager. Be careful
-with GNU libmicrohttpd; here, some distributions only include an older version
-that will not work.
-
-While you are in the GNU Taler exchange
-`download directory <http://ftpmirror.gnu.org/taler/>`__,
-you might as well also download the tarball for GNU Taler merchant.
+The package sources can be find in our
+`download directory <http://ftpmirror.gnu.org/taler/>`__.
GNU Taler components version numbers follow the ``MAJOR.MINOR.MICRO`` format.
The general rule for compatibility is that ``MAJOR`` and ``MINOR`` must match.
Exceptions to this general rule are documented in the release notes.
-For example, Taler merchant 0.8.0 is compatible with Taler exchange 0.8.1.
-
-The following sections will provide detailed instructions for installing
-the ``libgnunetutil`` and GNU Taler exchange dependencies.
-
-.. _Installing-libgnunetutil:
+For example, Taler merchant 1.3.0 should be compatible with Taler exchange 1.4.x
+as the MAJOR version matches. A MAJOR version of 0 indicates experimental
+development, and you are expected to always run all of the *latest* releases
+together (no compatibility guarantees).
-Installing GNUnet
-^^^^^^^^^^^^^^^^^
+First, the following packages need to be installed before we can compile the
+backend:
-.. index:: GNUnet
+.. include:: frags/list-of-dependencies.rst
.. include:: frags/installing-gnunet.rst
+.. include:: frags/install-before-check.rst
+
There is no need to actually run a GNUnet peer to use the Taler merchant
backend -- all the merchant needs from GNUnet is a number of headers and
libraries!
-
-.. _Installing-the-GNU-Taler-exchange:
-
-Installing the GNU Taler exchange
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-.. index:: exchange
-
.. include:: frags/installing-taler-exchange.rst
There is no need to actually run a Taler exchange to use the Taler merchant
backend -- all the merchant needs from the Taler exchange is a few headers and
libraries!
-
-.. _Installing-the-GNU-Taler-merchant-backend:
-
-Installing the GNU Taler merchant backend
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-.. index:: backend
+.. include:: frags/install-before-check.rst
.. include:: frags/installing-taler-merchant.rst
@@ -373,80 +336,6 @@ Installing the GNU Taler binary packages on Ubuntu
.. include:: frags/apt-install-taler-merchant.rst
-.. _Installing-Taler-on-Debian-GNU_002fLinux:
-
-Installing Taler on Debian GNU/Linux from source
-------------------------------------------------
-
-.. index:: Wheezy
-.. index:: Jessie
-.. index:: Stretch
-.. index:: Buster
-.. index:: Bullseye
-.. index:: Debian
-
-Debian Wheezy is too old and lacks most of the packages required.
-Debian Jessie, Stretch, and Buster are better, but still lack PostgreSQL 12.
-
-.. note::
-
- When compiling PostgreSQL 12, make sure to
- do ``make world`` to build the ``contrib/`` modules, and
- ``cd contrib && make install`` to install them, as well.
-
-On Debian Stretch and Buster, only GNU libmicrohttpd needs to be compiled from
-source. To install dependencies on Debian Stretch, run the following
-commands:
-
-.. code-block:: console
-
- # apt-get install \
- libqrencode-dev \
- libsqlite3-dev \
- libltdl-dev \
- libunistring-dev \
- libsodium-dev \
- libargon2-0-dev \
- libcurl4-gnutls-dev \
- libgcrypt20-dev \
- libjansson-dev \
- libpq-dev \
- postgresql-9.6
- # wget https://ftpmirror.gnu.org/libmicrohttpd/libmicrohttpd-latest.tar.gz
- # wget https://ftpmirror.gnu.org/libmicrohttpd/libmicrohttpd-latest.tar.gz.sig
- # gpg -v libmicrohttpd-latest.tar.gz # Should show signed by 939E6BE1E29FC3CC
- # tar xf libmicrohttpd-latest.tar.gz
- # cd libmicrohttpd-0*
- # ./configure
- # make install
-
-For more recent versions of Debian, you should instead run:
-
-.. code-block:: console
-
- # apt-get install \
- libqrencode-dev \
- libsqlite3-dev \
- libltdl-dev \
- libunistring-dev \
- libsodium-dev \
- libargon2-dev \
- libcurl4-gnutls-dev \
- libgcrypt20-dev \
- libjansson-dev \
- libpq-dev \
- postgresql-9.6 \
- libmicrohttpd-dev
-
-Note that Stretch requires ``libargon2-0-dev``,
-while later versions of Debian require ``libargon2-dev``.
-
-For the rest of the installation, follow the generic installation
-instructions starting with the installation of libgnunetutil. Note that
-if you used the Debian Stretch instructions above, you need to pass
-``--with-microhttpd=/usr/local/`` to all ``configure`` invocations.
-
-
How to configure the merchant’s backend
=======================================