XML de GRLoader

Este artículo contiene los siguientes temas:
casm173
Este artículo contiene los siguientes temas:
GRLoader requiere la entrada de documentos XML, que consisten en un encabezado de documento seguido por etiquetas de elementos XML <GRLoader> de cierre con una o más etiquetas <ci> (para definiciones de elementos de configuración) o <relation> (para relaciones).
Especifique el encabezamiento de documentos XML de la siguiente manera:
<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
El atributo de codificación se debe actualizar según corresponda para gestionar los requisitos de codificación de caracteres adecuados. Por ejemplo, especifique “ISO-8859-1” para gestionar los caracteres especiales en Noruego.
Ejemplo: formateo de un archivo XML de GRLoader
En la plantilla siguiente se muestra el formato de un archivo XML de GRLoader:
<?xml version="1.0" encoding="UTF-8" standalone="yes" ?> <GRLoader> <ci> [define a CI: common and family-specific attributes, versioning, reconciliation, MDR] </ci> [repeat as necessary for each CI] <relation> <type>relationship_type</type> <delete_flag>active_state</delete_flag> <provider> <name>resource name</name> <serial_number>serial number</serial_number> <system_name>host name</system_name> <asset_num>resource tag</asset_num> <mac_address>mac address</mac_address> <dns_name>dns name</dns_name> <id>ci_uuid</id> </provider> <dependent> <name>resource name</name> <serial_number>serial number</serial_number> <system_name>host name</system_name> <asset_num>resource tag</asset_num> <mac_address>mac address</mac_address> <dns_name>dns name</dns_name> <id>ci_uuid</id> </dependent> </relation> [repeat as necessary for each relationship] </GRLoader>
Contenido del archivo XML: Etiqueta de elemento de configuración
GRLoader utiliza la definición XML CI para cargar los valores y relaciones de atributo de un elemento de configuración. La definición del elemento de configuración debe incluir un mínimo de atributos necesarios para crear o actualizar mediante etiquetas de elemento XML
.
Se define el XML de un elemento de configuración especificando valores para los siguientes atributos:
  • Identificación de clase (obligatorio)
  • Atributos de reconciliación (obligatorio)
  • Atributos comunes
  • Atributos específicos de la familia
  • Atributos de identificación MDR
  • Atributos de versión
Indentificación de la clase y la familia de la etiqueta de elemento de configuración
La identificación de la clase se debe especificar para cada elemento de configuración para así asociar la familia y clase correcta con el elemento de configuración.
Especifique los atributos de familia y clase con las siguientes etiquetas XML:
  • <family>
    (Opcional) Especifica un conjunto de elementos de configuración con atributos similares.
  • <class>
    (Obligatorio) Especifica un subconjunto de elementos de configuración dentro de una familia.
Si GRLoader no encuentra la familia ni la clase, el elemento de configuración no se creará ni se actualizará.
Ejemplo: identificación de un elemento de configuración por la familia y la clase
El siguiente ejemplo muestra un elemento de configuración denominado ServerCI que se identifica con la familia
Hardware.Server y la clase
Windows.
<ci> <name>ServerCI</name> <family>Hardware.Server</family> <class>Windows</class> ... </ci>
Atributos de conciliación de la etiqueta de elemento de configuración (requeridos)
Es necesario introducir uno o varios atributos de reconciliación al crear, actualizar o hacer referencia a un elemento de configuración. GRLoader utiliza estos atributos para identificar de forma exclusiva el elemento de configuración creado o actualizado. Los atributos de reconciliación también se utilizan para identificar una relación de proveedor/dependiente entre dos elementos de configuración.
Especifique los atributos de reconciliación con las siguientes etiquetas de elemento XML:
  • : Nombre del elemento de configuración o recurso (necesario al crear el elemento de configuración por primera vez)
  • : Identificador único del fabricante
  • : Identificador de recurso alternativo (por ejemplo, el ID alternativo indicado en una etiqueta pegada en el equipo)
  • : Nombre del equipo (solo hardware)
  • ombre por el que se conoce este dispositivo en el servidor de nombres de dominio
  • : Dirección MAC (sólo hardware)
  • : UUID del elemento de configuración utilizado para las actualizaciones directas cuando se conoce el ID
El atributo de nombre es necesario al crear un elemento de configuración por primera vez. Si GRLoader no puede resolver los atributos de reconciliación especificados, no se actualizará un elemento de configuración existente. Los atributos de reconciliación son atributos comunes para fines especiales que se utilizan para identificación.
Ejemplo: identificación de un elemento de configuración al crearlo o actualizarlo
En el ejemplo siguiente, en la definición del elemento de configuración se utiliza name, serial_number, dns_name, mac_address y system_name para identificar de forma exclusiva el elemento de configuración al crearlo o actualizarlo.
<ci> <name>ServerCI</name> <serial_number>HMVV081</serial_number> <dns_name>serverci.myco.com</dns_name> <mac_address>00:12:3F:48:F0:95</mac_address> <system_name>ServerCI</system_name> ... </ci>
Atributos comunes de la etiqueta de elemento de configuración
En general, los atributos comunes son atributos que se pueden utilizar en cualquier familia o clase de CMDB. La etiqueta de elemento XML utilizada para el atributo es la misma que el nombre de objeto de atributo. El valor de atributo depende del tipo. Este puede ser una constante o un valor SREL que indica una referencia de clave externa a otra tabla.
Ejemplo: especificación de atributos comunes
En el ejemplo siguiente, la definición de elemento de configuración de nombre ServerCI especifica los siguientes atributos comunes: manufacturer, model y alarm_id (dirección IP). El nombre ServerCI es también un atributo común.
<ci> <name>ServerCI</name> ... <manufacturer>Dell Inc.</manufacturer> <model>OptiPlex GX280</model> <alarm_id>130.200.19.220</alarm_id> ... </ci>
Atributos específicos de familia de la etiqueta de elemento de configuración
Los atributos de clase son exclusivos de una familia o clase de elemento de configuración específicas. La etiqueta de elemento XML utilizada para el atributo de clase es la misma que el nombre de objeto de atributo encontrado en las tablas específicas de la familia/clase.
Ejemplo: especificación de atributos específicos de familia
En el ejemplo siguiente, la definición de elemento de configuración denominada ServerCI especifica los atributos específicos de la familia
Hardware.Server que incluye bios_ver, cd_rom_type, hard_drive_capacity, etc.
<ci> <name>ServerCI</name> ... <bios_ver>A04</bios_ver> <cd_rom_type>DVD+-RW DVD8701</cd_rom_type> <hard_drive_capacity>90 MB</hard_drive_capacity> <number_net_card>3</number_net_card> <number_proc_inst>1</number_proc_inst> <phys_mem>2048 MB</phys_mem> <proc_speed>2793 MHz</proc_speed> <swap_size>4959 MB</swap_size> ... </ci>
Identificador MDR de la etiqueta de elemento de configuración
Un repositorio de datos de gestión (MDR) identifica al proveedor de los datos de un elemento de configuración y cómo se asignan los elementos de configuración de nuevo al MDR correspondiente.
CA SDM utiliza información de MDR para realizar las tareas siguientes:
  • Inicio en contexto del registro de elemento de configuración directamente en el proveedor de datos de MDR.
  • Realiza un seguimiento de los cambios en los atributos de los elementos de configuración en el MDR fuente.
  • Detecta cuando más de un MDR actualiza un atributo de un elemento de configuración. Esta situación se produce cuando varios MDR proporcionan datos independientemente a una definición del elemento de configuración.
  • Identifica el MDR que actúa como la fuente autoritativa.
Para obtener más información acerca de los repositorios de datos de gestión, consulte este tema.
Utilice las siguientes etiquetas de elemento XML para especificar atributos de MDR:
  • <mdr_class>
    Especifica la clase MDR para agrupar los MDR que se procesan de forma similar en CA SDM.
  • <mdr_name>
    Especifica el nombre MDR que utiliza un MDR para hacer referencia a él mismo. Verifique que la combinación de los valores de mdr_name y mdr_class sea exclusiva dentro de la empresa.
  • <federated_asset_id>
    Especifica el ID del activo federado que indica el identificador exclusivo de un MDR para un elemento de configuración.
Si GRLoader no puede resolver los valores mdr_class y mdr_name de un MDR existente, GRLoader no importa el elemento de configuración. Un elemento de configuración sin asignación de federated_asset_id asociada no se federa.
Ejemplo: identificación de un elemento de configuración en el MDR
En el ejemplo siguiente, la definición de elemento de configuración de nombre ServerCI especifica mdr_class y mdr_name para identificar de forma exclusiva el MDR y el ID del activo federado, con lo que se identifica el elemento de configuración en MDR.
CA SDM utiliza el valor
Cohesion
de la cadena mdr_class al federar datos desde el producto (asignar el valor de acm del libro).
<ci> <name>ServerCI</name> ... <federated_asset_id>1001118</federated_asset_id> <mdr_class>Cohesion</mdr_class> <mdr_name>CohesionServer</mdr_name> ... </ci>
Atributos de versión de la etiqueta de elemento de configuración
GRLoader se puede utilizar para establecer los atributos de versión para un elemento de configuración.
Para obtener más información sobre el control de versiones, consulte la sección Control de versiones.
Especifique los atributos de versión con las siguientes etiquetas de elemento XML:
  • <milestone>
    Especifica la etiqueta asociada a ese hito que se muestra en la ficha Control de versiones.
  • <standard_ci>
    Especifica el nombre del elemento de configuración estándar que se utiliza para las comparaciones de línea de referencia en la ficha Control de versiones.
El elemento de configuración especificado para el atributo standard_ci debe existir ya en CMDB o especificarse antes de especificar la definición del elemento de configuración en el archivo XML. El hito generado registra el estado del elemento de configuración en el momento de ejecución de GRLoader.
Ejemplo: especificación de comparaciones de línea de referencia
En el ejemplo siguiente, la definición del elemento de configuración denominada ServerCI especifica el elemento de configuración estándar denominado
standard server config para comparaciones de línea de referencia con ServerCI (el elemento de configuración central). En este ejemplo se asume que el elemento de configuración estándar ya existe en CA SDM. Además, también se crea un hito llamado Cierre del ejercicio fiscal 2008 para conservar el estado del elemento de configuración en el momento en que GRLoader importa el archivo XML.
<ci> <name>ServerCI</name> <class>Server</class> <standard_ci>standard server config</standard_ci> <milestone>Fiscal year end 2008</milestone> ... </ci>
Contenido del archivo XML: Etiqueta de relación
GRLoader puede crear o actualizar relaciones entre elementos de configuración con la etiqueta <relation> de elemento XML. Las relaciones son de muchos a muchos y el tipo de relación especifica el modo en el que se relacionan entre sí dos elementos de configuración proveedor y dependiente en CMDB.
Especifique los atributos de relación con las siguientes etiquetas de elemento XML:
  • <type>
    (Opcional) Especifica el nombre del tipo de relación.
  • <delete_flag>
    Designa una relación como inactiva o activa. Especifique 1 (uno), sí o verdadero (true) para desactivar una relación. Especifique 0 (cero), no o falso (false) para volver a activar una relación. Al establecer delete_flag como verdadero se conserva intacta la relación existente pero se marca como inactiva.
  • <provider>
    (Obligatorio) Identifica el elemento de configuración proveedor de la relación, que contiene uno o varios atributos de reconciliación de elementos de configuración.
  • <dependent>
    (Obligatorio) Identifica el elemento de configuración dependiente de la relación, que contiene uno o varios atributos de reconciliación de elementos de configuración.
Si GRLoader no puede encontrar un tipo especificado, un elemento de configuración de proveedor o un elemento de configuración dependiente, la relación no se creará ni se actualizará.
Ejemplo: definición de una relación entre elementos de configuración
En el ejemplo siguiente se define una relación entre los elementos de configuración denominados ServerCI (proveedor) y
ServerCI|NetworkAdaptor-0 (dependiente). El tipo de relación es "contiene". En este ejemplo se asume que ambos elementos de configuración ya se han definido en CMDB o se han especificado antes de la definición de la relación en un archivo XML. Además, para que pueda crearse la relación deben coincidir todos los atributos de reconciliación del elemento de configuración de proveedor y dependiente.
<relation> <type>contains</type> <provider> <name>ServerCI</name> <serial_number>HMVV081</serial_number> <dns_name>serverci.myco.com</dns_name> <mac_address>00:12:3F:48:F0:95</mac_address> <system_name>ServerCi</system_name> </provider> <dependent> <name>ServerCI|NetworkAdaptor-0</name> </dependent> </relation>
Contenido del archivo XML: Valores especiales
Los atributos XML para fines especiales pueden modificar la configuración o actualización de un valor de elemento de configuración al importarse en GRLoader. Estos atributos se pueden usar para realizar operaciones especiales de procesamiento o formato al establecer el valor (por ejemplo, para dar formato a un valor de fecha o utilizar el resultado de una búsqueda).
Algunos ejemplos de valores XML especiales son:
  • búsqueda
    Especifica un elemento de configuración a través de un atributo distinto de combo_name (apellidos, nombre, inicial). Los ejemplos incluyen: userid,
  • update_if_null
    Especifica la opción update_if_null para que GRLoader distinga entre valores en blanco y valores que no se proporcionan en el archivo XML. De forma predeterminada, update_if_null está establecido en "", lo que significa que GRLoader omite los valores en blanco o inexistentes.
    Las siguientes descripciones de atributos para número de serie son equivalentes:
    <serial_number></serial_number> <serial_number/> <serial_number update_if_null="">
    Si desea eliminar el número de serie de un elemento de configuración que tiene uno, las etiquetas XML anteriores
    no
    funcionan, ya que GRLoader ignora los valores en blanco o inexistentes. En lugar de ello, debe codificar el archivo XML para el número de serie del siguiente modo:
    <serial_number update_if_null="true"></serial_number>
    Con esta sintaxis siempre se actualiza el atributo, aunque el valor esté en blanco o no exista.
  • dateformat=[utc | localtime]
    Establezca el atributo
    dateformat
    del campo de fecha en “utc” o “localtime”. Obligatorio cuando el formato de la fecha está en código de hora UNIX (UTC). Si no se establece dateformat, el valor predeterminado es “localtime".
Formatos de fecha:
CMDB admite los siguientes formatos de fecha y hora locales:
  • aaaa.mm.dd
  • aaaa.mm.dd hh:mm:ss
Si el valor no coincide con ninguno de estos formatos, el analizador intenta resolver la fecha como zona UTC. Si el formato de fecha no es UTC, CMDB utiliza la configuración de la configuración regional del sistema: para Inglés de EE.UU., el formato de 12 horas "mm/dd/aaaa" o "mm/dd/aaaa hh:mm:ss
a
", donde
a
especifica a. m. o p. m.
Contacto y otros campos de búsqueda
El objeto Contacto combina nombre, inicial y apellidos. El objeto tiene el siguiente formato:
<resource_contact>Lastname, Firstname MiddleInitial</resource_contact>
Si desea utilizar otro campo para un campo de búsqueda, puede indicar un atributo de lookup (búsqueda). Por ejemplo, si se desea buscar José M. Martínez por ID de usuario, se debe utilizar la entrada siguiente:
<resource_contact lookup="userid">doejo04</resource_contact>
Campos validados con datos de tablas existentes (SREL)
Los atributos comunes solamente aceptan un conjunto específico de valores que se debe definir en tablas relacionadas en CA CMDB. Estos atributos pueden tener también otras restricciones y excepciones como requisito previo para la asignación. Por ejemplo, el atributo de clase especificado en el archivo XML debe coincidir con uno de los nombres de clase existentes en CMDB, ya sea predeterminado o definido por el usuario. En caso contrario, no se podrá crear o actualizar el elemento de configuración. Además, para poder realizar la asignación, el valor no se puede establecer en nulo y la clase debe estar Activa.
Los siguientes campos validan los datos con datos de tablas existentes:
  • audit_userid
  • bm_rep
  • bm_status
  • class
  • company_bought_for_uuid
  • contact_1
  • contact_2
  • contact_3
  • delete_flag
  • department
  • expense_code
  • family
  • location
  • manufacturer
  • model
  • operating_system
  • org_bought_for_uuid
  • priority
  • repair_org
  • resource_contact
  • resource_owner_uuid
  • service_org
  • service_type
  • status
  • supplier
  • vendor_repair
  • vendor_restore
Entrada XML
Cuando se importan datos de un elemento de configuración, deben proporcionarse en un formato compatible, como XML o una hoja de cálculo (XLS o XLSX).
Tenga en cuenta el ejemplo de formato siguiente:
Documento XML
Notas
<?xml version="1.0" encoding="UTF-8" standalone="yes" ?> <GRLoader>
Estos encabezados son obligatorios.
<ci>
Incluir cero o más nodos <ci> para definir los elementos de configuración.
<name>value</name> <mac_address>value</mac_address> <dns_name>value</dns_name> <asset_num>value</asset_num> <serial_number>value</serial_number> <system_name>value</system_name>
Estas seis características identifican de forma exclusiva un elemento de configuración en una definición de elemento de configuración o de relación. Se debe especificar al menos una.
<class>value</class> <family>value</family> <manufacturer>value</manufacturer> <model>value</model>
Estos cuatro valores determinan la clase y la familia de un elemento de configuración. Debe especificarse (clase) o (fabricante/modelo).
<mem_capacity>value</mem_capacity> <number_net_card>value </number_net_card> <phys_mem>value</phys_mem_update> <proc_speed>value</proc_speed> <proc_type>value</proc_type> <server_type>value</server_type> </ci>
Valores específicos de familia. Al definir elementos de configuración se pueden proporcionar cero o más valores específicos de familia.
<relation> <type>relation_type</type>
Incluya cero o más nodos <relation> para definir las relaciones. Especifique el tipo de relación.
<provider> <name>value</name> <mac_address>value</mac_address> <dns_name>value</dns_name> <asset_num>value</asset_num> <serial_number>value</serial_number> </provider>
Identifique el CI proveedor con al menos un atributo.
<dependent> <name>value</name> <mac_address>value</mac_address> <dns_name>value</dns_name> <asset_num>value</asset_num> <serial_number>value</serial_number> </dependent> </relation>
Identifique el CI dependiente con al menos un atributo.
</GRLoader>
Ejemplo: entrada XML
<?xml version="1.0" encoding="UTF-8" standalone="yes" ?> <GRLoader> <ci> <name>Host1</name> <class>Server</class> </ci> <ci> <name>Host2</name> <class>Server</class> </ci> <relation> <type>connects to</type> <provider> <name>host1</name> </provider> <dependent> <name>host2</name> </dependent> </relation> </GRLoader>
Normalización de dirección MAC
En las versiones anteriores de GRLoader se normalizó la dirección MAC de elementos de configuración eliminando los delimitadores ":" y "-" de la dirección MAC. Esta normalización dio lugar a la dirección MAC: aa:bb:cc:dd:ee, que se guarda como aabbccddee.
Tenga en cuenta el siguiente comportamiento de las direcciones MAC:
  • El valor predeterminado es que no se normalicen direcciones MAC.
  • Los elementos de configuración creados sin normalización en CMDB se conciliarán con los elementos de configuración creados sin normalización en CA CMDB r11.x.
  • Las direcciones MAC no válidas se tratan como cadenas sencillas y se guardan sin modificar.
Los siguientes parámetros de GRLoader permiten activar o desactivar la normalización para MAC:
  • -mn
    Elimina los delimitadores ":" y "-" de las direcciones MAC (normalización para MAC).
  • -nomn
    No elimina los delimitadores ":" y "-" de las direcciones MAC.
    La instalación de una versión anterior de CMDB activa la normalización de la dirección MAC automáticamente. Se puede anular la normalización mediante el parámetro
    -nomn
Dado que las opciones se procesan de forma secuencial en la línea de comandos, el orden de las opciones es importante en la sintaxis.