initial-config

This section lists the Corda CLI initial-config arguments. You can use these commands to manually perform various setup actions, as described in the Manual Bootstrapping Tutorial.

create-user-config

The create-user-config command creates the SQL script to add the RBAC configuration for an initial admin user.

Argument
Description
-l, --locationThe path to write the generated SQL files to.
-p, --passwordThe password of the initial admin user.
-u, --userThe user name of the initial admin user.
corda-cli.sh initial-config create-user-config -u <INITIAL-ADMIN-USERNAME> -p <INITIAL-ADMIN-PASSWORD> -l /tmp/db
corda-cli.sh initial-config create-user-config -u <INITIAL-ADMIN-USERNAME> -p <INITIAL-ADMIN-PASSWORD> -l /tmp/db
corda-cli.cmd initial-config create-user-config -u <INITIAL-ADMIN-USERNAME> -p <INITIAL-ADMIN-PASSWORD> -l /tmp/db

create-db-config

The create-db-config command creates the SQL statements to insert the connection manager configuration for the database.

Argument
Description
-a, --is-adminSpecifies if this is an admin (DDL) connection. The default value is false.
-d, --descriptionDetailed information about the database connection.
-e, --passphraseThe passphrase for the encrypting secrets service. This must match the value specified in the Corda deployment configuration for the DB worker.
-j, --jbdc-urlThe JDBC URL for the connection. This value is required.
--jdbc-pool-max-sizeThe maximum size of the JDBC connection pool. The default value is 10.
-l, --locationThe path to write the generated SQL files to.
-n, --nameThe name of the database connection. Required.
-p, --passwordThe password for the database connection. Required.
-s, --saltSalt for the encrypting secrets service. This must match the value specified in the Corda deployment configuration for the DB worker.
-u, --userThe user name for the database connection. Required.
corda-cli.sh initial-config create-db-config -u <RBAC-USERNAME> -p <RBAC-PASSWORD> \
  --name corda-rbac --jbdc-url jdbc:postgresql://<DB-HOST>:<DB-PORT>/<DB=NAME> \
  --jdbc-pool-max-size <POOL-SIZE> --salt <SALT> --passphrase <PASSPHRASE> -l /tmp/db
corda-cli.sh initial-config create-db-config -u <RBAC-USERNAME> -p <RBAC-PASSWORD> \
  --name corda-rbac --jbdc-url jdbc:postgresql://<DB-HOST>:<DB-PORT>/<DB=NAME> \
  --jdbc-pool-max-size <POOL-SIZE> --salt <SALT> --passphrase <PASSPHRASE> -l /tmp/db
corda-cli.cmd initial-config create-db-config -u <RBAC-USERNAME> -p <RBAC-PASSWORD> `
  --name corda-rbac --jbdc-url jdbc:postgresql://<DB-HOST>:<DB-PORT>/<DB=NAME> `
  --jdbc-pool-max-size <POOL-SIZE> --salt <SALT> --passphrase <PASSPHRASE> -l /tmp/db

create-crypto-config

The create-crypto-config command creates the SQL statements to insert the initial crypto configuration for the database. This operation must be performed after the cluster database is initialized but before the cluster is started.

Argument
Description
-l, --locationThe path to write the generated SQL files to.
-p, --passphraseThe passphrase for the encrypting secrets service. This must match the value specified in the Corda deployment configuration for the DB worker.
-s, --saltSalt for the encrypting secrets service. This must match the value specified in the Corda deployment configuration for the DB worker.
-wp, --wrapping-passphraseThe passphrase for the soft HSM root wrapping key.
-ws, --wrapping-saltSalt for the soft HSM root wrapping key.
corda-cli.sh initial-config create-crypto-config --salt <SALT> --passphrase <PASSPHRASE> -l /tmp/db
corda-cli.sh initial-config create-crypto-config --salt <SALT> --passphrase <PASSPHRASE> -l /tmp/db
corda-cli.cmd initial-config create-crypto-config --salt <SALT> --passphrase <PASSPHRASE> -l /tmp/db
Previous
database
Next
mgm

Was this page helpful?

Thanks for your feedback!

Chat with us

Chat with us on our #docs channel on slack. You can also join a lot of other slack channels there and have access to 1-on-1 communication with members of the R3 team and the online community.

Propose documentation improvements directly

Help us to improve the docs by contributing directly. It's simple - just fork this repository and raise a PR of your own - R3's Technical Writers will review it and apply the relevant suggestions.

We're sorry this page wasn't helpful. Let us know how we can make it better!

Chat with us

Chat with us on our #docs channel on slack. You can also join a lot of other slack channels there and have access to 1-on-1 communication with members of the R3 team and the online community.

Create an issue

Create a new GitHub issue in this repository - submit technical feedback, draw attention to a potential documentation bug, or share ideas for improvement and general feedback.

Propose documentation improvements directly

Help us to improve the docs by contributing directly. It's simple - just fork this repository and raise a PR of your own - R3's Technical Writers will review it and apply the relevant suggestions.