summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--libeufin/nexus-tutorial.rst28
1 files changed, 17 insertions, 11 deletions
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)