El script de instalación o actualización es un archivo de texto que contiene los comandos compatibles (por ejemplo, ks.cfg).

La sección de comandos del script contiene las opciones de instalación de ESXi. Esta sección es obligatoria y debe aparecer primero en el script.

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.

El archivo boot.cfg tiene la siguiente sintaxis:
# 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.

Tabla 1. Comandos de boot.cfg.
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:

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.

Nota: El uso de dispositivos SD y USB para almacenar particiones de ESX-OSData está cayendo es desuso. Puede usar dispositivos SD y USB solo para crear particiones de banco de arranque, boot-bank 0 y boot-bank 1. También puede proporcionar un disco persistente de 32 GB como mínimo para instalar la partición ESX-OSData. Para definir estos discos, utilice el parámetro systemDisk en el comando install.

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,...]
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.
Particiona el primer disco encontrado que satisface las condiciones. De forma predeterminada, los discos que satisfacen las condiciones se ordenan en el orden siguiente:
  1. Almacenamiento conectado a nivel local (local)
  2. 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 ESXi, 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.

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.6d09466044143600247aee55ca2a6405 o
  • 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.

--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.
Particiona el primer disco encontrado que satisface las condiciones. De forma predeterminada, los discos que satisfacen las condiciones se ordenan en el orden siguiente:
  1. Almacenamiento conectado a nivel local (local)
  2. 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.

--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.
Nota: Si un disco persistente local no está disponible o el tamaño del disco es inferior a 32 GB, verá mensajes de advertencia, pero la instalación continúa.
--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.6d09466044143600247aee55ca2a6405 o
  • 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.

--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.
Particiona el primer disco encontrado que satisface las condiciones. De forma predeterminada, los discos que satisfacen las condiciones se ordenan en el orden siguiente:
  1. Almacenamiento conectado a nivel local (local)
  2. 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.

--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 --nameserver puede 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: 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.
Particiona el primer disco encontrado que satisface las condiciones. De forma predeterminada, los discos que satisfacen las condiciones se ordenan en el orden siguiente:
  1. Almacenamiento conectado a nivel local (local)
  2. 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.6d09466044143600247aee55ca2a6405 o
  • 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.

--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:
  1. Almacenamiento conectado a nivel local (local)
  2. 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.

Nota: No es posible comprobar la semántica de los scripts %firstboot hasta el primer arranque del sistema. Un script %firstboot puede contener errores potencialmente catastróficos que no se detectan sino hasta después de la finalización de la instalación.
Importante: El script %firstboot no se ejecuta si el arranque seguro está habilitado en el host ESXi.
--interpreter
=[python|busybox]
Especifica el intérprete que se usará. El valor predeterminado es busybox.
Nota: No es posible comprobar la semántica del script %firstboot hasta el primer arranque del sistema. Si el script contiene errores, no se detectan sino hasta después de la finalización de la instalación.