Run the clusterctl install command to install the PKI Hub cluster in one of the following modes:
- demo-mode
- prod-mode
See below for the mode differences.
Setting | demo-mode | prod-mode |
|---|---|---|
Deployment type | Proof-of-concept deployments. | Production deployments. |
Requirements | Does not need the disk performance requirements described in Machine requirements. Specifically, fsync latency is not an issue in this mode. | All the Requirements. |
Supported number of nodes | One | One or more. See Required number of nodes for details. |
Supported operations | You cannot perform the operations described in Creating a multi-node cluster, Backing up PKI Hub, Recovering from disaster, or Restoring PKI Hub. | All |
Supported updates | You cannot upgrade to a newer version or migrate to a prod-mode installation. | All |
See below for how to run these modes.
The clusterctl install command validates the Requirements and throws an error if not met.
demo-mode installations
For a proof-of-concept installation, run clusterctl install on demo-mode in the machine where you have installed the PKI Hub image (this mode only supports one node). For example:
$ sudo clusterctl install --mode demo-mode --db-host db.example.com --db-port 5432 --db-name clusterdb --db-username admin --db-tls-enabled noInstalling done ╢▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌╟ 100 %prod-mode installations on a single node
For a production environment installation on a single node, run clusterctl install with the default prod-mode in the machine where you have installed the PKI Hub image. For example:
$ sudo clusterctl install --db-host db.example.com --db-port 5432 --db-name clusterdb --db-username admin --db-tls-enabled yes --db-ca-certificate ./db-ca.crtInstalling done ╢▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌╟ 100 %prod-mode installations on several nodes
For a production environment installation on several nodes:
- Run clusterctl install with the default
prod-modein only one of the machines where you have installed the PKI Hub image. For example:$ sudo clusterctl install --db-host db.example.com --db-port 5432 --db-name clusterdb --db-username admin --db-tls-enabled yes --db-ca-certificate ./db-ca.crtInstalling done ╢▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌▌╟ 100 % - Follow the steps described in Creating a multi-node cluster to add the remaining cluster nodes.