diff options
author | MS <ms@taler.net> | 2020-12-10 18:27:29 +0100 |
---|---|---|
committer | MS <ms@taler.net> | 2020-12-10 18:27:51 +0100 |
commit | fbe6e17700125a791e78b0262603d24309e3ecd3 (patch) | |
tree | f84af852a19008f6d8709d609aaa5fc1dfb7044a /libeufin/nexus-tutorial.rst | |
parent | c6955531567b6bcfdf52e527253c2207e89af8ef (diff) | |
download | docs-fbe6e17700125a791e78b0262603d24309e3ecd3.tar.gz docs-fbe6e17700125a791e78b0262603d24309e3ecd3.tar.bz2 docs-fbe6e17700125a791e78b0262603d24309e3ecd3.zip |
launching Nexus how-to
Diffstat (limited to 'libeufin/nexus-tutorial.rst')
-rw-r--r-- | libeufin/nexus-tutorial.rst | 28 |
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) |