Cómo actualizar Proxmox VE 7 a Proxmox VE 8

Esta guía describe la actualización in situ de un nodo Proxmox VE 7 a Proxmox VE 8 con apt. La actualización lleva el sistema de Debian 11 Bullseye a Debian 12 Bookworm y sustituye el kernel 5.15 por uno más reciente. Planifique un tiempo de inactividad: el nodo debe reiniciarse al menos una vez y, normalmente, dos.

Antes de empezar

Requisitos

Compruebe lo siguiente antes de tocar ningún repositorio:

• todos los nodos ejecutan los últimos paquetes de Proxmox VE 7.4 (pve-manager 7.4-15 o posterior);
• al menos 5 GB de espacio libre en el sistema de archivos raíz;
• el clúster está en buen estado, si el nodo forma parte de uno;
• dispone de acceso al servidor que no depende de su red, como IP-KVM;
• existe una copia de seguridad válida y probada de todas las máquinas virtuales y contenedores.

Compruebe el espacio libre en el sistema de archivos raíz:

df -h /

Cómo conectarse al nodo

Conéctese por SSH o mediante IP-KVM. Con SSH, inicie una sesión de tmux para que la actualización siga en marcha si se pierde la conexión:

apt update
apt install tmux
tmux new -s upgrade

Si se pierde la conexión, vuelva a conectarse y regrese a la sesión:

tmux attach -t upgrade

La opción más segura es IP-KVM, porque sigue funcionando aunque la red del nodo no se levante tras el reinicio. Para conectarse a un servidor dedicado mediante IP-KVM, consulte Conexión a IDRAC KVM o Guía de acceso IP-KVM mediante OpenVPN (servidores DC2, DC3).

Máquinas virtuales y contenedores en el nodo

Apague las máquinas virtuales y los contenedores del nodo o migre a otro nodo los que deban seguir funcionando. Se admite la migración desde una versión anterior de Proxmox VE a una más reciente. No se admite la migración de una versión más reciente a una anterior.

Paso 1. Actualizar Proxmox VE 7 a la versión 7.4

La herramienta de comprobación pve7to8 y una ruta de actualización segura solo están disponibles en los últimos paquetes de la versión 7.4. Puede instalar las actualizaciones en la interfaz web o desde la línea de comandos.

Configurar los repositorios

Abra el nodo en la interfaz web y vaya a Updates → Repositories.

Si no tiene una suscripción de pago, seleccione el repositorio pve-enterprise y haga clic en Disable. Este repositorio requiere una clave de suscripción.

Haga clic en Add, seleccione No-Subscription y haga clic en Add en el cuadro de diálogo.

Instalar las actualizaciones

Vaya a Updates y haga clic en Refresh. Espere a que se actualice la lista de paquetes.

Haga clic en Upgrade. Se abre una ventana de terminal. Cuando le pregunte si desea continuar, introduzca Y y pulse Enter.

Espere a que termine el proceso y no cierre la ventana. Al final, la salida le pedirá que reinicie el nodo.

La misma actualización desde la línea de comandos. Sin suscripción de pago, desactive primero el repositorio enterprise y añada el de no-subscription, como en la interfaz web anterior:

sed -i 's/^deb/#deb/' /etc/apt/sources.list.d/pve-enterprise.list
echo "deb http://download.proxmox.com/debian/pve bullseye pve-no-subscription" > /etc/apt/sources.list.d/pve-no-subscription.list

A continuación, instale las actualizaciones:

apt update
apt dist-upgrade

deb http://archive.debian.org/debian bullseye main contrib
deb http://archive.debian.org/debian-security bullseye-security main contrib

Estas líneas solo son necesarias para terminar el Paso 1. En el Paso 3, sustitúyalas por las líneas de Bookworm que se muestran allí en lugar de ejecutar sed.

Reiniciar y comprobar la versión

Reinicie el nodo:

reboot

Cuando el nodo arranque, actualice la página del navegador y compruebe la versión en Summary del nodo, o ejecute:

pveversion

La salida debe mostrar 7.4-15 o posterior.

Paso 2. Ejecutar la herramienta de comprobación pve7to8

Proxmox VE 7.4 incluye el script pve7to8. Solo comprueba el sistema e informa de problemas; no cambia nada. Ejecútelo con todas las comprobaciones activadas:

pve7to8 --full

Revise el resultado:

• los elementos FAIL deben corregirse antes de la actualización;
• los elementos WARN deben leerse y evaluarse, aunque no bloqueen la actualización;
• tras cada corrección, ejecute de nuevo el script para confirmar que el problema ha desaparecido.

Paso 3. Cambiar los repositorios a Bookworm

Repositorios de Debian

Sustituya Bullseye por Bookworm en la lista de orígenes principal:

sed -i 's/bullseye/bookworm/g' /etc/apt/sources.list

Si cambió a archive.debian.org en el Paso 1, sed apuntaría las líneas a una ruta de Bookworm que no existe en el archivo. En su lugar, sustituya el contenido de /etc/apt/sources.list por las líneas estándar de Debian 12:

deb http://deb.debian.org/debian bookworm main contrib
deb http://deb.debian.org/debian bookworm-updates main contrib
deb http://security.debian.org/debian-security bookworm-security main contrib

Después, asegúrese de que no quedan entradas de Bullseye en ningún archivo:

grep -r bullseye /etc/apt/sources.list /etc/apt/sources.list.d/

Si el comando encuentra líneas, actualícelas a Bookworm o coméntelas con #. Elimine cualquier línea de backports: la actualización no se probó con paquetes de backports.

Compruebe también que no hay paquetes retenidos (held) ni a medio instalar. Ambos comandos deben devolver una salida vacía:

apt-mark showhold
dpkg --audit

Repositorio de Proxmox VE

El nombre del archivo del repositorio depende de cómo se añadió. Primero liste los archivos:

ls /etc/apt/sources.list.d/

Sin suscripción, actualice el archivo que contiene la línea pve-no-subscription. En un sistema instalado desde la ISO, suele ser pve-install-repo.list:

sed -i 's/bullseye/bookworm/g' /etc/apt/sources.list.d/pve-install-repo.list

La línea correcta para Proxmox VE 8 sin suscripción es:

deb http://download.proxmox.com/debian/pve bookworm pve-no-subscription

En algunos sistemas la línea también contiene [arch=amd64] después de deb. Es correcto, consérvelo.

Asegúrese de que el repositorio enterprise está desactivado: si existe pve-enterprise.list, su línea debe estar comentada con #, como queda tras desactivarlo en el Paso 1.

Con una suscripción de pago, escriba el repositorio enterprise y asegúrese de que no queda ninguna línea pve-no-subscription activa en otros archivos:

echo "deb https://enterprise.proxmox.com/debian/pve bookworm pve-enterprise" > /etc/apt/sources.list.d/pve-enterprise.list

Repositorio de Ceph

Omita esta parte si Ceph no está instalado en el nodo.

Con suscripción de pago:

echo "deb https://enterprise.proxmox.com/debian/ceph-quincy bookworm enterprise" > /etc/apt/sources.list.d/ceph.list

Sin suscripción:

echo "deb http://download.proxmox.com/debian/ceph-quincy bookworm no-subscription" > /etc/apt/sources.list.d/ceph.list

Actualizar el índice de paquetes

apt update

La salida no debe contener errores. Todas las líneas deben apuntar a bookworm.

Paso 4. Actualizar el sistema a Proxmox VE 8

Inicie la actualización:

apt dist-upgrade

La duración depende de la velocidad del disco raíz: unos minutos en SSD y hasta una hora o más en un HDD lento.

Preguntas durante la actualización

Si al principio se abre una página con notas de la versión, pulse q para cerrarla y continúe.

Cuando se le pregunte si desea reiniciar los servicios automáticamente durante las actualizaciones de paquetes, seleccione Yes con las teclas de flecha y pulse Enter.

Preguntas sobre archivos de configuración

Durante la actualización, apt pregunta qué hacer con los archivos de configuración que fueron modificados tanto por usted como por el paquete. Pulse D para ver la diferencia antes de responder. Respuestas recomendadas para los archivos habituales:

• /etc/issue: conserve su versión (N). Proxmox VE regenera este archivo en el arranque y solo afecta a la pantalla de inicio de sesión;
• /etc/lvm/lvm.conf: instale la versión del mantenedor del paquete (Y) si no ha editado el archivo usted mismo;
• /etc/apt/sources.list.d/pve-enterprise.list: si apt pregunta por este archivo, conserve su versión (N); de lo contrario, apt sobrescribe el repositorio que configuró en el Paso 3;
• /etc/ssh/sshd_config: si no ha editado el archivo, instale la versión del mantenedor (Y), que sustituye la opción obsoleta ChallengeResponseAuthentication por KbdInteractiveAuthentication. Si ha cambiado usted mismo la configuración de SSH, compare los archivos con cuidado;
• /etc/default/grub: esta pregunta suele aparecer solo si ha modificado el archivo, por ejemplo para añadir parámetros del kernel. Compruebe la diferencia; si tiene dudas, conserve su versión (N).

[ -d /sys/firmware/efi ] && apt install grub-efi-amd64

Ejecute este comando en sistemas UEFI que arrancan con GRUB, que es lo predeterminado en instalaciones desde la ISO de Proxmox VE con raíz en LVM. En un sistema con BIOS heredada no hace nada. Omítalo si la raíz está en ZFS: esos sistemas arrancan mediante proxmox-boot-tool y no se ven afectados.

Comprobar el resultado

Cuando apt dist-upgrade termine sin errores, ejecute de nuevo la herramienta de comprobación:

pve7to8 --full

Antes del reinicio, la herramienta puede mostrar elementos WARN sobre el kernel en ejecución y sobre LXCFS, que sigue usando la biblioteca FUSE antigua. Es lo esperado: ambos desaparecen cuando reinicia con el nuevo kernel en el Paso 5. No debe haber elementos FAIL.

Paso 5. Reiniciar con el nuevo kernel

Reinicie el nodo. Es obligatorio incluso si ya utilizaba el kernel 6.2 opcional en Proxmox VE 7:

reboot

Paso 6. Comprobar el resultado

Borre la caché del navegador o fuerce la recarga de la interfaz web con Ctrl+Shift+R (Cmd+Shift+R en macOS). Compruebe la versión en Summary del nodo o con:

pveversion

Inicie las máquinas virtuales y los contenedores y compruebe que funcionan. En un clúster, desactive el modo de mantenimiento del nodo y continúe con el siguiente nodo, empezando de nuevo por la comprobación de requisitos.

Solución de problemas

La actualización quiere eliminar proxmox-ve

El mensaje W: (pve-apt-hook) You are attempting to remove the meta-package 'proxmox-ve'! significa que algún repositorio sigue configurado para Bullseye o no existe para Bookworm. Revise todos los archivos de /etc/apt/sources.list.d/, corrija los repositorios y ejecute apt update de nuevo. No confirme la eliminación.

La actualización se interrumpió

Si se perdió la conexión o la actualización se detuvo a medias, vuelva a conectarse a la sesión de tmux o inicie sesión de nuevo y ejecute:

dpkg --configure -a
apt -f install
apt dist-upgrade

Errores de dependencias de paquetes de Ceph

Si apt dist-upgrade informa de dependencias no satisfechas para paquetes de Ceph en un nodo sin Ceph, añada el repositorio no-subscription de Ceph Quincy del Paso 3 y ejecute apt update de nuevo. Algunos paquetes de Proxmox VE pueden necesitarlo durante la actualización.

El nodo no arranca

Conéctese mediante IP-KVM para ver el error de arranque. Para problemas con GRUB, consulte la página oficial Recover From Grub Failure.

Qué hacer a continuación

Proxmox VE 8 ya no recibe actualizaciones. Planifique la actualización a Proxmox VE 9 sobre Debian 13 Trixie, que sigue el mismo procedimiento con la herramienta de comprobación pve8to9.

Si prefiere no realizar usted mismo las actualizaciones mayores, los especialistas de Administración de sistemas de INTROSERV pueden planificar y llevar a cabo la actualización por usted.