Macros predefinidas
As macros fornecem a capacidade de adicionar dados variáveis (definições de configuração) a um arquivo sem supervisão ou script de pós-instalação. O Lenovo XClarity Administrator fornece um conjunto de configurações predefinidas que você pode usar.
Para inserir macros predefinidas a um arquivo sem supervisão ou de script pós-instalação, prefixe a macro com "predefinida" para macros predefinidas, separe objetos aninhados usando um ponto e, em seguida, coloque uma cerquilha (#) ao redor do nome da macro, por exemplo #predefined.globalSettings.ipAssignment#.
O valor para cada macro predefinida varia com base na instância do XClarity Administrator. Por exemplo, o campo permite que você especifique o modo de IP. Depois que o valor inserido pelo usuário é coletado durante a implantação do SO, o valor é representado nas configurações predefinidas pela macro predefinida #predefined.globalSettings.ipAssignment# e na instância do arquivo JSON de configuração sob o nome do objeto ipAssignment.
A tabela a seguir lista as macros predefinidas (definições de configuração) que estão disponíveis em XClarity Administrator.
Nome da macro | Tipo | Descrição | ||||
---|---|---|---|---|---|---|
predefinido | Objeto | Informações sobre todas as configurações de implantação do SO predefinidas | ||||
globalSettings | Objeto | Informações sobre configurações de implantação do SO | ||||
credenciais | Matriz de objetos | Informações sobre as credenciais do usuário | ||||
nome | Sequência | |||||
tipo | Sequência | Tipo de sistema operacional. Este pode ser um dos valores a seguir.
| ||||
ipAssignment | Sequência | Opção de configuração de rede de host para implantação de sistema operacional. Este pode ser um dos valores a seguir.
| ||||
isVLANMode | Sequência | Indica se o modo VLAN é usado. Este pode ser um dos valores a seguir.
| ||||
hostPlatforms | Objeto | Configurações de implantação das plataformas de host | ||||
licenseKey | Sequência | Chave de licença a ser usada para Microsoft Windows ou VMware ESXi. Se você não tiver uma chave de licença, poderá definir esse campo como nulo. | ||||
networkSettings | Matriz | Informações sobre configurações de rede | ||||
dns1 | Sequência | Servidor DNS preferencial para o host a ser usado após a implantação do sistema operacional | ||||
dns2 | Sequência | Servidor DNS para o host a ser usado após a implantação do sistema operacional | ||||
gateway | Sequência | Gateway do servidor de host a ser usado após a implantação do sistema operacional. Isso é usado quando a configuração de rede é definida como estática nas configurações globais de implantação do SO. Dica para determinar o modo de IP, use | ||||
nome do host | Sequência | Nome do host para o servidor de host. Se um nome do host não for especificado, um nome do host padrão será atribuído. | ||||
ipAddress | Sequência | Endereço IP do servidor de host a ser usado após a implantação do sistema operacional. Isso é usado quando a configuração de rede é definida como estática nas configurações globais de implantação do SO. | ||||
mtu | Longo | Unidade máxima de transmissão para o host a ser usada após a implantação do sistema operacional. | ||||
prefixLength | Sequência | Comprimento de prefixo do endereço IP do host a ser usado após a implantação do sistema operacional. Isso é usado quando a configuração de rede é definida como IPv6 estático nas configurações globais de implantação do SO. | ||||
selectedMAC | Sequência | Endereço MAC do servidor de host ao qual o endereço IP deve estar associado. O endereço MAC é definido como AUTO por padrão. Essa definição automaticamente detecta as portas Ethernet que podem ser configuradas e usadas para implantação. O primeiro endereço MAC (porta) detectado é usado por padrão. Se a conectividade for detectada em um endereço MAC diferente, o host do XClarity Administrator será reiniciado automaticamente para usar o endereço MAC recém-detectado para a implantação e selectedMAC é definido como o endereço MAC recentemente detectado. O modo VLAN é compatível somente para servidores que têm endereços MAC no inventário. Se AUTO for o único endereço MAC disponível para um servidor, VLANs não poderão ser usadas para implantar sistemas operacionais neste servidor. Dica para obter o endereço MAC, use a propriedade de resposta | ||||
subnetCIDRNumber | Número inteiro | Máscara de sub-rede do servidor host a ser usada após a implantação do sistema operacional, no formato Classless Inter-Domain Routing (CIDR). Isso é usado quando a configuração de rede é definida como estática nas configurações globais de implantação do SO. O número CIDR é normalmente precedido por uma barra "/" e segue o endereço IP. Por exemplo, um endereço IP de 131.10.55.70 com uma máscara de sub-rede 255.0.0.0 (que tem 8 bits de rede) seria representado como 131.10.55.70/8. Para obter mais informações, consulte o Página da Web Tutorial da notação CIDR. Dica para determinar o modo de IP, use | ||||
subnetMask | Sequência | Máscara de sub-rede do servidor host a ser usada após a implantação do sistema operacional, em notação decimal pontilhada (por exemplo, 255.0.0.0.). Isso é usado quando a configuração de rede é definida como estática nas configurações globais de implantação do SO. Dica para determinar o modo de IP, use | ||||
vlanId | Sequência | ID da VLAN para a marcação de VLAN do sistema operacional. Esse parâmetro será válido somente se estiver habilitado no modo VLAN. Para determinar se o modo VLAN está ativado, use GET /osdeployment/globalSettings. Importante Especifique um ID de VLAN somente quando uma marca VLAN for necessária para funcionar na rede. O uso de tags de VLAN pode afetar a roteabilidade da rede entre o sistema operacional do host e o | ||||
selectedImage | Sequência | ID do perfil da imagem do sistema operacional a ser implantada. Dica para obter os IDs de perfil da imagem do sistema operacional, use a propriedade de resposta | ||||
storageSettings | Matriz | Local de armazenamento preferencial onde você quer implantar imagens do sistema operacional | ||||
targetDevice | Sequência | Dispositivo de destino. Este pode ser um dos valores a seguir.
Nota Para servidores ThinkServer, esse valor é sempre localdisk. | ||||
unattendFileId | Sequência | ID do arquivo sem supervisão a ser usado com essa implantação | ||||
uuid do | Sequência | UUID do servidor de host no qual o sistema operacional deve ser implantado | ||||
imageSettings | Objeto | Informações sobre cada imagem do SO e o perfil de imagem | ||||
nome | Sequência | Nome da imagem do sistema operacional | ||||
perfil | Sequência | Nome do perfil da imagem | ||||
otherSettings | Objeto | Configurações adicionais que estão relacionadas aos trabalhos de implantação do SO em execução no momento | ||||
deployDataAndSoftwareLocation | Sequência | Caminho até a carga de software extraído, arquivos personalizados e dados de implantação (como certificados e logs) | ||||
installRepoUrl | Sequência | (SLES 15 e posterior somente) URL da imagem do pacote importado Você pode usar essa macro predefinida em arquivos sem supervisão personalizados para a media_url na seção complementar, por exemplo:
| ||||
lxcaIp | Sequência | O endereço IP da instância do XClarity Administrator | ||||
lxcaRelease | Sequência | Versão do XClarity Administrator (por exemplo, 2.0.0) | ||||
jobId | Sequência | ID do trabalho de implantação do SO em execução no momento | ||||
ntpServer | Sequência | Servidor NTP que está associado com o XClarity Administrator | ||||
statusSettings | Objeto | Configurações de status de implantação do SO | ||||
urlStatus | Sequência | URL HTTPS (incluindo a porta) que o XClarity Administrator usa para registro de status | ||||
certLocation | Sequência | Pasta que contém os certificados necessários para acessar o serviço da Web urlStatus no SO do host na primeira inicialização | ||||
sdkLocation | Sequência | Local dos scripts auxiliares e interfaces fornecidos pelo XClarity Administrator para acessar o XClarity Administrator | ||||
timezone | Sequência | Fuso horário configurado para XClarity Administrator (por exemplo, América/Nova_York) | ||||
unattendSettings | Objeto | Configurações que são usadas para preencher o arquivo sem supervisão. Esses valores são específicos da versão do XClarity Administrator | ||||
networkConfig | Sequência | (Somente para ESXi e RHEL) Conteúdo predefinido do XClarity Administrator para uso durante a instalação sem supervisão. Isso define as configurações de rede para o sistema operacional | ||||
preinstallConfig | Sequência | Conteúdo predefinido do XClarity Administrator para uso durante a pré-instalação sem supervisão. Isso inclui o status pré-instalação.
Atenção É altamente recomendado incluir essa macro no arquivo sem supervisão personalizado. Você pode colocar a macro no arquivo sem supervisão em qualquer lugar após a linha 1 (após a tag <xml>). | ||||
postinstallConfig | Sequência | Conteúdo predefinido do XClarity Administrator para uso após o servidor ser configurado e inicializado pela primeira vez. Isso inclui o status pós-instalação.
Atenção É altamente recomendado que essa macro seja incluída no arquivo sem supervisão personalizado. Você pode colocar a macro no arquivo sem supervisão em qualquer lugar após a linha 1 (após a tag <xml>). | ||||
reportWorkloadNotComplete | Sequência | Quando essa macro estiver presente, a macro postinstallConfig não relatará o status Instalação do SO concluída (17). O perfil personalizado deve relatar a conclusão. | ||||
storageConfig | Sequência | (Somente para ESXi e RHEL) Conteúdo predefinido do XClarity Administrator para uso durante a instalação sem supervisão. Isso define as configurações de armazenamento para o sistema operacional. |