Enabling Enterprise Features in Splice Machine

There are two mechanisms for enabling enterprise features in Splice Machine:

  • To access enterprise features such as Backup and Restore, you can simply call the  SYSCS_UTIL.SYSCS_ENABLE_ENTERPRISE built-in system procedure with the license key you obtain from Splice Machine, as described in the next section.
  • To unlock Splice Machine Enterprise features that require configuration changes in your HBase settings, such as Kerberos and LDAP, you need to add one or more properties to your configuration file, as described in Using Configuration Properties to Upgrade to the Enterprise, below.

   Learn more

Using SYSCS_UTIL.SYSCS_ENABLE_ENTERPRISE to Upgrade

If you want to use Enterprise features, such as Backup and Restore, that do not need system properties updated, you can call the SYSCS_UTIL.SYSCS_ENABLE_ENTERPRISE system procedure to unlock those features. You only need to do this once:

  1. Obtain your Splice Machine Enterprise Edition license key.
  2. Enter this command on the splice> command line:

    splice> CALL SYSCS_UTIL.SYSCS_ENABLE_ENTERPRISE('<yourLicenseKey>');Statement executed.
    

    If you enter an invalid license key, you’ll see an error message:

    splice> CALL SYSCS_UTIL.SYSCS_ENABLE_ENTERPRISE ('<bogus-license>');
    Error
    -------------------------------
    ERROR XSRSE: Unable to enable the enterprise Manager. Enterprise services are disabled. Contact your Splice Machine representative to enable.
    

Using Configuration Properties to Upgrade to the Enterprise

If your site uses Kerberos or LDAP, you need to update to the Enterprise version of Splice Machine by modifying your cluster’s HBase configuration, and then restart Splice Machine. Follow these steps:

  1. Obtain your Splice Machine Enterprise Edition license key.
  2. Edit the hbase-site.xml configuration file, adding this property:

    <property>   <name>splicemachine.enterprise.key</name>   <value><your-Splice-Machine-license-key></value></property>
    
  3. If you’re using or switching from another authentication mechanism to LDAP, also add the LDAP properties to your hbase-site.xml file, as described in the Splice Machine Authentication and Authorization topic.

  4. If you’re using Kerberos, add this to your HBase Master Java Configuration Options:

    -Dsplice.spark.hadoop.fs.hdfs.impl.disable.cache=true
    
  5. Restart Splice Machine, by first Starting Your Database.