FAQ / Manually adding the cluster licence .deb file

The Nexenta HA plugin is licensed on a per machine basis. Licences come in two forms, a temporary one that expires after 45 days, and a permanent one that never expires. Licences are delivered in a packaged .deb file. Normally this .deb file is automatically uploaded from your Nexenta repository during plugin install or upgrade and requires no manual intervention. The licence .deb file contains the following cluster files:

  • A licence file which contains a pair of licence keys for the two nodes of the cluster – the HA cluster plugin will check each licence key in in the licence file till either a match for the machine signature is found or end of file is reached (i.e. the licence file does not contain a valid key).
  • A password file with randomly generated passwords so that the two nodes can issue authenticated cluster commands to each other (this is different from the ssh bindings and provides an extra level of security).
  • A configuration file distribution password file, again with matched passwords so paired cluster nodes can distribute updated configuration data between themselves.

In some circumstances it is necessary to install the cluster licence directly. To do this you will need a copy of the debian licence package, it will named similar to rsf-1-licence_1.0.0_solaris-i386.deb – copy this file on both nodes to /opt/HAC/RSF-1/etc/, then to install this package do the following after logging into NMC:

nmc$ option expert_mode=1
nmc$ !bash
nmc$ You are about to enter the Unix (“raw”) shell and execute low-level Unix command(s). Warning: using low-level Unix commands is not recommended! Execute?  (y/n)y

nmc$ option expert_mode=1
# cd /opt/HAC/RSF-1/etc
# dpkg –force-all -i ./rsf-1-licence_1.0.0_solaris-i386.deb
# <CTRL>-D

Remember that this procedure must be executed on both nodes.

The HA plug-in checks the licence file every hour, on the hour, for changes (therefore there is no need to restart a running cluster).

Posted in: Licensing, NexentaStor