Ondat Feature Labels

Overview

Ondat Feature labels are Kubernetes Labels which provide a powerful and flexible way to control storage features.

Applying specific feature labels triggers compression, replication, data encryption and other storage features. In order to use feature labels, end users are required to explicitly enable the features they want to use in their cluster.

Types Of Ondat Feature Labels

Ondat Volume Labels

Below are the list of available feature labels that can be used to define Volume resources and StorageClass resources in an Ondat cluster.

💡 The encryption and compression labels can only applied at provisioning time, they can’t be changed during execution.

Feature Name	Label Reference	Values	Feature Description
Compression	`storageos.com/nocompress`	`true` / `false`	Enables or disables compression of data-at-rest and data-in-transit. Compression is not enabled by default to maximise performance.
Encryption	`storageos.com/encryption`	`true` / `false`	Encrypts the contents of the volume. For each volume, a key is automatically generated, stored, and linked with the PVC.
Failure Mode	`storageos.com/failure-mode`	`hard`, `soft`, `alwayson`, or `threshold` integers starting from `0` to `5`	Sets the failure mode for a volume, either explicitly using a failure mode or implicitly using a replica threshold. The default failure mode is set to `hard`.
Replication	`storageos.com/replicas`	`integers` starting from `0` to `5`	Sets the number of replicas, for example full copies of the data across nodes. Typically `1` or `2` replicas is sufficient (`2` or `3` instances of the data). Latency implications need to be assessed when using more than `2` replicas.
Topology-Aware Placement	`storageos.com/topology-aware`	`true` / `false`	Enables or disables Ondat Topology-Aware Placement.
Topology Domain Key	`storageos.com/topology-key`	custom region, read as a string	Define the failure domain for the node by using a custom key. If you don’t define a custom key, the label defaults to the `topology.kubernetes.io/zone` value.
Squash Mode	`storageos.com/nfs-squash`	`root`, `rootuid`, `all`, `none`	Define the squash mode that will be used with Ondat Files - `ReadWriteMany` (RWX) volumes to set the file ownership in the share. The default squash mode is set to `all`.

Ondat Node Labels

When Ondat is run within Kubernetes, the Ondat API Manager syncs any Kubernetes node labels to the corresponding Ondat node. The Kubernetes node labels act as the “source of truth”, so labels should be applied to the Kubernetes nodes rather than to Ondat nodes. This is because the Kubernetes node labels overwrite the Ondat node labels on sync.

Below are the list of available feature labels that can be used to define Kubernetes Nodes in an Ondat Cluster.

Feature Name	Label Reference	Values	Feature Description
Compute-only Nodes	`storageos.com/computeonly`	`true` / `false`	Specifies whether a node should be `computeonly` where it only acts as a client and does not host volume data locally, otherwise the node is hyper-converged (the default), where the node can operate in both client and server modes.

Ondat Pod Labels

Below are the list of available feature labels that can be used to define Kubernetes Pods in an Ondat Cluster.

💡 For a pod to be fenced by Ondat, a recommendation will be to review the the Ondat Fencing operations page for more information.

Feature Name	Label Reference	Values	Feature Description
Pod Fencing	`storageos.com/fenced`	`true` / `false`	Targets a pod to be fenced in case of node failure. The default value is `false`

How To Use Ondat Feature Labels?

For more information about how to enable specific Ondat features, review the Ondat Feature Labels operations pages listed below;