org.apache.hadoop.hbase

Class RESTApiClusterManager

java.lang.Object

org.apache.hadoop.conf.Configured

org.apache.hadoop.hbase.RESTApiClusterManager

All Implemented Interfaces:

org.apache.hadoop.conf.Configurable

public class RESTApiClusterManager
extends org.apache.hadoop.conf.Configured

A ClusterManager implementation designed to control Cloudera Manager (http://www.cloudera.com) clusters via REST API. This API uses HTTP GET requests against the cluster manager server to retrieve information and POST/PUT requests to perform actions. As a simple example, to retrieve a list of hosts from a CM server with login credentials admin:admin, a simple curl command would be curl -X POST -H "Content-Type:application/json" -u admin:admin \ "http://this.is.my.server.com:7180/api/v8/hosts" This command would return a JSON result, which would need to be parsed to retrieve relevant information. This action and many others are covered by this class. A note on nomenclature: while the ClusterManager interface uses a ServiceType enum when referring to things like RegionServers and DataNodes, cluster managers often use different terminology. As an example, Cloudera Manager (http://www.cloudera.com) would refer to a RegionServer as a "role" of the HBase "service." It would further refer to "hbase" as the "serviceType." Apache Ambari (http://ambari.apache.org) would call the RegionServer a "component" of the HBase "service." This class will defer to the ClusterManager terminology in methods that it implements from that interface, but uses Cloudera Manager's terminology when dealing with its API directly.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ClusterManager.ServiceType Type of the service daemon

Method Summary

Modifier and Type	Method and Description
boolean	isRunning(ClusterManager.ServiceType service, String hostname, int port) Returns whether the service is running on the remote host.
void	kill(ClusterManager.ServiceType service, String hostname, int port) Kills the service running on the given host
void	restart(ClusterManager.ServiceType service, String hostname, int port) Restart the service on the given host
void	resume(ClusterManager.ServiceType service, String hostname, int port) Resumes the services running on the given host
void	setConf(org.apache.hadoop.conf.Configuration conf)
void	start(ClusterManager.ServiceType service, String hostname, int port) Start the service on the given host
void	stop(ClusterManager.ServiceType service, String hostname, int port) Stop the service on the given host
void	suspend(ClusterManager.ServiceType service, String hostname, int port) Suspends the service running on the given host

Methods inherited from class org.apache.hadoop.conf.Configured

getConf

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.apache.hadoop.conf.Configurable

getConf

Method Detail

setConf

public void setConf(org.apache.hadoop.conf.Configuration conf)

Specified by:

setConf in interface org.apache.hadoop.conf.Configurable

Overrides:

setConf in class org.apache.hadoop.conf.Configured

start

public void start(ClusterManager.ServiceType service,
                  String hostname,
                  int port)
           throws IOException

Start the service on the given host

Throws:

IOException

stop

public void stop(ClusterManager.ServiceType service,
                 String hostname,
                 int port)
          throws IOException

Stop the service on the given host

Throws:

IOException

restart

public void restart(ClusterManager.ServiceType service,
                    String hostname,
                    int port)
             throws IOException

Restart the service on the given host

Throws:

IOException

isRunning

public boolean isRunning(ClusterManager.ServiceType service,
                         String hostname,
                         int port)
                  throws IOException

Returns whether the service is running on the remote host. This only checks whether the service still has a pid.

Throws:

IOException

kill

public void kill(ClusterManager.ServiceType service,
                 String hostname,
                 int port)
          throws IOException

Kills the service running on the given host

Throws:

IOException

suspend

public void suspend(ClusterManager.ServiceType service,
                    String hostname,
                    int port)
             throws IOException

Suspends the service running on the given host

Throws:

IOException

resume

public void resume(ClusterManager.ServiceType service,
                   String hostname,
                   int port)
            throws IOException

Resumes the services running on the given host

Throws:

IOException