En el artículo Jails en FreeBSD presenté un esquema de jails a partir del cual sería posible actualizar el sistema base de todos los Jails en una única operación. Este se basaba en separar el filesystem de los jails en dos partes: una compartida de sólo lectura (sistema base) y otra privada de lectura/escritura (configuraciones, paquetes y directorios de trabajo). En este artículo voy a detallar el proceso de upgrade de un host con múltiples jails.
El planteo es el siguiente: se requiere migrar los jails de una versión mayor a la siguiente (en este caso de 10.x a 11.0) y actualizar sus ports.
El procedimiento es relativamente sencillo y se divide en tres partes: 1- actualizar el host, 2- crear el nuevo sistema base para los jails, y actulizar los paquetes en cada jail. Gracias a este esquema, se evita tener que actualizar uno por uno el sistema base de cada jail: se hace una sola vez para todos. Esto también sirve para actualizar entre versiones menores.
Es importante destacar que un jail nunca puede correr un sistema base cuya versión mayor sea más actual que la del host. Esto se debe a que un kernel previo no es compatible con un sistema base más moderno (recordar que los jails comparten el mismo kernel que el host, pues se trata de virtualización a nivel sistema operativo). Por ello la versión del host siempre debe ir siempre igual (o más adelante) que la de los jails. Sin embargo, un kernel más actualizado (por ejemplo un kernel 11.x) funciona perfectamente para un jail con una versión de sistema base previa (10.x). He hecho esta prueba y lo he comprobado antes de actualizar los jails (un host 11.0 soporta correctamente jails con sistema base versión 10.3).
Actualizar el host
El primer paso entonces, consiste en migrar el host. Actualizar el host FreeBSD según se indica en las instrucciones del release announcement.
Partiendo de la versión 10.3, actualizar el sistema base a la versión 11 de la siguiente forma:
# freebsd-update upgrade -r 11.0-RELEASE # freebsd-update install # reboot # freebsd-update install
Luego actualizar los ports y paquetes del host:
# portsnap fetch extract # pkg-static install -f pkg # pkg update && pkg upgrade # portmaster -a -y # freebsd-update install
En este punto, el sistema base corre la versión FreeBSD 11.0, y los jails la versión 10.3. Este esquema es compatible y funciona perfectamente, tal como mencioné anteriormente.
Cuando se actualiza el kernel y se están utilizando sistemas de archivos ZFS, es necesario actualizar la versión de dichos sistemas de archivos, para soportar características adicionales introducidas por el nuevo kernel.
Cómo actualizar un sistema de archivos ZFS
El comando zpool status permite recuperar el estado de los filesystems ZFS:
# zpool status
En su salida, este comando indica si un pool ZFS requiere actualización. También es posible recurrir directamente al comando zpool upgrade:
# zpool upgrade
El cual directamente lista los sistemas de archivos ZFS que requieren actualización.
Para actualizar un pool (por ejemplo "zroot") ejecutar:
# zpool upgrade zroot
Este comando actualiza la versión de ZFS (para introducir nuevas características disponibles en el kernel actual) sin afectar el normal funcionamiento del sistema de archivos ni desmontar ningún dataset.
Tener en cuenta que una vez que se actualiza un pool ZFS, este dejará de funcionar con versiones de kernel anterior al actual. Tal vez parezca un detalle menor, pero puede afectar en el caso de recuperación o backup (si el pool es replicado y enviado a otros sistema FreeBSD con una versión de kernel previa).
Al tratarse de un pool que aloja el sistema de archivos raíz, es necesario actualizar el sector de booteo del disco involucrado:
# gpart bootcode -b /boot/pmbr -p /boot/gptzfsboot -i 1 da0
Luego, actualizar el resto de los pooles:
# zpool upgrade zjails
Crear el nuevo template para los jails
La creación del nuevo sistema base para los jails es similar (o casi idéntica) al proceso de creación de los jails inicial. Cambiar al directorio base y crear una nueva versión del sistema raíz para los jails:
root@fbsd11:~ # cd /zjails/jail/ root@fbsd11:/zjails/jail # mkdir mroot-11.0
Guardar copias de respaldo de las imágenes del sistema base (base.txz) y fuentes (src.txz) previas, y descargar las correspondientes a la nueva versión de FreeBSD:
root@fbsd11:/zjails/jail # mv base.txz base-10.3.txz root@fbsd11:/zjails/jail # mv src.txz src-10.3.txz root@fbsd11:/zjails/jail # fetch https://download.freebsd.org/ftp/releases/amd64/amd64/11.0-RELEASE/base.txz root@fbsd11:/zjails/jail # fetch https://download.freebsd.org/ftp/releases/amd64/amd64/11.0-RELEASE/src.txz root@fbsd11:/zjails/jail # mv base.txz base-11.0.txz root@fbsd11:/zjails/jail # mv src.txz src-11.0.txz
Extraer el sistema base y los fuentes de FreeBSD:
root@fbsd11:/zjails/jail # cd mroot-11.0/ root@fbsd11:/zjails/jail/mroot-11.0 # tar xzf ../base-11.0.txz root@fbsd11:/zjails/jail/mroot-11.0 # tar xzf ../src-11.0.txz
Actualizar el sistema base:
root@fbsd11:/zjails/jail/mroot-11.0 # freebsd-update -b /zjails/jail/mroot-11.0/ fetch root@fbsd11:/zjails/jail/mroot-11.0 # freebsd-update -b /zjails/jail/mroot-11.0/ install
Y eliminar los directorios no compartidos (privados a cada jail):
root@fbsd11:/zjails/jail/mroot-11.0 # chflags -R 0 var root@fbsd11:/zjails/jail/mroot-11.0 # rm -R etc var root usr/local tmp
Finalmente, recrear los enlaces simbólicos a directorios de lectura/escritura privados:
root@fbsd11:/zjails/jail/mroot-11.0 # ln -s s/etc etc root@fbsd11:/zjails/jail/mroot-11.0 # ln -s s/home home root@fbsd11:/zjails/jail/mroot-11.0 # ln -s s/root root root@fbsd11:/zjails/jail/mroot-11.0 # ln -s ../s/usr-local usr/local root@fbsd11:/zjails/jail/mroot-11.0 # ln -s ../s/usr-X11R6 usr/X11R6 root@fbsd11:/zjails/jail/mroot-11.0 # ln -s ../../s/distfiles usr/ports/distfiles root@fbsd11:/zjails/jail/mroot-11.0 # ln -s ../../s/packages usr/ports/packages root@fbsd11:/zjails/jail/mroot-11.0 # ln -s s/tmp tmp root@fbsd11:/zjails/jail/mroot-11.0 # ln -s s/var var
Actualizar los jails
Finalizada la creación del nuevo mroot (sistema FreeBSD base compartido por todos los jails), se debe proceder con la actualización de los mismos.
Detener los jails:
# service jail stop # service jailsffss stop
Recordar que el servicio jailsffss es de mi autoría y está definido en el artículo Jails en FreeBSD. Fue creado para lograr montar los sistemas de archivos de los jails cuando éstos están contenidos dentro de datasets ZFS.
Cambiar al nuevo mroot:
root@fbsd11:/zjails/jail/mroot-11.0 # cd .. root@fbsd11:/zjails/jail # mv mroot mroot-10.3 root@fbsd11:/zjails/jail # mv mroot-11.0 mroot root@fbsd11:/zjails/jail # mv mroot-10.3/usr/ports mroot/usr/
Notar que (para ahorrar espacio y vnodos) se mueve el arbol de ports desde la versión anterior a la versión actual.
Reiniciar los jails:
root@fbsd11:/zjails/jail # service jailsffss start
Mounting jails filesystems...
root@fbsd11:/zjails/jail # service jail start
Starting jails: www db.
root@fbsd11:/zjails/jail # jls
JID IP Address Hostname Path
3 192.168.39.204 fbsd10-www.linuxito.com /zjails/jail/www
4 192.168.39.205 fbsd10-db.linuxito.com /zjails/jail/db
Actualizar los paquetes en cada jail
El último paso consiste en actualizar los ports y paquetes en cada jail. Primero, desde el host, actualizar el árbol de ports (para todos los jails):
root@fbsd11:/zjails/jail # portsnap -p /zjails/jail/mroot/usr/ports fetch extract
Este comando se realiza una única vez para todos los jails, pues el árbol de ports es compartido para todos.
Luego sí es necesario actualizar los paquetes en cada jail, uno por uno:
pkg-static install -f pkg pkg update && pkg upgrade portmaster -a -y
Es posible hacerlo por SSH o utilizando jexec desde el host. Si portmaster no se encuentra instalado, ejecutar:
# cd /usr/ports/ports-mgmt/portmaster # make install clean
Referencias
Cómo actualizar FreeBSD 10.x a 11
FreeBSD 11.0-RELEASE Announcement
