Typically we’d run a connected configuration with a Context Management Registry (Kwanza) and its interface and the let the Driver Platform (Manatee) instances which runs on the local desktops connect to the CMR for its configuration. It is however also possible to run the Manatee without the CMR on a standalone configuration by providing it with an initial configuration.
The software components needed to run this setup are;
Kwanza is distributed as a single binary or as a docker image. Contact us for access to the distribution platform for Kwanza if you haven’t already got a version.
kwanza serve command with suitable arguments. Running
kwanza serve --help will display available options (here shown for v2.0.0):
$ ./kwanza serve --help Command will start registry, connecting to the given database. Usage: kwanza serve [flags] Flags: --cluster Enable cluster mode -d, --database string Database connection url (default "rdb://localhost") -p, --port int The port Kwanza will listen for requests on (default 8000) -s, --salt string The salt used for checking hashed passwords (default "kwanzified") --typeprefix string Optional type prefix to add to all types --verbose Enable verbose (debug level) logging Global Flags: --auth [none|jwt] The mechanism by which to authenticate. Allowed values: 'none' (default) and 'jwt'. (default none) --cert string The location (relative to pwd) of the certificate/public key. (default "cert/kwanza.pem") --config string config file (default is $HOME/.kwanza.yaml) --key string The location (relative to pwd) of the private key. (default "cert/kwanza.key")
$ ./kwanza serve --auth jwt --database rdb://foo:[email protected]:1234 --port 6000
will start an instance which
6000and grpc on port
jwtas authentication mechanism
Only configuration (hardcoded at build-time) is the location of the Kwanza to connect to. Cuesta must therefore be built specifically for a deployment.
The Driver Platform (Manatee) is distributed as a machine-wide installer (
.msi file) or as a per-user installer (
.exe file) as well as a hybrid of the two.
The machine-wide installer should be used for rolling out Manatee in enterprise environments or in deployments where a normal desktop user does not have administrative rights. Using the machine-wide installer means that:
The installation process is straightforward, simply run the
.msi file. It should not show any UI and will install shortcuts in the startmenu.
The per-user installer should be used when individual users themselves are responsible for installing software on their own machine. It has the properties that:
The installation procedure is the same as for the machine-wide installer.
The hybrid installer is an
.msi file which is intended to be run either by each individual user or by an administrator. It will install the application for the each user when the user next logs in on the machine using the per-user installer. Its intended use is for situations where an
.msi installation is the only viable option (enterprise environments) but the automatic updates are considered critical.