Macros predefinidas

Las macros ofrecen la posibilidad de añadir datos de la variable (valores de configuración) a un archivo de instalación desatendida o script posterior a la instalación. Lenovo XClarity Administrator proporciona un conjunto predefinido de valores de configuración que puede utilizar.

Para inyectar macros predefinidas en un archivo de instalación desatendida o un archivo de script posterior reinstalación, use “predefinido” como prefijo para las macros predefinidas, separa los objetos mirados con un punto rodee el nombre de la macro un símbolo de número (#), por ejemplo #predefined.globalSettings.ipAssignment#.

El valor de cada macro predefinida varía según la instancia de XClarity Administrator. Por ejemplo, el campo Desplegar imágenes del SO > Valores globales > Asignación de IP le permite especificar el modo de IP. Después de que se recopila el valor de entrada de usuario durante el despliegue del SO, el valor se representa en los valores de configuración predefinidos por la macro predefinida #predefined.globalSettings.ipAssignment# y la instancia del archivo JSON de valores de configuración en el nombre de objeto ipAssignment.

La siguiente tabla enumera las macros predefinido (valores de configuración) que están disponibles en XClarity Administrator.

Nombre de macro				Tipo	Descripción
predefinido				Objeto	Información acerca de todos los valores de despliegue del SO predeterminados
	globalSettings			Objeto	Información acerca de los valores globales de despliegue del SO
		credentials		Matriz de objetos	Información acerca de las credenciales de usuario
			name	Cadena
			tipo	Cadena	Tipo de sistema operativo. Puede presentar uno de los valores siguientes. ESXi LINUX WINDOWS
		ipAssignment		Cadena	Opción de configuración de la red del host para el despliegue del sistema operativo. Puede presentar uno de los valores siguientes. dhcpv4 staticv4 staticv6
		isVLANMode		Cadena	Indica si se usa el modo VLAN. Puede presentar uno de los valores siguientes. verdadero. Se utiliza el modo VLAN. falso. No se utiliza el modo VLAN.
	hostPlatforms			Objeto	Valores de despliegue de las plataformas de host
		licenseKey		Cadena	Clave de licencia que se utilizará en Microsoft Windows o VMware ESXi. Si no cuenta con una clave de licencia, puede especificar este campo como nulo.
		networkSettings		Matriz	Información acerca de valores de red
			dns1	Cadena	Servidor de DNS preferido para el servidor de host que se usará después de desplegar el sistema operativo
			dns2	Cadena	Servidor de DNS alternativo para el servidor de host que se usará después de desplegar el sistema operativo
			puerta de enlace	Cadena	Puerta de enlace para el servidor de host que se usará después de desplegar el sistema operativo. Se utiliza cuando los valores de red están establecidos en estático en los valores de despliegue de SO global. Consejo para determinar el modo de IP, utilice GET /osdeployment/globalSettings.
			Nombre de host de	Cadena	Nombre de host para el servidor host. Si no se especifica un nombre de host, se asigna un nombre de host predeterminado.
			ipAddress	Cadena	Dirección IP para el servidor de host que se usará después de desplegar el sistema operativo. Se utiliza cuando los valores de red están establecidos en estático en los valores de despliegue de SO global.
			mtu	Larga	Unidad de transmisión máxima preferida para el host para usar después de desplegar el sistema operativo.
			prefixLength	Cadena	Longitud del prefijo de la dirección IP de host que se usará después de desplegar el sistema operativo. Se utiliza cuando los valores de red están establecidos en IPv6 estático en los valores de despliegue de SO global.
			selectedMAC	Cadena	Dirección MAC del servidor host vinculado a la dirección IP. La dirección MAC está configurada en AUTO de forma predeterminada. Esta configuración detecta automáticamente los puertos Ethernet que se pueden configurar y utilizar para el despliegue. La primera dirección MAC (puerto) que se detecta se utiliza manera predeterminada. Si se detecta la conectividad en otra dirección MAC, el host de XClarity Administrator se reinicia automáticamente para utilizar la dirección MAC recién detectada para el despliegue y selectedMAC se establecen en la dirección MAC recién detectada. El modo VLAN solo se admite para servidores que tienen direcciones MAC en su inventario. Si AUTO es la única dirección MAC disponible para un servidor, entonces no se pueden usar VLAN para desplegar sistemas operativos en ese servidor. Consejo para obtener la dirección MAC, utilice el campo de propiedad de respuesta de macaddress en GET /hostPlatforms.
			subnetCIDRNumber	Entero	Máscara de subred del servidor host que se va a utilizar después de desplegar el sistema operativo, en formato de Enrutamiento entre dominios sin clase (CIDR). Se utiliza cuando los valores de red están establecidos en estático en los valores de despliegue de SO global. El número CIDR suele estar precedido por una barra diagonal "/" y sigue la dirección IP. Por ejemplo, una dirección IP de 131.10.55.70 con una máscara de subred de 255.0.0.0 (que tiene 8 bits de red) se representa como 131.10.55.70/8. Para obtener más información, consulte el Sitio web del tutorial de la notación CIDR Consejo para determinar el modo de IP, utilice GET /osdeployment/globalSettings.
			subnetMask	Cadena	Máscara de subred del servidor host que se va a utilizar después de desplegar el sistema operativo, en notación decimal con puntos (por ejemplo, 255.0.0.0). Se utiliza cuando los valores de red están establecidos en estático en los valores de despliegue de SO global. Consejo para determinar el modo de IP, utilice GET /osdeployment/globalSettings.
			vlanId	Cadena	Identificador de VLAN para el etiquetado VLAN del sistema operativo. Este parámetro es válido solo si el modo VLAN está habilitado. Para determinar si el modo VLAN está habilitado, use GET /osdeployment/globalSettings). Importante Solo especifique un Id. de VLAN cuando se requiere una etiqueta de VLAN para que funcione en la red. El uso de etiquetas de VLAN puede afectar el enrutamiento de la red entre el sistema operativo del host y el XClarity Administrator.
		selectedImage		Cadena	Identificador de perfil de la imagen del sistema operativo que va a desplegar. Consejo para obtener los Id. de perfil de la imagen del sistema operativo, utilice la propiedad de respuesta de availableImages en GET /hostPlatforms.
		storageSettings		Matriz	Ubicación de almacenamiento preferida donde desea desplegar imágenes de sistema operativo.
			targetDevice	Cadena	Dispositivo objetivo. Puede presentar uno de los valores siguientes. localdisk. Unidad de disco local. Se usa la primera de las unidades de disco local enumeradas en el servidor gestionado. M.2drive. Unidad M.2. Se usa la primera de las unidades M.2 enumeradas en el servidor gestionado. usbdisk. Hipervisor USB integrado. Esta ubicación solo es aplicable cuando se despliega una imagen de VMware ESXi en servidores gestionados. Si hay dos claves de hipervisor instaladas en el servidor gestionado, el instalador de VMware selecciona la primera clave enumerada para el despliegue. lunpluswwn=`LUN`@`WWN`. Almacenamiento SAN FC (por ejemplo, lunpluswwn=2@50:05:07:68:05:0c:09:bb). lunplusiqn=`LUN`@`IQN`. Almacenamiento SAN iSCSI (por ejemplo, lunplusiqn=0@iqn.1990-01.com.lenovo:tgt1). Especificación del `IQN` es opcional si solo se configura un destino iSCSI si no se especifica el `IQN`, se selecciona el primer destino iSCSI detectado para OSDN. Si se especifica, y se realiza una coincidencia exacta. Nota Para servidores ThinkServer, este valor siempre es “localdisk.”
		unattendFileId		Cadena	Identificador del archivo de instalación desatendida a utilizar en este despliegue
		UUID		Cadena	UUidentificador del servidor de host donde se desplegará el sistema operativo
	imageSettings			Objeto	Información acerca de cada imagen de SO y el perfil de imagen
		name		Cadena	Nombre de la imagen del sistema operativo
		perfil		Cadena	Nombre del perfil de imagen
	otherSettings			Objeto	Valores adicionales asociados con los trabajos de despliegue del SO en ejecución actualmente
		deployDataAndSoftwareLocation		Cadena	Ruta a la carga útil de software extraído, los archivos personalizados y los datos de despliegue (por ejemplo, los certificados y los registros)
		installRepoUrl		Cadena	(Solo SLES 15 y versiones posteriores) URL para la imagen de paquete importado Puede utilizar están macro predefinido en la instalación desatendida personalizada para media_url en la sección adicional, por ejemplo: `<add-on> <add_on_products config:type="list"> <listentry> <media_url>#predefined.otherSettings.installRepoUrl# </media_url> <product>sle-module-basesystem</product> <product_dir>/Module-Basesystem</product_dir> </listentry> </add_on_products> </add-on>`
		lxcaIp		Cadena	Dirección IP de la instancia XClarity Administrator
		lxcaRelease		Cadena	Versión de XClarity Administrator (por ejemplo, 2.0.0)
		jobId		Cadena	El identificador del trabajo de despliegue del SO que se está ejecutando actualmente
		ntpServer		Cadena	Servidor NTP que está asociado con XClarity Administrator
		statusSettings		Objeto	Valores de estado de despliegue de SO
			urlStatus	Cadena	HTTPS URL (incluye el puerto) que XClarity Administrator utiliza para los informes de estado
			certLocation	Cadena	Carpeta que contiene los certificados que se necesitan para acceder al servicio web urlStatus desde el SO del host en el primer arranque
			sdkLocation	Cadena	Ubicación de XClarity Administrator proporcionada por scripts e interfaces de ayuda para acceder a XClarity Administrator
		timezone		Cadena	La zona horaria se establece para XClarity Administrator (por ejemplo, America/New_York)
	unattendSettings			Objeto	Valores que se utilizan para rellenar el archivo de instalación desatendida. Estos valores son específicos para la versión de XClarity Administrator
		networkConfig		Cadena	(Solo ESXi y RHEL) Contenido predefinido de XClarity Administrator para su uso en el tiempo de instalación desatendida. Esto configura los valores de red para el sistema operativo
		preinstallConfig		Cadena	Contenido predefinido de XClarity Administrator para su uso durante la instalación previa desatendida. Esto incluye el estado de instalación previa. En ESXi y RHEL, se usa el enlace de scripts previos a la instalación %pre. En SLES, se usa el enlace de scripts previos a la instalación <scripts>. Atención Se recomienda encarecidamente incluir estas macros en el archivo de instalación desatendida. Puede colocar el macro en el archivo de instalación desatendida en cualquier lugar después de la línea 1 (después de la etiqueta <xml>).
		postinstallConfig		Cadena	Contenido predefinido de XClarity Administrator para su uso después de que el servidor está configurado y se inicia por primera vez. Esto incluye el estado posterior a la instalación. En ESXi y RHEL, se usa el enlace de scripts posteriores a la instalación %post En SLES, se usa el enlace de scripts posterior a la instalación <scripts>. En Windows, esto utiliza la sección “valores especializados”. Atención Se recomienda encarecidamente incluir esta macro en el archivo de instalación desatendida. Puede colocar el macro en el archivo de instalación desatendida en cualquier lugar después de la línea 1 (después de la etiqueta <xml>).
		reportWorkloadNotComplete		Cadena	Cuando esta macro está presente, el macro postinstallConfig no informará el estado de Instalación de SO completa (17). El perfil personalizado debe informar que se completó.
		storageConfig		Cadena	(Solo ESXi y RHEL) Contenido predefinido de XClarity Administrator para su uso en el tiempo de instalación desatendida. Esto configura los valores de almacenamiento para el sistema operativo.

Entregar comentarios