text: # Copyright (c) 2011 OpenStack Foundation
  # All Rights Reserved.
  #
  #    Licensed under the Apache License, Version 2.0 (the "License"); you may
  #    not use this file except in compliance with the License. You may obtain
  #    a copy of the License at
  #
  #         http://www.apache.org/licenses/LICENSE-2.0
  #
  #    Unless required by applicable law or agreed to in writing, software
  #    distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
  #    WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
  #    License for the specific language governing permissions and limitations
  #    under the License.
  
  """The hosts admin extension."""
  
  from oslo_log import log as logging
  import six
  import webob.exc
  
  from nova.api.openstack import common
  from nova.api.openstack.compute.schemas import hosts
  from nova.api.openstack import wsgi
  from nova.api import validation
  from nova.compute import api as compute
  from nova import context as nova_context
  from nova import exception
  from nova import objects
  from nova.policies import hosts as hosts_policies
  
  LOG = logging.getLogger(__name__)
  
  
  class HostController(wsgi.Controller):
      """The Hosts API controller for the OpenStack API."""
      def __init__(self):
          super(HostController, self).__init__()
          self.api = compute.HostAPI()
  
      @wsgi.Controller.api_version("2.1", "2.42")
      @validation.query_schema(hosts.index_query)
      @wsgi.expected_errors(())
      def index(self, req):
          """Returns a dict in the format
  
          |   {'hosts': [{'host_name': 'some.host.name',
          |     'service': 'cells',
          |     'zone': 'internal'},
          |    {'host_name': 'some.other.host.name',
          |     'service': 'cells',
          |     'zone': 'internal'},
          |    {'host_name': 'some.celly.host.name',
          |     'service': 'cells',
          |     'zone': 'internal'},
          |    {'host_name': 'compute1.host.com',
          |     'service': 'compute',
          |     'zone': 'nova'},
          |    {'host_name': 'compute2.host.com',
          |     'service': 'compute',
          |     'zone': 'nova'},
          |    {'host_name': 'sched1.host.com',
          |     'service': 'scheduler',
          |     'zone': 'internal'},
          |    {'host_name': 'sched2.host.com',
          |     'service': 'scheduler',
          |     'zone': 'internal'},
          |    {'host_name': 'vol1.host.com',
          |     'service': 'volume',
          |     'zone': 'internal'}]}
  
          """
          context = req.environ['nova.context']
          context.can(hosts_policies.BASE_POLICY_NAME)
          filters = {'disabled': False}
          zone = req.GET.get('zone', None)
          if zone:
              filters['availability_zone'] = zone
          services = self.api.service_get_all(context, filters=filters,
                                              set_zones=True, all_cells=True)
          hosts = []
          api_services = ('nova-osapi_compute', 'nova-metadata')
          for service in services:
              if service.binary not in api_services:
                  hosts.append({'host_name': service['host'],
                                'service': service['topic'],
                                'zone': service['availability_zone']})
          return {'hosts': hosts}
  
      @wsgi.Controller.api_version("2.1", "2.42")
      @wsgi.expected_errors((400, 404, 501))
      @validation.schema(hosts.update)
      def update(self, req, id, body):
          """Return booleanized version of body dict.
  
          :param Request req: The request object (containing 'nova-context'
                              env var).
          :param str id: The host name.
          :param dict body: example format {'host': {'status': 'enable',
                            'maintenance_mode': 'enable'}}
          :return: Same dict as body but 'enable' strings for 'status' and
                   'maintenance_mode' are converted into True, else False.
          :rtype: dict
          """
          def read_enabled(orig_val):
              # Convert enable/disable str to a bool.
              val = orig_val.strip().lower()
              return val == "enable"
  
          context = req.environ['nova.context']
          context.can(hosts_policies.BASE_POLICY_NAME)
          # See what the user wants to 'update'
          status = body.get('status')
          maint_mode = body.get('maintenance_mode')
          if status is not None:
              status = read_enabled(status)
          if maint_mode is not None:
              maint_mode = read_enabled(maint_mode)
          # Make the calls and merge the results
          result = {'host': id}
          if status is not None:
              result['status'] = self._set_enabled_status(context, id, status)
          if maint_mode is not None:
              result['maintenance_mode'] = self._set_host_maintenance(context,
                                                                      id,
                                                                      maint_mode)
          return result
  
      def _set_host_maintenance(self, context, host_name, mode=True):
          """Start/Stop host maintenance window. On start, it triggers
          guest VMs evacuation.
          """
          LOG.info("Putting host %(host_name)s in maintenance mode %(mode)s.",
                   {'host_name': host_name, 'mode': mode})
          try:
              result = self.api.set_host_maintenance(context, host_name, mode)
          except NotImplementedError:
              common.raise_feature_not_supported()
          except (exception.HostNotFound, exception.HostMappingNotFound) as e:
              raise webob.exc.HTTPNotFound(explanation=e.format_message())
          except exception.ComputeServiceUnavailable as e:
              raise webob.exc.HTTPBadRequest(explanation=e.format_message())
          if result not in ("on_maintenance", "off_maintenance"):
              raise webob.exc.HTTPBadRequest(explanation=result)
          return result
  
      def _set_enabled_status(self, context, host_name, enabled):
          """Sets the specified host's ability to accept new instances.
          :param enabled: a boolean - if False no new VMs will be able to start
                          on the host.
          """
          if enabled:
              LOG.info("Enabling host %s.", host_name)
          else:
              LOG.info("Disabling host %s.", host_name)
          try:
              result = self.api.set_host_enabled(context, host_name, enabled)
          except NotImplementedError:
              common.raise_feature_not_supported()
          except (exception.HostNotFound, exception.HostMappingNotFound) as e:
              raise webob.exc.HTTPNotFound(explanation=e.format_message())
          except exception.ComputeServiceUnavailable as e:
              raise webob.exc.HTTPBadRequest(explanation=e.format_message())
          if result not in ("enabled", "disabled"):
              raise webob.exc.HTTPBadRequest(explanation=result)
          return result
  
      def _host_power_action(self, req, host_name, action):
          """Reboots, shuts down or powers up the host."""
          context = req.environ['nova.context']
          context.can(hosts_policies.BASE_POLICY_NAME)
          try:
              result = self.api.host_power_action(context, host_name, action)
          except NotImplementedError:
              common.raise_feature_not_supported()
          except (exception.HostNotFound, exception.HostMappingNotFound) as e:
              raise webob.exc.HTTPNotFound(explanation=e.format_message())
          except exception.ComputeServiceUnavailable as e:
              raise webob.exc.HTTPBadRequest(explanation=e.format_message())
          return {"host": host_name, "power_action": result}
  
      @wsgi.Controller.api_version("2.1", "2.42")
      @wsgi.expected_errors((400, 404, 501))
      def startup(self, req, id):
          return self._host_power_action(req, host_name=id, action="startup")
  
      @wsgi.Controller.api_version("2.1", "2.42")
      @wsgi.expected_errors((400, 404, 501))
      def shutdown(self, req, id):
          return self._host_power_action(req, host_name=id, action="shutdown")
  
      @wsgi.Controller.api_version("2.1", "2.42")
      @wsgi.expected_errors((400, 404, 501))
      def reboot(self, req, id):
          return self._host_power_action(req, host_name=id, action="reboot")
  
      @staticmethod
      def _get_total_resources(host_name, compute_node):
          return {'resource': {'host': host_name,
                               'project': '(total)',
                               'cpu': compute_node.vcpus,
                               'memory_mb': compute_node.memory_mb,
                               'disk_gb': compute_node.local_gb}}
  
      @staticmethod
      def _get_used_now_resources(host_name, compute_node):
          return {'resource': {'host': host_name,
                               'project': '(used_now)',
                               'cpu': compute_node.vcpus_used,
                               'memory_mb': compute_node.memory_mb_used,
                               'disk_gb': compute_node.local_gb_used}}
  
      @staticmethod
      def _get_resource_totals_from_instances(host_name, instances):
          cpu_sum = 0
          mem_sum = 0
          hdd_sum = 0
          for instance in instances:
              cpu_sum += instance['vcpus']
              mem_sum += instance['memory_mb']
              hdd_sum += instance['root_gb'] + instance['ephemeral_gb']
  
          return {'resource': {'host': host_name,
                               'project': '(used_max)',
                               'cpu': cpu_sum,
                               'memory_mb': mem_sum,
                               'disk_gb': hdd_sum}}
  
      @staticmethod
      def _get_resources_by_project(host_name, instances):
          # Getting usage resource per project
          project_map = {}
          for instance in instances:
              resource = project_map.setdefault(instance['project_id'],
                      {'host': host_name,
                       'project': instance['project_id'],
                       'cpu': 0,
                       'memory_mb': 0,
                       'disk_gb': 0})
              resource['cpu'] += instance['vcpus']
              resource['memory_mb'] += instance['memory_mb']
              resource['disk_gb'] += (instance['root_gb'] +
                                      instance['ephemeral_gb'])
          return project_map
  
      @wsgi.Controller.api_version("2.1", "2.42")
      @wsgi.expected_errors(404)
      def show(self, req, id):
          """Shows the physical/usage resource given by hosts.
  
          :param id: hostname
          :returns: expected to use HostShowTemplate.
              ex.::
  
                  {'host': {'resource':D},..}
                  D: {'host': 'hostname','project': 'admin',
                      'cpu': 1, 'memory_mb': 2048, 'disk_gb': 30}
          """
          context = req.environ['nova.context']
          context.can(hosts_policies.BASE_POLICY_NAME)
          host_name = id
          try:
              mapping = objects.HostMapping.get_by_host(context, host_name)
              nova_context.set_target_cell(context, mapping.cell_mapping)
              compute_node = (
                  objects.ComputeNode.get_first_node_by_host_for_old_compat(
                      context, host_name))
              instances = self.api.instance_get_all_by_host(context, host_name)
          except (exception.ComputeHostNotFound,
                  exception.HostMappingNotFound) as e:
              raise webob.exc.HTTPNotFound(explanation=e.format_message())
          resources = [self._get_total_resources(host_name, compute_node)]
          resources.append(self._get_used_now_resources(host_name,
                                                        compute_node))
          resources.append(self._get_resource_totals_from_instances(host_name,
                                                                    instances))
          by_proj_resources = self._get_resources_by_project(host_name,
                                                             instances)
          for resource in six.itervalues(by_proj_resources):
              resources.append({'resource': resource})
          return {'host': resources}
  