Configuring and Deploying Quantotto Product
Deploying Quantotto is done in two grand steps using Quantotto Server CLI
- Configure Product
qtoserver product config
: this is prep step for deployment - Deploy product
qtoserver product deploy
: actual deployment step
Configure
-
Run
qtoserver product config
and provide answers to multiple prompts (or accept defaults where relevant)
-
Here are the settings that will need your attention:
$ qtoserver product config --help Usage: qtoserver product config [OPTIONS] Configures product settings prior to deployment Options: --quantotto-version TEXT Quantotto version to deploy [default: 3.1.0; required] --server-fqdn TEXT Fully qualified domain name of this server [default: <detected hostname>; required] --server-ip TEXT IP address of this server [default: <detected IP>; required] --internal-host-subnet TEXT Internal host network mask [default: <detected subnet>; required] --docker-subnet TEXT Docker network mask [default: 172.19.0.0/16; required] --retention-days INTEGER Days to retain captured data [default: 3; required] --data-volume TEXT Quantotto data root volume [default: /opt/quantotto/data; required] --qdb-host TEXT Quantotto DB host [default: qdb; required] --qdb-user TEXT Quantotto DB user [default: quantotto; required] --qdb-password TEXT Quantotto DB password [required] --mongodb-host TEXT Mongo DB host [default: mongodb; required] --mongodb-user TEXT Mongo DB user [default: quantotto; required] --mongodb-password TEXT Mongo DB password [required] --ldap-uri TEXT LDAP Server URI: ldap://host:port [default: ldap://openldap:389; required] --ldap-admin-password TEXT LDAP administrator password [required] --help Show this message and exit.
NOTES:
- You can either provide some or all of the above options in a command line or omit them; if omitting, you will be prompted for missing options.
- In most cases, provided defaults will work fine
Once complete, the command will generate $QUANTOTTO_HOME/.env file with all the settings.
Deploy
NOTES:
This step requires access to private DockerHub repositories (at this time, Quantotto images are not yet public).
-
Login into docker with credentials obtained from Quantotto:
docker login
-
Run deploy command:
qtoserver product deploy
No user input will be required at this point. It might take a few minutes for deployment to complete, especially when downloading docker images for the first time.
IMPORTANT NOTE:
When command completes, it will output super-admin secret that is required for administrative operations.
This secret is only displayed once. Hence, store it in a safe place prior to moving further.
The message will look similar to below (your super-admin secret instead of ABCDEF):********************************* Superadmin secret: ABCDEF Please keep in a safe place *********************************