Diamanti licensing

The licensing feature allows Diamanti to issue licenses for nodes. The end users can activate and use the node level licenses to unlock proper functionality of the Ultima Enterprise nodes.

The license types supported are:

Trial
Perpetual
Subscription

Note

For Node Licenses, contact to support team at support@diamanti.com.

Node serial number is required to generate license. Serial number is node machine-id and machine-id information details can be extracted from “/etc/machine-id” on each node.

[diamanti@ue-cluster-n1 ~]$ cat /etc/machine-id

1af64f758b2640f6bfb79cd962ee9c6b

[diamanti@ue-cluster-n1 ~]$

This guide provides a comprehensive reference to the Diamanti command line interface (CLI) and GUI for licensing targeting cluster administrators.

The Diamanti licensing CLI offers a set of commands that makes it easy to provision, clean and list the licenses of the nodes in the cluster. As well as, shows the status of the licensing system of the nodes in the cluster.

Syntax

dctl [global options] node license [command options] [arguments...]

Note

All licensing commands, except the dctl node license add command (on a node which is not part of a cluster yet), require users to be logged into the cluster (using the dctl login command).

Commands

status     Get licensing status of a node/nodes in the cluster
list           Get license list of a node/nodes in the cluster
add         Add license to the node in the cluster
clean      Clean expired/inactive licenses
activate  Activate the provisioned licenses of the node

Options

--help, -h        Show help

dctl node license status

Display the information of the licensing system of node/nodes in the cluster. The node names are provided as comma separated arguments to the command. If no argument is provided then the command will show licensing status of all the nodes in the cluster.

Syntax

dctl node license status [[<node-name>][,<node-name>]...]

Example

$ dctl node license status

Maintenance license 1af64f758b2640f6bfb79cd962ee9c6b on node ue-cluster-n1 is about to expire in 29 days.
Please, contact Diamanti to extend the license.
Licenses on node ue-cluster-n3 are expired.  Functionality will be limited.  Please, contact Diamanti to unlock all features.
Licensing check every:    12h0m0s
Licensing delay:          72h0m0s
Licensing alerts start:   720h0m0s


NAME            HOST SERIAL NUMBER                 LICENSING STATUS   CHECK INTERVAL   DELAY     LAST CHECK
ue-cluster-n1   1af64f758b2640f6bfb79cd962ee9c6b   Active             12h0m0s          72h0m0s   2h
ue-cluster-n2   3dc2a51a68bb425ba91be520af6f7157   Active             12h0m0s          72h0m0s   2h
ue-cluster-n3   2d6ffe780be4486691b351ed01634c3a   Expired            12h0m0s          72h0m0s   2h

dctl node license list

List the licenses of the node/nodes in the cluster. The node names are provided as comma separated arguments to the command. If no argument is provided then the command will show license list of all the nodes in the cluster.

Syntax

dctl node license list [[<node-name>][,<node-name>]...]

Example

$ dctl node license list

Maintenance license 1af64f758b2640f6bfb79cd962ee9c6b on node ue-cluster-n1 is about to expire in 29 days.  Please, contact Diamanti to extend the license.
License 2d6ffe780be4486691b351ed01634c3a on node ue-cluster-n3 is expired.  Functionality will be limited.  Please, contact Diamanti to unlock all features.


NODE NAME       LICENSE ID                         TYPE           STATUS    EXPIRATION DATE
ue-cluster-n1   1af64f758b2640f6bfb79cd962ee9c6b   Perpetual      Active    6 Nov 2022
ue-cluster-n2   3dc2a51a68bb425ba91be520af6f7157   Subscription   Active    16 Nov 2022
ue-cluster-n3   2d6ffe780be4486691b351ed01634c3a   Trial          Expired   7 Oct 2022

dctl node license clean

Clean up the expired/inactive licenses of the nodes in the cluster. The node names are provided as comma separated arguments to the command. If no argument is provided then the command will clean up licenses for all the nodes in the cluster. At least one of expired/inactive options should be provided.

Syntax

dctl node license clean [[<node-name>][,<node-name>]...] { [--inactive] | [--expired] }

Options

--expired   Expired  license flag
--inactive  Inactive license flag

Example

$ dctl node license clean --expired
License 2d6ffe780be4486691b351ed01634c3a deleted from ue-cluster-n3

dctl node license add

Provision license for the node in the cluster before/after node joins the cluster.

Syntax

dctl node license add <node-name> <full-path-to-license-file>

Example

$ dctl node license add ue-cluster-n3 'PassiveCert - UE_2d6ffe780be4486691b351ed01634c3a.txt'
License UE_2d6ffe780be4486691b351ed01634c3a is provisioned on node ue-cluster-n3

dctl node license activate

Immediately start the activation of provisioned licenses of the node/nodes in the cluster. The node names are provided as comma separated arguments to the command. If no argument is provided then the command will activate licenses for all the nodes in the cluster.

Syntax

dctl node license activate [[<node-name>][,<node-name>]...]

Example

$ dctl node license activate

License activation process started for node ue-cluster-n1
License activation process started for node ue-cluster-n2
License activation process started for node ue-cluster-n3

$ dctl node license activate ue-cluster-n1
License activation process started for node ue-cluster-n1