Aplicar actualizaciones mediante la CLI xe
Aplique actualizaciones a los hosts y grupos de XenServer 8 mediante la CLI xe.
Para recibir actualizaciones, los hosts de XenServer necesitan acceso a Internet. Si sus hosts están detrás de un firewall, asegúrese de que tengan acceso a los subdominios de ops.xenserver.com
. Para obtener más información, consulte Requisitos de conectividad .
Complete los siguientes pasos para poder actualizar los grupos de XenServer:
Configure las actualizaciones para su agrupación
Antes de poder aplicar actualizaciones a los hosts y grupos de XenServer, debe configurar las actualizaciones del host suscribiendo el grupo o el host a un canal de actualizaciones. Estos canales controlan la rapidez con la que puede acceder a las actualizaciones que están disponibles en la red de entrega de contenido (CDN).
Los dos canales de actualización son:
- Acceso anticipado : perfecto para entornos de prueba
- Normal : recomendado para entornos de producción
Después de suscribir su grupo a uno de los canales de actualización, su grupo se sincroniza de forma periódica y automática con el canal de actualización. Como alternativa, sincronice manualmente su grupo con el canal de actualización. Esta acción de sincronización descarga todas las actualizaciones disponibles para el coordinador del grupo. A continuación, puede aplicar las actualizaciones descargadas mediante la CLI xe.
-
Cree y habilite el canal de actualizaciones de acceso anticipado para tu grupo:
pool_uuid=$(xe pool-list --minimal) base_binary_url="https://repo.ops.xenserver.com/xs8/base" base_source_url="https://repo-src.ops.xenserver.com/xs8/base" base_repo_uuid=$(xe repository-introduce name-label=base_repo name-description=Base binary-url=<base_binary_url> source-url=<base_source_url> update=false) update_binary_url="https://repo.ops.xenserver.com/xs8/earlyaccess" update_source_url="https://repo-src.ops.xenserver.com/xs8/earlyaccess" update_repo_uuid=$(xe repository-introduce name-label=early_access_repo name-description="Early Access" binary-url=<update_binary_url> source-url=<update_source_url> update=true) xe pool-param-set uuid=<pool_uuid> repositories=<base_repo_uuid>,<update_repo_uuid> <!--NeedCopy-->
Como alternativa, cree y habilite el canal de actualización normal para su grupo:
pool_uuid=$(xe pool-list --minimal) base_binary_url="https://repo.ops.xenserver.com/xs8/base" base_source_url="https://repo-src.ops.xenserver.com/xs8/base" base_repo_uuid=$(xe repository-introduce name-label=base_repo name-description=Base binary-url=<base_binary_url> source-url=<base_source_url> update=false) update_binary_url="https://repo.ops.xenserver.com/xs8/normal" update_source_url="https://repo-src.ops.xenserver.com/xs8/normal" update_repo_uuid=$(xe repository-introduce name-label=normal name-description="Normal" binary-url=<update_binary_url> source-url=<update_source_url> update=true) xe pool-param-set uuid=<pool_uuid> repositories=<base_repo_uuid>,<update_repo_uuid> <!--NeedCopy-->
-
Recupere una lista de los UUID de repositorio actualmente habilitados:
pool_uuid=$(xe pool-list --minimal) xe pool-param-get uuid=<pool_uuid> param-name=repositories <!--NeedCopy-->
-
Con el UUID del repositorio, puede ver más detalles sobre un repositorio en particular:
xe repository-param-list uuid=<UUID> <!--NeedCopy-->
-
(Opcional) Configure y habilite un servidor proxy de conexión HTTP que se utilice para la comunicación entre el host y la CDN pública que aloja los repositorios:
xe pool-configure-repository-proxy proxy-url=<http://proxy.example.com> proxy-username=<proxy-user> proxy-password=<proxy-password> <!--NeedCopy-->
Inhabilite la configuración del servidor proxy:
xe pool-disable-repository-proxy <!--NeedCopy-->
Vea la configuración del servidor proxy:
pool_uuid=$(xe pool-list --minimal) xe pool-param-get uuid=<pool_uuid> param-name=repository-proxy-url xe pool-param-get uuid=<pool_uuid> param-name=repository-proxy-username <!--NeedCopy-->
Sincronice las nuevas actualizaciones para su grupo
Permita que su grupo se sincronice automáticamente con el canal de actualización configurando un programa de sincronización. Puede programar una sincronización para que se lleve a cabo a diario o semanalmente en un día determinado de la semana. Al sincronizar su grupo con el canal de actualizaciones, se descargan todas las actualizaciones disponibles para el coordinador del grupo y, a continuación, puede aplicar todas las actualizaciones descargadas a su grupo.
-
Configure su grupo para que se sincronice a diario:
xe pool-configure-update-sync update-sync-frequency=daily update-sync-day=0 xe pool-set-update-sync-enabled value=true <!--NeedCopy-->
Como alternativa, configure su grupo para que se sincronice semanalmente:
xe pool-configure-update-sync update-sync-frequency=weekly update-sync-day=1 (# 0 is Sunday, 1 is Monday, etc) xe pool-set-update-sync-enabled value=true <!--NeedCopy-->
-
Consulte su configuración de sincronización:
pool_uuid=$(xe pool-list --minimal) xe pool-param-get uuid=<pool_uuid> param-name=update-sync-frequency xe pool-param-get uuid=<pool_uuid> param-name=update-sync-day xe pool-param-get uuid=<pool_uuid> param-name=update-sync-enabled <!--NeedCopy-->
-
Obtenga la marca de hora de la última sincronización correcta de su grupo con el canal de actualización:
pool_uuid=$(xe pool-list --minimal) xe pool-param-get param-name=last-update-sync uuid=<pool_uuid> <!--NeedCopy-->
Como alternativa, puede sincronizar manualmente el grupo de XenServer con el canal de actualización:
pool_uuid=$(xe pool-list --minimal)
update_checksum=$(xe pool-sync-updates uuid=<pool_uuid> --minimal)
<!--NeedCopy-->
update_checksum
es un identificador único que indica el nivel de las actualizaciones instaladas. Cambia cada vez que hay nuevas actualizaciones disponibles en la CDN pública y se usa más adelante al aplicar actualizaciones a su grupo para garantizar que siempre esté aplicando las últimas actualizaciones disponibles. update_checksum
también puede proporcionar información útil si necesita ponerse en contacto con el servicio de asistencia técnica.
Nota:
Tras la sincronización, aplique las actualizaciones a su grupo lo antes posible para beneficiarse de las últimas actualizaciones.
Si designa a un nuevo coordinador del grupo después de la sincronización, pero antes de aplicar las actualizaciones a los anfitriones del grupo, debe volver a sincronizar con el nuevo coordinador del grupo para poder actualizar el grupo.
No sincronice el grupo de XenServer mientras el grupo se esté actualizando.
Conozca las categorías de orientación y las tareas de actualización
Es posible que se requieran algunas tareas (como evacuar o reiniciar los hosts) antes y después de aplicar las actualizaciones a su grupo. A veces, no se requieren tareas de actualización.
Categorías de orientación
XenServer intenta minimizar las interrupciones en las máquinas virtuales que estas tareas pueden provocar al clasificarlas en obligatorias, recomendadas, de plena eficacia y con parches activos. Estas categorizaciones le permiten determinar si es necesaria para su entorno y perfil de riesgo una tarea de actualización que pueda provocar un tiempo de inactividad o una interrupción leve en sus hosts o máquinas virtuales.
Las actualizaciones pueden incluir tareas en más de una de estas categorías. Por ejemplo, una actualización puede requerir que reinicie el host para ser totalmente efectiva, pero se recomienda reiniciar la pila de herramientas para aprovechar al máximo los beneficios de la actualización y reducir las posibles interrupciones en el grupo.
Durante el proceso de actualización, puede elegir llevar a cabo uno de los tres niveles de tareas siguientes:
- Obligatorio
- Obligatorio + Recomendado
- Obligatorio + Recomendado + Plena eficacia
Obligatorio
Las tareas obligatorias se deben realizar después de una actualización; de lo contrario, el sistema podría fallar durante el tiempo de ejecución. Estas acciones son necesarias para habilitar las correcciones críticas y garantizar que su entorno sea seguro y estable. No puede omitir las tareas obligatorias.
Recomendado
Las tareas recomendadas son las tareas que le recomendamos que realice para aprovechar la mayoría de las funciones y correcciones incluidas en las actualizaciones. Si decide no realizar estas tareas ahora, se enumeran en las tareas de actualización pendientes del grupo, el host o la máquina virtual correspondiente.
Por qué realizar las tareas recomendadas:
- Estas tareas son las que garantizan un entorno de XenServer seguro y estable.
Por qué omitir las tareas recomendadas:
- Tras revisar la información detallada de las actualizaciones, considera que el riesgo de no aplicarlas por completo ahora es aceptable.
- Las tareas recomendadas ahora provocan interrupciones no deseadas en sus máquinas virtuales.
Plena eficacia
Se requieren tareas de plena eficacia para obtener los beneficios de la actualización relacionada. Las actualizaciones que tienen asociadas tareas de plena eficacia suelen ser relevantes solo para los usuarios de determinado hardware o que utilizan funciones específicas.
Revise la información de actualización para saber si estas tareas son necesarias para su entorno. Si decide no realizar estas tareas ahora, se enumeran en las tareas pendientes del grupo, el host o la máquina virtual correspondiente.
Por qué realizar las tareas de plena eficacia:
- Las actualizaciones que tienen tareas de plena eficacia son relevantes para su hardware, entorno o configuración.
Por qué omitir las tareas de plena eficacia:
- Las actualizaciones que tienen una guía de plena eficacia no son relevantes para su hardware, entorno o configuración.
- Las tareas de plena eficacia provocan ahora interrupciones no deseadas en sus máquinas virtuales.
- No necesita los beneficios de estas actualizaciones en este momento.
Si las tareas de plena eficacia se aplican a su entorno, pero ha optado por aplazarlas, planifique completar estas tareas durante un período de mantenimiento adecuado para mantener la estabilidad de su entorno.
Parches activos
Las actualizaciones de ciertos componentes pueden incluir un parche activo, o en vivo. La posibilidad de aplicar un parche activo a los hosts depende de la versión del componente que se haya instalado la última vez que se reiniciaron los hosts. Si se puede aplicar una actualización como parche activo a sus hosts, la guía sobre parches activos reemplaza a la guía recomendada.
Ejemplo:
Tienes dos agrupaciones. El grupo A se ha actualizado a un nivel reciente. El grupo B no se ha actualizado durante algún tiempo. Publicamos una nueva actualización que incluye la tarea de actualización recomendada “Reiniciar el host” y la tarea de actualización de parche activo “Reiniciar la pila de herramientas”.
En el grupo A, el parche activo se puede aplicar a estos hosts más actualizados. La guía recomendada muestra “Reiniciar la pila de herramientas”. La tarea menos disruptiva de la guía de parches activos anula la guía recomendada.
En el grupo B, el parche activo no se puede aplicar a los hosts porque están en un nivel anterior. La guía recomendada muestra “Reiniciar el host”. La guía recomendada sigue siendo aplicable. La guía sobre los parches en vivo, o activos, es irrelevante en este caso.
A veces, solo algunas de las correcciones de una actualización están habilitadas cuando la actualización se aplica como un parche activo. Revise los detalles de la actualización para saber si necesita todas las correcciones de la actualización o solo las habilitadas con el parche activo. A continuación, puede usar esta información para decidir si desea realizar las tareas recomendadas. Para obtener más información, consulte Ver las actualizaciones disponibles para su grupo.
Actualizar tareas
Es posible que se requieran una o más de las siguientes tareas al aplicar una actualización. Cualquier tipo de tarea de actualización se puede incluir en cualquier categoría de orientación.
Actualizar las tareas de su host
Esta tarea solo se lleva a cabo antes de aplicar las actualizaciones y, a veces, la lleva a cabo como parte de la tarea “Reiniciar el host”:
Actualizar tarea | Comando de CLI xe para llevar a cabo la tarea | Descripción |
---|---|---|
Evacuar el host | xe host-evacuate |
Migre todas las máquinas virtuales del host de XenServer o apáguelas. Mientras esta tarea está en curso, el grupo de XenServer funciona a una capacidad reducida, ya que un host no está disponible temporalmente para ejecutar máquinas virtuales. |
Las siguientes tareas requieren acciones en el host actualizado:
Actualizar tarea | Comando de CLI xe para llevar a cabo la tarea | Descripción |
---|---|---|
Reiniciar el host | xe host-reboot |
Se debe reiniciar el host de XenServer. Todas las máquinas virtuales se migran del host y el host se reinicia. Mientras esta tarea está en curso, el grupo de XenServer funciona a una capacidad reducida, ya que un host no está disponible temporalmente para ejecutar máquinas virtuales. |
Reiniciar el host en caso de error del parche activo de Xen | xe host-reboot |
No se pudo aplicar un parche activo de Xen. El host de XenServer debe reiniciarse para que la actualización surta efecto. Todas las máquinas virtuales se migran del host y el host se reinicia. Mientras esta tarea está en curso, el grupo de XenServer funciona a una capacidad reducida, ya que un host no está disponible temporalmente para ejecutar máquinas virtuales. |
Reiniciar el host en caso de error del parche activo del kernel | xe host-reboot |
No se pudo aplicar un parche activo del kernel dom0. El host de XenServer debe reiniciarse para que la actualización surta efecto. Todas las máquinas virtuales se migran del host y el host se reinicia. Mientras esta tarea está en curso, el grupo de XenServer funciona a una capacidad reducida, ya que un host no está disponible temporalmente para ejecutar máquinas virtuales. |
Reiniciar toolstack | xe-toolstack-restart |
Se debe reiniciar la pila de herramientas del host. Reinicie la pila de herramientas en el host actualizado en lugar de en el coordinador del grupo. Cuando se reinicia la pila de herramientas en el coordinador del grupo, se pierde la conexión con el grupo, pero cuando se reinicia la pila de herramientas en otros miembros del grupo, no hay ningún efecto visible. |
Consulte las tareas de actualización necesarias para su host
Consulte las tareas necesarias para su host antes y después de aplicar las actualizaciones mediante los siguientes comandos.
Obtenga una lista de las tareas obligatorias para su host:
xe host-param-get param-name=pending-guidances uuid=<host UUID>
<!--NeedCopy-->
Obtenga una lista de las tareas obligatorias para su host:
xe host-param-get param-name=pending-guidances-recommended uuid=<host UUID>
<!--NeedCopy-->
Obtenga una lista de las tareas de plena eficacia para su host:
xe host-param-get param-name=pending-guidances-full uuid=<host UUID>
<!--NeedCopy-->
Actualizar las tareas de su máquina virtual
Algunas actualizaciones proporcionan nuevas funciones para sus máquinas virtuales. Estas actualizaciones pueden requerir las siguientes tareas en las máquinas virtuales:
Actualizar tarea | Comando de CLI xe para llevar a cabo la tarea | Descripción |
---|---|---|
Reiniciar VM | xe vm-reboot |
La máquina virtual debe reiniciarse. Mientras la máquina virtual se reinicia, no está disponible para el usuario final. |
Reiniciar el modelo de dispositivo | xe vm-restart-device-models |
Se debe reiniciar el modelo de dispositivo para las máquinas virtuales del host actualizado. Mientras se reinicia el modelo de dispositivo, no puede detener, iniciar ni migrar la máquina virtual. Es posible que el usuario final de la máquina virtual experimente una pausa leve y se reanude su sesión. Para que la acción de reinicio del modelo de dispositivo sea compatible con una máquina virtual Windows, la máquina virtual debe tener instalado XenServer VM Tools para Windows. |
Ver las tareas de actualización necesarias para su máquina virtual
Obtenga una lista de las tareas obligatorias para su máquina virtual:
xe vm-param-get param-name=pending-guidances uuid=<VM UUID>
<!--NeedCopy-->
Obtenga una lista de las tareas recomendadas para su máquina virtual:
xe vm-param-get param-name=pending-guidances-recommended uuid=<VM UUID>
<!--NeedCopy-->
Obtenga una lista de las tareas de plena eficacia para su máquina virtual:
xe vm-param-get param-name=pending-guidances-full uuid=<VM UUID>
<!--NeedCopy-->
Vea las actualizaciones disponibles para su agrupación
Antes de instalar las actualizaciones, consulte las actualizaciones disponibles para su grupo y revise las tareas de actualización necesarias. Para obtener más información sobre las diferentes tareas de actualización que pueden ser necesarias para una actualización, consulte Conozca las categorías de orientación y las tareas de actualización.
Comprobar las actualizaciones disponibles para un host en particular
Compruebe si hay actualizaciones disponibles para un host en particular:
xe host-param-get param-name=latest-synced-updates-applied uuid=<host UUID>
<!--NeedCopy-->
Este comando devuelve yes
si hay actualizaciones disponibles para un host en particular y no
si no hay ninguna disponible.
Comprobar las actualizaciones disponibles para todos los hosts
Compruebe si hay actualizaciones disponibles para todos los hosts realizando una solicitud GET en el dispositivo de punto final HTTP /updates
.
Obtenga actualizaciones para todos los hosts mediante la utilidad wget
:
wget -O - --no-check-certificate https://<user name>:<password>@<coordinator IP address>/updates
<!--NeedCopy-->
Como alternativa, puede usar la biblioteca cliente HTTP:
HTTP GET
session_id: <XAPI session ID returned from login>
host_refs: <host XAPI reference>
<!--NeedCopy-->
La salida devuelta está en formato JSON y contiene los siguientes objetos:
-
hosts
: muestra las actualizaciones disponibles para cada host. -
updates
: muestra los detalles de las actualizaciones disponibles. -
hash
:update_checksum
(se utiliza para garantizar que siempre se apliquen las últimas actualizaciones disponibles).
Los objetos hosts
y updates
también contienen el objeto guidance
, que consta de las siguientes claves:
mandatory
recommended
full
livepatch
Estas claves hacen referencia a las diferentes categorías de orientación para las tareas de actualización. Enumeran las tareas de actualización necesarias para sus hosts y máquinas virtuales. Para obtener más información sobre las diferentes tareas que pueden ser necesarias para una actualización, consulte Conozca las categorías de orientación y las tareas de actualización.
Aplicar actualizaciones a su agrupación
Antes de comenzar
-
Asegúrese de que todos los hosts de su grupo estén en línea antes de llevar a cabo la actualización del grupo.
-
Asegúrese de que no haya tareas de actualización obligatorias pendientes en ningún host o máquina virtual. Cualquier tarea de actualización obligatoria pendiente de actualizaciones anteriores debe llevarse a cabo antes de iniciar una nueva actualización del grupo. Para obtener más información, consulte Ver las tareas de actualización necesarias para su host y Ver las tareas de actualización necesarias para su máquina virtual.
-
Inhabilite la alta disponibilidad (HA) si está habilitada:
pool_uuid=$(xe pool-list --minimal) xe pool-ha-disable uuid=<pool_uuid> <!--NeedCopy-->
-
Inhabilite Workload Balancing (WLB) si está habilitado:
pool_uuid=$(xe pool-list --minimal) xe pool-param-set wlb-enabled=false uuid=<pool_uuid> <!--NeedCopy-->
Instalar actualizaciones
Para actualizar su grupo, debe aplicar las actualizaciones a todos los hosts del grupo, empezando por el coordinador del grupo. Siga estos pasos, empezando por el coordinador del grupo:
-
Inhabilite el host:
xe host-disable uuid=<host UUID> <!--NeedCopy-->
-
Si una de las tareas de actualización necesarias para la actualización es “Evacuar el host” o “Reiniciar el host”, evacúe el host:
xe host-evacuate uuid=<host UUID> <!--NeedCopy-->
Si no puede migrar una máquina virtual a otros hosts durante la evacuación del host, apague o suspenda la máquina virtual.
-
Aplique las actualizaciones al host:
xe host-apply-updates uuid=<host UUID> hash=<update_checksum> <!--NeedCopy-->
-
Obtenga una lista de las tareas de actualización del host necesarias. Para obtener más información, consulte Actualizar tareas del host.
Realice las tareas de actualización del host de la lista en el siguiente orden:
- Reiniciar la pila de herramientas (se puede omitir si hay que realizar un “reinicio del host”)
- Reiniciar el host
-
Para cada máquina virtual en ejecución en el host, obtenga una lista de las tareas de actualización de máquinas virtuales necesarias. Para obtener más información, consulte Tareas de actualización para su máquina virtual.
Realice las tareas de actualización de la máquina virtual de la lista en el siguiente orden:
- Reiniciar modelo de dispositivo (se puede omitir si hay que realizar un “reinicio de la máquina virtual”)
- Reiniciar VM
-
Habilite el host si aún está inhabilitado:
xe host-enable uuid=<host UUID> <!--NeedCopy-->
-
Para cada máquina virtual que haya migrado a otro host con
host-evacuate
antes de la actualización del host, obtenga una lista de las tareas de actualización. Para obtener más información, consulte Tareas de actualización para su máquina virtual.Si “Reiniciar máquina virtual” está en la lista de tareas de actualización, apague la máquina virtual e iníciela en el host actualizado actual. De lo contrario, vuelva a migrar la máquina virtual al host actualizado actual.
-
Reanude o inicie las máquinas virtuales que apagó o suspendió antes de aplicar las actualizaciones.
-
Ver el estado de actualización del host:
xe host-param-get param-name=last-software-update uuid=<host UUID> xe host-param-get param-name=latest-synced-updates-applied uuid=<host UUID> xe host-param-get param-name=last-update-hash uuid=<host UUID> <!--NeedCopy-->
Repita los pasos anteriores para actualizar todos los hosts del grupo.
Después de actualizar sus hosts
Después de actualizar cada host de su grupo, lleve a cabo las tareas de actualización restantes.
-
Para cada máquina virtual de su grupo, obtenga una lista de las tareas de actualización. Para obtener más información, consulte Tareas de actualización para su máquina virtual.
Si la opción “Reiniciar máquina virtual” está en la lista de tareas de actualización, llévela a cabo.
-
Habilite la alta disponibilidad si la inhabilitó antes de aplicar las actualizaciones:
pool_uuid=$(xe pool-list --minimal) xe pool-ha-disable uuid=<pool_uuid> <!--NeedCopy-->
-
Habilite WLB si lo inhabilitó antes de aplicar las actualizaciones:
pool_uuid=$(xe pool-list --minimal) xe pool-param-set wlb-enabled=true uuid=<pool_uuid> <!--NeedCopy-->
-
Si ha decidido llevar a cabo solo las tareas de actualización obligatorias necesarias para la actualización de un grupo, las tareas de actualización que no se hayan llevado a cabo se adjuntan a la lista de tareas de actualización pendientes necesarias para sus hosts. Para ver esta lista y llevar a cabo estas tareas, consulte Actualizar tareas para el host.