def to_managed_object(self):
"""
Method creates and returns an object of ManagedObject class using the class_id and information from the
Generic managed object.
"""
from Imc import class_factory
cln = ImcUtils.word_u(self._class_id)
mo = class_factory(cln)
if mo and isinstance(mo, ManagedObject) == True:
meta_class_id = CoreUtils.find_class_id_in_mo_meta_ignore_case(self._class_id)
mo.set_handle(self._handle)
for prop in self.properties:
if ImcUtils.word_u(prop) in CoreUtils.get_property_list(meta_class_id):
mo.set_attr(ImcUtils.word_u(prop), self.properties[prop])
else:
ImcUtils.write_imc_warning("Property %s Not Exist in MO %s" %(ImcUtils.word_u(prop), meta_class_id))
if len(self._child):
for child in self._child:
moch = child.to_managed_object()
mo.child.append(moch)
return mo
else:
return None
def to_managed_object(self):
"""
Method creates and returns an object of ManagedObject class using the class_id and information from the
Generic managed object.
"""
from Imc import class_factory
cln = ImcUtils.word_u(self._class_id)
mo = class_factory(cln)
if mo and isinstance(mo, ManagedObject) == True:
meta_class_id = CoreUtils.find_class_id_in_mo_meta_ignore_case(
self._class_id)
mo.set_handle(self._handle)
for prop in self.properties:
if ImcUtils.word_u(prop) in CoreUtils.get_property_list(
meta_class_id):
mo.set_attr(ImcUtils.word_u(prop), self.properties[prop])
else:
ImcUtils.write_imc_warning(
"Property %s Not Exist in MO %s" %
(ImcUtils.word_u(prop), meta_class_id))
if len(self._child):
for child in self._child:
moch = child.to_managed_object()
mo.child.append(moch)
return mo
else:
return None
def _translate_imc_managedobject(m_obj, xlate_map):
""" Method used to translate a managedobject. This method is used in compare_imc_managedobject. """
x_mo = m_obj.clone()
x_mo.set_handle(m_obj.get_handle())
if xlate_map != None:
original_dn = x_mo.dn
if original_dn in xlate_map:
x_mometa = CoreUtils.get_mo_property_meta(ImcUtils.word_u(x_mo.class_id), "Meta")
if x_mometa == None:
ImcUtils.write_imc_warning('[Warning]: Could not translate [%s]' %(original_dn))
return x_mo
#Check for naming property
match_obj = re.findall(r'(\[[^\]]+\])', x_mometa.rn)
if match_obj:
_update_mo_dn_along_with_naming_properties(x_mo, x_mometa, xlate_map[original_dn])
else:
#print "Translating", x_mo.dn, " => ", xlate_map[original_dn]
x_mo.dn = xlate_map[original_dn]
else:
original_dn = re.sub(r'[/]*[^/]+$', '', original_dn)
while original_dn != None or original_dn == "":
if not original_dn in xlate_map:
original_dn = re.sub(r'[/]*[^/]+$', '', original_dn)
continue
new_dn = re.sub("^%s/"%(original_dn), "%s/"%(xlate_map[original_dn]), x_mo.dn)
#print "Translating", x_mo.dn, " => ", new_dn
x_mo.dn = new_dn
break
return x_mo
def _translate_imc_managedobject(m_obj, xlate_map):
""" Method used to translate a managedobject. This method is used in compare_imc_managedobject. """
x_mo = m_obj.clone()
x_mo.set_handle(m_obj.get_handle())
if xlate_map != None:
original_dn = x_mo.dn
if original_dn in xlate_map:
x_mometa = CoreUtils.get_mo_property_meta(
ImcUtils.word_u(x_mo.class_id), "Meta")
if x_mometa == None:
ImcUtils.write_imc_warning(
'[Warning]: Could not translate [%s]' % (original_dn))
return x_mo
#Check for naming property
match_obj = re.findall(r'(\[[^\]]+\])', x_mometa.rn)
if match_obj:
_update_mo_dn_along_with_naming_properties(
x_mo, x_mometa, xlate_map[original_dn])
else:
#print "Translating", x_mo.dn, " => ", xlate_map[original_dn]
x_mo.dn = xlate_map[original_dn]
else:
original_dn = re.sub(r'[/]*[^/]+$', '', original_dn)
while original_dn != None or original_dn == "":
if not original_dn in xlate_map:
original_dn = re.sub(r'[/]*[^/]+$', '', original_dn)
continue
new_dn = re.sub("^%s/" % (original_dn),
"%s/" % (xlate_map[original_dn]), x_mo.dn)
#print "Translating", x_mo.dn, " => ", new_dn
x_mo.dn = new_dn
break
return x_mo
def set_imc_managedobject(self,
in_mo,
class_id=None,
params=None,
dump_xml=None):
"""
Modifies Managed Object in IMC.
- in_mo, if provided, it acts as the target object for the present operation.
It should be None unless a username wants to provide an in_mo.
It can be a single MO or a list containing multiple managed objects.
- class_id of the managed object/s to be removed.
- params contains semicolon (;) separated list of key/value pairs(key=value),
that are used as filters for selecting specific managed objects.
The key should be a valid property of the managed object to be modified.
"""
#unknown_mo = False
dn = None
obj = None
config_map = None
dn_param_set = False
if params != None:
keys = params.keys()
else:
keys = []
for key in keys:
if key.lower() == "dn":
# ClassId And dn Specified - No Parent Necessary
dn_param_set = True
dn = params[key]
if in_mo == None or not isinstance(in_mo, list) or len(in_mo) == 0:
if not dn_param_set:
if class_id == None or class_id == "":
raise ImcValidationException(
'[Error]: set_imc_managedobject [Description]: in_mo and ClassId are both not specified'
)
else:
raise ImcValidationException(
'[Error]: set_imc_managedobject [Description]: in_mo and dn are both not specified'
)
else:
if class_id == None or class_id == "":
raise ImcValidationException(
'[Error]: set_imc_managedobject [Description]: in_mo and ClassId are both not specified'
)
else:
meta_class_id = CoreUtils.find_class_id_in_mo_meta_ignore_case(
class_id)
if meta_class_id != None:
class_id = meta_class_id
# mo_meta = CoreUtils.get_mo_property_meta(class_id, "Meta")
#else:
# unknown_mo = True
obj = ManagedObject(class_id)
for prop in keys:
prop_mo_meta = CoreUtils.is_property_in_meta_ignore_case(
class_id, prop)
if prop_mo_meta != None:
if prop.lower() == "rn" or prop.lower() == "dn":
pass
elif prop_mo_meta.access == MoPropertyMeta.READ_ONLY:
ImcUtils.write_imc_warning(
"[Warning]: SetManagedObject [Description] Attempt to set non-writable property %s in Class %s"
% (prop, class_id))
obj.set_attr(prop_mo_meta.name, str(params[prop]))
else:
#Sets the unknown property/value as Xtra_property in obj
obj.set_attr(ImcUtils.word_l(prop),
str(params[prop]))
obj.set_attr("Dn", dn)
obj.set_attr("Status", Status().MODIFIED)
pair = Pair()
pair.set_attr("Key", obj.get_attr("Dn"))
pair.add_child(obj)
config_map = ConfigMap()
config_map.add_child(pair)
else:
if class_id != None and class_id != "":
ImcUtils.write_imc_warning(
"[Warning]: SetManagedObject [Description] ClassId <%s> is ignored with InMo input"
% (class_id))
config_map = ConfigMap()
for mo in in_mo:
obj = ManagedObject(mo.prop_mo_meta.name)
dn = mo.get_attr("Dn")
class_id = mo.prop_mo_meta.name
for prop in keys:
prop_mo_meta = CoreUtils.is_property_in_meta_ignore_case(
class_id, prop)
if prop_mo_meta != None:
if prop.lower() == "rn" or prop.lower() == "dn":
pass
elif prop_mo_meta.access == MoPropertyMeta.READ_ONLY:
ImcUtils.write_imc_warning(
"[Warning]: SetManagedObject [Description] Attempt to set non-writeable property %s in Class %s"
% (prop, class_id))
obj.set_attr(prop_mo_meta.name, str(params[prop]))
else:
#Sets the unknown property/value as Xtra_property in obj
obj.set_attr(ImcUtils.word_l(prop), str(params[prop]))
obj.set_attr("Dn", dn)
obj.set_attr("Status", Status.MODIFIED)
pair = Pair()
pair.set_attr("Key", obj.get_attr("Dn"))
pair.add_child(obj)
config_map.add_child(pair)
output_molist = []
for pair in config_map.child:
in_config = ConfigConfig()
for mo in pair.child:
in_config.add_child(mo)
ccm = self.config_conf_mo(dn=pair.Key,
in_config=in_config,
in_hierarchical=YesOrNo.FALSE,
dump_xml=dump_xml)
if ccm.error_code == 0:
molist = []
for child in ccm.OutConfig.child:
if isinstance(child, Pair) == True:
for mo in child.child:
molist.append(mo)
elif isinstance(child, ManagedObject) == True:
molist.append(child)
output_molist.extend(molist)
else:
raise ImcException(ccm.error_code, ccm.error_descr)
return output_molist
def add_imc_managedobject(self,
in_mo=None,
class_id=None,
params=None,
dump_xml=None):
"""
Adds a Managed Object to IMC.
- in_mo, if provided, it acts as a parent for the present operation.
It should be None unless a username wants to define a parent scope.
It can be a single MO or a list containing multiple managed objects.
- class_id of the managed object/s to be added.
- params contains semicolon (;) separated list of key/value pairs(key=value),
that are used as filters for selecting specific managed objects.
The key should be a valid property of the managed object to be added.
"""
unknown_mo = False
if class_id == None or class_id == "":
raise ImcValidationException(
'[Error]: add_imc_managedobject [Description]: class_id is Null'
)
meta_class_id = CoreUtils.find_class_id_in_mo_meta_ignore_case(
class_id)
if meta_class_id != None:
class_id = meta_class_id
mo_meta = CoreUtils.get_mo_property_meta(class_id, "Meta")
else:
unknown_mo = True
config_map = ConfigMap()
rn = None
dn = None
#mo_meta = CoreUtils.get_mo_property_meta(class_id, "Meta")
if params != None:
keys = params.keys()
else:
keys = []
if not unknown_mo:
rn = mo_meta.rn
for prop in CoreUtils.get_property_list(class_id):
prop_meta = CoreUtils.get_mo_property_meta(class_id, prop)
if prop_meta.access != MoPropertyMeta.NAMING:
continue
naming_prop_found = False
for key in keys:
if key.lower() == prop.lower():
rn = re.sub(r'\[%s\]' % prop, '%s' % params[key], rn)
naming_prop_found = True
break
if naming_prop_found == False:
ImcUtils.write_imc_warning(
"[Warning]: add_imc_managedobject [Description]:Expected NAMING Property %s for ClassId %s not found"
% (prop, class_id))
rn = re.sub(r'\[%s\]' % prop, '%s' % "", rn)
obj = ManagedObject(class_id)
for prop in keys:
if not unknown_mo:
prop_mo_meta = CoreUtils.is_property_in_meta_ignore_case(
class_id, prop)
if prop_mo_meta != None:
if prop.lower() == "rn" or prop.lower() == "dn":
pass
elif prop_mo_meta.access == MoPropertyMeta.READ_ONLY:
ImcUtils.write_imc_warning(
"[Warning]: AddManagedObject [Description]:Attempt to add non-writeable property %s in Class %s"
% (prop, class_id))
if prop.lower() == "rn":
if in_mo == None or not isinstance(
in_mo, list) or len(in_mo) == 0:
ImcUtils.write_imc_warning(
"[Warning]: AddManagedObject [Description]:Ignoring Rn since no parent provided"
)
if rn != params[prop]:
ImcUtils.write_imc_warning(
"[Warning]: AddManagedObject [Description]:Rn Mismatch. Provided %s Computed %s. Ignoring Computed Rn"
% (params[prop], rn))
rn = params[
prop] #bug fix. if Rn and Name are both provided by username then Rn will get preference.
if prop.lower() == "dn":
dn = params[prop]
obj.set_attr(prop_mo_meta.name, str(params[prop]))
else:
#Known MO - Unknown Property
obj.set_attr(ImcUtils.word_l(prop), str(params[prop]))
else:
#Unknown MO
if prop.lower() == "dn":
dn = params[prop]
if prop.lower() == "rn":
rn = params[prop]
if rn == None:
rn = ""
obj.set_attr(ImcUtils.word_l(prop), str(params[prop]))
obj.set_attr("Status", Status().CREATED)
if dn != None and dn != "":
obj.set_attr("Dn", dn)
pair = Pair()
#pair.set_attr("Key", obj.dn)
pair.set_attr("Key", obj.get_attr("Dn"))
pair.add_child(obj)
config_map.add_child(pair)
elif in_mo != None and isinstance(in_mo, list) and len(in_mo) > 0:
for mo in in_mo:
pdn = mo.get_attr("Dn")
if pdn != None:
obj.set_attr("Dn", pdn + '/' + rn)
pair = Pair()
#pair.set_attr("Key", obj.dn)
pair.set_attr("Key", obj.get_attr("Dn"))
pair.add_child(obj.clone())
config_map.add_child(pair)
if config_map.get_child_count() == 0:
ImcUtils.write_imc_warning(
'[Warning]: AddManagedObject [Description]: Nothing to Add')
return None
output_molist = []
for pair in config_map.child:
in_config = ConfigConfig()
for mo in pair.child:
in_config.add_child(mo)
ccm = self.config_conf_mo(dn=pair.Key,
in_config=in_config,
in_hierarchical=YesOrNo.FALSE,
dump_xml=dump_xml)
if ccm.error_code == 0:
molist = []
for child in ccm.OutConfig.child:
if isinstance(child, Pair) == True:
for mo in child.child:
molist.append(mo)
elif isinstance(child, ManagedObject) == True:
molist.append(child)
output_molist.extend(molist)
else:
raise ImcException(ccm.error_code, ccm.error_descr)
return output_molist
def set_imc_managedobject(self, in_mo, class_id=None, params=None, dump_xml=None):
"""
Modifies Managed Object in IMC.
- in_mo, if provided, it acts as the target object for the present operation.
It should be None unless a username wants to provide an in_mo.
It can be a single MO or a list containing multiple managed objects.
- class_id of the managed object/s to be removed.
- params contains semicolon (;) separated list of key/value pairs(key=value),
that are used as filters for selecting specific managed objects.
The key should be a valid property of the managed object to be modified.
"""
#unknown_mo = False
dn = None
obj = None
config_map = None
dn_param_set = False
if params != None:
keys = params.keys()
else:
keys = []
for key in keys:
if key.lower() == "dn":
# ClassId And dn Specified - No Parent Necessary
dn_param_set = True
dn = params[key]
if in_mo == None or not isinstance(in_mo, list) or len(in_mo) == 0:
if not dn_param_set:
if class_id == None or class_id == "":
raise ImcValidationException('[Error]: set_imc_managedobject [Description]: in_mo and ClassId are both not specified')
else:
raise ImcValidationException('[Error]: set_imc_managedobject [Description]: in_mo and dn are both not specified')
else:
if class_id == None or class_id == "":
raise ImcValidationException('[Error]: set_imc_managedobject [Description]: in_mo and ClassId are both not specified')
else:
meta_class_id = CoreUtils.find_class_id_in_mo_meta_ignore_case(class_id)
if meta_class_id != None:
class_id = meta_class_id
# mo_meta = CoreUtils.get_mo_property_meta(class_id, "Meta")
#else:
# unknown_mo = True
obj = ManagedObject(class_id)
for prop in keys:
prop_mo_meta = CoreUtils.is_property_in_meta_ignore_case(class_id, prop)
if prop_mo_meta != None:
if prop.lower() == "rn" or prop.lower() == "dn":
pass
elif prop_mo_meta.access == MoPropertyMeta.READ_ONLY:
ImcUtils.write_imc_warning("[Warning]: SetManagedObject [Description] Attempt to set non-writable property %s in Class %s" %(prop, class_id))
obj.set_attr(prop_mo_meta.name, str(params[prop]))
else:
#Sets the unknown property/value as Xtra_property in obj
obj.set_attr(ImcUtils.word_l(prop), str(params[prop]))
obj.set_attr("Dn", dn)
obj.set_attr("Status", Status().MODIFIED)
pair = Pair()
pair.set_attr("Key", obj.get_attr("Dn"))
pair.add_child(obj)
config_map = ConfigMap()
config_map.add_child(pair)
else:
if class_id != None and class_id != "":
ImcUtils.write_imc_warning("[Warning]: SetManagedObject [Description] ClassId <%s> is ignored with InMo input" %(class_id))
config_map = ConfigMap()
for mo in in_mo:
obj = ManagedObject(mo.prop_mo_meta.name)
dn = mo.get_attr("Dn")
class_id = mo.prop_mo_meta.name
for prop in keys:
prop_mo_meta = CoreUtils.is_property_in_meta_ignore_case(class_id, prop)
if prop_mo_meta != None:
if prop.lower() == "rn" or prop.lower() == "dn":
pass
elif prop_mo_meta.access == MoPropertyMeta.READ_ONLY:
ImcUtils.write_imc_warning("[Warning]: SetManagedObject [Description] Attempt to set non-writeable property %s in Class %s" %(prop, class_id))
obj.set_attr(prop_mo_meta.name, str(params[prop]))
else:
#Sets the unknown property/value as Xtra_property in obj
obj.set_attr(ImcUtils.word_l(prop), str(params[prop]))
obj.set_attr("Dn", dn)
obj.set_attr("Status", Status.MODIFIED)
pair = Pair()
pair.set_attr("Key", obj.get_attr("Dn"))
pair.add_child(obj)
config_map.add_child(pair)
output_molist = []
for pair in config_map.child:
in_config = ConfigConfig()
for mo in pair.child:
in_config.add_child(mo)
ccm = self.config_conf_mo(dn=pair.Key, in_config=in_config, in_hierarchical=YesOrNo.FALSE, dump_xml=dump_xml)
if ccm.error_code == 0:
molist = []
for child in ccm.OutConfig.child:
if isinstance(child, Pair) == True:
for mo in child.child:
molist.append(mo)
elif isinstance(child, ManagedObject) == True:
molist.append(child)
output_molist.extend(molist)
else:
raise ImcException(ccm.error_code, ccm.error_descr)
return output_molist
def add_imc_managedobject(self, in_mo=None, class_id=None, params=None, dump_xml=None):
"""
Adds a Managed Object to IMC.
- in_mo, if provided, it acts as a parent for the present operation.
It should be None unless a username wants to define a parent scope.
It can be a single MO or a list containing multiple managed objects.
- class_id of the managed object/s to be added.
- params contains semicolon (;) separated list of key/value pairs(key=value),
that are used as filters for selecting specific managed objects.
The key should be a valid property of the managed object to be added.
"""
unknown_mo = False
if class_id == None or class_id == "":
raise ImcValidationException('[Error]: add_imc_managedobject [Description]: class_id is Null')
meta_class_id = CoreUtils.find_class_id_in_mo_meta_ignore_case(class_id)
if meta_class_id != None:
class_id = meta_class_id
mo_meta = CoreUtils.get_mo_property_meta(class_id, "Meta")
else:
unknown_mo = True
config_map = ConfigMap()
rn = None
dn = None
#mo_meta = CoreUtils.get_mo_property_meta(class_id, "Meta")
if params != None:
keys = params.keys()
else:
keys = []
if not unknown_mo:
rn = mo_meta.rn
for prop in CoreUtils.get_property_list(class_id):
prop_meta = CoreUtils.get_mo_property_meta(class_id, prop)
if prop_meta.access != MoPropertyMeta.NAMING:
continue
naming_prop_found = False
for key in keys:
if key.lower() == prop.lower():
rn = re.sub(r'\[%s\]' % prop, '%s' % params[key], rn)
naming_prop_found = True
break
if naming_prop_found == False:
ImcUtils.write_imc_warning("[Warning]: add_imc_managedobject [Description]:Expected NAMING Property %s for ClassId %s not found" %(prop, class_id))
rn = re.sub(r'\[%s\]' % prop, '%s' % "", rn)
obj = ManagedObject(class_id)
for prop in keys:
if not unknown_mo:
prop_mo_meta = CoreUtils.is_property_in_meta_ignore_case(class_id, prop)
if prop_mo_meta != None:
if prop.lower() == "rn" or prop.lower() == "dn":
pass
elif prop_mo_meta.access == MoPropertyMeta.READ_ONLY:
ImcUtils.write_imc_warning("[Warning]: AddManagedObject [Description]:Attempt to add non-writeable property %s in Class %s" %(prop, class_id))
if prop.lower() == "rn":
if in_mo == None or not isinstance(in_mo, list) or len(in_mo) == 0:
ImcUtils.write_imc_warning("[Warning]: AddManagedObject [Description]:Ignoring Rn since no parent provided")
if rn != params[prop]:
ImcUtils.write_imc_warning("[Warning]: AddManagedObject [Description]:Rn Mismatch. Provided %s Computed %s. Ignoring Computed Rn" %(params[prop], rn))
rn = params[prop]#bug fix. if Rn and Name are both provided by username then Rn will get preference.
if prop.lower() == "dn":
dn = params[prop]
obj.set_attr(prop_mo_meta.name, str(params[prop]))
else:
#Known MO - Unknown Property
obj.set_attr(ImcUtils.word_l(prop), str(params[prop]))
else:
#Unknown MO
if prop.lower() == "dn":
dn = params[prop]
if prop.lower() == "rn":
rn = params[prop]
if rn == None:
rn = ""
obj.set_attr(ImcUtils.word_l(prop), str(params[prop]))
obj.set_attr("Status", Status().CREATED)
if dn != None and dn != "":
obj.set_attr("Dn", dn)
pair = Pair()
#pair.set_attr("Key", obj.dn)
pair.set_attr("Key", obj.get_attr("Dn"))
pair.add_child(obj)
config_map.add_child(pair)
elif in_mo != None and isinstance(in_mo, list) and len(in_mo) > 0:
for mo in in_mo:
pdn = mo.get_attr("Dn")
if pdn != None:
obj.set_attr("Dn", pdn + '/' +rn)
pair = Pair()
#pair.set_attr("Key", obj.dn)
pair.set_attr("Key", obj.get_attr("Dn"))
pair.add_child(obj.clone())
config_map.add_child(pair)
if config_map.get_child_count() == 0:
ImcUtils.write_imc_warning('[Warning]: AddManagedObject [Description]: Nothing to Add')
return None
output_molist = []
for pair in config_map.child:
in_config = ConfigConfig()
for mo in pair.child:
in_config.add_child(mo)
ccm = self.config_conf_mo(dn=pair.Key, in_config=in_config, in_hierarchical=YesOrNo.FALSE, dump_xml=dump_xml)
if ccm.error_code == 0:
molist = []
for child in ccm.OutConfig.child:
if isinstance(child, Pair) == True:
for mo in child.child:
molist.append(mo)
elif isinstance(child, ManagedObject) == True:
molist.append(child)
output_molist.extend(molist)
else:
raise ImcException(ccm.error_code, ccm.error_descr)
return output_molist
def compare_imc_managedobject(reference_object, difference_object, exclude_different=YesOrNo.FALSE, include_equal=YesOrNo.FALSE, no_version_filter=YesOrNo.FALSE, include_operational=YesOrNo.FALSE, xlate_map=None):
"""
Compares managed objects.
- reference_object specifies objects used as a reference for comparison.
- difference_object specifies objects that are compared to the reference objects.
- exclude_different, if set as True then displays only the properties of compared objects that are equal.
- include_equal, set as True to display properties of compared objects that are equal. By default, only properties that differ between the
reference and difference objects are displayed.
- no_version_filter, set as True to ignore minimum version in properties.
- include_operational, set as True to include operational properties.
- xlate_map specifies translation map with DNs of entities that needs to be translated.
"""
from ImcUtilityCore import _ImcMoDiff, _compare, _CompareStatus, _translate_imc_managedobject
reference_dict = {}
difference_dict = {}
if reference_object != None and isinstance(reference_object, list) and len(reference_object) > 0:
for mo in reference_object:
if mo == None:
continue
mo_meta = CoreUtils.is_property_in_meta_ignore_case(mo.prop_mo_meta.name, "Meta")
if mo_meta != None:
if mo_meta.io == MoMeta.ACCESS_TYPE_OUTPUTONLY:
ImcUtils.write_imc_warning('[Warning]: Ignoring [%s]. Non-configurable class [%s]' %(mo.Dn, mo.prop_mo_meta.name))
continue
if mo_meta.io == MoMeta.ACCESS_TYPE_IO and len(mo_meta.access) == 1 and mo_meta.access[0] == "read-only":
ImcUtils.write_imc_warning('[Warning]: Ignoring read-only MO [%s]. Class [%s]' %(mo.Dn, mo.prop_mo_meta.name))
continue
reference_dict[mo.Dn] = mo
if difference_object != None and isinstance(difference_object, list) and len(difference_object) > 0:
for mo in difference_object:
if mo == None:
continue
mo_meta = CoreUtils.is_property_in_meta_ignore_case(mo.prop_mo_meta.name, "Meta")
if mo_meta != None:
if mo_meta.access == MoMeta.ACCESS_TYPE_OUTPUTONLY:
ImcUtils.write_imc_warning('[Warning]: Ignoring [%s]. Non-configurable class [%s]' %(mo.Dn, mo.prop_mo_meta.name))
continue
if mo_meta.access == MoMeta.ACCESS_TYPE_IO and len(mo_meta.access) == 1 and mo_meta.access[0] == "read-only":
ImcUtils.write_imc_warning('[Warning]: Ignoring read-only MO [%s]. Class [%s]' %(mo.Dn, mo.prop_mo_meta.name))
continue
if xlate_map in ImcUtils.AFFIRMATIVE_LIST:
translated_mo = _translate_imc_managedobject(mo, xlate_map)
difference_dict[translated_mo.Dn] = translated_mo
else:
difference_dict[mo.Dn] = mo
dn_list = []
for key in reference_dict:
dn_list.append(key)
for key in difference_dict:
if key not in reference_dict:
dn_list.append(key)
dn_list = sorted(dn_list)
diff_output = []
for dn in dn_list:
if dn not in difference_dict:
if exclude_different not in ImcUtils.AFFIRMATIVE_LIST:
mo_diff = _ImcMoDiff(reference_dict[dn], _ImcMoDiff.REMOVE)
diff_output.append(mo_diff)
elif dn not in reference_dict:
if exclude_different not in ImcUtils.AFFIRMATIVE_LIST:
mo_diff = _ImcMoDiff(difference_dict[dn], _ImcMoDiff.ADD_MODIFY)
diff_output.append(mo_diff)
else:
diff_props = []
option = WriteXmlOption.ALL_CONFIG
if include_operational in ImcUtils.AFFIRMATIVE_LIST:
option = WriteXmlOption.ALL
gmo_reference = GenericMO(reference_dict[dn], option)
gmo_difference = GenericMO(difference_dict[dn], option)
if not no_version_filter:
handle = gmo_reference.get_handle()
if handle != None and handle.version != None:
gmo_reference.filter_version(handle.version)
handle = gmo_difference.get_handle()
if handle != None and handle.version != None:
gmo_difference.filter_version(handle.version)
diff_status = _compare(gmo_reference, gmo_difference, diff_props)
if diff_status == _CompareStatus.EQUAL and include_equal in ImcUtils.AFFIRMATIVE_LIST:
mo_diff = _ImcMoDiff(reference_dict[dn], _ImcMoDiff.EQUAL)
diff_output.append(mo_diff)
elif diff_status == _CompareStatus.TYPES_DIFFERENT and exclude_different not in ImcUtils.AFFIRMATIVE_LIST:
mo_diff = _ImcMoDiff(reference_dict[dn], _ImcMoDiff.REMOVE)
diff_output.append(mo_diff)
mo_diff = _ImcMoDiff(reference_dict[dn], _ImcMoDiff.ADD_MODIFY)
diff_output.append(mo_diff)
elif diff_status == _CompareStatus.PROPS_DIFFERENT and exclude_different not in ImcUtils.AFFIRMATIVE_LIST:
ref_values = {}
diff_values = {}
for prop in diff_props:
ref_values[prop] = gmo_reference.get_attr(prop)
diff_values[prop] = gmo_difference.get_attr(prop)
mo_diff = _ImcMoDiff(difference_dict[dn], _ImcMoDiff.ADD_MODIFY, diff_props, ref_values, diff_values)
diff_output.append(mo_diff)
return diff_output
def sync_imc_managedobject(handle, difference, delete_not_present=False, no_version_filter=True, dump_xml=None):
"""
Syncs Managed Object.
Method takes the difference object (output of compare_imc_managedobject) and applies the differences
on reference Managed Object.
- difference specifies the Difference object (output of compare_imc_managedobject) which has
differences of the properties of two or more Managed Objects.
- delete_not_present, if set as True, any missing MOs in reference Managed Object set will be deleted.
- no_version_filter, If set as True, minversion for Mos or properties to be added in reference
Managed Object will not be checked.
"""
from ImcUtilityCore import _ImcMoDiff
if difference == None or (isinstance(difference, list) and len(difference) == 0):
raise ImcValidationException("[Error]: sync_imc_managedobject: Difference Object can not be Null")
config_map = ConfigMap()
for mo_diff in difference:
mo = mo_diff.input_object
class_id = mo.class_id
gmo_diff = None
meta_class_id = CoreUtils.find_class_id_in_mo_meta_ignore_case(class_id)
if meta_class_id == None:
ImcUtils.write_imc_warning("Ignoring [%s]. Unknown ClassId [%s]." %(mo_diff.input_object.get_attr("dn"), class_id))
continue
#Removes Difference Object.
if mo_diff.side_indicator == _ImcMoDiff.REMOVE and delete_not_present:
gmo_diff = ManagedObject(class_id)
gmo_diff.set_attr("dn", mo.get_attr("dn"))
gmo_diff.set_attr("Status", Status().DELETED)
gmo_diff = GenericMO(gmo_diff, WriteXmlOption.ALL_CONFIG)#gmo_diff should be generic object
if mo_diff.side_indicator == _ImcMoDiff.ADD_MODIFY:
gmo_diff = ManagedObject(class_id)
add_exists = False
mo_meta = CoreUtils.is_property_in_meta_ignore_case(class_id, "Meta")
if mo_meta != None and 'Add' in mo_meta.verbs:
add_exists = True
#Add Difference Object.
if add_exists and (mo_diff.diff_property == None or len(mo_diff.diff_property) == 0):
for prop in mo.__dict__:
prop_mo_meta = CoreUtils.is_property_in_meta_ignore_case(class_id, prop)
if prop_mo_meta != None:
if prop.lower() == "rn" or prop.lower() == "dn" or prop_mo_meta.access == MoPropertyMeta.READ_ONLY:
continue
gmo_diff.set_attr(prop_mo_meta.name, mo.get_attr(prop))
gmo_diff.set_attr("Dn", mo.get_attr("Dn"))
gmo_diff.set_attr("Status", Status().CREATED)
gmo_diff = GenericMO(gmo_diff, WriteXmlOption.ALL_CONFIG)#gmo_diff should be generic object
if not no_version_filter:
h_reference = mo.get_handle()
if h_reference != None and h_reference.version != None:
gmo_diff.filter_version(h_reference.version)
#Modify the Managed Object
else:
if mo_diff.diff_property == None or len(mo_diff.diff_property) == 0:
ImcUtils.write_imc_warning('Add not supported for class_id ' + class_id +'. Reverting to modify.')
continue
final_diff_props = mo_diff.diff_property
gmo_diff = ManagedObject(class_id)
for prop in final_diff_props:
prop_mo_meta = CoreUtils.is_property_in_meta_ignore_case(class_id, prop)
if prop_mo_meta != None:
#if (prop.lower() == "rn" or prop.lower() == "dn" or prop_mo_meta.access == MoPropertyMeta.ReadOnly):
if prop.lower() == "rn" or prop.lower() == "dn":
continue
gmo_diff.set_attr(prop_mo_meta.name, mo.get_attr(prop))
gmo_diff.set_attr("Dn", mo.get_attr("Dn"))
gmo_diff.set_attr("Status", Status().MODIFIED)
gmo_diff = GenericMO(gmo_diff, WriteXmlOption.ALL_CONFIG)#gmo_diff should be generic object to apply filter_version on it.
#TODO: NoversionFilter functionality discussion.
if gmo_diff != None and not no_version_filter:
gmo_meta = CoreUtils.get_mo_property_meta(gmo_diff.class_id, "Meta")
if gmo_meta != None and handle.version != None:
if handle.version < gmo_meta.version:
ImcUtils.write_imc_warning('Ignoring unsupported class_id %s for dn %s.' %(gmo_diff.class_id, gmo_diff.get_attr("dn")))
gmo_diff = None
if gmo_diff != None and handle.version != None:
gmo_diff.filter_version(h_reference.version)
if gmo_diff.__dict__.has_key("_exclude_prop_list"):
for prop in gmo_diff.excludePropList:
if prop == "Xtra_property":
gmo_diff.__dict__[prop] = {}
continue
gmo_diff.__dict__[prop] = None
if gmo_diff != None:
pair = Pair()
pair.set_attr("Key", gmo_diff.get_attr("Dn"))
pair.add_child(gmo_diff)
config_map.add_child(pair)
if config_map.get_child_count() == 0:
return None
output_molist = []
for pair in config_map.child:
in_config = ConfigConfig()
for mo in pair.child:
in_config.add_child(mo)
ccm = handle.config_conf_mo(dn=pair.Key, in_config=in_config, in_hierarchical=YesOrNo.FALSE, dump_xml=dump_xml)
if ccm.error_code == 0:
molist = []
for child in ccm.OutConfig.child:
if isinstance(child, Pair) == True:
for mo in child.child:
molist.append(mo)
elif isinstance(child, ManagedObject) == True:
molist.append(child)
output_molist.extend(molist)
else:
raise ImcException(ccm.error_code, ccm.error_descr)
return output_molist
def get_imc_techsupport(handle, remotehost, remotefile, protocol, username, password, timeout_sec=ImcConstant.TIME_OUT_IN_SEC, dump_xml=None):
"""
Creates and downloads the technical support data of IMC server.
- remotehost specifies the host where username need to download the technical support data.
- remotefile specifies the path on remotehost where username need to download the technical support data.
- protocol specifies the protocol used for transferring the file to remotehost.
- username specifies the username credential to login to remotehost.
- password specifies the password credential to login to remotehost.
- timeout_sec specifies the time in seconds for which method waits for the technical support data file
to generate else exit.Default is 600 Seconds.
"""
from ImcMos import MgmtImporter
if timeout_sec == None or timeout_sec == "" or timeout_sec < 1:
timeout_sec = ImcConstant.TIME_OUT_IN_SEC
ImcUtils.write_imc_warning('[Warning]: Inappropriate <timeoutsec>. Chosen default value is 600 Seconds')
#dn = "sys/rack-unit-1/tech-support"
dn = CoreUtils.make_dn([CoreUtils.make_rn(NamingId.TOP_SYSTEM), CoreUtils.make_rn(NamingId.COMPUTE_RACK_UNIT, ServerId="1"), CoreUtils.make_rn(NamingId.SYSDEBUG_TECH_SUPPORT_EXPORT)])
sysdebug_techsupport = ManagedObject(NamingId.SYSDEBUG_TECH_SUPPORT_EXPORT)
sysdebug_techsupport.DN = dn
sysdebug_techsupport.AdminState = MgmtImporter.CONST_ADMIN_STATE_ENABLED
sysdebug_techsupport.RemoteFile = remotefile
sysdebug_techsupport.Protocol = protocol
sysdebug_techsupport.Status = Status.MODIFIED
sysdebug_techsupport.Hostname = remotehost
sysdebug_techsupport.User = username
sysdebug_techsupport.Pwd = password
in_config = ConfigConfig()
in_config.add_child(sysdebug_techsupport)
ccm = handle.config_conf_mo(dn=dn, in_config=in_config, in_hierarchical=YesOrNo.FALSE, dump_xml=dump_xml)
time.sleep(10) #Wait for 10 seconds before start checking.
#TODO: CHECK THE FIELD fsmStageDescr
duration = timeout_sec
poll_interval = ImcConstant.POLL_INTERVAL_IN_SEC
crd = None
if ccm.error_code == 0:
ImcUtils.write_imc_warning('Waiting for the Tech Support file to become available (this may take several minutes).')
status = False
while True:
crd = handle.config_resolve_dn(dn, in_hierarchical=YesOrNo.FALSE, dump_xml=dump_xml)
if crd.error_code == 0:
if crd.OutConfig.get_child_count() > 0:
for tech_support in crd.OutConfig.child:
if tech_support.AdminState == MgmtImporter.CONST_ADMIN_STATE_DISABLED: #TODO: replace the hard-coded string after schema change
if tech_support.FsmStatus == "success":
status = True
else:
raise ImcValidationException('Failed to create the TechSupport file.' + tech_support.FsmStatus)
else:
raise ImcValidationException('Failed to create the TechSupport file.')
else:
raise ImcException(crd.error_code, crd.error_descr)
if status:
break
time.sleep(min(duration, poll_interval))
duration = max(0, (duration-poll_interval))
if duration == 0:
raise ImcValidationException('TechSupport generation in progress but get_imc_techsupport process timed out. Exiting Method get_imc_techsupport')
else:
raise ImcException(ccm.error_code, ccm.error_descr)
return crd.OutConfig.child
def backup_imc(handle, remotehost, remotefile, protocol, username, password, passphrase=None, timeout_sec=ImcConstant.TIME_OUT_IN_SEC, dump_xml=None):
"""
Creates and downloads the backup of IMC.
- remotehost specifies the host where username need to download the backup.
- remotefile specifies the path on remotehost where username need to download the backup.
- protocol specifies the protocol used for transferring the file to remotehost.
- username specifies the username credential to login to remotehost.
- password specifies the password credential to login to remotehost.
- timeout_sec specifies the time in seconds for which method waits for the backUp file
to generate else exit. Default is 600 Seconds.
"""
from ImcMos import MgmtBackup
if timeout_sec == None or timeout_sec == "" or timeout_sec < 1:
timeout_sec = ImcConstant.TIME_OUT_IN_SEC
ImcUtils.write_imc_warning('[Warning]: Inappropriate <timeoutsec>. Chosen default value is 600 Seconds')
#dn = "sys/export-config"
#dn = ImcUtils.make_dn([ManagedObject(NamingId.TOP_SYSTEM).make_rn(),ManagedObject(NamingId.MGMT_BACKUP).make_rn()])
dn = CoreUtils.make_dn([CoreUtils.make_rn(NamingId.TOP_SYSTEM), CoreUtils.make_rn(NamingId.MGMT_BACKUP)])
mgmt_backup = ManagedObject(NamingId.MGMT_BACKUP)
mgmt_backup.Hostname = remotehost
mgmt_backup.User = username
mgmt_backup.Pwd = password
mgmt_backup.Proto = protocol
mgmt_backup.RemoteFile = remotefile
mgmt_backup.dn = dn
mgmt_backup.AdminState = MgmtBackup.CONST_ADMIN_STATE_ENABLED
mgmt_backup.Status = Status.MODIFIED
mgmt_backup.Passphrase = passphrase
in_config = ConfigConfig()
in_config.add_child(mgmt_backup)
response = handle.config_conf_mo(dn, in_config=in_config, in_hierarchical=YesOrNo.FALSE, dump_xml=dump_xml)
if response.error_code != 0:
raise ImcException(response.error_code, response.error_descr)
#raise Exception('[Error]: backup_imc [Code]:' + ccm.error_code + ' [Description]:' + ccm.error_descr)
time.sleep(10) #Wait for 10 seconds before start checking.
duration = timeout_sec
poll_interval = ImcConstant.POLL_INTERVAL_IN_SEC
cr_dn = None
status = False
while True:
cr_dn = handle.config_resolve_dn(dn, in_hierarchical=YesOrNo.FALSE, dump_xml=dump_xml)
if cr_dn.error_code == 0:
for each_mgmt_dn in cr_dn.OutConfig.child:
if each_mgmt_dn.AdminState == MgmtBackup.CONST_ADMIN_STATE_DISABLED:
if each_mgmt_dn.FsmStageDescr == "Completed successfully":
status = True
if each_mgmt_dn.FsmStageDescr == "Error":
raise ImcValidationException("Failed to export the CIMC configuration file." + "Error Code: " + each_mgmt_dn.FsmRmtInvErrCode + " Error Description: " + each_mgmt_dn.FsmRmtInvErrDescr)
else:
raise ImcException(cr_dn.error_code, cr_dn.error_descr)
if status:
break
time.sleep(min(duration, poll_interval))
duration = max(0, (duration-poll_interval))
if duration == 0:
raise ImcValidationException('Backup operation in progress but utility backup_imc timed out. Exiting Method backup_imc')
return cr_dn.OutConfig.child
def import_imc_session(file_path, key):
"""
This operation will do a login to each IMC which is present in credential file.
- file_path specifies the path of the credential file.
- key specifies string used for secure encryption while export_imc_session operation.
"""
from ImcUtilityCore import _ImcLoginXml
if file_path is None:
raise ImcValidationException('[Error]: Please provide file_path')
if key is None:
raise ImcValidationException('[Error]: Please provide key')
if not os.path.isfile(file_path) or not os.path.exists(file_path):
raise ImcValidationException('[Error]: File <%s> does not exist ' %(file_path))
doc = xml.dom.minidom.parse(file_path)
top_node = doc.documentElement
#print top_node.localName
if top_node is None or top_node.localName != _ImcLoginXml.IMC_HANDLES:
return None
if top_node.hasChildNodes():
child_list = top_node.childNodes
child_count = len(child_list)
for count in range(child_count):
child_node = child_list.item(count)
if child_node.nodeType != Node.ELEMENT_NODE:
continue
if child_node.localName != _ImcLoginXml.IMC:
continue
lname = None
lusername = None
lpassword = None
lnossl = False
lport = None
if child_node.hasAttribute(_ImcLoginXml.NAME):
lname = child_node.getAttribute(_ImcLoginXml.NAME)
if child_node.hasAttribute(_ImcLoginXml.USER_NAME):
lusername = child_node.getAttribute(_ImcLoginXml.USER_NAME)
if child_node.hasAttribute(_ImcLoginXml.PASSWORD):
#lpassword = p3_decrypt(child_node.getAttribute(_ImcLoginXml.PASSWORD), key)
lpassword = ImcUtils.decrypt_password(child_node.getAttribute(_ImcLoginXml.PASSWORD), key)
if child_node.hasAttribute(_ImcLoginXml.NO_SSL):
lnossl = child_node.getAttribute(_ImcLoginXml.NO_SSL)
if child_node.hasAttribute(_ImcLoginXml.PORT):
lport = child_node.getAttribute(_ImcLoginXml.PORT)
# Process login
if lname is None or lusername == None or lpassword == None:
ImcUtils.write_imc_warning("[Warning] Insufficient information for login ...")
continue
try:
handle = ImcHandle()
handle.login(name=lname, username=lusername, password=lpassword, nossl=lnossl, port=lport)
except Exception, err:
ImcUtils.write_imc_warning("[Connection Error<%s>] %s" %(lname, str(err)))