Vous pouvez utiliser un script par défaut pour effectuer une installation d'ESXi standard sur le premier disque détecté.
Lors d'une installation d'ESXi, vous pouvez utiliser un script par défaut pour effectuer une installation standard sur le premier disque détecté, ainsi que le fichier de configuration du chargeur de démarrage pour spécifier le noyau, les options du noyau et les modules de démarrage que le chargeur de démarrage mboot.c32 ou mboot.efi utilise pour l'installation.
À propos du script d'installation ks.cfg par défaut
Le programme d'installation ESXi contient un script d'installation par défaut qui effectue une installation standard sur le premier disque dur détecté.
Le script d'installation ks.cfg par défaut se trouve dans /etc/vmware/weasel/ks.cfg dans le disque RAM initial. Vous pouvez spécifier l'emplacement du fichier ks.cfg par défaut avec l'option de démarrage ks=file://etc/vmware/weasel/ks.cfg
. Reportez-vous à la section Entrer les options de démarrage pour exécuter un script d'installation ou de mise à niveau.
Lorsque vous installez ESXi en utilisant le script ks.cfg, le mot de passe racine par défaut est myp@ssw0rd
.
Vous ne pouvez pas modifier le script par défaut sur le support d'installation. Après l'installation, vous pouvez utiliser vSphere Client pour vous connecter au vCenter Server qui gère l'hôte ESXi et modifier les paramètres par défaut.
Avec vSphere 8.0, si votre système dispose d'unités de traitement des données (DPU), vous utilisez le script ks.cfg également pour installer ESXi sur des DPU.
Le script par défaut contient les commandes suivantes :
#
# 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() )
À 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.
# 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.
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 :
- CD/DVD. Reportez-vous à la section Créer une image ISO du programme d'installation avec un script d'installation ou de mise à niveau personnalisé.
- Clé USB. Reportez-vous à la section Créer une clé USB pour stocker le script d'installation ou de mise à niveau ESXi.
- Un emplacement réseau accessible via les protocoles suivants : NFS, HTTP, HTTPS, FTP
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.
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,...]
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.
- Nom du disque :
- --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. - --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.
- --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.
- Nom du disque :
- --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. - --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 dansvmnic0
. 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 :Partitions pour le premier disque éligible trouvé. Par défaut, les disques éligibles sont définis dans l'ordre suivant :
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.- Stockage connecté localement (local)
- 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.
- Nom du disque :
- --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 :
- Stockage connecté localement (local)
- 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.
- --interpreter
- =[python|busybox]
Noms de périphériques de disques
Les commandes de script d'installation install, upgrade et installorupgrade requièrent l'utilisation de noms de périphériques de disques.
Format | Exemple | Description |
---|---|---|
NAA | naa.6d09466044143600247aee55ca2a6405 | Identifiant SCSI INQUIRY |
EUI | eui.3966623838646463 | Identifiant SCSI INQUIRY |
T10 | t10.SanDisk00Cruzer_Blade000000004C530001171118101244 | Identifiant SCSI INQUIRY |
VML | vml.00025261 | Identifiant VMkernel hérité |
MPX | mpx.vmhba0:C0:T0:L0 | Identificateur basé sur le chemin d'accès |
Pour plus d'informations sur les noms des périphériques de stockage, reportez-vous à la section Noms et identifiants de périphériques de stockage dans la documentation Stockage vSphere.