Instalando o ESXi usando um script

O script de instalação/atualização é um arquivo de texto, por exemplo, ks.cfg, que contém comandos compatíveis.

A seção de comando do script contém as opções de instalação ESXi. Esta seção é obrigatória e deve aparecer primeiro no script.

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) Adiciona`DIRPATH/` 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:

CD/DVD. Consulte Criar uma imagem ISO do instalador com um script de instalação ou atualização personalizado.
Unidade flash USB. Consulte Criar uma unidade flash USB para armazenar o script de instalação ESXi ou o script de atualização.
Um local de rede acessível por meio dos seguintes protocolos: NFS, HTTP, HTTPS, FTP

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:

Armazenamento conectado localmente (local)
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:

Armazenamento conectado localmente (local)
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:

Armazenamento conectado localmente (local)
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:

Armazenamento conectado localmente (local)
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:

Armazenamento conectado localmente (local)
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.