taler-docs

Documentation for GNU Taler components, APIs and protocols
Log | Files | Refs | README | LICENSE

commit fbe6e17700125a791e78b0262603d24309e3ecd3
parent c6955531567b6bcfdf52e527253c2207e89af8ef
Author: MS <ms@taler.net>
Date:   Thu, 10 Dec 2020 18:27:29 +0100

launching Nexus how-to

Diffstat:
Mlibeufin/nexus-tutorial.rst | 28+++++++++++++++++-----------
1 file changed, 17 insertions(+), 11 deletions(-)

diff --git a/libeufin/nexus-tutorial.rst b/libeufin/nexus-tutorial.rst @@ -28,8 +28,9 @@ Navigate into the `libeufin` local repository, and from top-level run: .. code-block:: console - $ ./gradlew -Pprefix=$PREFIX nexus:installToPrefix - $ ./gradlew -Pprefix=$PREFIX cli:installToPrefix + $ ./bootstrap + $ ./configure --prefix=$PREFIX + $ make install In case of success, the two following commands should be found: @@ -45,23 +46,28 @@ Use the following command to *(1) run the nexus service*: .. code-block:: console - $ libeufin-nexus + $ libeufin-nexus serve -After the startup, Nexus should have created a ``.sqlite3`` file in -its current working directory. Feel free to use the ``--with-db`` option -to change the database name and path. In future releases, the support -for PostgreSQL will be provided. +We recommend using the ``--db-conn-string=$DBCONN`` option. It +instructs Nexus to reach the database addressed by the connection +string. Only `SQLite` and `PostgreSQL (only via TCP)` are supported +right now. + +For example: + +.. code-block:: console + + $ libeufin-nexus serve --db-conn-string=jdbc:postgresql://127.0.0.1:5433/libeufindb?user=foo&password=secret At this point a *(2) superuser account needs to be activated into the system*: .. code-block:: console - $ libeufin-nexus superuser foo # Will interactively ask for password + $ libeufin-nexus superuser --db-conn-string=jdbc:postgresql://127.0.0.1:5433/libeufindb?user=foo&password=secret foo # Will interactively ask for password -For simplicity, we'll enable the superuser to access the bank account -via the EBICS protocol, but a API to create less privileged users is -offered as well. +For simplicity, a superuser can as well act as a normal user, but a API +to create less privileged users is offered. Nexus needs now to associate the user to a EBICS subscriber that was activated on the bank. In the Nexus terminology, this is called *(3)