From fbe6e17700125a791e78b0262603d24309e3ecd3 Mon Sep 17 00:00:00 2001 From: MS Date: Thu, 10 Dec 2020 18:27:29 +0100 Subject: launching Nexus how-to --- libeufin/nexus-tutorial.rst | 28 +++++++++++++++++----------- 1 file changed, 17 insertions(+), 11 deletions(-) (limited to 'libeufin/nexus-tutorial.rst') diff --git a/libeufin/nexus-tutorial.rst b/libeufin/nexus-tutorial.rst index e919ed8c..5d090992 100644 --- 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) -- cgit v1.2.3