summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMS <ms@taler.net>2023-07-29 10:28:14 +0200
committerMS <ms@taler.net>2023-07-29 10:28:42 +0200
commit86a033fafbd4b3e826c499b0f5cdd746d03653c9 (patch)
tree84a896a6a062d2aaa6990a8ce8828d7781531e8e
parent6b28afc281a80f99f12fe78c8e95ac78ebf912f9 (diff)
downloaddocs-86a033fafbd4b3e826c499b0f5cdd746d03653c9.tar.gz
docs-86a033fafbd4b3e826c499b0f5cdd746d03653c9.tar.bz2
docs-86a033fafbd4b3e826c499b0f5cdd746d03653c9.zip
Remove JDBC mentions from Nexus tutorial.
-rw-r--r--libeufin/nexus-tutorial.rst24
1 files changed, 9 insertions, 15 deletions
diff --git a/libeufin/nexus-tutorial.rst b/libeufin/nexus-tutorial.rst
index 64f4a69e..af142821 100644
--- a/libeufin/nexus-tutorial.rst
+++ b/libeufin/nexus-tutorial.rst
@@ -147,7 +147,7 @@ core banking system with EBICS access to bank accounts.
The sandbox uses HTTP Basic auth, with username ``admin``.
Choose a password and set env var ``LIBEUFIN_SANDBOX_ADMIN_PASSWORD`` to it.
-The sandbox relies on a database, which you must specify using a JDBC
+The sandbox relies on a database, which you must specify using a Postgres
connection URI with the ``LIBEUFIN_SANDBOX_DB_CONNECTION`` environment
variable, before invoking any commands.
If this variable is not set, ``libeufin-sandbox`` complains and exits:
@@ -156,12 +156,10 @@ If this variable is not set, ``libeufin-sandbox`` complains and exits:
$ export LIBEUFIN_SANDBOX_ADMIN_PASSWORD=secret
$ libeufin-sandbox serve
- DB connection string not found/valid in the env variable LIBEUFIN_SANDBOX_DB_CONNECTION.
+ DB connection string not found in the env variable LIBEUFIN_SANDBOX_DB_CONNECTION.
The following two examples are valid connection strings:
- jdbc:sqlite:/tmp/libeufindb.sqlite3
- jdbc:postgresql://localhost:5432/libeufindb?user=Foo&password=secret
-
-Only *SQLite* and *PostgreSQL (via TCP)* are supported right now.
+ postgresql://localhost:5432/libeufindb?user=Foo&password=secret
+ postgres:///libeufindb
Before being usable, a Sandbox needs to be configured. This is done
by creating the ``default`` demobank. A demobank is a set of configuration
@@ -177,14 +175,14 @@ A default demobank having the EUR currency is created with the following command
.. code-block:: console
- $ export LIBEUFIN_SANDBOX_DB_CONNECTION=jdbc:sqlite:/tmp/libeufintestdb
+ $ export LIBEUFIN_SANDBOX_DB_CONNECTION=postgres:///libeufintestdb
$ libeufin-sandbox config --currency EUR default
In order to use Taler, a default exchange needs to be configured.
.. code-block:: console
- $ export LIBEUFIN_SANDBOX_DB_CONNECTION=jdbc:sqlite:/tmp/libeufintestdb
+ $ export LIBEUFIN_SANDBOX_DB_CONNECTION=postgres:///libeufintestdb
$ libeufin-sandbox default-exchange --demobank default $exchange_base_url $exchange_payto_address
The sandbox service can now be started with the following command:
@@ -192,7 +190,7 @@ The sandbox service can now be started with the following command:
.. code-block:: console
$ export LIBEUFIN_SANDBOX_ADMIN_PASSWORD=secret
- $ export LIBEUFIN_SANDBOX_DB_CONNECTION=jdbc:sqlite:/tmp/libeufintestdb
+ $ export LIBEUFIN_SANDBOX_DB_CONNECTION=postgres:///libeufintestdb
$ libeufin-sandbox serve --port 5016
The instructions below hook Nginx to the Sandbox:
@@ -445,15 +443,11 @@ the :ref:`Sandbox API <sandbox-api>`.
Connect Nexus with the bank.
============================
-Nexus relies on a database, which you must specify using a JDBC
+Nexus relies on a database, which you must specify using a Postgres
connection URI with the ``LIBEUFIN_NEXUS_DB_CONNECTION`` environment
variable, before invoking any commands.
(If this variable is not set, ``libeufin-nexus`` complains and exits.)
-Only *SQLite* (e.g. ``jdbc:sqlite:/tmp/libeufintestdb``) and *PostgreSQL (via TCP)*
-(e.g. ``jdbc:postgresql://localhost:$port/libeufintestdb?user=$username&password=$password``)
-are supported right now.
-
Use the following command to run the Nexus service:
Neuxs defaults to *not* storing the messages that it downloads
@@ -463,7 +457,7 @@ Use the following command to run the Nexus service:
.. code-block:: console
- $ export LIBEUFIN_NEXUS_DB_CONNECTION=jdbc:postgresql://localhost:5433/libeufindb?user=foo&password=secret
+ $ export LIBEUFIN_NEXUS_DB_CONNECTION=postgresql://localhost:5433/libeufindb?user=foo&password=secret
$ libeufin-nexus serve --port 5017
This assumes that the PostgreSQL service with a database