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.
# 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.
| 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:
- 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.
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--alldrivesseja 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,...]
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.6d09466044143600247aee55ca2a6405ou - 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.
- Nome do 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> - --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.
- --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.6d09466044143600247aee55ca2a6405ou - 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.
- Nome do 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> - --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 emvmnic0. 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
--nameserverpode 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.6d09466044143600247aee55ca2a6405ou - 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.
- Nome do 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.
- --interpreter
- =[python|busybox]
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.
| 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.
