This is the documentation for Cloudera Enterprise 5.8.x. Documentation for other versions is available at Cloudera Documentation.

Configuring the HBase Canary

The HBase canary is an optional service that periodically checks that a RegionServer is alive. This canary is different from the Cloudera Service Monitoring canary and is provided by the HBase service. The HBase canary is disabled by default. After enabling the canary, you can configure several different thresholds and intervals relating to it, as well as exclude certain tables from the canary checks. The canary works on Kerberos-enabled clusters if you have the HBase client configured to use Kerberos.

Configure the HBase Canary Using Cloudera Manager

Minimum Required Role: Full Administrator

  1. Go to the HBase service.
  2. Click the Configuration tab.
  3. Select Scope > HBase or HBase Service-Wide.
  4. Select Category > Monitoring.
  5. Locate the HBase Canary property or search for it by typing its name in the Search box. Several properties have Canary in the property name.
  6. Select the checkbox.
  7. Review other HBase Canary properties to configure the specific behavior of the canary.

    If more than one role group applies to this configuration, edit the value for the appropriate role group. See Modifying Configuration Properties Using Cloudera Manager.

  8. Click Save Changes to commit the changes.
  9. Restart the role.
  10. Restart the service.

Configure the HBase Canary Using the Command Line

  Important:
  • If you use Cloudera Manager, do not use these command-line instructions.
  • This information applies specifically to CDH 5.8.x. If you use a lower version of CDH, see the documentation for that version located at Cloudera Documentation.
The HBase canary is a Java class. To run it from the command line, in the foreground, issue a command similar to the following, as the HBase user:
$ /usr/bin/hbase org.apache.hadoop.hbase.tool.Canary 
To start the canary in the background, add the --daemon option. You can also use this option in your HBase startup scripts.
$ /usr/bin/hbase org.apache.hadoop.hbase.tool.Canary --daemon
The canary has many options. To see usage instructions, add the --help parameter:
$ /usr/bin/hbase org.apache.hadoop.hbase.tool.Canary --help
Page generated July 8, 2016.