xbusd¶
xbusd account¶
list¶
Display accounts allowed to connect to Xbus, as a list.
Usage:
xbusd account list [flags]
Flags:
--cert-details Display cert details
--csr-hash Display CSR fingerprints (default true)
Global Flags:
--cert-dir string The directory where certificates and private keys of use to this program reside. (default "certs/xbusd")
--config string config file (default is $HOME/.xbus.yaml)
-d, --database-dsn string PostgreSQL database connection string (ex: "sslmode=disable dbname=xbus")
--database-max-connections int Maximum allowed number of open database connections (default 5)
--debug Enable debugging mode, with lots of logging to the console
--full-version Show version and commit hash
--nats-host string Host of the nats server (default "localhost")
--nats-port int Port of the nats server (default 4222)
--storage-process-db-max-connections int Maximum number of db connections for the process storage (defaults to 30% of database.max-connections)
--trace Enable even more logging than --debug.
--version Show version
accept <fingerprint>¶
Accept a pending account request so it can be allowed to connect to Xbus.
Usage:
xbusd account accept <id|name|fingerprint> [flags]
Global Flags:
--cert-dir string The directory where certificates and private keys of use to this program reside. (default "certs/xbusd")
--config string config file (default is $HOME/.xbus.yaml)
-d, --database-dsn string PostgreSQL database connection string (ex: "sslmode=disable dbname=xbus")
--database-max-connections int Maximum allowed number of open database connections (default 5)
--debug Enable debugging mode, with lots of logging to the console
--full-version Show version and commit hash
--nats-host string Host of the nats server (default "localhost")
--nats-port int Port of the nats server (default 4222)
--storage-process-db-max-connections int Maximum number of db connections for the process storage (defaults to 30% of database.max-connections)
--trace Enable even more logging than --debug.
--version Show version
reject <fingerprint>¶
Reject a pending account request; it will not be allowed to connect to Xbus.
Usage:
xbusd account reject <id|name|fingerprint> [flags]
Global Flags:
--cert-dir string The directory where certificates and private keys of use to this program reside. (default "certs/xbusd")
--config string config file (default is $HOME/.xbus.yaml)
-d, --database-dsn string PostgreSQL database connection string (ex: "sslmode=disable dbname=xbus")
--database-max-connections int Maximum allowed number of open database connections (default 5)
--debug Enable debugging mode, with lots of logging to the console
--full-version Show version and commit hash
--nats-host string Host of the nats server (default "localhost")
--nats-port int Port of the nats server (default 4222)
--storage-process-db-max-connections int Maximum number of db connections for the process storage (defaults to 30% of database.max-connections)
--trace Enable even more logging than --debug.
--version Show version
xbusd cert¶
generate¶
server-ca¶
Generate certificates for the server CA (the one clients connecting to Xbus will check). The file will be named "ServerCA.crt" and is based on a "ServerCA.key" private key.
Usage:
xbusd cert generate server-ca [flags]
Flags:
--host-defs string A host defs for the server certificate. If ommited, --nats-host is used
Global Flags:
--cert-dir string The directory where certificates and private keys of use to this program reside. (default "certs/xbusd")
--config string config file (default is $HOME/.xbus.yaml)
-d, --database-dsn string PostgreSQL database connection string (ex: "sslmode=disable dbname=xbus")
--database-max-connections int Maximum allowed number of open database connections (default 5)
--debug Enable debugging mode, with lots of logging to the console
--full-version Show version and commit hash
--nats-host string Host of the nats server (default "localhost")
--nats-port int Port of the nats server (default 4222)
--storage-process-db-max-connections int Maximum number of db connections for the process storage (defaults to 30% of database.max-connections)
--trace Enable even more logging than --debug.
--version Show version
client-ca¶
Generate certificates for the client CA (the one clients connecting to Xbus will have to have been signed by). The file will be named "ClientCA.crt" and is based on a "ClientCA.key" private key.
Usage:
xbusd cert generate client-ca [flags]
Global Flags:
--cert-dir string The directory where certificates and private keys of use to this program reside. (default "certs/xbusd")
--config string config file (default is $HOME/.xbus.yaml)
-d, --database-dsn string PostgreSQL database connection string (ex: "sslmode=disable dbname=xbus")
--database-max-connections int Maximum allowed number of open database connections (default 5)
--debug Enable debugging mode, with lots of logging to the console
--full-version Show version and commit hash
--nats-host string Host of the nats server (default "localhost")
--nats-port int Port of the nats server (default 4222)
--storage-process-db-max-connections int Maximum number of db connections for the process storage (defaults to 30% of database.max-connections)
--trace Enable even more logging than --debug.
--version Show version
xbusd init¶
This command can be used to automatically create or update Xbus
configuration tables in a PostgreSQL database.
Usage:
xbusd init [flags]
Global Flags:
--cert-dir string The directory where certificates and private keys of use to this program reside. (default "certs/xbusd")
--config string config file (default is $HOME/.xbus.yaml)
-d, --database-dsn string PostgreSQL database connection string (ex: "sslmode=disable dbname=xbus")
--database-max-connections int Maximum allowed number of open database connections (default 5)
--debug Enable debugging mode, with lots of logging to the console
--full-version Show version and commit hash
--nats-host string Host of the nats server (default "localhost")
--nats-port int Port of the nats server (default 4222)
--storage-process-db-max-connections int Maximum number of db connections for the process storage (defaults to 30% of database.max-connections)
--trace Enable even more logging than --debug.
--version Show version
xbusd key¶
generate¶
Generate private keys:
- ServerCA.key: For the server CA (the one clients connecting to Xbus will
check).
- ClientCA.key: For the client CA (the one clients connecting to Xbus will have
to have been signed by).
Usage:
xbusd key generate [flags]
Global Flags:
--cert-dir string The directory where certificates and private keys of use to this program reside. (default "certs/xbusd")
--config string config file (default is $HOME/.xbus.yaml)
-d, --database-dsn string PostgreSQL database connection string (ex: "sslmode=disable dbname=xbus")
--database-max-connections int Maximum allowed number of open database connections (default 5)
--debug Enable debugging mode, with lots of logging to the console
--full-version Show version and commit hash
--nats-host string Host of the nats server (default "localhost")
--nats-port int Port of the nats server (default 4222)
--storage-process-db-max-connections int Maximum number of db connections for the process storage (defaults to 30% of database.max-connections)
--trace Enable even more logging than --debug.
--version Show version
xbusd serve¶
Run one or several of the Xbus servers.
The servers are:
- nats: A genuine nats server
- broker: Exchanges envelopes with actors
- control: Handle control API
Usage:
xbusd serve [flags]
Flags:
--broker Start the broker service (default true)
--clientapi Start the clientapi service (default true)
--control Start the control service (default true)
--debug-sql-bindings Logs sql bindings to debug. Very verbose
--debug-sql-queries Logs sql queries to debug. Very verbose
--emitter Start the emitter service (default true)
--nats Start a NATS server (default true)
--postmortem Start the postmortem service (default true)
--processstate Start the processstate service (default true)
--registration Start the registration service (default true)
--sentinel Start the sentinel service (default true)
Global Flags:
--cert-dir string The directory where certificates and private keys of use to this program reside. (default "certs/xbusd")
--config string config file (default is $HOME/.xbus.yaml)
-d, --database-dsn string PostgreSQL database connection string (ex: "sslmode=disable dbname=xbus")
--database-max-connections int Maximum allowed number of open database connections (default 5)
--debug Enable debugging mode, with lots of logging to the console
--full-version Show version and commit hash
--nats-host string Host of the nats server (default "localhost")
--nats-port int Port of the nats server (default 4222)
--storage-process-db-max-connections int Maximum number of db connections for the process storage (defaults to 30% of database.max-connections)
--trace Enable even more logging than --debug.
--version Show version