cloudbox-server 0.0.1

data/lib/exec/service_start.rb

@@ -0,0 +1,110 @@
+# This file is part of cloudbox-service project
+# @author tmarmin (INGENSI)
+
+require 'exec/executable_command'
+require 'exec/check_parameter'
+
+require 'command/ambari_start_component'
+require 'command/ambari_start_host'
+require 'command/ambari_start_host_component'
+require 'command/ambari_start_service_components'
+require 'command/ambari_start_host_component'
+require 'command/ambari_start_cluster'
+require 'command/ambari_service_component_info'
+
+require 'common/services_description'
+
+include Exec::CheckParameter
+include Common::ServicesDescription
+
+module Exec
+  # Allows the user to start services.
+  # @author tnoguer
+  class ServiceStart < ExecutableCommand
+
+    private
+    # Parse and check the parameters of the function.
+    # @author tmarmin
+    def set_options
+      @logger.info("setting options")
+      @options.add_option("C", "cluster", "The virtual cluster name.", true, true, method(:check_cluster_name))
+      @options.add_option("s", "service", "Limit request to this service.", false, true, method(:check_hadoop_service_name))
+      @options.add_option("H", "host", "Limit request to this host.", false, true, method(:check_ambari_host_name))
+      @options.add_option("c", "component", "Limit request to this component type.", false, true, method(:check_hadoop_component_name))
+      @options.add_option("f", "follow", "Follow completion of the request.", false)
+    end
+
+    private
+    # Execution of the command
+    def exec
+      begin
+        Color::print_log("NONE", "Checking dependencies...", @stdout)
+        Common::ServicesDescription.get_master_components_deps(@values["service"]).each do |dep_master_component|
+          dep_service_name = Common::ServicesDescription.get_service_name_by_comp_name(dep_master_component)
+          data = Command::AmbariServiceComponentInfo.new(dep_service_name, @values["cluster"], dep_master_component).exec
+
+          started = true
+          data["host_components"].each do |host_component|
+            started = false if host_component["HostRoles"]["state"] != "STARTED"
+          end
+
+          raise MissingDependency.new("Master component #{dep_master_component} has to be started before start #{@values["service"]} service.") unless started
+        end
+        Color::echo_ok(@stdout)
+
+      rescue CloudboxError => e
+        Color::echo_fail(@stdout)
+        raise e
+      end
+
+      msg = "Unknown combination of attributes... (should never happend)"
+      cmd = nil
+
+      if (!@values["host"].nil? && !@values["component"].nil?) || (!@values["service"].nil? && !@values["host"].nil? && !@values["component"].nil?)
+        # 3
+        # one component on one host
+        msg = "Start components #{@values["component"]} on host #{@values["host"]} (@cluster #{@values["cluster"]})."
+        cmd = Command::AmbariStartHostComponent.new(@values["cluster"], @values["component"], @values["host"])
+
+      elsif !@values["component"].nil? || (!@values["service"].nil? && !@values["component"].nil?)
+        # 1
+        # one component on all hosts
+        msg = "Start all components (@cluster #{@values["cluster"]})."
+        cmd = Command::AmbariStartComponent.new(@values["cluster"], @values["component"])
+
+      elsif !@values["service"].nil? && !@values["host"].nil?
+        # 5
+        # all component on one host for one service
+        # @todo it is the same case than number 3
+        msg = "Start components #{@values["component"]} of service #{@values["service"]} on host #{@values["host"]} (@cluster #{@values["cluster"]})."
+        cmd = Command::AmbariStartHostComponents.new(@values["cluster"], @values["service"], @values["host"])
+
+      elsif !@values["host"].nil?
+        # 2
+        # all component on one host
+        msg = "Start all components on host #{@values["host"]} (@cluster #{@values["cluster"]})."
+        cmd = Command::AmbariStartHost.new(@values["cluster"], @values["host"])
+
+      elsif !@values["service"].nil?
+        # 4
+        # all component on all hosts for one service
+        msg = "Start all components #{@values["component"]} of service #{@values["service"]} on all hosts (@cluster #{@values["cluster"]})."
+        cmd = Command::AmbariStartServiceComponents.new(@values["cluster"], @values["service"])
+
+      elsif @values["service"].nil? && @values["host"].nil? && @values["component"].nil?
+        # 6
+        # all component on all host for all service
+        msg = "Start all components of all services on all hosts (@cluster #{@values["cluster"]})."
+        cmd = Command::AmbariStartCluster.new(@values["cluster"])
+
+      else
+        raise StandardError(msg)
+      end
+
+      Color::print_log("NONE", msg, @stdout)
+      cmd.exec()
+      Color::echo_ok(@stdout)
+    end
+
+  end
+end

data/lib/exec/service_stop.rb

@@ -0,0 +1,112 @@
+# This file is part of cloudbox-service project
+# @author tmarmin (INGENSI)
+
+require 'exec/executable_command'
+require 'exec/check_parameter'
+
+require 'command/ambari_stop_component'
+require 'command/ambari_stop_host'
+require 'command/ambari_stop_host_component'
+require 'command/ambari_stop_service_components'
+require 'command/ambari_stop_host_component'
+require 'command/ambari_stop_cluster'
+require 'command/ambari_service_component_info'
+
+require 'common/services_description'
+
+include Exec::CheckParameter
+include Common::ServicesDescription
+
+module Exec
+  # Allows the user to stop host components.
+  # @author tnoguer
+  class ServiceStop < ExecutableCommand
+
+    private
+    # Parse and check the parameters of the function.
+    # @author tmarmin
+    def set_options
+      @logger.info("setting options")
+      @options.add_option("C", "cluster", "The virtual cluster name.", true, true, method(:check_cluster_name))
+      @options.add_option("s", "service", "Limit request to this service.", false, true, method(:check_hadoop_service_name))
+      @options.add_option("H", "host", "Limit request to this host.", false, true, method(:check_ambari_host_name))
+      @options.add_option("c", "component", "Limit request to this component type.", false, true, method(:check_hadoop_component_name))
+      @options.add_option("f", "follow", "Follow completion of the request.", false)
+    end
+
+    private
+    # Execution of the command
+    # @author tnoguer
+    def exec
+
+      begin
+        Color::print_log("NONE", "Checking dependencies...", @stdout)
+        Common::ServicesDescription.get_master_components_depends_on(@values["service"]).each do |dep_master_component|
+          dep_service_name = Common::ServicesDescription.get_service_name_by_comp_name(dep_master_component)
+          data = Command::AmbariServiceComponentInfo.new(dep_service_name, @values["cluster"], dep_master_component).exec
+
+          stopped = true
+          data["host_components"].each do |host_component|
+            stopped = false if host_component["HostRoles"]["status"] != "STOPPED"
+          end
+
+          raise MissingDependency.new("Master component #{dep_master_component} has to be stopped before stop #{@values["service"]} service.") unless stopped
+        end
+        Color::echo_ok(@stdout)
+
+      rescue CloudboxError => e
+        Color::echo_fail(@stdout)
+        raise e
+      end
+
+      msg = "Unknown combination of attributes... (should never happend)"
+      cmd = nil
+
+      if (!@values["host"].nil? && !@values["component"].nil?) || (!@values["service"].nil? && !@values["host"].nil? && !@values["component"].nil?)
+        # 3
+        # one component on one host
+        msg = "Stop components #{@values["component"]} on host #{@values["host"]} (@cluster #{@values["cluster"]})."
+        cmd = Command::AmbariStopHostComponent.new(@values["cluster"], @values["component"], @values["host"])
+
+      elsif !@values["component"].nil? || (!@values["service"].nil? && !@values["component"].nil?)
+        # 1
+        # one component on all hosts
+        msg = "Stop all components (@cluster #{@values["cluster"]})."
+        cmd = Command::AmbariStopComponent.new(@values["cluster"], @values["component"])
+
+      elsif !@values["service"].nil? && !@values["host"].nil?
+        # 5
+        # all component on one host for one service
+        # @todo it is the same case than number 3
+        msg = "Stop components #{@values["component"]} of service #{@values["service"]} on host #{@values["host"]} (@cluster #{@values["cluster"]})."
+        cmd = Command::AmbariStopHostComponents.new(@values["cluster"], @values["service"], @values["host"])
+
+      elsif !@values["host"].nil?
+        # 2
+        # all component on one host
+        msg = "Stop all components on host #{@values["host"]} (@cluster #{@values["cluster"]})."
+        cmd = Command::AmbariStopHost.new(@values["cluster"], @values["host"])
+
+      elsif !@values["service"].nil?
+        # 4
+        # all component on all hosts for one service
+        msg = "Stop all components #{@values["component"]} of service #{@values["service"]} on all hosts (@cluster #{@values["cluster"]})."
+        cmd = Command::AmbariStopServiceComponents.new(@values["cluster"], @values["service"])
+
+      elsif @values["service"].nil? && @values["host"].nil? && @values["component"].nil?
+        # 6
+        # all component on all host for all service
+        msg = "Stop all components of all services on all hosts (@cluster #{@values["cluster"]})."
+        cmd = Command::AmbariStopCluster.new(@values["cluster"])
+
+      else
+        raise StandardError(msg)
+      end
+
+      Color::print_log("NONE", msg, @stdout)
+      cmd.exec()
+      Color::echo_ok(@stdout)
+    end
+
+  end
+end

data/lib/receiver.rb

@@ -0,0 +1,14 @@
+# This file is part of cloudbox-service project
+# Author: tmarmin
+# Created: 8/21/13 10:38 AM
+
+$: << File.dirname(__FILE__)
+
+require 'receiver/basic_receiver'
+require 'receiver/ambari_receiver'
+require 'receiver/ambari_rest_api_connector'
+require 'receiver/connector'
+require 'receiver/crowbar_receiver'
+require 'receiver/crowbar_rest_api_connector'
+require 'receiver/crowbar_shell_api'
+require 'receiver/rest_api_connector'

data/lib/receiver/ambari_receiver.rb

@@ -0,0 +1,812 @@
+# This file is part of cloudbox-server project
+# @author tnoguer (INGENSI)
+
+require 'rubygems'
+require 'json'
+require 'receiver/basic_receiver'
+require 'receiver/ambari_rest_api_connector'
+require 'common/cloudbox_exceptions'
+
+
+module Receiver
+  # Class listing all the available methods to interact with Ambari.
+  # @author tnoguer
+  # @todo Catch the HTTPError and throw a new one with just the error message.
+  # @todo Reformat the returned arrays to remove the http notion.
+  # @todo Refactor names and private methods below
+  class AmbariReceiver < BasicReceiver
+
+    public
+    @@hadoop_services_description = {
+        "HDFS" => {
+            "MASTER" => %w{NAMENODE SECONDARY_NAMENODE},
+            "SLAVE" => %w{DATANODE}},
+        "MAPREDUCE" => {
+            "MASTER" => %w{JOBTRACKER},
+            "SLAVE" => %w{TASKTRACKER}},
+        "HIVE" => {
+            "MASTER" => %w{HIVE_SERVER},
+            "SLAVE" => []},
+        "HBASE" => {
+            "MASTER" => %w{HBASE_MASTER},
+            "SLAVE" => %w{HBASE_REGIONSERVER}},
+        "ZOOKEEPER" => {
+            "MASTER" => %w{ZOOKEEPER_SERVER},
+            "SLAVE" => []},
+        "OOZIE" => {
+            "MASTER" => %w{OOZIE_SERVER},
+            "SLAVE" => []},
+        "NAGIOS" => {
+            "MASTER" => %w{NAGIOS_SERVER},
+            "SLAVE" => []},
+        "GANGLIA" => {
+            "MASTER" => %w{GANGLIA_SERVER},
+            "SLAVE" => []}
+    }
+
+    protected
+    @@available_actions = {'START' => {'required_state' => %w{INSTALLED STARTED START_FAILED},
+                                       'target_state' => 'STARTED'},
+                           'STOP' => {'required_state' => %w{STARTED INSTALLED STOP_FAILED},
+                                      'target_state' => 'INSTALLED'},
+                           'INSTALL' => {'required_state' => %w{INIT MAINTENANCE INSTALLED INSTALL_FAILED},
+                                         'target_state' => 'INSTALLED'},
+                           'DETACH' => {'required_state' => %w{INSTALLED MAINTENANCE},
+                                        'target_state' => 'MAINTENANCE'},
+                           'DELETE' => {'required_state' => %w{MAINTENANCE},
+                                        'target_state' => nil}}
+
+    public
+    # Get the component list of service_name.
+    # It includes master and slave nodes.
+    # @todo throw an exception of type UnknownHadoopService
+    # @param service_name [String] The hadoop service name.
+    # @return [Array<String>] The list of components.
+    def self.get_components_by_service_name(service_name)
+      return nil if !valid_service?(service_name) # @todo throw exception
+
+      components = []
+
+      components.concat(@@hadoop_services_description[service_name]["MASTER"])
+      components.concat(@@hadoop_services_description[service_name]["SLAVE"])
+
+      return components
+    end
+
+    public
+    # Get the component list of service_name.
+    # It includes master and slave nodes.
+    # @todo throw an exception of type UnknownHadoopComponent
+    # @param component_name [String] The hadoop component name.
+    # @return [String] The related service name.
+    def self.get_service_by_component_name(component_name)
+      return nil if !valid_component?(component_name) # @todo throw exception
+
+      @@hadoop_services_description.each do |service_name|
+        return service_name if get_components_by_service_name(service_name).include?(component_name)
+      end
+
+      return nil
+    end
+
+    public
+    # Check if service_name is a Hadoop service.
+    # @param service_name [String] The Hadoop service name.
+    # @return true if service_name is a known hadoop service.
+    def self.valid_service?(service_name)
+      return true if @@hadoop_services_description.has_key?(service_name)
+    end
+
+    public
+    # Check if component_name is a Hadoop service.
+    # @param component_name [String] The Hadoop component name.
+    # @return true if component_name is a known hadoop component.
+    def self.valid_component?(component_name)
+      @@hadoop_services_description.each_key do |service|
+        return true if get_component_by_service_name(service).include?(component_name)
+      end
+      return false
+    end
+
+    public
+    # Check if a component is part of a service
+    # @todo throw an exception of type UnknownHadoopService if the service_name doesn't exists.
+    # @todo throw and exception of type UnknownHadoopComponent if the component_name doesn't exists.
+    # @param service_name [String] The Hadoop service name.
+    # @param component_name [String] The Hadoop component name.
+    # @return true if component_name is a component of service service_name.
+    def self.valid_service_component?(service_name, component_name)
+      return nil if !valid_service?(service_name) # @todo throw an exception
+      return nil if !valid_component?(component_name) # @todo throw an exception
+
+      @@hadoop_services_description[service_name].each_value do |component|
+        return true if component == component_name
+      end
+
+      return false
+    end
+
+    private
+    # The connector to the rest API.
+    @rest_connector
+
+    public
+    # Default constructor.
+    # @author tnoguer
+    def initialize(logger = nil)
+      super(logger)
+      @rest_connector = Receiver::AmbariRestAPIConnector.new(logger)
+      @logger.info("Command::AmbariReceiver   initialize the parameters...")
+    end
+
+    public
+    # Create a configuration into a cluster.
+    # @param cluster_name The name of the cluster.
+    # @param configuration_type The type of the configuration to add.
+    # @param configuration_tag The tag of the configuration to add.
+    # @param configuration_properties The hash of properties for the configuration. (ex: {"Property 1" => "value", "Property 2" => "value"})
+    # @return The http response.
+    # @raise [ArgumentError] If any argument is nil.
+    # @raise [HTTPError] If the request is invalid.
+    # @author tnoguer
+    def create_configuration(cluster_name, configuration_type, configuration_tag, configuration_properties)
+      @rest_connector.create_configuration(cluster_name, configuration_type, configuration_tag, configuration_properties)
+    end
+
+    public
+    # Create and apply a configuration into a cluster.
+    # @param cluster_name The name of the cluster.
+    # @param configuration_type The type of the configuration to add.
+    # @param configuration_tag The tag of the configuration to add.
+    # @param configuration_properties The hash of properties for the configuration. (ex: {"Property 1" => "value", "Property 2" => "value"})
+    # @return The http response.
+    # @raise [ArgumentError] If any argument is nil.
+    # @raise [HTTPError] If the request is invalid.
+    # @author tnoguer
+    def create_apply_configuration(cluster_name, configuration_type, configuration_tag, configuration_properties)
+      @rest_connector.create_apply_configuration(cluster_name, configuration_type, configuration_tag, configuration_properties)
+    end
+
+    public
+    # Apply a configuration into a cluster.
+    # @param cluster_name The name of the cluster.
+    # @param configuration_type The type of the configuration to add.
+    # @param configuration_tag The tag of the configuration to add.
+    # @return The http response.
+    # @raise [ArgumentError] If any argument is nil.
+    # @raise [HTTPError] If the request is invalid.
+    # @raise [UnknownEntity] If the configuration does not exist.
+    # @author tnoguer
+    def apply_configuration(cluster_name, configuration_type, configuration_tag)
+
+      confs = get_cluster_configurations_list(cluster_name)
+      exist = false
+      confs.each do |conf|
+        if (configuration_type == conf["type"] && configuration_tag == conf["tag"])
+          exist = true
+        end
+      end
+      raise Common::UnknownEntity.new("Ambari configuration", "Type: #{configuration_type} Tag: #{configuration_tag}") unless exist
+
+      response = @rest_connector.apply_configuration(cluster_name, configuration_type, configuration_tag)
+    end
+
+    public
+    # Defines a new cluster.
+    # @param cluster_name The name of the cluster to be defined.
+    # @param cluster_version The version of the cluster to be created.
+    # @raise [ArgumentError] If any argument is nil.
+    # @raise [Common:HTTPError] If the request is invalid.
+    # @author tnoguer
+    def define_cluster(cluster_name, cluster_version)
+      @rest_connector.define_cluster(cluster_name, cluster_version)
+    end
+
+    public
+    # Deletes a new cluster.
+    # @param cluster_name The name of the cluster to be deleted.
+    # @raise [ArgumentError] If any argument is nil.
+    # @raise [Common:HTTPError] If the request is invalid.
+    # @author tnoguer
+    def delete_cluster(cluster_name)
+      @rest_connector.delete_cluster(cluster_name)
+    end
+
+    public
+    # Shows the hosts of a cluster.
+    # @param cluster_name The name of the cluster.
+    # @return The result of the request.
+    # @raise [ArgumentError] If any argument is nil.
+    # @raise [Common:HTTPError] If the request is invalid.
+    # @author tnoguer
+    def show_cluster_hosts(cluster_name)
+      response = @rest_connector.show_cluster_hosts(cluster_name)
+      return JSON.parse(response.body)
+    end
+
+    public
+    # Shows the services of a cluster.
+    # @param cluster_name The name of the cluster.
+    # @return The result of the request.
+    # @raise [ArgumentError] If any argument is nil.
+    # @raise [Common:HTTPError] If the request is invalid.
+    # @author tnoguer
+    def show_cluster_services(cluster_name)
+      response = @rest_connector.show_cluster_services(cluster_name)
+      return JSON.parse(response.body)
+    end
+
+    public
+    # Returns the list of configuration of a cluster.
+    # @param cluster_name The name of the cluster.
+    # @return The list of configuration. (ex: {[{"active"=>true,"type"=>value,"tag"=>value}, ...]})
+    # @raise [ArgumentError] If any argument is nil.
+    # @raise [HTTPError] If the request is invalid.
+    # @author tnoguer
+    def get_cluster_configurations_list(cluster_name)
+      if cluster_name == nil
+        raise(ArgumentError, 'Arguments can\'t be nil!')
+      end
+
+      response = @rest_connector.show_cluster(cluster_name)
+      confs = JSON.parse(response.body)
+      active_confs = confs["Clusters"]["desired_configs"]
+      confs = confs["configurations"].sort { |x, y| x["href"] <=> y["href"] }
+      confs.each do |conf|
+        conf.delete("href")
+        conf.delete("Config")
+        if (!conf["type"].nil? && active_confs[conf["type"]]["tag"] == conf["tag"])
+          conf["active"] = true
+        else
+          conf["active"] = false
+        end
+      end
+      return confs
+    end
+
+    public
+    # Returns the list of configuration of a cluster.
+    # @param cluster_name The name of the cluster.
+    # @param type The type of configuration.
+    # @param tag The tag ot configuration.
+    # @return The hash of properties of the configuration. (ex: {"Property name"=>value,"Property name2"=>value}, ...}.
+    # @raise [ArgumentError] If any argument is nil.
+    # @raise [HTTPError] If the request is invalid.
+    # @raise [UnknownEntity] If the configuration does not exist.
+    # @author tnoguer
+    def get_cluster_configuration(cluster_name, type, tag)
+      if cluster_name == nil || type == nil || tag == nil
+        raise(ArgumentError, 'Arguments can\'t be nil!')
+      end
+
+      response = @rest_connector.get_cluster_configuration(cluster_name, type, tag)
+      conf = JSON.parse(response.body)
+      conf = conf["items"][0]
+      if conf.nil?
+        raise Common::UnknownEntity.new("Ambari configuration", "Type: #{type} Tag: #{tag}")
+      end
+      return conf["properties"]
+    end
+
+    public
+    # Shows the requests of a cluster.
+    # @param cluster_name The name of the cluster.
+    # @return The result of the request.
+    # @raise [ArgumentError] If any argument is nil.
+    # @raise [Common:HTTPError] If the request is invalid.
+    # @author tnoguer
+    def show_requests(cluster_name)
+      response = @rest_connector.show_requests(cluster_name)
+      return JSON.parse(response.body)
+    end
+
+    public
+    # Shows the requests of a cluster.
+    # @param cluster_name The name of the cluster.
+    # @param request_id The id of the request.
+    # @return The result of the request.
+    # @raise [ArgumentError] If any argument is nil.
+    # @raise [Common:HTTPError] If the request is invalid.
+    # @author tnoguer
+    def show_request(cluster_name, request_id)
+      response = @rest_connector.show_request(cluster_name, request_id)
+      return JSON.parse(response.body)
+    end
+
+    public
+    # Shows the information of a cluster.
+    # @param cluster_name The name of the cluster.
+    # @param show_host True to show the detail of the hosts. False otherwise.
+    # @param show_components True to show the detail of the components. False otherwise.
+    # @return The result of the request.
+    # @raise [ArgumentError] If any argument is nil.
+    # @raise [Common:HTTPError] If the request is invalid.
+    # @author tnoguer
+    def show_cluster(cluster_name, show_host, show_components)
+      response = @rest_connector.show_cluster(cluster_name, show_host, show_components)
+      return JSON.parse(response.body)
+    end
+
+    public
+    # Shows the list of clusters.
+    # @return The result of the request.
+    # @raise [Common:HTTPError] If the request is invalid.
+    # @author tnoguerr
+    def list_clusters
+      response = @rest_connector.list_clusters()
+      return JSON.parse(response.body)
+    end
+
+    public
+    # Installs every host components of a cluster.
+    # @param cluster_name The name of the cluster.
+    # @return [Array] The IDs of the processing requests. Empty if there is no requests.
+    # @raise [ArgumentError] If any argument is nil.
+    # @raise [Common::HTTPError] If the request is invalid.
+    # @author tnoguer
+    def install_cluster(cluster_name)
+      return execute_method_on_components(method(:install_host_component), cluster_name)
+    end
+
+    public
+    # Starts every host components of a cluster.
+    # @param cluster_name The name of the cluster.
+    # @return [Array] The IDs of the processing requests. Empty if there is no requests.
+    # @raise [ArgumentError] If any argument is nil.
+    # @raise [Common::HTTPError] If the request is invalid.
+    # @author tnoguer
+    def start_cluster(cluster_name)
+      return execute_method_on_components(method(:start_host_component), cluster_name)
+    end
+
+    public
+    # Stops every host components of a cluster.
+    # @param cluster_name The name of the cluster.
+    # @return [Array] The IDs of the processing requests. Empty if there is no requests.
+    # @raise [ArgumentError] If any argument is nil.
+    # @raise [Common::HTTPError] If the request is invalid.
+    # @author tnoguer
+    def stop_cluster(cluster_name)
+      return execute_method_on_components(method(:stop_host_component), cluster_name)
+    end
+
+
+    public
+    # Adds a component to an host.
+    # @param cluster_name The name of the cluster.
+    # @param host_name The name of the host.
+    # @param component_name The name of the component to add.
+    # @raise [ArgumentError] If any argument is nil.
+    # @raise [Common:AlreadyExistsEntity] If the request is invalid.
+    # @author tnoguer
+    def add_host_component(cluster_name, host_name, component_name)
+      begin
+        @rest_connector.add_host_component(cluster_name, host_name, component_name)
+      rescue ClientError => e
+        raise Common::AlreadyExistsEntity.new("host component", component_name, e.to_s) if e.code == 409
+      end
+    end
+
+    public
+    # Deletes a component from an host.
+    # @param cluster_name The name of the cluster.
+    # @param host_name The name of the host.
+    # @param component_name The name of the component to delete.
+    # @raise [ArgumentError] If any argument is nil.
+    # @raise [Common::HTTPError] If the request is invalid.
+    # @raise [Common::InvalideActionSequence] If the action can't be performed on the host component.
+    # @author tnoguer
+    def delete_host_component(cluster_name, host_name, component_name)
+      valid_action_host_component('DELETE', cluster_name, host_name, component_name)
+      @rest_connector.delete_host_component(cluster_name, host_name, component_name)
+    end
+
+    public
+    # Deletes an host.
+    # @param cluster_name The name of the cluster.
+    # @param host_name The name of the host to delete.
+    # @raise [ArgumentError] If any argument is nil.
+    # @raise [Common::HTTPError] If the request is invalid.
+    # @author tnoguer
+    def delete_host(cluster_name, host_name)
+      @rest_connector.delete_host(cluster_name, host_name)
+    end
+
+    public
+    # Installs a component of an host.
+    # @param cluster_name The name of the cluster.
+    # @param host_name The name of the host.
+    # @param component_name The name of the component to install.
+    # @return [Int] The ID of the processing request if there is one, Nil otherwise.
+    # @raise [ArgumentError] If any argument is nil.
+    # @raise [Common::HTTPError] If the request is invalid.
+    # @raise [Common::InvalidActionSequence] If the action can't be performed on the host component.
+    # @author tnoguer
+    def install_host_component(cluster_name, host_name, component_name)
+      valid_action_host_component('INSTALL', cluster_name, host_name, component_name)
+      response = @rest_connector.install_host_component(cluster_name, host_name, component_name)
+      return get_request_id_from_response(response)
+    end
+
+    public
+    # Starts a component of an host.
+    # @param cluster_name The name of the cluster.
+    # @param host_name The name of the host.
+    # @param component_name The name of the component to start.
+    # @return [Int] The ID of the processing request if there is one, Nil otherwise.
+    # @raise [ArgumentError] If any argument is nil.
+    # @raise [Common::HTTPError] If the request is invalid.
+    # @raise [Common::InvalideActionSequence] If the action can't be performed on the host component.
+    # @author tnoguer
+    def start_host_component(cluster_name, host_name, component_name)
+      valid_action_host_component('START', cluster_name, host_name, component_name)
+      response = @rest_connector.start_host_component(cluster_name, host_name, component_name)
+      return get_request_id_from_response(response)
+    end
+
+    public
+    # Stops a component of an host.
+    # @param cluster_name The name of the cluster.
+    # @param host_name The name of the host.
+    # @param component_name The name of the component to stop.
+    # @return [Int] The ID of the processing request if there is one, Nil otherwise.
+    # @raise [ArgumentError] If any argument is nil.
+    # @raise [Common::HTTPError] If the request is invalid.
+    # @raise [Common::InvalideActionSequence] If the action can't be performed on the host component.
+    # @author tnoguer
+    def stop_host_component(cluster_name, host_name, component_name)
+      valid_action_host_component('STOP', cluster_name, host_name, component_name)
+      response = @rest_connector.stop_host_component(cluster_name, host_name, component_name)
+      return get_request_id_from_response(response)
+    end
+
+    public
+    # Detachs a component of an host.
+    # @param cluster_name The name of the cluster.
+    # @param host_name The name of the host.
+    # @param component_name The name of the component to detach.
+    # @return [Int] The ID of the processing request if there is one, Nil otherwise.
+    # @raise [ArgumentError] If any argument is nil.
+    # @raise [Common::HTTPError] If the request is invalid.
+    # @raise [Common::InvalideActionSequence] If the action can't be performed on the host component.
+    # @author tnoguer
+    def detach_host_component(cluster_name, host_name, component_name)
+      valid_action_host_component('DETACH', cluster_name, host_name, component_name)
+      response = @rest_connector.detach_host_component(cluster_name, host_name, component_name)
+      return get_request_id_from_response(response)
+    end
+
+    public
+    # Adds an host.
+    # @param cluster_name The name of the cluster.
+    # @param host_name The name of the host to add.
+    # @raise [ArgumentError] If any argument is nil.
+    # @raise [Common::HTTPError] If the request is invalid.
+    # @author tnoguer
+    def add_host(cluster_name, host_name)
+      @rest_connector.add_host(cluster_name, host_name)
+    end
+
+    public
+    # Gets the list of hosts.
+    # @param cluster_name The name of the cluster.
+    # @return [Array] The list of hosts.
+    # @raise [Common::HTTPError] If the request is invalid.
+    def get_host_list(cluster_name)
+      response = @rest_connector.show_cluster(cluster_name)
+      data = JSON.parse(response.body)
+      hosts = []
+      data["hosts"].each do |host|
+        hosts << host["Hosts"]["host_name"]
+      end
+      return hosts
+    end
+
+    public
+    # Shows information of an host.
+    # @param cluster_name The name of the cluster.
+    # @param host_name The name of the host.
+    # @return The result of the request
+    # @raise [ArgumentError] If any argument is nil.
+    # @raise [Common::HTTPError] If the request is invalid.
+    # @author tnoguer
+    def show_host(cluster_name, host_name)
+      response = @rest_connector.show_host(cluster_name, host_name)
+      return JSON.parse(response.body)
+    end
+
+    public
+    # Shows information of an host component.
+    # @param cluster_name The name of the cluster.
+    # @param host_name The name of the host.
+    # @param component_name The name of component.
+    # @return [Hash] The information of the host component.
+    # @raise [ArgumentError] If any argument is nil.
+    # @raise [Common::HTTPError] If the request is invalid.
+    # @author tnoguer
+    def show_host_component(cluster_name, host_name, component_name)
+      response = @rest_connector.show_host(cluster_name, host_name)
+      data = JSON.parse(response.body)
+      data["host_components"].each do |component|
+        if component["HostRoles"]["component_name"] == component_name
+          return component["HostRoles"]
+        end
+      end
+    end
+
+    public
+    # Installs every components of an host.
+    # @param cluster_name The name of the cluster.
+    # @param host_name The name of the host.
+    # @return [Array] The IDs of the processing requests. Empty if there is no requests.
+    # @raise [ArgumentError] If any argument is nil.
+    # @raise [Common::HTTPError] If the request is invalid.
+    # @author tnoguer
+    def install_host(cluster_name, host_name)
+      return execute_method_on_components(method(:install_host_component), cluster_name, nil, host_name)
+    end
+
+    public
+    # Starts every components of an host.
+    # @param cluster_name The name of the cluster.
+    # @param host_name The name of the host.
+    # @return [Array] The IDs of the processing requests. Empty if there is no requests.
+    # @raise [ArgumentError] If any argument is nil.
+    # @raise [Common::HTTPError] If the request is invalid.
+    # @author tnoguer
+    def start_host(cluster_name, host_name)
+      return execute_method_on_components(method(:start_host_component), cluster_name, nil, host_name)
+    end
+
+    public
+    # Stops every components of an host.
+    # @param cluster_name The name of the cluster.
+    # @param host_name The name of the host.
+    # @return [Array] The IDs of the processing requests. Empty if there is no requests.
+    # @raise [ArgumentError] If any argument is nil.
+    # @raise [Common::HTTPError] If the request is invalid.
+    # @author tnoguer
+    def stop_host(cluster_name, host_name)
+      return execute_method_on_components(method(:stop_host_component), cluster_name, nil, host_name)
+    end
+
+    public
+    # Installs every components of a specific service for an host.
+    # @param cluster_name The name of the cluster.
+    # @param service_name The name of the service.
+    # @param host_name The name of the host.
+    # @return [Array] The IDs of the processing requests. Empty if there is no requests.
+    # @raise [ArgumentError] If any argument is nil.
+    # @raise [Common::HTTPError] If the request is invalid.
+    # @author tnoguer
+    def install_host_components(cluster_name, service_name, host_name)
+      return execute_method_on_components(method(:install_host_component), cluster_name, service_name, host_name)
+    end
+
+    public
+    # Starts every components of a specific service for an host.
+    # @param cluster_name The name of the cluster.
+    # @param service_name The name of the service.
+    # @param host_name The name of the host.
+    # @return [Array] The IDs of the processing requests. Empty if there is no requests.
+    # @raise [ArgumentError] If any argument is nil.
+    # @raise [Common::HTTPError] If the request is invalid.
+    # @author tnoguer
+    def start_host_components(cluster_name, service_name, host_name)
+      return execute_method_on_components(method(:start_host_component), cluster_name, service_name, host_name)
+    end
+
+    public
+    # Stops every components of a specific service for an host.
+    # @param cluster_name The name of the cluster.
+    # @param service_name The name of the service.
+    # @param host_name The name of the host.
+    # @return [Array] The IDs of the processing requests. Empty if there is no requests.
+    # @raise [ArgumentError] If any argument is nil.
+    # @raise [Common::HTTPError] If the request is invalid.
+    # @author tnoguer
+    def stop_host_components(cluster_name, service_name, host_name)
+      return execute_method_on_components(method(:stop_host_component), cluster_name, service_name, host_name)
+    end
+
+    public
+    # Adds a component to a service.
+    # @param cluster_name The name of the cluster.
+    # @param service_name The name of the service.
+    # @param component_name The name of the component to add.
+    # @raise [ArgumentError] If any argument is nil.
+    # @raise [Common::HTTPError] If the request is invalid.
+    # @author tnoguer
+    def add_service_component(cluster_name, service_name, component_name)
+      @rest_connector.add_service_component(cluster_name, service_name, component_name)
+    end
+
+    public
+    # Defines a new service.
+    # @param cluster_name The name of the cluster.
+    # @param service_name The name of the service to define.
+    # @raise [ArgumentError] If any argument is nil.
+    # @raise [Common::HTTPError] If the request is invalid.
+    # @raise [Common::AlreadyExistsEntity] If the service is already defined
+    # @author tnoguer
+    def define_service(cluster_name, service_name)
+      begin
+        @rest_connector.define_service(cluster_name, service_name)
+      rescue ServerError => e
+        raise Common::AlreadyExistsEntity.new("service", service_name, e.to_s) if e.code == 409
+      end
+    end
+
+    public
+    # Deletes a service.
+    # @param cluster_name The name of the cluster.
+    # @param service_name The name of the service to delete.
+    # @raise [ArgumentError] If any argument is nil.
+    # @raise [Common::HTTPError] If the request is invalid.
+    # @author tnoguer
+    def delete_service(cluster_name, service_name)
+      @rest_connector.delete_service(cluster_name, service_name)
+    end
+
+    public
+    # Installs a service.
+    # @param cluster_name The name of the cluster.
+    # @param service_name The name of the service to install.
+    # @return [Array] The IDs of the processing requests. Empty if there is no requests.
+    # @raise [ArgumentError] If any argument is nil.
+    # @raise [Common::HTTPError] If the request is invalid.
+    # @author tnoguer
+    def install_service(cluster_name, service_name)
+      return execute_method_on_components(method(:install_host_component), cluster_name, service_name)
+    end
+
+    public
+    # Starts a service.
+    # @param cluster_name The name of the cluster.
+    # @param service_name The name of the service to start.
+    # @return [Array] The IDs of the processing requests. Empty if there is no requests.
+    # @raise [ArgumentError] If any argument is nil.
+    # @raise [Common::HTTPError] If the request is invalid.
+    # @author tnoguer
+    def start_service(cluster_name, service_name)
+      return execute_method_on_components(method(:start_host_component), cluster_name, service_name)
+    end
+
+    public
+    # Stops a service.
+    # @param cluster_name The name of the cluster.
+    # @param service_name The name of the service to stop.
+    # @return [Array] The IDs of the processing requests. Empty if there is no requests.
+    # @raise [ArgumentError] If any argument is nil.
+    # @raise [Common::HTTPError] If the request is invalid.
+    # @author tnoguer
+    def stop_service(cluster_name, service_name)
+      return execute_method_on_components(method(:stop_host_component), cluster_name, service_name)
+    end
+
+    public
+    # Installs a type of components of a service.
+    # @param cluster_name The name of the cluster.
+    # @param component_name The name of the components to install.
+    # @return [Array] The IDs of the processing requests. Empty if there is no requests.
+    # @raise [ArgumentError] If any argument is nil.
+    # @raise [Common::HTTPError] If the request is invalid.
+    # @author tnoguer
+    def install_component(cluster_name, component_name)
+      return execute_method_on_components(method(:install_host_component), cluster_name, nil, nil, component_name)
+    end
+
+    public
+    # Starts a type of component.
+    # @param cluster_name The name of the cluster.
+    # @param component_name The name of the components to start.
+    # @return [Array] The IDs of the processing requests. Empty if there is no requests.
+    # @raise [ArgumentError] If any argument is nil.
+    # @raise [Common::HTTPError] If the request is invalid.
+    # @author tnoguer
+    def start_component(cluster_name, component_name)
+      return execute_method_on_components(method(:start_host_component), cluster_name, nil, nil, component_name)
+    end
+
+    public
+    # Stops a type of component.
+    # @param cluster_name The name of the cluster.
+    # @param component_name The name of the components to stops.
+    # @return [Array] The IDs of the processing requests. Empty if there is no requests.
+    # @raise [ArgumentError] If any argument is nil.
+    # @raise [Common::HTTPError] If the request is invalid.
+    # @author tnoguer
+    def stop_component(cluster_name, component_name)
+      return execute_method_on_components(method(:stop_host_component), cluster_name, nil, nil, component_name)
+    end
+
+    public
+    # Shows information of a type of components of a service.
+    # @param cluster_name The name of the cluster.
+    # @param service_name The name of the service.
+    # @param component_name The name of the components.
+    # @return The result of the request.
+    # @raise [ArgumentError] If any argument is nil.
+    # @raise [Common::HTTPError] If the request is invalid.
+    # @author tnoguer
+    def show_service_components(cluster_name, service_name, component_name)
+      response = @rest_connector.show_service_components(cluster_name, service_name, component_name)
+      return JSON.parse(response.body)
+    end
+
+    public
+    # Shows the list of service of a cluster.
+    # @param cluster_name The name of the cluster.
+    # @param service_name The name of the service.
+    # @return The result of the request.
+    # @raise [ArgumentError] If any argument is nil.
+    # @raise [Common::HTTPError] If the request is invalid.
+    # @author tnoguer
+    def show_service(cluster_name, service_name)
+      response = @rest_connector.show_service(cluster_name, service_name)
+      return JSON.parse(response.body)
+    end
+
+    private
+    # Checks if the action is valid on the host component.
+    # @param action The action to perform.
+    # @param cluster_name The name of the cluster.
+    # @param host_name The name of the host.
+    # @param component_name The name of the component
+    # @raise [Common::InvalidActionSequence] If the action can't be performed on the host component.
+    # @author tnoguer
+    def valid_action_host_component(action, cluster_name, host_name, component_name)
+      response = show_host_component(cluster_name, host_name, component_name)
+      current_state = response["state"]
+      unless @@available_actions[action]['required_state'].include?(current_state)
+        raise Common::InvalidActionSequence.new(action, current_state, @@available_actions, "#{component_name}/#{host_name}", "host component")
+      end
+    end
+
+    private
+    # Execute a method passed in parameter for every host component of a cluster
+    # @param method The method to be executed. Must be either install_host_component, start_host_component or stop_host_component
+    # @param cluster_name The name of the cluster.
+    # @param service_name The name of the service, used to filter to this service.. Can be nil.
+    # @param host_name The name of the host, used to filter to this host. Can be nil.
+    # @param component_type The type of component, used to filter to this component. Can be nil
+    # @return [Array] The returns of the calls of the method.
+    # @author tnoguer
+    def execute_method_on_components(method, cluster_name, service_name = nil, host_name = nil, component_type = nil)
+      request_ids = []
+      data = show_cluster(cluster_name, true, true)
+      data['services'].each do |service|
+        if service_name == nil || service_name == service['ServiceInfo']['service_name']
+          service['components'].each do |component|
+            if component_type == nil || component_type == component['ServiceComponentInfo']['component_name']
+              component['host_components'].each do |host_component|
+                if host_name == nil || host_name == host_component['HostRoles']['host_name']
+                  begin
+                    request_ids << method.call(cluster_name, host_component['HostRoles']['host_name'], component['ServiceComponentInfo']['component_name'])
+                  rescue Common::InvalidActionSequence
+                    # @todo Do a feedback to the interface that the install of the component was ignored.
+                  end
+                end
+              end
+            end
+          end
+        end
+      end
+      return request_ids
+    end
+
+    private
+    # Get the id of the ambari request from the http response when the response code is 202.
+    # @param response [HTTPReseponse] The http response.
+    # @return The id of the request in case there is one, nil otherwise.
+    # @author tnoguer
+    def get_request_id_from_response(response)
+      request_id = nil
+      if response.code == '202'
+        request_id = JSON.parse(response.body)['Requests']['id']
+      end
+      return request_id
+    end
+
+  end
+end