Durante uma instalação do ESXi, você pode usar um script padrão para executar uma instalação padrão no primeiro disco detectado e o arquivo de configuração do carregador de inicialização para especificar o kernel, as opções do kernel e os módulos de inicialização que o mboot.c32 ou o mboot O carregador de inicialização .efi usa para a instalação.

Sobre o script de instalação padrão do ks.cfg

O instalador do ESXi inclui um script de instalação padrão que executa uma instalação padrão no primeiro disco detectado.

O script de instalação padrão do ks.cfg está localizado no disco RAM inicial em /etc/vmware/weasel/ks.cfg. Você pode especificar a localização do arquivo ks.cfg padrão com a opção de inicialização ks=file://etc/vmware/weasel/ks.cfg. Consulte Digite as opções de inicialização para iniciar um script de instalação ou atualização.

Quando você instala o ESXi usando o script ks.cfg, a senha raiz padrão é myp@ssw0rd.

Você não pode modificar o script padrão na mídia de instalação. Após a instalação, você pode usar o vSphere Client para fazer login no vCenter Server que gerencia o host ESXi e modificar as configurações padrão.

Com o vSphere 8.0, se o seu sistema tiver unidades de processamento de dados (DPU), use o script ks.cfg também para instalar o ESXi em DPUs.

O script padrão contém os seguintes comandos:

#
# Sample scripted installation file
#

# Accept the VMware End User License Agreement
vmaccepteula

# Set the root password for the DCUI and Tech Support Mode
rootpw myp@ssw0rd

# Install on the first local disk available on machine
install --firstdisk --overwritevmfs
 In case you system has DPUs, you also specify a PCI slot:
install --firstdisk --overwritevmfs --dpuPciSlots=<PCIeSlotID>

# Set the network to DHCP on the first network adapter
network --bootproto=dhcp --device=vmnic0

# A sample post-install script
%post --interpreter=python --ignorefailure=true
import time
stampFile = open('/finished.stamp', mode='w')
stampFile.write( time.asctime() )

Sobre o arquivo boot.cfg

O arquivo de configuração do carregador de inicialização boot.cfg especifica o kernel, as opções do kernel e os módulos de inicialização que o carregador de inicialização mboot.c32 ou mboot.efi usa em uma instalação do ESXi.

O arquivo boot.cfg é fornecido no instalador do ESXi. Você pode modificar a linha kernelopt do arquivo boot.cfg para especificar o local de um script de instalação ou para transmitir outras opções de inicialização.

O arquivo boot.cfg tem a seguinte sintaxe:
# boot.cfg -- mboot configuration file
#
# Any line preceded with '#' is a comment.

title=STRING
prefix=DIRPATH
kernel=FILEPATH
kernelopt=STRING
modules=FILEPATH1 --- FILEPATH2... --- FILEPATHn

# Any other line must remain unchanged.

Os comandos em boot.cfg configuram o carregador de inicialização.

Tabela 1. Comandos em boot.cfg.
Comando Descrição
title=STRING Define o título do carregador de inicialização como STRING.
prefix=STRING (Opcional) AdicionaDIRPATH/ na frente de cada FILEPATH nos comandos kernel= e modules= que ainda não foram iniciados com / ou com http://.
kernel=FILEPATH Define o caminho do kernel como FILEPATH.
kernelopt=STRING Anexa STRING às opções de inicialização do kernel.
modules=FILEPATH1 --- FILEPATH2... --- FILEPATHn Lista os módulos a serem carregados, separados por três hífens (---).

Consulte Criar uma imagem ISO do instalador com um script de instalação ou atualização personalizado e Inicialização de rede do instalador do ESXi.

Locais com suporte para scripts de instalação ou atualização

Em instalações e upgrades com script, o instalador do ESXi pode acessar o script de instalação ou upgrade, também chamado de arquivo kickstart, de vários locais.

Os seguintes locais são compatíveis com o script de instalação ou upgrade:

Caminho para o script de instalação ou upgrade

Você pode especificar o caminho para um script de instalação ou upgrade.

ks=http://XXX.XXX.XXX.XXX/kickstart/KS.CFG é o caminho para o script de instalação do ESXi, em que XXX .XXX.XXX.XXX é o endereço IP da máquina em que o script reside. Consulte Instalando o ESXi usando um script.

Para iniciar um script de instalação a partir de uma instalação interativa, digite a opção ks= manualmente. Consulte Digite as opções de inicialização para iniciar um script de instalação ou atualização.

Comandos de script de instalação e upgrade

Para modificar o script padrão de instalação ou upgrade ou para criar seu próprio script, use os comandos compatíveis. Use os comandos com suporte no script de instalação, que você especifica com um comando boot ao inicializar o instalador.

Para determinar em qual disco instalar ou fazer upgrade do ESXi, o script de instalação requer um dos seguintes comandos: install, upgrade ou installorupgrade. O comando install cria as partições padrão, incluindo um datastore VMFS que ocupa todo o espaço disponível após a criação das outras partições.

Com o vSphere 8.0, se o sistema tiver suporte a unidades de processamento de dados (DPU), sempre considere a instalação, a reinstalação ou o upgrade de ESXi nas DPUs junto com ESXi nos hosts. No entanto, a atualização de ESXi e o upgrade em DPUs não são compatíveis com o método interativo ou com script. Você só pode usar vSphere Lifecycle Manager.

Observação: O uso de dispositivos SD e USB para armazenar partições ESX-OSData está sendo descontinuado. Você pode usar dispositivos SD e USB somente para criar partições de banco de inicialização, boot-bank 0 e boot-bank 1. Além disso, você pode fornecer um disco permanente de no mínimo 32 GB no qual instalar a partição ESX-OSData. Você define esses discos usando o parâmetro systemDisk no comando install.

accepteula ou vmaccepteula (obrigatório)

Aceita o contrato de licença ESXi.

clearpart (opcional)

Limpa todas as partições existentes no disco. Requer que o comando install seja especificado. Edite com cuidado o comando clearpart nos scripts existentes.

--drives=
Remova partições nas unidades especificadas.
--alldrives
Ignora o requisito --drives= e permite a limpeza de partições em cada unidade.
--ignoredrives=
Remove partições em todas as unidades, exceto as especificadas. Obrigatório, a menos que o sinalizador --drives= ou --alldrives seja especificado.
--overwritevmfs
Permite a substituição de VMFS partições nas unidades especificadas. Por padrão, a substituição de partições VMFS não é permitida.
--firstdisk=
disk-type1
[disk-type2,...]
Observação: Caso seu sistema tenha DPUs, você também especifica um slot PCI.
Particiona o primeiro disco elegível encontrado. Por padrão, os discos qualificados são definidos na seguinte ordem:
  1. Armazenamento conectado localmente (local)
  2. Armazenamento de rede (remote)

Você pode alterar a ordem dos discos usando uma lista separada por vírgulas anexada ao argumento. Se você fornecer uma lista de filtros, as configurações padrão serão substituídas. Você pode combinar filtros para especificar um disco específico, incluindo esx para o primeiro disco com o ESXi instalado nele, informações de modelo e fornecedor ou o nome do driver de dispositivo VMkernel. Por exemplo, para preferir um disco com o nome do modelo ST3120814A e qualquer disco que use o driver mptsas em vez de um disco local normal, o argumento é --firstdisk=ST3120814A,mptsas,local. Você pode usar localesx para armazenamento local que contém a imagem ESXi ou remoteesx para armazenamento remoto que contém a imagem ESXi.

simulação (opcional)

Analisa e verifica o script de instalação. Não realiza a instalação.

instalar

Especifica que esta é uma nova instalação. O comando install, upgrade ou installorupgrade é necessário para determinar em qual disco instalar ou fazer upgrade do ESXi.

--disk= or --drive=
Especifica o disco a ser particionado. No comando --disk=diskname, o diskname pode ser um nome de disco ou um caminho completo do sistema de arquivos do disco em ESXi, por exemplo:
  • Nome do disco: --disk=naa.6d09466044143600247aee55ca2a6405 ou
  • Caminho do dispositivo: --disk=/vmfs/devices/disks/mpx.vmhba1:C0:T0:L0

Para obter os formatos de nome de disco aceitos, consulte Nomes de dispositivos de disco.

--firstdisk=
disk-type1,
[ disk-type2,...]
Observação: Caso seu sistema tenha DPUs, você também especifica um slot PCI: install --firstdisk --overwritevmfs --dpuPciSlots=<PCIeSlotID>
Particiona o primeiro disco elegível encontrado. Por padrão, os discos qualificados são definidos na seguinte ordem:
  1. Armazenamento conectado localmente (local)
  2. Armazenamento de rede (remote)

Você pode alterar a ordem dos discos usando uma lista separada por vírgulas anexada ao argumento. Se você fornecer uma lista de filtros, as configurações padrão serão substituídas. Você pode combinar filtros para especificar um disco específico, incluindo esx para o primeiro disco com o ESX instalado nele, informações de modelo e fornecedor ou o nome do driver de dispositivo VMkernel. Por exemplo, para preferir um disco com o nome do modelo ST3120814A e qualquer disco que use o driver mptsas em vez de um disco local normal, o argumento é --firstdisk=ST3120814A,mptsas,local. Você pode usar localesx para armazenamento local que contém a imagem ESXi ou remoteesx para armazenamento remoto que contém a imagem ESXi.

--ignoressd
Exclui os discos de estado sólido da elegibilidade para particionamento. Essa opção pode ser usada com o comando install e a opção --firstdisk. Essa opção tem precedência sobre a opção --firstdisk. Essa opção é inválida com as opções --drive ou --disk e com os comandos upgrade e installorupgrade. Consulte a documentação do vSphere Armazenamento para obter mais informações sobre como impedir a formatação do SSD durante o particionamento automático.
--overwritevsan
Você deve usar a opção --overwritevsan ao instalar o ESXi em um disco, SSD ou HDD (magnético), que está em um grupo de discos vSAN. Se você usar essa opção e nenhuma partição vSAN estiver no disco selecionado, a instalação falhará. Quando você instala o ESXi em um disco que está no grupo de discos vSAN, o resultado depende do disco selecionado:
  • Se você selecionar um SSD, o SSD e todos os HDDs subjacentes no mesmo grupo de discos serão apagados.
  • Se você selecionar um HDD e o tamanho do grupo de discos for maior que dois, somente o HDD selecionado será apagado.
  • Se você selecionar um disco HDD e o tamanho do grupo de discos for dois ou menos, o SSD e o HDD selecionado serão apagados.

Para obter mais informações sobre como gerenciar grupos de discos vSAN, consulte a documentação do vSphere Armazenamento.

--overwritevmfs
Necessário para substituir um datastore VMFS existente no disco antes da instalação.
--preservevmfs
Preserva um datastore VMFS existente no disco durante a instalação.
--novmfsondisk
Impede que uma partição VMFS seja criada neste disco. Deve ser usado com --overwritevmfs se existir uma partição VMFS no disco.
--systemdisk
Se você usar um dispositivo USB ou SD, systemDisk especificará o disco permanente local no qual instalar a partição ESX-OSData. Por exemplo, install --firstdisk = usb --systemDisk=<diskID>. Como resultado, as partições do banco de inicialização são colocadas no dispositivo USB, enquanto a partição OSData está no disco especificado no parâmetro systemDisk.
--repartitionsystemdisk
Se você usar um dispositivo USB ou SD e o disco local especificado com o parâmetro systemDisk não estiver vazio ou contiver um armazenamento de dados, será possível usar repartitionSystemDisk para garantir que o disco permanente seja reparticionado novamente antes do uso.
Observação: Se um disco permanente local não estiver disponível ou o tamanho do disco for menor que 32 GB, você verá mensagens de aviso, mas a instalação continuará.
--forceunsupportedinstall

Bloqueia a instalação de CPUs obsoletas.

installorupgrade

O comando install, upgrade ou installorupgrade é necessário para determinar em qual disco instalar ou fazer upgrade do ESXi.

--disk= or --drive=
Especifica o disco a ser particionado. No comando --disk=diskname, o diskname pode ser um nome de disco ou um caminho completo do sistema de arquivos do disco em ESXi, por exemplo:
  • Nome do disco: --disk=naa.6d09466044143600247aee55ca2a6405 ou
  • Caminho do dispositivo: --disk=/vmfs/devices/disks/mpx.vmhba1:C0:T0:L0

Para obter os formatos de nome de disco aceitos, consulte Nomes de dispositivos de disco.

--firstdisk=
disk-type1,
[ disk-type2,...]
Observação: Caso seu sistema tenha DPUs, você também especifica um slot PCI: installorupgrade --firstdisk --overwritevmfs --dpuPciSlots=<PCIeSlotID>
Particiona o primeiro disco elegível encontrado. Por padrão, os discos qualificados são definidos na seguinte ordem:
  1. Armazenamento conectado localmente (local)
  2. Armazenamento de rede (remote)

Você pode alterar a ordem dos discos usando uma lista separada por vírgulas anexada ao argumento. Se você fornecer uma lista de filtros, as configurações padrão serão substituídas. Você pode combinar filtros para especificar um disco específico, incluindo esx para o primeiro disco com o ESX instalado nele, informações de modelo e fornecedor ou o nome do driver de dispositivo VMkernel. Por exemplo, para preferir um disco com o nome do modelo ST3120814A e qualquer disco que use o driver mptsas em vez de um disco local normal, o argumento é --firstdisk=ST3120814A,mptsas,local. Você pode usar localesx para armazenamento local que contém a imagem ESXi ou remoteesx para armazenamento remoto que contém a imagem ESXi.

--overwritevsan
Você deve usar a opção --overwritevsan ao instalar o ESXi em um disco, SSD ou HDD (magnético), que está em um grupo de discos vSAN. Se você usar essa opção e nenhuma partição vSAN estiver no disco selecionado, a instalação falhará. Quando você instala o ESXi em um disco que está em um grupo de discos vSAN, o resultado depende do disco selecionado:
  • Se você selecionar um SSD, o SSD e todos os HDDs subjacentes no mesmo grupo de discos serão apagados.
  • Se você selecionar um HDD e o tamanho do grupo de discos for maior que dois, somente o HDD selecionado será apagado.
  • Se você selecionar um disco HDD e o tamanho do grupo de discos for dois ou menos, o SSD e o HDD selecionado serão apagados.

Para obter mais informações sobre como gerenciar grupos de discos vSAN, consulte a documentação do vSphere Armazenamento.

--overwritevmfs

Instale o ESXi se existir uma partição VMFS no disco, mas nenhuma instalação do ESX ou do ESXi existir. A menos que essa opção esteja presente, o instalador falhará se existir uma partição VMFS no disco, mas uma instalação ESX ou ESXi estiver ausente.

teclado (opcional)

Define o tipo de teclado para o sistema.

keyboardType
Especifica o mapa de teclado para o tipo de teclado selecionado. keyboardType deve ser um dos tipos a seguir.
  • belga
  • brasileiro
  • croata
  • Tcheco
  • Dinamarquês
  • estoniano
  • Finlandês
  • Francês
  • alemão
  • grego
  • islandês
  • italiano
  • Japonês
  • América Latina
  • Norueguês
  • Polonês
  • Português
  • russo
  • esloveno
  • Espanhol
  • sueco
  • Francês suíço
  • Alemão suíço
  • turco
  • Ucraniano
  • Reino Unido
  • Padrão dos EUA
  • Dvorak dos EUA

serialnum ou vmserialnum (opcional)

O comando é compatível com o ESXi versão 5.1 e posterior. Configura o licenciamento. Se não for incluído, o ESXi será instalado no modo de avaliação.

--esx=<license-key>

Especifica a chave de licença vSphere a ser usada. O formato é de 5 grupos de cinco caracteres (XXXXXXX-XXXXX-XXXXX-XXXXX-XXXXX).

rede (opcional)

Especifica um endereço de rede para o sistema.

--bootproto=[dhcp|static]

Especifica se as configurações de rede do DHCP devem ser obtidas ou definidas manualmente.

--device=
Especifica o endereço MAC da placa de rede ou o nome do dispositivo, no formato vmnicNN, como em vmnic0. Essa opção se refere ao dispositivo de uplink para o comutador virtual.
--ip=
Define um endereço IP para a máquina a ser instalada, no formato xxx.xxx.xxx.xxx. Obrigatório com a opção --bootproto=static e, caso contrário, ignorado.
--gateway=
Designa o gateway padrão como um endereço IP, no formato xxx.xxx.xxx.xxx. Usado com a opção --bootproto=static.
--nameserver=
Designa o servidor de nomes primário como um endereço IP. Usado com a opção --bootproto=static. Omita essa opção se você não pretender usar o DNS.

A opção --nameserver pode aceitar dois endereços IP. Por exemplo: --nameserver="10.126.87.104[,10.126.87.120]"

--netmask=
Especifica a máscara de sub-rede do sistema instalado, no formato 255.xxx.xxx.xxx. Usado com a opção --bootproto=static.
--hostname=
Especifica o nome do host para o sistema instalado.
--vlanid= vlanid
Especifica em qual VLAN o sistema está ligado. Usado com a opção --bootproto=dhcp ou --bootproto=static. Defina como um número inteiro de 1 a 4096.
--addvmportgroup=(0|1)
Especifica se o grupo de portas de Rede da VM deve ser adicionado, que é usado por máquinas virtuais. O valor padrão é 1.

paranóico (opcional)

Faz com que mensagens de aviso interrompam a instalação. Se você omitir esse comando, as mensagens de aviso serão registradas em log.

parte ou partição (opcional)

Cria um armazenamento de dados extra VMFS no sistema. Somente um datastore por disco pode ser criado. Não pode ser usado no mesmo disco que o comando install. Somente uma partição pode ser especificada por disco e só pode ser uma partição VMFS.

nome do armazenamento de dados
Especifica onde a partição deve ser montada.
--ondisk= or --ondrive=
Especifica o disco ou a unidade em que a partição é criada.
--firstdisk=
disk-type1,
[ disk-type2,...]
Observação: Caso seu sistema tenha DPUs, você também especifica um slot PCI.
Particiona o primeiro disco elegível encontrado. Por padrão, os discos qualificados são definidos na seguinte ordem:
  1. Armazenamento conectado localmente (local)
  2. Armazenamento de rede (remote)

Você pode alterar a ordem dos discos usando uma lista separada por vírgulas anexada ao argumento. Se você fornecer uma lista de filtros, as configurações padrão serão substituídas. Você pode combinar filtros para especificar um disco específico, incluindo esx para o primeiro disco com o ESX instalado nele, informações de modelo e fornecedor ou o nome do driver de dispositivo VMkernel. Por exemplo, para preferir um disco com o nome do modelo ST3120814A e qualquer disco que use o driver mptsas em vez de um disco local normal, o argumento é --firstdisk=ST3120814A,mptsas,local. Você pode usar localesx para armazenamento local que contém a imagem ESXi ou remoteesx para armazenamento remoto que contém a imagem ESXi.

reinicializar (opcional)

Reinicializa a máquina após a conclusão da instalação com script.

<--noeject>
O CD não é ejetado após a instalação.

rootpw (obrigatório)

Define a senha raiz do sistema.

--iscrypted
Especifica que a senha é criptografada.
senha
Especifica o valor da senha.

atualizar

O comando install, upgrade ou installorupgrade é necessário para determinar em qual disco instalar ou fazer upgrade do ESXi.

--disk= or --drive=
Especifica o disco a ser particionado. No comando --disk=diskname, o diskname pode ser um nome de disco ou um caminho completo do sistema de arquivos do disco em ESXi, por exemplo:
  • Nome do disco: --disk=naa.6d09466044143600247aee55ca2a6405 ou
  • Caminho do dispositivo: --disk=/vmfs/devices/disks/mpx.vmhba1:C0:T0:L0

Para obter os formatos de nome de disco aceitos, consulte Nomes de dispositivos de disco.

--firstdisk=
disk-type1,
[ disk-type2,...]
Particiona o primeiro disco elegível encontrado. Por padrão, os discos qualificados são definidos na seguinte ordem:
  1. Armazenamento conectado localmente (local)
  2. Armazenamento de rede (remote)

Você pode alterar a ordem dos discos usando uma lista separada por vírgulas anexada ao argumento. Se você fornecer uma lista de filtros, as configurações padrão serão substituídas. Você pode combinar filtros para especificar um disco específico, incluindo esx para o primeiro disco com o ESX instalado nele, informações de modelo e fornecedor ou o nome do driver de dispositivo VMkernel. Por exemplo, para preferir um disco com o nome do modelo ST3120814A e qualquer disco que use o driver mptsas em vez de um disco local normal, o argumento é --firstdisk=ST3120814A,mptsas,local. Você pode usar localesx para armazenamento local que contém a imagem ESXi ou remoteesx para armazenamento remoto que contém a imagem ESXi.

%include ou include (opcional)

Especifica outro script de instalação a ser analisado. Esse comando é tratado de forma semelhante a um comando de várias linhas, mas recebe apenas um argumento.

nome do arquivo
Por exemplo: %include part.cfg

%pre (opcional)

Especifica um script a ser executado antes que a configuração do kickstart seja avaliada. Por exemplo, você pode usá-lo para gerar arquivos para o arquivo kickstart incluir.

--interpreter
=[python|busybox]
Especifica um interpretador a ser usado. O padrão é busybox.

%post (opcional)

Executa o script especificado após a conclusão da instalação do pacote. Se você especificar várias seções %post, elas serão executadas na ordem em que aparecem no script de instalação.

--interpreter
=[python|busybox]
Especifica um interpretador a ser usado. O padrão é busybox.
--timeout=secs
Especifica um tempo limite para executar o script. Se o script não for concluído quando o tempo limite expirar, o script será interrompido à força.
--ignorefailure
=[true|false]
Se for true, a instalação será considerada bem-sucedida, mesmo se o script %post for interrompido com um erro.

%firstboot

Cria um script init que é executado somente durante a primeira inicialização. O script não tem efeito nas inicializações subsequentes. Se várias seções %firstboot forem especificadas, elas serão executadas na ordem em que aparecem no arquivo de kickstart.

Observação: Você não pode verificar a semântica de scripts %firstboot até que o sistema esteja inicializando pela primeira vez. Um script %firstboot pode conter erros potencialmente catastróficos que não são expostos até que a instalação seja concluída.
Importante: O script %firstboot não será executado se a inicialização segura estiver ativada no host ESXi.
--interpreter
=[python|busybox]
Especifica um interpretador a ser usado. O padrão é busybox.
Observação: Você não pode verificar a semântica do script %firstboot até que o sistema seja inicializado pela primeira vez. Se o script contiver erros, eles não serão expostos até que a instalação seja concluída.

Nomes de dispositivos de disco

Os comandos de script de instalação install, upgrade e installorupgrade requerem o uso de nomes de dispositivos de disco.

Tabela 2. Nomes de dispositivos de disco
Formato Exemplo Descrição
NAA naa.6d09466044143600247aee55ca2a6405 Identificador SCSI INQUIRY
EUI eui.3966623838646463 Identificador SCSI INQUIRY
T10 t10.SanDisk00Cruzer_Blade000000004C530001171118101244 Identificador SCSI INQUIRY
VML vml.00025261 Identificador do VMkernel herdado
MPX mpx.vmhba0:C0:T0:L0 Identificador baseado em caminho

Para obter mais informações sobre nomes de dispositivos de armazenamento, consulte Nomes e identificadores de dispositivos de armazenamento na documentação vSphereArmazenamento.