def import_imc_backup(handle, remotehost, remotefile, protocol, username, password, passphrase=None, dump_xml=None):
"""
Imports backUp.
This operation will upload the IMC backup taken earlier via GUI or backup_imc operation.
User can perform an import while the system is up and running.
- 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.
"""
from ImcMos import MgmtImporter
dn = CoreUtils.make_dn([CoreUtils.make_rn(NamingId.TOP_SYSTEM), CoreUtils.make_rn(NamingId.MGMT_IMPORTER)])
mgmt_importer = ManagedObject(NamingId.MGMT_IMPORTER)
mgmt_importer.dn = dn
mgmt_importer.AdminState = MgmtImporter.CONST_ADMIN_STATE_ENABLED
mgmt_importer.Hostname = remotehost
mgmt_importer.User = username
mgmt_importer.Pwd = password
mgmt_importer.RemoteFile = remotefile
mgmt_importer.Proto = protocol
mgmt_importer.AdminState = MgmtImporter.CONST_ADMIN_STATE_ENABLED
mgmt_importer.Status = Status.MODIFIED
mgmt_importer.Passphrase = passphrase
in_config = ConfigConfig()
in_config.add_child(mgmt_importer)
ccm = handle.config_conf_mo(dn=dn, in_config=in_config, in_hierarchical=YesOrNo.FALSE, dump_xml=dump_xml)
if ccm.error_code != 0:
raise ImcException(ccm.error_code, ccm.error_descr)
time.sleep(10) #Wait for 10 seconds before start checking.
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:
if cr_dn.OutConfig.get_child_count() > 0:
for cimc_backup in cr_dn.OutConfig.child:
if cimc_backup.AdminState == MgmtImporter.CONST_ADMIN_STATE_DISABLED:
if cimc_backup.FsmStageDescr == "Completed successfully":
status = True
if cimc_backup.FsmStageDescr == "Error":
raise ImcValidationException("Failed to import the CIMC configuration file." + "Error Code: " + cimc_backup.FsmRmtInvErrCode + " Error Description: " + cimc_backup.FsmRmtInvErrDescr)
else:
raise ImcValidationException("Failed to import the CIMC configuration file.")
else:
raise ImcException(cr_dn.error_code, cr_dn.error_descr)
if status:
break
return ccm.OutConfig.child
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
