Puede utilizar un script predeterminado para realizar una instalación estándar ESXi en el primer disco detectado.
Durante una instalación de ESXi, puede usar un script predeterminado para realizar una instalación estándar en el primer disco detectado y el archivo de configuración del cargador de arranque para especificar el kernel, las opciones de kernel y los módulos de arranque que utiliza el cargador de arranque mboot.c32 o mboot.efi para la instalación.
Acerca del script de instalación predeterminado ks.cfg
El instalador de ESXi incluye un script de instalación predeterminado que realiza una instalación estándar en el primer disco detectado.
El script de instalación ks.cfg predeterminado está ubicado en el disco RAM inicial en /etc/vmware/weasel/ks.cfg. Puede especificar la ubicación del archivo ks.cfg predeterminado con la opción de arranque ks=file://etc/vmware/weasel/ks.cfg. Consulte Introducir las opciones de arranque para ejecutar un script de instalación o actualización.
Cuando instale ESXi con el script ks.cfg, la contraseña raíz predeterminada será myp@ssw0rd.
No puede modificar el script predeterminado en los medios de instalación. Después de la instalación, puede utilizar vSphere Client para iniciar sesión en vCenter Server que administra el host ESXi y modificar la configuración predeterminada.
Con vSphere 8.0, si el sistema tiene unidades de procesamiento de datos (Data Processing Units, DPU), se utiliza el script ks.cfg también para instalar ESXi en las DPU.
El script predeterminado contiene los siguientes 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() )
Acerca del archivo boot.cfg
El archivo de configuración del cargador de arranque boot.cfg especifica el kernel, las opciones del kernel y los módulos de arranque que utiliza el cargador de arranque mboot.c32 o mboot.efi en una instalación de ESXi.
El archivo boot.cfg se incluye en el instalador de ESXi. Puede modificar la línea kernelopt del archivo boot.cfg para especificar la ubicación de un script de instalación o para pasar otras opciones de arranque.
# 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.
Los comandos de boot.cfg configuran el cargador de arranque.
| Comando | Descripción |
|---|---|
title=STRING |
Establece el título del cargador de arranque como STRING. |
prefix=STRING |
(Opcional) Agrega DIRPATH/ frente a cada FILEPATH en los comandos kernel= y modules= que no empiezan con / o con http://. |
kernel=FILEPATH |
Establece la ruta de acceso del kernel como FILEPATH. |
kernelopt=STRING |
Anexa STRING a las opciones de arranque del kernel. |
modules=FILEPATH1 --- FILEPATH2... --- FILEPATHn |
Enumera los módulos que se van a cargar, separados por tres guiones (---). |
Consulte Crear una imagen ISO de instalador con un script de instalación o actualización personalizado y Arranque de red del instalador de ESXi.
Ubicaciones admitidas para scripts de instalación o actualización
En instalaciones y actualizaciones generadas por script, el instalador de ESXi puede acceder al script de la instalación o actualización, que también se conoce como el archivo inicial, desde varias ubicaciones.
Se admiten las siguientes ubicaciones para el script de instalación o actualización:
- CD/DVD. Consulte Crear una imagen ISO de instalador con un script de instalación o actualización personalizado.
- Unidad flash USB. Consulte Crear una unidad flash USB para almacenar el script de instalación o actualización de ESXi.
- Una ubicación local de red a la que se puede acceder mediante los siguientes protocolos: NFS, HTTP, HTTPS, FTP
Ruta de acceso del script de instalación o actualización
Puede especificar la ruta de acceso de un script de instalación o actualización.
ks=http://XXX.XXX.XXX.XXX/kickstart/KS.CFG es la ruta de acceso del script de instalación de ESXi, dondeXXX.XXX.XXX.XXXes la dirección IP del equipo donde reside el script. Consulte Instalar ESXi mediante un script.
Para iniciar un script de instalación desde una instalación interactiva, escriba la opción ks= de forma manual. Consulte Introducir las opciones de arranque para ejecutar un script de instalación o actualización.
Comandos de scripts de instalación y actualización
Para modificar el script predeterminado de instalación o actualización, o para crear su propio script, use comandos compatibles. Use comandos compatibles en el script de instalación, que se especifica mediante un comando de arranque cuando se arranca el instalador.
Para determinar en qué disco instalar o actualizar ESXi, el script de instalación requiere uno de los comandos siguientes: install, upgrade o installorupgrade. El comando install crea las particiones predeterminadas, que incluyen un almacén de datos de VMFS que ocupa todo el espacio disponible después de que se crean las demás particiones.
Con vSphere 8.0, si el sistema tiene unidades de procesamiento de datos (DPU) admitidas, considere siempre la posibilidad de instalación, reinstalación o actualización de ESXi en las DPU además de ESXi en los hosts. La actualización de ESXi y la actualización en las DPU no es compatible con el método interactivo o con scripts, solo se puede usar vSphere Lifecycle Manager.
accepteula o vmaccepteula (obligatorio)
Acepta el contrato de licencia de ESXi.
clearpart (opcional)
Borra las particiones existentes del disco. Requiere que se especifique el comando install. Edite cuidadosamente el comando clearpart en sus scripts existentes.
- --drives=
- Quita las particiones en las unidades especificadas.
- --alldrives
-
Ignora el requisito de
--drives=y permite borrar las particiones de cada unidad. - --ignoredrives=
-
Elimina las particiones en todas las unidades, excepto las especificadas. Es obligatorio a menos que se especifiquen las marcas
--drives=o--alldrives. - --overwritevmfs
- Permite sobrescribir las particiones de VMFS en las unidades especificadas. De forma predeterminada, no se permite sobrescribir las particiones de VMFS.
- --firstdisk=
-
tipo-disco1 -
[tipo-disco2,...]
dryrun (opcional)
Analiza y comprueba el script de instalación. No ejecuta la instalación.
instalar
Especifica que se trata de una instalación nueva. Se requieren los comandos install, upgrade o installorupgrade para determinar en qué disco se debe instalar o actualizar ESXi.
- --disk= or --drive=
-
Especifica el disco que se particionará. En el comando
--disk=diskname, diskname puede ser un nombre de disco o una ruta completa de sistema de archivos de disco en ESXi, por ejemplo:- Nombre de disco:
--disk=naa.6d09466044143600247aee55ca2a6405o - Ruta de acceso del dispositivo:
--disk=/vmfs/devices/disks/mpx.vmhba1:C0:T0:L0
Para conocer los formatos admitidos de nombre de disco, consulte Nombre de los dispositivos de disco.
- Nombre de disco:
- --firstdisk=
- tipo-disco1,
- [ tipo-disco2,...]
-
Nota: Si la versión del sistema vSphere es anterior a la 8.0 Update 3 y tiene DPU, también debe especificar una ranura PCI:
install --firstdisk --overwritevmfs --dpupcislots=<PCIeSlotID>. Para los sistemas con la versión 8.0 Update 3 y posteriores, el parámetro dpupcislots ha quedado obsoleto. - --ignoressd
- Excluye los discos de estado sólido de los que satisfacen las condiciones para el particionamiento. Esta opción puede utilizarse con el comando install y la opción --firstdisk. Esta opción tiene prioridad sobre la opción --firstdisk. Esta opción no es válida con las opciones --drive o --disk ni con los comandos upgrade o installorupgrade. Consulte la documentación de Almacenamiento de vSphere para obtener más información sobre la prevención del formateo de SSD durante la creación automática de particiones.
- --overwritevsan
-
Debe usar la opción
--overwritevsan cuando instale
ESXi en un disco, ya sea SSD o HDD (magnética), que forme parte de un grupo de discos de
vSAN. Si usa esta opción y no hay ninguna partición de
vSAN en el disco seleccionado, se produce un error en la instalación. Al instalar
ESXi en un disco que forma parte de un grupo de discos de
vSAN, el resultado depende del disco que se selecciona:
- Si selecciona una SSD, esta y todas las HDD subyacentes del mismo grupo de discos se borrarán.
- Si selecciona una HDD y el tamaño del grupo de discos es mayor que 2, solo se borrará la HDD seleccionada.
- Si selecciona una HDD y el tamaño del grupo de discos es 2 o menos, se borrarán la SSD y la HDD seleccionada.
Para obtener más información acerca de la administración de grupos de discos de vSAN, consulte la documentación de Almacenamiento de vSphere.
- --overwritevmfs
- Es obligatorio para sobrescribir un almacén de datos existente de VMFS en el disco antes de la instalación.
- --preservevmfs
- Conserva el almacén de datos existente de VMFS en el disco durante la instalación.
- --novmfsondisk
- Impide que se cree una partición de VMFS en este disco. Debe utilizarse con --overwritevmfs si existe una partición de VMFS en el disco.
- --systemdisk
- Si utiliza un dispositivo USB o SD, systemDisk especifica el disco persistente local en el que se instalará la partición ESX-OSData. Por ejemplo, install --firstdisk = usb --systemDisk=<diskID>. Como resultado, las particiones de banco de arranque se colocan en el dispositivo USB, mientras que la partición de OSData se encuentra en el disco especificado en el parámetro systemDisk.
- --repartitionsystemdisk
- Si utiliza un dispositivo USB o SD y el disco local que especificó con el parámetro systemDisk no está vacío o contiene un almacén de datos, puede usar repartitionSystemDisk para asegurarse de que el disco persistente se vuelva a particionar antes de usarlo.
- --forceunsupportedinstall
-
Bloquea la instalación de CPU obsoletas.
installorupgrade
Se requieren los comandos install, upgrade o installorupgrade para determinar en qué disco se debe instalar o actualizar ESXi.
- --disk= or --drive=
-
Especifica el disco que se particionará. En el comando
--disk=diskname, diskname puede ser un nombre de disco o una ruta completa de sistema de archivos de disco en ESXi, por ejemplo:- Nombre de disco:
--disk=naa.6d09466044143600247aee55ca2a6405o - Ruta de acceso del dispositivo:
--disk=/vmfs/devices/disks/mpx.vmhba1:C0:T0:L0
Para conocer los formatos admitidos de nombre de disco, consulte Nombre de los dispositivos de disco.
- Nombre de disco:
- --firstdisk=
- tipo-disco1,
- [ tipo-disco2,...]
-
Nota: Si la versión del sistema vSphere es anterior a la 8.0 Update 3 y tiene DPU, también debe especificar una ranura PCI:
install --firstdisk --overwritevmfs --dpupcislots=<PCIeSlotID>. Para los sistemas con la versión 8.0 Update 3 y posteriores, el parámetro dpupcislots ha quedado obsoleto. - --overwritevsan
-
Debe usar la opción
--overwritevsan cuando instale
ESXi en un disco, ya sea SSD o HDD (magnética), que forme parte de un grupo de discos de
vSAN. Si usa esta opción y no hay ninguna partición de
vSAN en el disco seleccionado, se produce un error en la instalación. Al instalar
ESXi en un disco que forma parte de un grupo de discos de
vSAN, el resultado depende del disco que se selecciona:
- Si selecciona una SSD, esta y todas las HDD subyacentes del mismo grupo de discos se borrarán.
- Si selecciona una HDD y el tamaño del grupo de discos es mayor que 2, solo se borrará la HDD seleccionada.
- Si selecciona una HDD y el tamaño del grupo de discos es 2 o menos, se borrarán la SSD y la HDD seleccionada.
Para obtener más información acerca de la administración de grupos de discos de vSAN, consulte la documentación de Almacenamiento de vSphere.
- --overwritevmfs
-
Instale ESXi si en el disco existe una partición de VMFS, pero no una instalación de ESX ni ESXi. A menos que esta opción esté presente, se producirá un error en el instalador si en el disco existe una partición de VMFS, pero no una instalación de ESX o de ESXi.
keyboard (opcional)
Configura el tipo de teclado para el sistema.
- keyboardType
-
Especifica el mapa del teclado para el tipo de teclado seleccionado.
keyboardType debe ser uno de los siguientes tipos.
- Belgian
- Brazilian
- Croatian
- Czechoslovakian
- Danish
- Estonian
- Finnish
- Francés
- Alemán
- Greek
- Icelandic
- Italian
- Japonés
- Latin American
- Norwegian
- Polish
- Portuguese
- Russian
- Slovenian
- Español
- Swedish
- Swiss French
- Swiss German
- Turkish
- Ukrainian
- United Kingdom
- Inglés americano (predeterminado)
- US Dvorak
serialnum o vmserialnum (opcional)
El comando se admite en ESXi 5.1 y versiones posteriores. Configura las licencias. Si no se incluye, ESXi se instala en modo de evaluación.
- --esx=<license-key>
-
Especifica la clave de licencia de vSphere que se utilizará. El formato corresponde a cinco grupos de cinco caracteres (XXXXX-XXXXX-XXXXX-XXXXX-XXXXX).
network (opcional)
Especifica una dirección de red para el sistema.
- --bootproto=[dhcp|static]
-
Especifica si la configuración de red se debe obtener desde DHCP o si se debe configurar de forma manual.
- --device=
-
Especifica la dirección MAC de la tarjeta de red o el nombre del dispositivo, con el formato
vmnicNN(por ejemplo,vmnic0). Esta opción hace referencia al dispositivo del vínculo superior para el conmutador virtual. - --ip=
-
Establece una dirección IP para el equipo que se va a instalar, con el formato
xxx.xxx.xxx.xxx. Es obligatorio cuando se usa la opción --bootproto=static y se ignora en los demás casos. - --gateway=
-
Designa la puerta de enlace predeterminada como una dirección IP, con el formato
xxx.xxx.xxx.xxx. Se usa con la opción --bootproto=static. - --nameserver=
-
Designa el servidor de nombre principal como una dirección IP. Se usa con la opción
--bootproto=static. Omita esta opción si no va a usar DNS.La opción
--nameserverpuede admitir dos direcciones IP. Por ejemplo:--nameserver="10.126.87.104[,10.126.87.120]" - --netmask=
-
Especifica la máscara de subred para el sistema instalado, con el formato
255.xxx.xxx.xxx. Se usa con la opción--bootproto=static. - --hostname=
- Especifica el nombre de host para el sistema instalado.
- --vlanid= vlanid
-
Especifica la VLAN en la que reside el sistema. Se usa con las opciones
--bootproto=dhcp o
--bootproto=static. Se establece como un valor entero entre 1 y 4096. - --addvmportgroup=(0|1)
- Especifica si se debe agregar el grupo de puertos de la red de máquinas virtuales (VM), que utilizan las máquinas virtuales. El valor predeterminado es 1.
paranoid (opcional)
Hace que los mensajes de advertencia interrumpan la instalación. Si omite este comando, los mensajes de advertencia se registran.
part o partition (opcional)
Crea un almacén de datos de VMFS en el sistema. Solo se puede crear un almacén de datos por cada disco. No se puede usar en el mismo disco que el comando install. Solo se puede especificar una partición por cada disco y solo puede ser una partición de VMFS.
- datastore name
- Especifica dónde se debe montar la partición.
- --ondisk= or --ondrive=
- Especifica el disco o la unidad en la que se crea la partición.
- --onfirstdisk=
- tipo-disco1,
- [ tipo-disco2,...]
-
Nota: Si la versión del sistema vSphere es anterior a la 8.0 Update 3 y tiene DPU, también debe especificar una ranura PCI:Particiona el primer disco encontrado que satisface las condiciones. De forma predeterminada, los discos que satisfacen las condiciones se ordenan en el orden siguiente:
install --firstdisk --overwritevmfs --dpupcislots=<PCIeSlotID>. Para los sistemas con la versión 8.0 Update 3 y posteriores, el parámetro dpupcislots ha quedado obsoleto.- Almacenamiento conectado a nivel local (local)
- Almacenamiento en red (remote)
Puede cambiar el orden de los discos anexando una lista separada por comas al argumento. Si proporciona una lista de filtros, se sobrescribe la configuración predeterminada. Puede combinar filtros para especificar un disco en particular, lo que incluye esx para el primer disco en el que se haya instalado ESX, la información de modelo y proveedor, o el nombre del controlador del dispositivo VMkernel. Por ejemplo, para dar preferencia a un disco con el nombre de modelo ST3120814A y a cualquier disco que use el controlador mptsas en lugar de un disco local normal, el argumento es --onfirstdisk=ST3120814A,mptsas,local. Puede utilizar localesx para el almacenamiento local que contiene la imagen de ESXi o remoteesx para el almacenamiento remoto que contiene la imagen deESXi.
reboot (opcional)
Reinicia la máquina después de que finaliza la instalación generada por script.
- <--noeject>
- No se expulsa el CD después de la instalación.
rootpw (obligatorio)
Configura la contraseña raíz para el sistema.
- --iscrypted
- Especifica que la contraseña está cifrada.
- password
- Especifica el valor de la contraseña.
actualizar
Se requieren los comandos install, upgrade o installorupgrade para determinar en qué disco se debe instalar o actualizar ESXi.
- --disk= or --drive=
-
Especifica el disco que se particionará. En el comando
--disk=diskname, diskname puede ser un nombre de disco o una ruta completa de sistema de archivos de disco en ESXi, por ejemplo:- Nombre de disco:
--disk=naa.6d09466044143600247aee55ca2a6405o - Ruta de acceso del dispositivo:
--disk=/vmfs/devices/disks/mpx.vmhba1:C0:T0:L0
Para conocer los formatos admitidos de nombre de disco, consulte Nombre de los dispositivos de disco.
- Nombre de disco:
- --firstdisk=
- tipo-disco1,
- [ tipo-disco2,...]
-
Particiona el primer disco encontrado que satisface las condiciones. De forma predeterminada, los discos que satisfacen las condiciones se ordenan en el orden siguiente:
- Almacenamiento conectado a nivel local (local)
- Almacenamiento en red (remote)
Puede cambiar el orden de los discos anexando una lista separada por comas al argumento. Si proporciona una lista de filtros, se sobrescribe la configuración predeterminada. Puede combinar filtros para especificar un disco en particular, lo que incluye esx para el primer disco en el que se haya instalado ESX, la información de modelo y proveedor, o el nombre del controlador del dispositivo VMkernel. Por ejemplo, para dar preferencia a un disco con el nombre de modelo ST3120814A y a cualquier disco que use el controlador mptsas en lugar de un disco local normal, el argumento es --firstdisk=ST3120814A,mptsas,local. Puede utilizar localesx para el almacenamiento local que contiene la imagen de ESXi o remoteesx para el almacenamiento remoto que contiene la imagen deESXi.
%include o include (opcional)
Especifica otro script de instalación para analizar. Este comando se utiliza de manera similar a un comando de varias líneas, pero usa solamente un argumento.
- filename
- Por ejemplo: %include part.cfg
%pre (opcional)
Especifica un script para ejecutar antes de que se evalúe la configuración de inicio. Por ejemplo, puede usarse para generar los archivos que incluirá el archivo de inicio.
- --interpreter
- =[python|busybox]
- Especifica el intérprete que se usará. El valor predeterminado es busybox.
%post (opcional)
Ejecuta el script especificado después de que finaliza la instalación del paquete. Si se especifican varias secciones %post, se ejecutan en el orden en que aparecen en el script de instalación.
- --interpreter
- =[python|busybox]
- Especifica el intérprete que se usará. El valor predeterminado es busybox.
- --timeout=secs
- Especifica el límite de tiempo de espera para la ejecución del script. Si el script no finalizó cuando se agota el tiempo de espera, el script se interrumpe de manera forzosa.
- --ignorefailure
- =[true|false]
- Si se configura como true, la instalación se considera correcta incluso si el script %post finalizó con un error.
%firstboot
Crea un script init que se ejecuta solamente durante el primer arranque. El script no afecta los arranques posteriores. Si se especifican varias secciones %firstboot, se ejecutan en el orden en que aparecen en el archivo de inicio.
- --interpreter
- =[python|busybox]
Nombre de los dispositivos de disco
Para los comandos del script de instalación install, upgrade e installorupgrade, es necesario usar los nombres de dispositivos de disco.
| Formato | Ejemplo | Descripción |
|---|---|---|
| NAA | naa.6d09466044143600247aee55ca2a6405 | Identificador SCSI INQUIRY |
| EUI | eui.3966623838646463 | Identificador SCSI INQUIRY |
| T10 | t10.SanDisk00Cruzer_Blade000000004C530001171118101244 | Identificador SCSI INQUIRY |
| VML | vml.00025261 | Identificador de VMkernel heredado |
| MPX | mpx.vmhba0:C0:T0:L0 | Identificador basado en rutas |
Para obtener más información sobre los nombres de dispositivos de almacenamiento, consulte Identificadores y nombres de dispositivos de almacenamiento en la documentación de Almacenamiento de vSphere.
