From 86a033fafbd4b3e826c499b0f5cdd746d03653c9 Mon Sep 17 00:00:00 2001 From: MS Date: Sat, 29 Jul 2023 10:28:14 +0200 Subject: Remove JDBC mentions from Nexus tutorial. --- libeufin/nexus-tutorial.rst | 24 +++++++++--------------- 1 file 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 `. 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 -- cgit v1.2.3