Follow these steps to register a data plane:
Validate that the required Data Plane central configurations are set.
The required central configurations are auto-populated for hybrid-enabled control planes deployed with version 5.4 and later.
Go to Admin > Data Planes > Register Data Plane.
Enter the details for the new data plane:
Name - An arbitrary, human-readable name for the data plane.
Namespace - The Kubernetes namespace where you want to install the data plane in the data plane cluster. This namespace will be created if it does not already exist.
Storage Class - The Kubernetes StorageClass name to use for execution volumes in this data plane. If blank, it will default to the control plane’s storage class specified by
com.cerebro.domino.computegrid.kubernetes.volume.storageClassin the Central Configuration (default:
Data Plane Hostname - The subdomain component of the DNS name used for the data plane. For example, if the control plane is
example.comand the data plane is
dp.example.com, then you would enter
dphere. You can also append
:and a custom port number if your data plane load balancer runs on a port other than 443. See Enable a data plane for Workspaces.
Disable File Sync - Disable DFS file sync in this data plane.
Enable Istio - Indicate that Istio is running in this data plane’s cluster. This setting must be set for data planes with Istio; it is not sufficient to set the Helm value.
When data plane registration is complete, Domino displays the Helm install command to install the data plane in the target cluster. This command is unique for each data plane.
We recommend storing any Helm value overrides in a
values.yaml file in a secure location for each data plane.
To re-run the Helm command at a later date (for example, to upgrade the data plane), you can copy the new command and add
-f values.yaml to include the overrides for that data plane.
If your control plane makes use of non-public TLS certificates, you must manually copy
domino-generated-certificates from the control plane to the data plane before running the Helm install command.
Then, specify this
configmap to the Helm chart to mount the certificates in platform service pods:
global: dataPlane: tls: certs: domino-generated-certificates
Make sure that the nodes you wish to use for platform services in your data plane are labeled with
Make sure that your default Kubernetes context is the cluster in which you want to deploy the data plane.
Run the Helm command.
It may take up to a minute for installation to complete and for the Domino UI to report that the data plane is healthy.