summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorThien-Thi Nguyen <ttn@gnuvola.org>2022-09-19 02:18:39 -0400
committerThien-Thi Nguyen <ttn@gnuvola.org>2022-09-19 02:18:39 -0400
commitc91d277094ef0c6d58fa727fa0923eb17bbf139d (patch)
tree597fe28cb18518b3bd1b90793b531a92c3f72ad4
parent561e76a26b1e63e6c604c427799de6a8ae69939d (diff)
downloaddocs-c91d277094ef0c6d58fa727fa0923eb17bbf139d.tar.gz
docs-c91d277094ef0c6d58fa727fa0923eb17bbf139d.tar.bz2
docs-c91d277094ef0c6d58fa727fa0923eb17bbf139d.zip
remove "Back-office Web service manual"
https://bugs.gnunet.org/view.php?id=7364
-rw-r--r--conf.py2
-rw-r--r--index.rst1
-rw-r--r--taler-backoffice-manual.rst135
3 files changed, 0 insertions, 138 deletions
diff --git a/conf.py b/conf.py
index 5da674a7..a2fa3485 100644
--- a/conf.py
+++ b/conf.py
@@ -242,8 +242,6 @@ latex_documents = [
'GNU Taler Merchant POS Terminal', 'GNU Taler team', 'manual'),
('taler-merchant-api-tutorial', 'taler-merchant-api-tutorial.tex',
'GNU Taler Merchant API Tutorial', 'GNU Taler team', 'manual'),
- ('taler-backoffice-manual', 'taler-backoffice-manual.tex',
- 'GNU Taler Back Office Manual', 'GNU Taler team', 'manual'),
('taler-developer-manual', 'taler-developer-manual.tex', 'GNU Taler Developer Manual',
'GNU Taler team', 'manual'),
]
diff --git a/index.rst b/index.rst
index c16a9125..74fbb4d1 100644
--- a/index.rst
+++ b/index.rst
@@ -64,7 +64,6 @@ Documentation Overview
taler-merchant-api-tutorial
taler-merchant-pos-terminal
taler-bank-manual
- taler-backoffice-manual
taler-auditor-manual
taler-developer-manual
taler-wallet
diff --git a/taler-backoffice-manual.rst b/taler-backoffice-manual.rst
deleted file mode 100644
index 3042845d..00000000
--- a/taler-backoffice-manual.rst
+++ /dev/null
@@ -1,135 +0,0 @@
-.. _Top:
-
-Back-office Web service manual
-###############################
-
-.. _Introduction:
-
-Introduction
-============
-
-The back-office Web service allows a merchant to check on the status of
-their Taler transactions. Merchants can check if and when they were paid
-by a wire transfer for coins deposited at the exchange. Also, given a
-wire transfer they have received, they can ask which Taler transactions
-correspond to the wire transfer.
-
-This manual guides merchant system administrators through the
-installation and configuration of this Web service.
-
-.. _Installation:
-
-Installation
-============
-
-The back-office Web service code is available at
-``git://taler.net/backoffice``. The application can be installed in a
-GNU-ish fashion.
-
-.. code-block:: console
-
- # Get the code:
- $ git clone git://taler.net/backoffice
-
- # Bootstrap and configure
- $ cd backoffice
- $ ./bootstrap
- # This step will check if the system is ready to
- # allow the installation.
- $ ./configure --prefix=<PREFIX>
- $ make install
-
-Note that to make the application work ``<PREFIX>/bin`` must be included
-in the ``$PATH``, and ``<PREFIX>/lib/python3.7/site-packages/`` in
-``$PYTHONPATH``.
-
-.. _Configuration:
-
-Configuration
-=============
-
-The following information must be provided in the configuration: on
-which address the backend should serve the Web site, which currency is
-used, and which merchant backend this Web service will work with.
-
-The merchant backend is an important agent, as it is responsible for
-returning information about transactions and wire transfers. The
-backoffice Web service is merely a frontend for it. A separate manual
-(available at https://docs.taler.net/merchant/backend/html/manual.html)
-describes the installation and configuration of the merchant backend.
-
-Assuming the reader is familiar with configuration in Taler (if not,
-read:
-https://docs.taler.net/exchange/html/taler-exchange.html#Configuration-format),
-a working configuration example is the following one:
-
-.. code-block:: ini
-
- [taler]
- # will be EUR, USD, or whatever currency the merchant
- # works with.
- currency = KUDOS
-
- # each back-office Web service is associated with a "frontend
- # name": this name instructs the application which configuration
- # section is going to be read. Thus <name> is the "frontend name"
- # and must be specified on the command line via the "--frontend"
- # option. See the 'Run' chapter for more details on launching the
- # application.
- [backoffice-<name>]
-
- # This option sets the way the backoffice communicates
- # when it is instructed to operate via UWSGI. Therefore,
- # <how> can be: TCP or UNIX. If TCP is given, then the
- # additional UWSGI_PORT option becomes necessary.
- uwsgi_serve = <how>
-
- # those options will be read if the Web site is served via
- # WSGI.
- uwsgi_unixpath_mode = 660
- uwsgi_unixpath = /path/to/backoffice-<name>.uwsgi
- uwsgi_unixmode = 666
-
- # If UWSGI_SERVE were set as 'TCP', then the following option
- # would have been necessary. It instructs the backoffice service
- # about which TCP port should be listened on, to communicate over
- # UWSGI.
- # uwsgi_port = 8080
-
- # this option will be read if the Web site is served via
- # HTTP.
- http_port = 5959
-
- # specifies which merchant backend is going to be used.
- backend = http://backend.test.taler.net/
-
- # Informally speaking, each instance points to both a private
- # key that can sign proposals and a bank account that can receive
- # wire transfers by some exchange.
-
- # Here, <instance_i> is just a string (with no spaces) that will
- # make the referenced instance be traceable by the back-office Web
- # application.
-
- instances = <instance_1> <instance_2> ..
-
-.. _Launching-the-backoffice:
-
-Launching the backoffice
-========================
-
-The following example shows how to run the Web service.
-
-.. code-block:: console
-
- # Such invocation will work only if the configuration contains
- # a section called "[backoffice-myshop]" which looks like the
- # example above.
-
- # As of serving, the Web site will be available via HTTP, at the
- # port specified in the configuration option "http_port", at localhost.
-
- $ taler-merchant-backoffice --frontend myshop serve-http
-
-Other options, such as those to serve the site via WSGI, are explained
-in the man page and can be listed using the ``--help`` argument.