SingleStore DB

What are license units and how do they apply to my cluster?

Previous versions of SingleStore DB used available RAM for pricing and to define the boundary between free and enterprise licenses. If you already have one of these RAM-based licenses, you can continue to use it when upgrading to newer versions of MemSQL; however, MemSQL 6.7.13 and later now support licenses based on the concept of units. All new licenses generated in the SingleStore Customer Portal will be unit-based licenses.

A unit is a combination of compute (8 vCPU or less) and RAM (32 GB or less) and only applies to host machines that run leaf nodes in a cluster. Note: SingleStore DB counts the number of virtual cores available to a processor, regardless of whether hyper-threading is enabled or not.

The size of the host machine (physical or virtual) determines how many license units will be counted when you add leaf nodes to that host machine to your cluster. The total license units for a host machine are calculated by taking the total RAM of the host machine divided by 32, or the total number of vCPUs divided by 8, and rounding up. Whichever is the greater value (RAM or vCPU) is the number of potential license units on that host machine. Because this only applies to leaf nodes in your cluster, aggregator nodes are not part of the license unit calculation and can be deployed on any quantity or size of host machines that meet the minimum hardware requirements for installation.

To help understand how license units are calculated, the following table provides examples of how many license units would be counted for various AWS EC2 instance types:

Host Size

RAM

vCPU

SingleStore DB License Units

m5.2xlarge

32

8

1

c5.2xlarge

16

8

1

i3.2xlarge

61

8

2

r5.2xlarge

64

8

2

m5.4xlarge

64

16

2

m4.10xlarge

160

40

5

You can artificially constrain or limit the number of license units to a subset of the resources available by lowering the resources available to a host machine that you are deploying a leaf node onto. For example, if you have a physical machine with 16 vCPU and 48 GB of RAM, SingleStore DB will consider you to have two potential license units if you used that machine as a host. To artificially constrain your capacity, deploy SingleStore DB onto a virtual machine instead with fewer resources to lower your license unit count per host machine (which would be considered the virtual machine).