def template_values(ext_name, template_name, template_id):
if show_args.workdir is None:
# Load from vManage via API
devices_attached = DeviceTemplateAttached.get(api, template_id)
if devices_attached is None:
cls.log_error('Failed to retrieve %s attached devices',
template_name)
return None
try:
uuid_list = [uuid for uuid, _ in devices_attached]
values = DeviceTemplateValues(
api.post(
DeviceTemplateValues.api_params(
template_id, uuid_list),
DeviceTemplateValues.api_path.post))
except RestAPIException:
cls.log_error('Failed to retrieve %s values',
template_name)
return None
else:
# Load from local backup
values = DeviceTemplateValues.load(show_args.workdir, ext_name,
template_name, template_id)
if values is None:
cls.log_debug('Skipped %s. No template values file found.',
template_name)
return values
def runner(cls, api, parsed_args):
cls.log_info('Starting backup: vManage URL: "%s" > Local workdir: "%s"', api.base_url, parsed_args.workdir)
# Backup workdir must be empty for a new backup
saved_workdir = cls.clean_workdir(parsed_args.workdir)
if saved_workdir:
cls.log_info('Previous backup under "%s" was saved as "%s"', parsed_args.workdir, saved_workdir)
target_info = ServerInfo(server_version=api.server_version)
if target_info.save(parsed_args.workdir):
cls.log_info('Saved vManage server information')
if CATALOG_TAG_ALL in parsed_args.tags:
# Items without index files to be included with tag 'all'
edge_certs = EdgeCertificate.get(api)
if edge_certs is None:
cls.log_error('Failed backup WAN edge certificates')
elif edge_certs.save(parsed_args.workdir):
cls.log_info('Saved WAN edge certificates')
for _, info, index_cls, item_cls in catalog_entries(*parsed_args.tags):
item_index = index_cls.get(api)
if item_index is None:
cls.log_debug('Skipped %s, item not supported by this vManage', info)
continue
if item_index.save(parsed_args.workdir):
cls.log_info('Saved %s index', info)
matched_item_iter = (
(item_id, item_name) for item_id, item_name in item_index
if parsed_args.regex is None or regex_search(parsed_args.regex, item_name)
)
for item_id, item_name in matched_item_iter:
item = item_cls.get(api, item_id)
if item is None:
cls.log_error('Failed backup %s %s', info, item_name)
continue
if item.save(parsed_args.workdir, item_index.need_extended_name, item_name, item_id):
cls.log_info('Done %s %s', info, item_name)
# Special case for DeviceTemplateAttached and DeviceTemplateValues
if isinstance(item, DeviceTemplate):
devices_attached = DeviceTemplateAttached.get(api, item_id)
if devices_attached is None:
cls.log_error('Failed backup %s %s attached devices', info, item_name)
continue
if devices_attached.save(parsed_args.workdir, item_index.need_extended_name, item_name, item_id):
cls.log_info('Done %s %s attached devices', info, item_name)
else:
cls.log_debug('Skipped %s %s attached devices, none found', info, item_name)
continue
try:
uuid_list = [uuid for uuid, _ in devices_attached]
values = DeviceTemplateValues(api.post(DeviceTemplateValues.api_params(item_id, uuid_list),
DeviceTemplateValues.api_path.post))
if values.save(parsed_args.workdir, item_index.need_extended_name, item_name, item_id):
cls.log_info('Done %s %s values', info, item_name)
except RestAPIException as ex:
cls.log_error('Failed backup %s %s values: %s', info, item_name, ex)
def get_template_input(template_id):
uuid_list = [
uuid for uuid, _ in DeviceTemplateAttached.get_raise(
api, template_id)
]
values = DeviceTemplateValues(
api.post(
DeviceTemplateValues.api_params(template_id, uuid_list),
DeviceTemplateValues.api_path.post))
return values.input_list()
def load_template_input(template_name, saved_id, target_id):
if target_id is None:
cls.log_debug('Skip %s, saved template is not on target node', template_name)
return None
saved_values = DeviceTemplateValues.load(workdir, ext_name, template_name, saved_id)
if saved_values is None:
cls.log_error('DeviceTemplateValues file not found: %s, %s', template_name, saved_id)
return None
if saved_values.is_empty:
cls.log_debug('Skip %s, saved template has no attachments', template_name)
return None
target_attached_uuid_set = {uuid for uuid, _ in DeviceTemplateAttached.get_raise(api, target_id)}
if target_uuid_set is None:
allowed_uuid_set = target_attached_uuid_set
else:
saved_attached = DeviceTemplateAttached.load(workdir, ext_name, template_name, saved_id)
if saved_attached is None:
cls.log_error('DeviceTemplateAttached file not found: %s, %s', template_name, saved_id)
return None
saved_attached_uuid_set = {uuid for uuid, _ in saved_attached}
allowed_uuid_set = target_uuid_set & saved_attached_uuid_set - target_attached_uuid_set
input_list = saved_values.input_list(allowed_uuid_set)
if len(input_list) == 0:
cls.log_debug('Skip %s, no devices to attach', template_name)
return None
return input_list
def runner(self, parsed_args, api, task_output=None):
self.log_info('Starting backup: vManage URL: "%s" -> Local workdir: "%s"', api.base_url, parsed_args.workdir)
# Backup workdir must be empty for a new backup
saved_workdir = clean_dir(parsed_args.workdir, max_saved=0 if parsed_args.no_rollover else 99)
if saved_workdir:
self.log_info('Previous backup under "%s" was saved as "%s"', parsed_args.workdir, saved_workdir)
target_info = ServerInfo(server_version=api.server_version)
if target_info.save(parsed_args.workdir):
self.log_info('Saved vManage server information')
# Backup items not registered to the catalog, but to be included when tag is 'all'
if CATALOG_TAG_ALL in parsed_args.tags:
edge_certs = EdgeCertificate.get(api)
if edge_certs is None:
self.log_error('Failed backup WAN edge certificates')
elif edge_certs.save(parsed_args.workdir):
self.log_info('Saved WAN edge certificates')
for inventory, info in ((EdgeInventory.get(api), 'WAN edge'), (ControlInventory.get(api), 'controller')):
if inventory is None:
self.log_error('Failed retrieving %s inventory', info)
continue
for uuid, _, hostname, _ in inventory.extended_iter():
if hostname is None:
self.log_debug('Skipping %s, no hostname', uuid)
continue
for item, config_type in ((DeviceConfig.get(api, DeviceConfig.api_params(uuid)), 'CFS'),
(DeviceConfigRFS.get(api, DeviceConfigRFS.api_params(uuid)), 'RFS')):
if item is None:
self.log_error('Failed backup %s device configuration %s', config_type, hostname)
continue
if item.save(parsed_args.workdir, item_name=hostname, item_id=uuid):
self.log_info('Done %s device configuration %s', config_type, hostname)
# Backup items registered to the catalog
for _, info, index_cls, item_cls in catalog_iter(*parsed_args.tags, version=api.server_version):
item_index = index_cls.get(api)
if item_index is None:
self.log_debug('Skipped %s, item not supported by this vManage', info)
continue
if item_index.save(parsed_args.workdir):
self.log_info('Saved %s index', info)
matched_item_iter = (
(item_id, item_name) for item_id, item_name in item_index
if parsed_args.regex is None or regex_search(parsed_args.regex, item_name)
)
for item_id, item_name in matched_item_iter:
item = item_cls.get(api, item_id)
if item is None:
self.log_error('Failed backup %s %s', info, item_name)
continue
if item.save(parsed_args.workdir, item_index.need_extended_name, item_name, item_id):
self.log_info('Done %s %s', info, item_name)
# Special case for DeviceTemplateAttached and DeviceTemplateValues
if isinstance(item, DeviceTemplate):
devices_attached = DeviceTemplateAttached.get(api, item_id)
if devices_attached is None:
self.log_error('Failed backup %s %s attached devices', info, item_name)
continue
if devices_attached.save(parsed_args.workdir, item_index.need_extended_name, item_name, item_id):
self.log_info('Done %s %s attached devices', info, item_name)
else:
self.log_debug('Skipped %s %s attached devices, none found', info, item_name)
continue
try:
uuid_list = [uuid for uuid, _ in devices_attached]
values = DeviceTemplateValues(api.post(DeviceTemplateValues.api_params(item_id, uuid_list),
DeviceTemplateValues.api_path.post))
if values.save(parsed_args.workdir, item_index.need_extended_name, item_name, item_id):
self.log_info('Done %s %s values', info, item_name)
except RestAPIException as ex:
self.log_error('Failed backup %s %s values: %s', info, item_name, ex)