305 lines
11 KiB
Python
305 lines
11 KiB
Python
# vim: tabstop=4 shiftwidth=4 softtabstop=4
|
|
# coding=utf-8
|
|
|
|
# Copyright 2013 Hewlett-Packard Development Company, L.P.
|
|
# 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.
|
|
#
|
|
# Copyright (c) 2013-2017 Wind River Systems, Inc.
|
|
#
|
|
|
|
"""
|
|
Client side of the agent RPC API.
|
|
"""
|
|
|
|
from sysinv.objects import base as objects_base
|
|
import sysinv.openstack.common.rpc.proxy
|
|
from sysinv.openstack.common import log
|
|
|
|
LOG = log.getLogger(__name__)
|
|
|
|
MANAGER_TOPIC = 'sysinv.agent_manager'
|
|
|
|
|
|
class AgentAPI(sysinv.openstack.common.rpc.proxy.RpcProxy):
|
|
"""Client side of the agent RPC API.
|
|
|
|
API version history:
|
|
|
|
1.0 - Initial version.
|
|
"""
|
|
|
|
RPC_API_VERSION = '1.0'
|
|
|
|
def __init__(self, topic=None):
|
|
if topic is None:
|
|
topic = MANAGER_TOPIC
|
|
|
|
# if host is None: ? JKUNG
|
|
|
|
super(AgentAPI, self).__init__(
|
|
topic=topic,
|
|
serializer=objects_base.SysinvObjectSerializer(),
|
|
default_version=self.RPC_API_VERSION)
|
|
|
|
def ihost_inventory(self, context, values):
|
|
"""Synchronously, have a agent collect inventory for this ihost.
|
|
|
|
Collect ihost inventory and report to conductor.
|
|
|
|
:param context: request context.
|
|
:param values: dictionary with initial values for new ihost object
|
|
:returns: created ihost object, including all fields.
|
|
"""
|
|
return self.call(context,
|
|
self.make_msg('ihost_inventory',
|
|
values=values))
|
|
|
|
def configure_isystemname(self, context, systemname):
|
|
"""Asynchronously, have the agent configure the isystemname
|
|
into the /etc/motd of the host.
|
|
|
|
:param context: request context.
|
|
:param systemname: systemname
|
|
:returns: none ... uses asynchronous cast().
|
|
"""
|
|
# fanout / broadcast message to all inventory agents
|
|
# to change systemname on all nodes ... standby controller and worker nodes
|
|
LOG.debug("AgentApi.configure_isystemname: fanout_cast: sending systemname to agent")
|
|
retval = self.fanout_cast(context, self.make_msg('configure_isystemname',
|
|
systemname=systemname))
|
|
|
|
return retval
|
|
|
|
def iconfig_update_file(self, context, iconfig_uuid, iconfig_dict):
|
|
"""Asynchronously, have the agent configure the iiconfig_uuid,
|
|
by updating file based upon iconfig_dict.
|
|
|
|
:param context: request context.
|
|
:param iconfig_uuid: iconfig_uuid,
|
|
:param iconfig_dict: iconfig_dict dictionary of attributes:
|
|
: {personalities: list of ihost personalities
|
|
: file_names: list of full path file names
|
|
: file_content: file contents
|
|
: actions: put(full replacement), patch, update_applied
|
|
: action_key: match key (for patch only)
|
|
: }
|
|
:returns: none ... uses asynchronous cast().
|
|
"""
|
|
|
|
LOG.debug("AgentApi.iconfig_update_file: fanout_cast: sending"
|
|
" iconfig %s %s to agent" % (iconfig_uuid, iconfig_dict))
|
|
|
|
# fanout / broadcast message to all inventory agents
|
|
retval = self.fanout_cast(context, self.make_msg(
|
|
'iconfig_update_file',
|
|
iconfig_uuid=iconfig_uuid,
|
|
iconfig_dict=iconfig_dict))
|
|
|
|
return retval
|
|
|
|
def iconfig_update_install_uuid(self, context, host_uuid, install_uuid):
|
|
"""Asynchronously, have the agent update install_uuid in
|
|
/etc/platform/platform.conf
|
|
|
|
:param context: request context.
|
|
:param host_uuid: The host uuid to update the install_uuid
|
|
:param install_uuid: The updated install_uuid that will be
|
|
: written into /etc/platform/platform.conf
|
|
"""
|
|
|
|
LOG.debug("AgentApi.iconfig_update_install_uuid: fanout_cast: sending"
|
|
" install_uuid %s to agent" % install_uuid)
|
|
|
|
retval = self.fanout_cast(context, self.make_msg(
|
|
'iconfig_update_install_uuid',
|
|
host_uuid=host_uuid,
|
|
install_uuid=install_uuid))
|
|
|
|
return retval
|
|
|
|
def config_apply_runtime_manifest(self, context, config_uuid, config_dict):
|
|
"""Asynchronously have the agent apply the specified
|
|
manifest based upon the config_dict (including personalities).
|
|
"""
|
|
|
|
LOG.debug("config_apply_runtime_manifest: fanout_cast: sending"
|
|
" config %s %s to agent" % (config_uuid, config_dict))
|
|
|
|
# fanout / broadcast message to all inventory agents
|
|
retval = self.fanout_cast(context, self.make_msg(
|
|
'config_apply_runtime_manifest',
|
|
config_uuid=config_uuid,
|
|
config_dict=config_dict))
|
|
return retval
|
|
|
|
def configure_ttys_dcd(self, context, uuid, ttys_dcd):
|
|
"""Asynchronously, have the agent configure the getty on the serial
|
|
console.
|
|
|
|
:param context: request context.
|
|
:param uuid: the host uuid
|
|
:param ttys_dcd: the flag to enable/disable dcd
|
|
:returns: none ... uses asynchronous cast().
|
|
"""
|
|
# fanout / broadcast message to all inventory agents
|
|
LOG.debug("AgentApi.configure_ttys_dcd: fanout_cast: sending "
|
|
"dcd update to agent: (%s) (%s" % (uuid, ttys_dcd))
|
|
retval = self.fanout_cast(
|
|
context, self.make_msg('configure_ttys_dcd',
|
|
uuid=uuid, ttys_dcd=ttys_dcd))
|
|
|
|
return retval
|
|
|
|
def delete_load(self, context, host_uuid, software_version):
|
|
"""Asynchronously, have the agent remove the specified load
|
|
|
|
:param context: request context.
|
|
:param host_uuid: the host uuid
|
|
:param software_version: the version of the load to remove
|
|
:returns: none ... uses asynchronous cast().
|
|
"""
|
|
# fanout / broadcast message to all inventory agents
|
|
LOG.debug("AgentApi.delete_load: fanout_cast: sending "
|
|
"delete load to agent: (%s) (%s) " %
|
|
(host_uuid, software_version))
|
|
retval = self.fanout_cast(
|
|
context, self.make_msg(
|
|
'delete_load',
|
|
host_uuid=host_uuid,
|
|
software_version=software_version))
|
|
|
|
return retval
|
|
|
|
def create_simplex_backup(self, context, software_upgrade):
|
|
"""Asynchronously, have the agent create the simplex backup data
|
|
|
|
:param context: request context.
|
|
:param software_upgrade: software_upgrade object
|
|
:returns: none
|
|
"""
|
|
retval = self.fanout_cast(context,
|
|
self.make_msg(
|
|
'create_simplex_backup',
|
|
software_upgrade=software_upgrade))
|
|
|
|
return retval
|
|
|
|
def apply_tpm_config(self, context, tpm_context):
|
|
"""Asynchronously, have the agent apply the tpm config
|
|
|
|
:param context: request context.
|
|
:param tpm_context: the TPM configuration context
|
|
:returns: none ... uses asynchronous cast().
|
|
"""
|
|
# fanout / broadcast message to all inventory agents
|
|
LOG.debug("AgentApi.apply_tpm_config: fanout_cast: sending "
|
|
"apply_tpm_config to agent")
|
|
retval = self.fanout_cast(
|
|
context, self.make_msg(
|
|
'apply_tpm_config',
|
|
tpm_context=tpm_context))
|
|
|
|
return retval
|
|
|
|
# TODO(oponcea) Evaluate if we need to delete PV's from sysinv-agent in the future - may be needed for AIO SX disk cinder-volumes disk replacement.
|
|
def delete_pv(self, context, host_uuid, ipv_dict):
|
|
"""Synchronously, delete an LVM physical volume
|
|
|
|
Also delete logical volume group if this is the last PV in group
|
|
|
|
:param context: an admin context
|
|
:param host_uuid: ihost uuid unique id
|
|
:param ipv_dict_array: values for physical volume object
|
|
:returns: pass or fail
|
|
"""
|
|
|
|
return self.call(context,
|
|
self.make_msg('delete_pv',
|
|
host_uuid=host_uuid,
|
|
ipv_dict=ipv_dict),
|
|
timeout=300)
|
|
|
|
def execute_command(self, context, host_uuid, command):
|
|
"""Asynchronously, have the agent execute a command
|
|
|
|
:param context: request context.
|
|
:param host_uuid: the host uuid
|
|
:param command: the command to execute
|
|
:returns: none ... uses asynchronous cast().
|
|
"""
|
|
# fanout / broadcast message to all inventory agents
|
|
LOG.debug("AgentApi.update_cpu_config: fanout_cast: sending "
|
|
"host uuid: (%s) " % host_uuid)
|
|
retval = self.fanout_cast(
|
|
context, self.make_msg(
|
|
'execute_command',
|
|
host_uuid=host_uuid,
|
|
command=command))
|
|
|
|
return retval
|
|
|
|
def agent_update(self, context, host_uuid, force_updates, cinder_device=None):
|
|
"""
|
|
Asynchronously, have the agent update partitions, ipv and ilvg state
|
|
|
|
:param context: request context
|
|
:param host_uuid: the host uuid
|
|
:param force_updates: list of inventory objects to update
|
|
:param cinder_device: device by path of cinder volumes
|
|
:return: none ... uses asynchronous cast().
|
|
"""
|
|
|
|
# fanout / broadcast message to all inventory agents
|
|
LOG.info("AgentApi.agent_update: fanout_cast: sending "
|
|
"update request to agent for: (%s)" %
|
|
(', '.join(force_updates)))
|
|
retval = self.fanout_cast(
|
|
context, self.make_msg(
|
|
'agent_audit',
|
|
host_uuid=host_uuid,
|
|
force_updates=force_updates,
|
|
cinder_device=cinder_device))
|
|
|
|
return retval
|
|
|
|
def disk_format_gpt(self, context, host_uuid, idisk_dict,
|
|
is_cinder_device):
|
|
"""Asynchronously, GPT format a disk.
|
|
|
|
:param context: an admin context
|
|
:param host_uuid: ihost uuid unique id
|
|
:param idisk_dict: values for disk object
|
|
:param is_cinder_device: bool value tells if the idisk is for cinder
|
|
:returns: pass or fail
|
|
"""
|
|
|
|
return self.fanout_cast(
|
|
context,
|
|
self.make_msg('disk_format_gpt',
|
|
host_uuid=host_uuid,
|
|
idisk_dict=idisk_dict,
|
|
is_cinder_device=is_cinder_device))
|
|
|
|
def update_host_memory(self, context, host_uuid):
|
|
"""Asynchronously, have the agent to send host memory update
|
|
|
|
:param context: request context.
|
|
:param host_uuid: ihost uuid unique id
|
|
:returns: pass or fail
|
|
"""
|
|
return self.fanout_cast(context,
|
|
self.make_msg('update_host_memory',
|
|
host_uuid=host_uuid))
|