Lo script di installazione/aggiornamento è un file di testo, ad esempio ks.cfg, che contiene comandi supportati.

La sezione del comando dello script contiene le opzioni di installazione ESXi. Questa sezione è obbligatoria e deve essere la prima dello script.

Informazioni sul file boot.cfg

Il file di configurazione del caricatore di avvio boot.cfg specifica il kernel, le opzioni del kernel e i moduli di avvio utilizzati dal caricatore di avvio mboot.c32 o mboot.efi in un'installazione di ESXi.

Il file boot.cfg è fornito nel programma di installazione di ESXi. È possibile modificare la riga kernelopt del file boot.cfg per specificare la posizione di uno script di installazione o per passare altre opzioni di avvio.

La sintassi del file boot.cfg è la seguente: 
# 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.

I comandi in boot.cfg configurano il caricatore di avvio.

Tabella 1. Comandi in boot.cfg.
Comando Descrizione
title=STRING Imposta il titolo del caricatore di avvio su STRING.
prefix=STRING (Facoltativo) AggiungeDIRPATH/ davanti a ogni FILEPATH nei comandi kernel= e modules= che non iniziano già con / o con http://.
kernel=FILEPATH Imposta il percorso del kernel su FILEPATH.
kernelopt=STRING Aggiunge STRING alle opzioni di avvio del kernel.
modules=FILEPATH1 --- FILEPATH2... --- FILEPATHn Elenca i moduli da caricare, separati da tre trattini (---).

Vedere Creazione di un'immagine ISO del programma di installazione con uno script di installazione o aggiornamento personalizzato e Avvio dalla rete del programma di installazione di ESXi.

Posizioni supportate per gli script di installazione o aggiornamento

Nelle installazioni e negli aggiornamenti controllati da script, il programma di installazione ESXi può accedere allo script di installazione o di aggiornamento, denominato anche file kickstart, da diverse posizioni.

Le seguenti posizioni sono supportate per lo script di installazione o aggiornamento:

Percorso dello script di installazione o aggiornamento

È possibile specificare il percorso di uno script di installazione o aggiornamento.

ks=http://XXX.XXX.XXX.XXX/kickstart/KS.CFG è il percorso dello script di installazione di ESXi, dove XXX.XXX.XXX.XXX è l'indirizzo IP della macchina su cui si trova lo script. Vedere Installazione di ESXi tramite uno script.

Per avviare uno script di installazione da un'installazione interattiva, immettere manualmente l'opzione ks=. Vedere Immissione delle opzioni di avvio per eseguire uno script di installazione o aggiornamento.

Comandi di script di installazione e aggiornamento

Per modificare lo script di installazione o di aggiornamento predefinito o per creare uno script personalizzato, utilizzare i comandi supportati. Utilizzare i comandi supportati nello script di installazione, che viene specificato con un comando di avvio quando si avvia il programma di installazione.

Per determinare su quale disco installare o aggiornare ESXi, lo script di installazione richiede uno dei seguenti comandi: install, upgrade o installorupgrade. Il comando install crea le partizioni predefinite, incluso un datastore VMFS che occupa tutto lo spazio disponibile dopo la creazione delle altre partizioni.

Con vSphere 8.0, se il sistema dispone di unità di elaborazione dati (DPU) supportate, considerare sempre l'installazione, la reinstallazione o l'aggiornamento di ESXi nelle DPU insieme a ESXi negli host. L'aggiornamento e l'upgrade di ESXi nelle DPU non sono supportati dal metodo interattivo o con script. È possibile utilizzare solo vSphere Lifecycle Manager.

Nota: L'uso di dispositivi SD e USB per l'archiviazione delle partizioni ESX-OSData verrà deprecato. È possibile utilizzare i dispositivi SD e USB solo per creare partizioni boot bank, boot-bank 0 e boot-bank 1. È inoltre possibile fornire un disco persistente di almeno 32 GB in cui installare la partizione ESX-OSData. Definire tali dischi utilizzando il parametro systemDisk nel comando install.

accepteula o vmacepteula (Obbligatorio)

Accetta il contratto di licenza di ESXi.

clearpart (facoltativo)

Cancella tutte le partizioni esistenti sul disco. Richiede che sia specificato il comando install. Modificare con attenzione il comando clearpart negli script esistenti.

--drives=
Rimuovere le partizioni nelle unità specificate.
--alldrives
Ignora il requisito --drives= e consente la cancellazione delle partizioni su ogni unità.
--ignoredrives=
Rimuove le partizioni su tutte le unità ad eccezione di quelle specificate. Obbligatorio a meno che non venga specificato il contrassegno --drives= --alldrives.
--overwritevmfs
Consente la sovrascrittura delle partizioni VMFS nelle unità specificate. Per impostazione predefinita, non è consentita la sovrascrittura delle partizioni VMFS.
--firstdisk=
tipo disco1
[tipo disco2,...]
Nota: Se la versione del sistema vSphere è precedente alla 8.0 Update 3 e sono presenti DPU, è necessario specificare anche uno slot PCI: install --firstdisk --overwritevmfs --dpupcislots=<PCIeSlotID>. Per i sistemi con versione 8.0 Update 3 e successive, il parametro dpupcislots è deprecato.
Partiziona il primo disco idoneo trovato. Per impostazione predefinita, i dischi idonei sono impostati sul seguente ordine:
  1. Storage collegato localmente (local)
  2. Archivio di rete (remote)

È possibile modificare l'ordine dei dischi utilizzando un elenco separato da virgole allegato all'argomento. Se si fornisce un elenco di filtri, le impostazioni predefinite vengono sovrascritte. È possibile combinare i filtri per specificare un disco particolare, incluso esx ESXi per il primo disco in cui è installato, le informazioni sul modello e sul fornitore o il nome del driver del dispositivo VMkernel. --firstdisk=ST3120814A,mptsas,localAd esempio, per preferire un disco con il nome di modello ST3120814A e qualsiasi disco che utilizza il driver mptsas anziché un normale disco locale, l'argomento è . È possibile utilizzare localesx per l'archiviazione locale che contiene l'immagine ESXi o remoteesx per l'archiviazione remota che contiene l'immagine ESXi.

prova (facoltativa)

Analizza e controlla lo script di installazione. Non esegue l'installazione.

install

Specifica che questa è una nuova installazione. Per determinare su quale disco installare o aggiornare ESXi, è necessario il comando install, upgrade o installorupgrade.

--disk= or --drive=
Specifica il disco da partizionare. Nel comando --disk=diskname, diskname può essere il nome di un disco o il percorso completo del file system del disco in ESXi, ad esempio:
  • Nome disco: --disk=naa.6d09466044143600247aee55ca2a6405 o
  • Percorso dispositivo: --disk=/vmfs/devices/disks/mpx.vmhba1:C0:T0:L0

Per i formati dei nomi dei dischi accettati, vedere Nomi dei dispositivi del disco.

--firstdisk=
tipo disco1,
[ tipo disco2 ,...]
Nota: Se la versione del sistema vSphere è precedente alla 8.0 Update 3 e sono presenti DPU, è necessario specificare anche uno slot PCI: install --firstdisk --overwritevmfs --dpupcislots=<PCIeSlotID>. Per i sistemi con versione 8.0 Update 3 e successive, il parametro dpupcislots è deprecato.
Partiziona il primo disco idoneo trovato. Per impostazione predefinita, i dischi idonei sono impostati sul seguente ordine:
  1. Storage collegato localmente (local)
  2. Archivio di rete (remote)

È possibile modificare l'ordine dei dischi utilizzando un elenco separato da virgole allegato all'argomento. Se si fornisce un elenco di filtri, le impostazioni predefinite vengono sovrascritte. È possibile combinare i filtri per specificare un particolare disco, incluso esx per il primo disco con ESX installato, informazioni sul modello e sul fornitore o il nome del driver del dispositivo VMkernel. --firstdisk=ST3120814A,mptsas,localAd esempio, per preferire un disco con il nome di modello ST3120814A e qualsiasi disco che utilizza il driver mptsas anziché un normale disco locale, l'argomento è . È possibile utilizzare localesx per l'archiviazione locale che contiene l'immagine ESXi o remoteesx per l'archiviazione remota che contiene l'immagine ESXi.

--ignoressd
Esclude i dischi SSD dall'idoneità per il partizionamento. Questa opzione può essere utilizzata con il comando install e l'opzione --firstdisk. Questa opzione ha la precedenza sull'opzione --firstdisk. Questa opzione non è valida con le opzioni --drive o --disk e con i comandi upgrade e installorupgrade. Per ulteriori informazioni su come impedire la formattazione di SSD durante la partizione automatica, vedere la documentazione di Storage di vSphere.
--overwritevsan
È necessario utilizzare l'opzione --overwritevsan quando si installa ESXi su un disco, SSD o HDD (magnetico), che si trova in un gruppo di dischi vSAN. vSANSe si utilizza questa opzione e sul disco selezionato non è presente alcuna partizione, l'installazione non riesce. Quando si installa ESXi su un disco che si trova nel gruppo di dischi vSAN, il risultato dipende dal disco selezionato:
  • Se si seleziona un'unità SSD, l'unità SSD e tutti gli HDD sottostanti nello stesso gruppo di dischi vengono cancellati.
  • Se si seleziona un disco rigido e le dimensioni del gruppo di dischi sono maggiori di due, viene cancellato solo il disco rigido selezionato.
  • Se si seleziona un disco rigido e le dimensioni del gruppo di dischi sono al massimo due, l'unità SSD e l'unità disco rigido selezionata vengono cancellati.

Per ulteriori informazioni sulla gestione dei gruppi di dischi vSAN, consultare la documentazione di Storage di vSphere.

--overwritevmfs
Necessario per sovrascrivere un datastore VMFS esistente sul disco prima dell'installazione.
--preservevmfs
Mantiene un datastore VMFS esistente sul disco durante l'installazione.
--novmfsondisk
Impedisce la creazione di una partizione VMFS su questo disco. Deve essere utilizzato con --overwritevmfs se sul disco è presente una partizione VMFS.
--systemdisk
Se si utilizza un dispositivo USB o SD, systemDisk specifica il disco persistente locale in cui installare la partizione ESX-OSData. Ad esempio, install --firstdisk = usb --systemDisk=<diskID>. Di conseguenza, le partizioni boot bank vengono posizionate nel dispositivo USB, mentre la partizione OSData si trova nel disco specificato nel parametro systemDisk.
--repartitionsystemdisk
Se si utilizza un dispositivo USB o SD e il disco locale specificato con il parametro systemDisk non è vuoto o contiene un datastore, è possibile utilizzare repartitionSystemDisk per assicurarsi che il disco persistente venga ripartizionato prima dell'uso.
Nota: Se non è disponibile un disco persistente locale o le dimensioni del disco sono inferiori a 32 GB, vengono visualizzati messaggi di avviso, ma l'installazione continua.
--forceunsupportedinstall

Blocca l'installazione delle CPU deprecate.

installorupgrade

Per determinare su quale disco installare o aggiornare ESXi, è necessario il comando install, upgrade o installorupgrade.

--disk= or --drive=
Specifica il disco da partizionare. Nel comando --disk=diskname, diskname può essere il nome di un disco o il percorso completo del file system del disco in ESXi, ad esempio:
  • Nome disco: --disk=naa.6d09466044143600247aee55ca2a6405 o
  • Percorso dispositivo: --disk=/vmfs/devices/disks/mpx.vmhba1:C0:T0:L0

Per i formati dei nomi dei dischi accettati, vedere Nomi dei dispositivi del disco.

--firstdisk=
tipo disco1,
[ tipo disco2 ,...]
Nota: Se la versione del sistema vSphere è precedente alla 8.0 Update 3 e sono presenti DPU, è necessario specificare anche uno slot PCI: install --firstdisk --overwritevmfs --dpupcislots=<PCIeSlotID>. Per i sistemi con versione 8.0 Update 3 e successive, il parametro dpupcislots è deprecato.
Partiziona il primo disco idoneo trovato. Per impostazione predefinita, i dischi idonei sono impostati sul seguente ordine:
  1. Storage collegato localmente (local)
  2. Archivio di rete (remote)

È possibile modificare l'ordine dei dischi utilizzando un elenco separato da virgole allegato all'argomento. Se si fornisce un elenco di filtri, le impostazioni predefinite vengono sovrascritte. È possibile combinare i filtri per specificare un particolare disco, incluso esx per il primo disco con ESX installato, informazioni sul modello e sul fornitore o il nome del driver del dispositivo VMkernel. --firstdisk=ST3120814A,mptsas,localAd esempio, per preferire un disco con il nome di modello ST3120814A e qualsiasi disco che utilizza il driver mptsas anziché un normale disco locale, l'argomento è . È possibile utilizzare localesx per l'archiviazione locale che contiene l'immagine ESXi o remoteesx per l'archiviazione remota che contiene l'immagine ESXi.

--overwritevsan
È necessario utilizzare l'opzione --overwritevsan quando si installa ESXi su un disco, SSD o HDD (magnetico), che si trova in un gruppo di dischi vSAN. vSANSe si utilizza questa opzione e sul disco selezionato non è presente alcuna partizione, l'installazione non riesce. Quando si installa ESXi su un disco che si trova in un gruppo di dischi vSAN, il risultato dipende dal disco selezionato:
  • Se si seleziona un'unità SSD, l'unità SSD e tutti gli HDD sottostanti nello stesso gruppo di dischi vengono cancellati.
  • Se si seleziona un disco rigido e le dimensioni del gruppo di dischi sono maggiori di due, viene cancellato solo il disco rigido selezionato.
  • Se si seleziona un disco rigido e le dimensioni del gruppo di dischi sono al massimo due, l'unità SSD e l'unità disco rigido selezionata vengono cancellati.

Per ulteriori informazioni sulla gestione dei gruppi di dischi vSAN, consultare la documentazione di Storage di vSphere.

--overwritevmfs

Installare ESXi se sul disco è presente una partizione VMFS ma non sono disponibili ESX o ESXi. A meno che questa opzione non sia presente, il programma di installazione non riesce se nel disco è presente una partizione VMFS, ma manca un'installazione ESX o ESXi.

tastiera (facoltativa)

Imposta il tipo di tastiera per il sistema.

keyboardType
Specifica la mappa della tastiera per il tipo di tastiera selezionato. Il tipo di tastiera deve essere di uno dei seguenti tipi.
  • Belga
  • Brasiliano
  • Croato
  • Cecoslovacco
  • Danese
  • Estone
  • Finlandese
  • Francese
  • Tedesco
  • Greca
  • islandese
  • Italiano
  • Giapponese
  • America Latina
  • Norvegese
  • Polacco
  • Portoghese
  • Russo
  • Sloveno
  • Spagnolo
  • Svedese
  • Francese svizzero
  • Svizzero tedesco
  • Turco
  • Ucraino
  • Regno Unito
  • Predefinito USA
  • Dvorak USA

serialnum o vmserialnum (facoltativo)

Il comando è supportato in ESXi versione 5.1 e successive. Configura le licenze. Se non è incluso, ESXi viene installato in modalità di valutazione.

--esx=<license-key>

Specifica la chiave di licenza di vSphere da utilizzare. Il formato è 5 gruppi di cinque caratteri (XXXXX-XXXXX-XXXXX-XXXXX-XXXXX).

rete (facoltativa)

Specifica un indirizzo di rete per il sistema.

--bootproto=[dhcp|static]

Specifica se ottenere le impostazioni di rete da DHCP o impostarle manualmente.

--device=
Specifica l'indirizzo MAC della scheda di rete o il nome del dispositivo, nel formato vmnicNN, come in vmnic0. Questa opzione si riferisce al dispositivo uplink per il commutatore virtuale.
--ip=
Imposta un indirizzo IP per la macchina da installare, nel formato xxx.xxx.xxx.xxx. Obbligatorio con l'opzione --bootproto=static e ignorato in caso contrario.
--gateway=
Designa il gateway predefinito come indirizzo IP, nel formato xxx.xxx.xxx.xxx. Utilizzato con l'opzione --bootproto=static.
--nameserver=
Designa il server dei nomi primario come indirizzo IP. Utilizzato con l'opzione --bootproto=static. Omettere questa opzione se non si intende utilizzare il DNS.

L'opzione --nameserver può accettare due indirizzi IP. Ad esempio: --nameserver="10.126.87.104[,10.126.87.120]"

--netmask=
Specifica la subnet mask per il sistema installato, nel formato 255.xxx.xxx.xxx. Utilizzato con l'opzione --bootproto=static.
--hostname=
Specifica il nome host per il sistema installato.
--vlanid= ID vlan
Specifica la VLAN su cui si trova il sistema. Utilizzato con l'opzione --bootproto=dhcp o --bootproto=static. Impostare su un numero intero compreso tra 1 e 4096.
--addvmportgroup=(0|1)
Specifica se aggiungere il gruppo della porta della rete della macchina virtuale, utilizzato dalle macchine virtuali. Il valore predefinito è 1.

paranoico (facoltativo)

Causa messaggi di avviso che interrompono l'installazione. Se si omette questo comando, vengono registrati i messaggi di avviso.

parte o partizione (facoltativa)

Crea un datastore VMFS aggiuntivo nel sistema. È possibile creare un solo datastore per disco. Non può essere utilizzato sullo stesso disco del comando install. È possibile specificare una sola partizione per disco e può essere solo una partizione VMFS.

nome datastore
Specifica dove deve essere montata la partizione.
--ondisk= or --ondrive=
Specifica il disco o l'unità in cui viene creata la partizione.
--onfirstdisk=
tipo disco1,
[ tipo disco2 ,...]
Nota: Se la versione del sistema vSphere è precedente alla 8.0 Update 3 e sono presenti DPU, è necessario specificare anche uno slot PCI: install --firstdisk --overwritevmfs --dpupcislots=<PCIeSlotID>. Per i sistemi con versione 8.0 Update 3 e successive, il parametro dpupcislots è deprecato.
Partiziona il primo disco idoneo trovato. Per impostazione predefinita, i dischi idonei sono impostati sul seguente ordine:
  1. Storage collegato localmente (local)
  2. Archivio di rete (remote)

È possibile modificare l'ordine dei dischi utilizzando un elenco separato da virgole allegato all'argomento. Se si fornisce un elenco di filtri, le impostazioni predefinite vengono sovrascritte. È possibile combinare i filtri per specificare un particolare disco, incluso esx per il primo disco con ESX installato, informazioni sul modello e sul fornitore o il nome del driver del dispositivo VMkernel. --onfirstdisk=ST3120814A,mptsas,localAd esempio, per preferire un disco con il nome di modello ST3120814A e qualsiasi disco che utilizza il driver mptsas anziché un normale disco locale, l'argomento è . È possibile utilizzare localesx per l'archiviazione locale che contiene l'immagine ESXi o remoteesx per l'archiviazione remota che contiene l'immagine ESXi.

riavvio (facoltativo)

Riavvia la macchina al termine dell'installazione con script.

<--noeject>
Il CD non viene espulso dopo l'installazione.

rootpw (Obbligatorio)

Imposta la password root per il sistema.

--iscrypted
Specifica che la password è crittografata.
password
Specifica il valore della password.

upgrade

Per determinare su quale disco installare o aggiornare ESXi, è necessario il comando install, upgrade o installorupgrade.

--disk= or --drive=
Specifica il disco da partizionare. Nel comando --disk=diskname, diskname può essere il nome di un disco o il percorso completo del file system del disco in ESXi, ad esempio:
  • Nome disco: --disk=naa.6d09466044143600247aee55ca2a6405 o
  • Percorso dispositivo: --disk=/vmfs/devices/disks/mpx.vmhba1:C0:T0:L0

Per i formati dei nomi dei dischi accettati, vedere Nomi dei dispositivi del disco.

--firstdisk=
tipo disco1,
[ tipo disco2 ,...]
Partiziona il primo disco idoneo trovato. Per impostazione predefinita, i dischi idonei sono impostati sul seguente ordine:
  1. Storage collegato localmente (local)
  2. Archivio di rete (remote)

È possibile modificare l'ordine dei dischi utilizzando un elenco separato da virgole allegato all'argomento. Se si fornisce un elenco di filtri, le impostazioni predefinite vengono sovrascritte. È possibile combinare i filtri per specificare un particolare disco, incluso esx per il primo disco con ESX installato, informazioni sul modello e sul fornitore o il nome del driver del dispositivo VMkernel. --firstdisk=ST3120814A,mptsas,localAd esempio, per preferire un disco con il nome di modello ST3120814A e qualsiasi disco che utilizza il driver mptsas anziché un normale disco locale, l'argomento è . È possibile utilizzare localesx per l'archiviazione locale che contiene l'immagine ESXi o remoteesx per l'archiviazione remota che contiene l'immagine ESXi.

%include o include (facoltativo)

Specifica un altro script di installazione da analizzare. Questo comando viene gestito in modo simile a un comando multilinea, ma richiede un solo argomento.

filename
Ad esempio: %include part.cfg

%pre (facoltativo)

Specifica uno script da eseguire prima che la configurazione kickstart venga valutata. Ad esempio, è possibile utilizzarlo per generare file da includere nel file kickstart.

--interpreter
=[python|busybox]
Specifica un interprete da utilizzare. Il valore predefinito è busybox.

%post (facoltativo)

Esegue lo script specificato al termine dell'installazione del pacchetto. %postSe si specificano più sezioni , queste vengono eseguite nell'ordine in cui vengono visualizzate nello script di installazione.

--interpreter
=[python|busybox]
Specifica un interprete da utilizzare. Il valore predefinito è busybox.
--timeout=secs
Specifica un timeout per l'esecuzione dello script. Se lo script non viene completato alla scadenza del timeout, viene forzatamente interrotto.
--ignorefailure
=[true|false]
Se è true, l'installazione viene considerata riuscita anche se lo script %post si arresta con un errore.

%firstboot

Crea uno script init che viene eseguito solo durante il primo avvio. Lo script non ha effetto agli avvii successivi. %firstbootSe vengono specificate più sezioni , queste vengono eseguite nell'ordine in cui vengono visualizzate nel file kickstart.

Nota: Non è possibile controllare la semantica degli script %firstboot finché il sistema non viene avviato per la prima volta. Uno script %firstboot potrebbe contenere errori potenzialmente irreversibili che non vengono esposti fino al completamento dell'installazione.
Importante: Lo script %firstboot non viene eseguito se l'avvio sicuro è abilitato nell'host ESXi.
--interpreter
=[python|busybox]
Specifica un interprete da utilizzare. Il valore predefinito è busybox.
Nota: Non è possibile controllare la semantica dello script %firstboot finché il sistema non viene avviato per la prima volta. Se lo script contiene errori, questi vengono esposti solo dopo il completamento dell'installazione.