Le script d'installation/de mise à niveau est un fichier texte, par exemple ks.cfg, qui contient les commandes prises en charge.

La section de commande du script contient les options d'installation ESXi. Cette section est requise et doit apparaître en premier dans le script.

À propos du fichier boot.cfg

Le fichier de configuration du chargeur de démarrage boot.cfg spécifie le noyau, les options du noyau et les modules de démarrage que le chargeur de démarrage mboot.c32 ou mboot.efi utilise dans une installation ESXi.

Le fichier boot.cfg est fourni dans le programme d'installation d'ESXi. Vous pouvez modifier la ligne kernelopt du fichier boot.cfg pour spécifier l'emplacement d'un script d'installation ou pour transmettre les autres options de démarrage.

La syntaxe du fichier boot.cfg est la suivante :
# 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.

Les commandes dans le fichier boot.cfg configurent le chargeur de démarrage.

Tableau 1. Commandes dans boot.cfg.
Commande Description
title=STRING Définit l'intitulé du chargeur de démarrage sur STRING.
prefix=STRING (Facultatif) AjouteDIRPATH/ devant chaque FILEPATH dans les commandes kernel= et modules= qui ne commencent pas déjà par / ou par http://.
kernel=FILEPATH Définit le chemin du noyau sur FILEPATH.
kernelopt=STRING Ajoute STRING aux options de démarrage du noyau.
modules=FILEPATH1 --- FILEPATH2... --- FILEPATHn Répertorie les modules à charger, séparés par trois traits d'union (---).

Reportez-vous aux sections Créer une image ISO du programme d'installation avec un script d'installation ou de mise à niveau personnalisé et Démarrage réseau du programme d'installation d'ESXi.

Emplacements pris en charge pour les scripts d'installation ou de mise à niveau

Dans les installations et les mises à niveau basées sur un script, le programme d'installation ESXi peut accéder au script d'installation ou de mise à niveau, également appelé le fichier kickstart, depuis plusieurs emplacements.

Les emplacements suivants sont pris en charge pour le script d'installation ou de mise à niveau :

Chemin d'accès au script d'installation ou de mise à niveau

Vous pouvez spécifier le chemin d'accès au script d'installation ou de mise à niveau.

ks=http://XXX.XXX.XXX.XXX/kickstart/KS.CFG est le chemin d'accès au script d'installation d'ESXi, oùXXX.XXX.XXX.XXXest l'adresse IP de la machine sur laquelle le script réside. Reportez-vous à la section Installation d'ESXi à l'aide d'un script.

Pour démarrer un script d'installation à partir d'une installation interactive, vous entrez l'option ks= manuellement. Reportez-vous à la section Entrer les options de démarrage pour exécuter un script d'installation ou de mise à niveau.

Commandes du script d'installation et de mise à niveau

Pour modifier le script d'installation ou de mise à niveau par défaut ou pour créer votre propre script, utilisez les commandes prises en charge. Utilisez les commandes prises en charge dans le script d'installation, que vous spécifiez à l'aide d'une commande de démarrage quand vous démarrez le programme d'installation.

Pour déterminer le disque sur lequel installer ou mettre à niveau ESXi, le script d'installation a besoin de l'une des commandes suivantes : install, upgrade ou installorupgrade. La commande install crée les partitions par défaut, incluant une banque de données VMFS qui occupe tout l'espace disponible après la création des autres partitions.

Avec vSphere 8.0, si votre système a pris en charge les unités de traitement de données (DPU), envisagez toujours l'installation, la réinstallation ou la mise à niveau d'ESXi sur les DPU ainsi que d'ESXi sur les hôtes. La mise à jour et la mise à niveau d'ESXi sur les DPU ne sont pas prises en charge par la méthode interactive ou avec script. Vous pouvez uniquement utiliser vSphere Lifecycle Manager.

Note : L'utilisation de périphériques SD et USB pour le stockage de partitions ESX-OSData est obsolète. Vous pouvez utiliser des périphériques SD et USB uniquement pour créer des partitions de banque de démarrage, boot-bank 0 et boot-bank 1. En outre, vous pouvez fournir un disque persistant d'au moins 32 Go sur lequel installer la partition ESX-OSData. Vous définissez ce type de disque à l'aide du paramètre systemDisk dans la commande install.

accepteula ou vmaccepteula (requis)

Accepte le contrat de licence ESXi.

clearpart (facultatif)

Effacez toutes les partitions existantes sur le disque. La commande install doit être spécifiée. Modifiez la commande clearpart avec précaution dans vos scripts existants.

--drives=
Supprimez les partitions sur les lecteurs spécifiés.
--alldrives
Ignore la spécification --drives= et autorise l'effacement des partitions sur chaque lecteur.
--ignoredrives=
Supprime les partitions sur tous les lecteurs, sauf sur les lecteurs spécifiés. Requis sauf si l'indicateur --drives= ou --alldrives est spécifié.
--overwritevmfs
Autorise l'écrasement des partitions VMFS sur les lecteurs spécifiés. Par défaut, l'écrasement des partitions VMFS n'est pas autorisé.
--firstdisk=
disk-type1
[disk-type2,...]
Note : Si votre système vSphere est de version antérieure à la version 8.0 Update 3 et dispose de DPU, vous spécifiez également un emplacement PCI : install --firstdisk --overwritevmfs --dpupcislots=<PCIeSlotID>. Pour les systèmes de version 8.0 Update 3 et versions ultérieures, le paramètre dpupcislots est obsolète.
Partitions pour le premier disque éligible trouvé. Par défaut, les disques éligibles sont définis dans l'ordre suivant :
  1. Stockage connecté localement (local)
  2. Stockage de réseau (remote)

Vous pouvez modifier l'ordre des disques en utilisant une liste séparée par des virgules ajoutée à l'argument. Si vous fournissez une liste de filtres, les paramètres par défaut sont écrasés. Vous pouvez combiner des filtres pour spécifier un disque en particulier, en incluant esx pour le premier disque sur lequel ESXi est installé, des informations sur le modèle et le fournisseur, ou le nom du pilote de périphérique vmkernel. Par exemple, pour préférer un disque avec le nom de modèle ST3120814A et n'importe quel disque qui utilise le pilote mptsas au lieu d'un disque local normal, l'argument est --firstdisk=ST3120814A,mptsas,local. Vous pouvez utiliser localesx pour le stockage local contenant une image ESXi ou remoteesx pour le stockage à distance contenant une image ESXi.

dryrun (facultatif)

Analyse et vérifie le script d'installation. N'effectue pas l'installation.

installer

Indique qu'il s'agit d'une nouvelle installation. La commande install, upgrade ou installorupgrade est requise pour déterminer sur quel disque ESXi doit être installé ou mis à niveau.

--disk= or --drive=
Indique le disque à la partition. Dans la commande --disk= diskname, diskname peut être un nom de disque ou un chemin de système de fichiers de disque complet dans ESXi, par exemple :
  • Nom du disque : --disk=naa.6d09466044143600247aee55ca2a6405 ou
  • Chemin d'accès au périphérique : --disk=/vmfs/devices/disks/mpx.vmhba1:C0:T0:L0

Pour les formats de nom de disque acceptés, reportez-vous à Noms de périphériques de disques.

--firstdisk=
disk-type1,
[ disk-type2,...]
Note : Si votre système vSphere est de version antérieure à la version 8.0 Update 3 et dispose de DPU, vous spécifiez également un emplacement PCI : install --firstdisk --overwritevmfs --dpupcislots=<PCIeSlotID>. Pour les systèmes de version 8.0 Update 3 et versions ultérieures, le paramètre dpupcislots est obsolète.
Partitions pour le premier disque éligible trouvé. Par défaut, les disques éligibles sont définis dans l'ordre suivant :
  1. Stockage connecté localement (local)
  2. Stockage de réseau (remote)

Vous pouvez modifier l'ordre des disques en utilisant une liste séparée par des virgules ajoutée à l'argument. Si vous fournissez une liste de filtres, les paramètres par défaut sont écrasés. Vous pouvez combiner des filtres pour spécifier un disque en particulier, en incluant esx pour le premier disque avec ESX installé, les informations sur le modèle et le fournisseur, ou le nom du pilote de périphérique VMkernel. Par exemple, pour préférer un disque avec le nom de modèle ST3120814A et n'importe quel disque qui utilise le pilote mptsas au lieu d'un disque local normal, l'argument est --firstdisk=ST3120814A,mptsas,local. Vous pouvez utiliser localesx pour le stockage local contenant une image ESXi ou remoteesx pour le stockage à distance contenant une image ESXi.

--ignoressd
Exclut les disques SSD de toute possibilité de partitionnement. Cette option peut être utilisée avec la commande install et l'option --firstdisk. Cette option a priorité sur l'option --firstdisk. Cette option n'est pas compatible avec les options --drive ou --disk et les commandes upgrade et installorupgrade. Pour savoir comment empêcher le formatage SSD lors du partitionnement automatique, consultez la documentation Stockage vSphere.
--overwritevsan
Vous devez utiliser l'option --overwritevsan lors de l'installation d' ESXi sur un disque SSD ou HDD (magnétique), c'est-à-dire sur un groupe de disques vSAN. Si vous utilisez cette option et qu'il n'existe aucune partition vSAN sur le disque sélectionné, l'installation échoue. Si vous installez ESXi sur un disque qui se trouve dans un groupe de disques vSAN, le résultat de l'installation dépend du disque sélectionné :
  • Si vous sélectionnez un SSD, le SSD et tous les HDD sous-jacents qui se trouvent dans le même groupe de disques sont effacés.
  • Si vous sélectionnez un HDD et que le nombre de groupes de disques est supérieur à deux, seul le HDD sélectionné est effacé.
  • Si vous sélectionnez un disque HDD et que le nombre de groupes de disques est égal ou inférieur à deux, le SDD et le HDD sélectionné sont effacés.

Pour plus d'informations sur la gestion des groupes de disques vSAN, consultez la documentation Stockage vSphere.

--overwritevmfs
Requis pour écraser une banque de données VMFS existante sur le disque avant l'installation.
--preservevmfs
Préserve une banque de données VMFS sur le disque pendant l'installation.
--novmfsondisk
Empêche la création d'une partition VMFS sur ce disque. Doit être utilisée avec --overwritevmfs si une partition VMFS existe sur le disque.
--systemdisk
Si vous utilisez un périphérique USB ou SD, systemDisk spécifie le disque persistant local sur lequel installer la partition ESX-OSData. Par exemple, install --firstdisk = usb --systemDisk=<diskID>. Par conséquent, les partitions de la banque de démarrage sont placées sur le périphérique USB, tandis que la partition OSData se trouve sur le disque spécifié dans le paramètre systemDisk.
--repartitionsystemdisk
Si vous utilisez un périphérique USB ou SD et que le disque local que vous spécifiez avec le paramètre systemDisk n'est pas vide ou qu'il contient une banque de données, vous pouvez utiliser repartitionSystemDisk pour vous assurer que le disque persistant est repartitionné avant utilisation.
Note : Si un disque persistant local n'est pas disponible ou si la taille du disque est inférieure à 32 Go, des messages d'avertissement s'affichent, mais l'installation se poursuit.
--forceunsupportedinstall

Bloque l'installation de CPU obsolètes.

installorupgrade

La commande install, upgrade ou installorupgrade est requise pour déterminer sur quel disque ESXi doit être installé ou mis à niveau.

--disk= or --drive=
Indique le disque à la partition. Dans la commande --disk= diskname, diskname peut être un nom de disque ou un chemin de système de fichiers de disque complet dans ESXi, par exemple :
  • Nom du disque : --disk=naa.6d09466044143600247aee55ca2a6405 ou
  • Chemin d'accès au périphérique : --disk=/vmfs/devices/disks/mpx.vmhba1:C0:T0:L0

Pour les formats de nom de disque acceptés, reportez-vous à Noms de périphériques de disques.

--firstdisk=
disk-type1,
[ disk-type2,...]
Note : Si votre système vSphere est de version antérieure à la version 8.0 Update 3 et dispose de DPU, vous spécifiez également un emplacement PCI : install --firstdisk --overwritevmfs --dpupcislots=<PCIeSlotID>. Pour les systèmes de version 8.0 Update 3 et versions ultérieures, le paramètre dpupcislots est obsolète.
Partitions pour le premier disque éligible trouvé. Par défaut, les disques éligibles sont définis dans l'ordre suivant :
  1. Stockage connecté localement (local)
  2. Stockage de réseau (remote)

Vous pouvez modifier l'ordre des disques en utilisant une liste séparée par des virgules ajoutée à l'argument. Si vous fournissez une liste de filtres, les paramètres par défaut sont écrasés. Vous pouvez combiner des filtres pour spécifier un disque en particulier, en incluant esx pour le premier disque avec ESX installé, les informations sur le modèle et le fournisseur, ou le nom du pilote de périphérique VMkernel. Par exemple, pour préférer un disque avec le nom de modèle ST3120814A et n'importe quel disque qui utilise le pilote mptsas au lieu d'un disque local normal, l'argument est --firstdisk=ST3120814A,mptsas,local. Vous pouvez utiliser localesx pour le stockage local contenant une image ESXi ou remoteesx pour le stockage à distance contenant une image ESXi.

--overwritevsan
Vous devez utiliser l'option --overwritevsan lors de l'installation d' ESXi sur un disque SSD ou HDD (magnétique), c'est-à-dire sur un groupe de disques vSAN. Si vous utilisez cette option et qu'il n'existe aucune partition vSAN sur le disque sélectionné, l'installation échoue. Si vous installez ESXi sur un disque qui se trouve dans un groupe de disques vSAN, le résultat de l'installation dépend du disque sélectionné :
  • Si vous sélectionnez un SSD, le SSD et tous les HDD sous-jacents qui se trouvent dans le même groupe de disques sont effacés.
  • Si vous sélectionnez un HDD et que le nombre de groupes de disques est supérieur à deux, seul le HDD sélectionné est effacé.
  • Si vous sélectionnez un disque HDD et que le nombre de groupes de disques est égal ou inférieur à deux, le SDD et le HDD sélectionné sont effacés.

Pour plus d'informations sur la gestion des groupes de disques vSAN, consultez la documentation Stockage vSphere.

--overwritevmfs

Installez ESXi si une partition VMFS existe sur le disque, mais qu'aucune installation d'ESX ou ESXi n'existe. Sauf si cette option est présente, le programme d'installation échoue si une partition VMFS existe sur le disque, mais qu'aucune installation d'ESX ou d'ESXi n'est présente.

keyboard (facultatif)

Configure le type de clavier pour le système.

keyboardType
Spécifie le mappage de clavier pour le type de clavier sélectionné. keyboardType doit être l'un des types suivants.
  • Belgian
  • Brazilian
  • Croatian
  • Czechoslovakian
  • Danish
  • Estonian
  • Finnish
  • Français
  • Allemand
  • Greek
  • Icelandic
  • Italian
  • Japonais
  • Latin American
  • Norwegian
  • Polish
  • Portuguese
  • Russian
  • Slovenian
  • Espagnol
  • Swedish
  • Swiss French
  • Swiss German
  • Turkish
  • Ukrainien
  • United Kingdom
  • États-Unis par défaut
  • US Dvorak

serialnum ou vmserialnum (facultatif)

La commande est prise en charge dans ESXi version 5.1 et versions ultérieures. Configure la licence. Si elle n'est pas incluse, ESXi s'installe en mode d'évaluation.

--esx=<license-key>

Précise la clé de licence vSphere à utiliser. Le format est un jeu de groupes de 5 caractères (XXXXX-XXXXX-XXXXX-XXXXX-XXXXX).

network (facultatif)

Spécifie une adresse réseau pour le système.

--bootproto=[dhcp|static]

Indique s'il convient d'obtenir les paramètres réseau à partir de DHCP ou de les définir manuellement.

--device=
Spécifie l'adresse MAC du réseau ou le nom du périphérique, au format vmnicNN, comme dans vmnic0. Cette option se rapporte au périphérique de liaison montante pour le commutateur virtuel.
--ip=
Définit une adresse IP pour la machine à installer, au format xxx.xxx.xxx.xxx. Requis avec l'option --bootproto=static et ignoré dans le cas contraire.
--gateway=
Désigne la passerelle par défaut sous la forme d'une adresse IP, au format xxx.xxx.xxx.xxx. Utilisé avec l'option --bootproto=static.
--nameserver=
Désigne le serveur de nom principal comme adresse IP. Utilisé avec l'option --bootproto=static. Omettez cette option si vous n'avez pas l'intention d'utiliser DNS.

L'option --nameserver peut accepter deux adresses IP. Par exemple :--nameserver="10.126.87.104[,10.126.87.120]"

--netmask=
Spécifie le masque de sous-réseau pour le système installé, au format 255.xxx.xxx.xxx. Utilisé avec l'option --bootproto=static.
--hostname=
Spécifie le nom d'hôte pour le système installé.
--vlanid= vlanid
Spécifie sur quel réseau VLAN se trouve le système. Utilisée avec l'option --bootproto=dhcp ou --bootproto=static. Définissez-la sur un nombre entier compris entre 1 et 4096.
--addvmportgroup=(0|1)
Précise s'il faut ajouter ou non le groupes de ports de réseau VM utilisé par des machines virtuelles. La valeur par défaut est 1.

paranoïd (facultatif)

Provoque l'interruption de l'installation par des messages d'avertissement. Si vous omettez cette commande, les messages d'avertissement sont consignés.

part ou partition (facultatif)

Crée une banque de données VMFS supplémentaire sur le système. Une seule banque de données peut être créée par disque. Ne peut pas être utilisée sur le même disque que la commande install. Une seule partition peut être spécifiée par disque et il doit s'agir uniquement d'une partition VMFS.

datastore name
Spécifie où la partition doit être montée.
--ondisk= or --ondrive=
Spécifie le disque ou le lecteur sur lequel la partition est créée.
--onfirstdisk=
disk-type1,
[ disk-type2,...]
Note : Si votre système vSphere est de version antérieure à la version 8.0 Update 3 et dispose de DPU, vous spécifiez également un emplacement PCI : install --firstdisk --overwritevmfs --dpupcislots=<PCIeSlotID>. Pour les systèmes de version 8.0 Update 3 et versions ultérieures, le paramètre dpupcislots est obsolète.
Partitions pour le premier disque éligible trouvé. Par défaut, les disques éligibles sont définis dans l'ordre suivant :
  1. Stockage connecté localement (local)
  2. Stockage de réseau (remote)

Vous pouvez modifier l'ordre des disques en utilisant une liste séparée par des virgules ajoutée à l'argument. Si vous fournissez une liste de filtres, les paramètres par défaut sont écrasés. Vous pouvez combiner des filtres pour spécifier un disque en particulier, en incluant esx pour le premier disque avec ESX installé, les informations sur le modèle et le fournisseur, ou le nom du pilote de périphérique VMkernel. Par exemple, pour préférer un disque avec le nom de modèle ST3120814A et n'importe quel disque qui utilise le pilote mptsas au lieu d'un disque local normal, l'argument est --onfirstdisk=ST3120814A,mptsas,local. Vous pouvez utiliser localesx pour le stockage local contenant une image ESXi ou remoteesx pour le stockage à distance contenant une image ESXi.

reboot (facultatif)

Redémarre la machine une fois l'installation basée sur un script effectuée.

<--noeject>
Le CD n'est pas éjecté après l'installation.

rootpw (requis)

Règle le mot de passe racine pour le système.

--iscrypted
Précise que le mot de passe est crypté.
password
Précise la valeur du mot de passe.

mise à niveau

La commande install, upgrade ou installorupgrade est requise pour déterminer sur quel disque ESXi doit être installé ou mis à niveau.

--disk= or --drive=
Indique le disque à la partition. Dans la commande --disk= diskname, diskname peut être un nom de disque ou un chemin de système de fichiers de disque complet dans ESXi, par exemple :
  • Nom du disque : --disk=naa.6d09466044143600247aee55ca2a6405 ou
  • Chemin d'accès au périphérique : --disk=/vmfs/devices/disks/mpx.vmhba1:C0:T0:L0

Pour les formats de nom de disque acceptés, reportez-vous à Noms de périphériques de disques.

--firstdisk=
disk-type1,
[ disk-type2,...]
Partitions pour le premier disque éligible trouvé. Par défaut, les disques éligibles sont définis dans l'ordre suivant :
  1. Stockage connecté localement (local)
  2. Stockage de réseau (remote)

Vous pouvez modifier l'ordre des disques en utilisant une liste séparée par des virgules ajoutée à l'argument. Si vous fournissez une liste de filtres, les paramètres par défaut sont écrasés. Vous pouvez combiner des filtres pour spécifier un disque en particulier, en incluant esx pour le premier disque avec ESX installé, les informations sur le modèle et le fournisseur, ou le nom du pilote de périphérique VMkernel. Par exemple, pour préférer un disque avec le nom de modèle ST3120814A et n'importe quel disque qui utilise le pilote mptsas au lieu d'un disque local normal, l'argument est --firstdisk=ST3120814A,mptsas,local. Vous pouvez utiliser localesx pour le stockage local contenant une image ESXi ou remoteesx pour le stockage à distance contenant une image ESXi.

%include ou include (facultatif)

Spécifie un autre script d'installation à analyser. Cette commande est traitée d'une manière similaire à une commande multiligne, mais elle ne prend qu'un seul argument.

filename
Par exemple : %include part.cfg

%pre (facultatif)

Indique un script à exécuter avant que la configuration kickstart ne soit évaluée. Par exemple, vous pouvez l'utiliser pour générer les fichiers que le fichier kickstart doit inclure.

--interpreter
=[python|busybox]
Indique un interprète à utiliser. L'interprète par défaut est busybox.

%post (facultatif)

Exécute le script spécifié une fois que le module a été installé. Si vous précisez plusieurs sections %post, elles sont exécutées dans leur ordre d'apparition dans le script d'installation.

--interpreter
=[python|busybox]
Indique un interprète à utiliser. L'interprète par défaut est busybox.
--timeout=secs
Précise un délai d'expiration pour l'exécution du script. Si le script n'est pas complété à l'expiration du délai, l'arrêt du script est forcé.
--ignorefailure
=[true|false]
Si le paramètre est vrai (true), l'installation est considérée comme ayant réussi même si le script %post s'arrête avec une erreur.

%firstboot

Crée un script init qui s'exécute uniquement lors du premier démarrage. Le script n'a pas d'incidence sur les démarrages suivants. Si plusieurs sections %firstboot sont spécifiées, elles sont exécutées dans l'ordre dans lequel elles apparaissent dans le fichier kickstart.

Note : Vous ne pouvez pas vérifier la sémantique des scripts %firstboot tant que le système n'aura pas démarré pour la première fois. Un script %firstboot peut contenir des erreurs pouvant être catastrophiques qui ne sont pas exposées tant que l'installation n'est pas terminée.
Important : Le script %firstboot ne s'exécute pas, si le démarrage sécurisé est activé sur l'hôte ESXi.
--interpreter
=[python|busybox]
Indique un interprète à utiliser. L'interprète par défaut est busybox.
Note : Vous ne pouvez pas vérifier la sémantique des scripts %firstboot tant que le système n'aura pas démarré pour la première fois. Si le script contient des erreurs, elles ne seront exposées qu'une fois l'installation terminée.