Proceso de eliminación de HyperFlex ESXi Agent Manager (EAM)

Introducción

Este documento describe cómo quitar ESXi Agent Manager (EAM) de los clústeres Hyperflex.

Antecedentes

ESX Agent Manager (EAM) es una extensión de vCenter que se encarga de administrar las VM de los agentes en los hosts ESX. Las VM de agente suelen ser utilizadas por las plataformas de software que requieren que los servicios distribuidos se ejecuten en todos los hosts de un clúster, lo que proporciona servicios a las VM invitadas en cada nodo local. El servicio EAM proporciona gestión automatizada del ciclo de vida de las VM designadas como agentes e incluye algunas capacidades útiles, entre las que se incluyen, entre otras: implementación automatizada en los hosts, encendido y apagado automáticos de las VM de los agentes cuando se ingresan o salen los hosts del modo de mantenimiento, encendiendo las VM de los agentes que detecta que están apagadas, asegurando un estricto orden de inicio para las VM de los agentes antes que las VM de invitados y advirtiendo a los usuarios cuando intentan realizar cambios en la configuración de las VM de los agentes.

Versiones HXDP aplicables

Esta versión de la información para HXDP se aplica al uso y eliminación de EAM -

• Sólo los clústeres implementados recientemente desde la versión 4.0(1) y posteriores se configuran para utilizar los servicios de ciclo de vida nativos y omitir la instalación y configuración de EAM.
• Los clústeres implementados en versiones anteriores y actualizados a 4.0(1) y versiones posteriores seguirán utilizando EAM a menos que se elimine manualmente. La eliminación de EAM es una configuración opcional en la que los clientes pueden optar si las ventajas son válidas para sus entornos.
• La sección de eliminación de esta guía pretende instruir a dichos clientes en la eliminación del servicio EAM para los clústeres existentes que se implementaron antes de la versión 4.0(1). Si está ejecutando una versión anterior a la 4.0.2b, actualice a esta generación antes de utilizar los procedimientos manuales de eliminación que se enumeran a continuación.

Ventajas de la eliminación de EAM en HXDP 4.0

• No hay dependencia del servicio EAM para las operaciones de clúster en curso.
• Ahora se recomienda el modo de mantenimiento regular de ESX y el uso del modo de mantenimiento de HX ya no es necesario en estos clústeres. HyperFlex detectará los eventos del modo de mantenimiento y activará automáticamente el apagado gradual de las respectivas VM del controlador.
• Ya no son necesarias las VM de controlador para los nodos UCS de sólo cómputo. La implementación de esta máquina virtual solo fue necesaria para satisfacer los requisitos de EAM y DRS y puede eliminarse de forma segura para los clústeres que ya no utilizan EAM.
• Las máquinas virtuales del controlador están protegidas frente a una eliminación accidental en vCenter mediante la desactivación de las acciones de usuario en la interfaz de usuario de vCenter.
• Los problemas conocidos de VMware con EAM ya no afectarán a los clústeres de HyperFlex. Estos nuevos servicios de ciclo de vida están diseñados, implementados y probados exclusivamente por el equipo de ingeniería de Cisco HyperFlex. 

Pasos para eliminar EAM

Procedimiento 1. Eliminación de EAM por eliminación de clúster del vCenter.

Este es el método más sencillo para llevar a cabo la eliminación, pero requiere que el clúster se desconecte del vCenter. No hay impacto en las VM y cargas de trabajo que se ejecutan actualmente al realizar este procedimiento. Si utiliza VMware Virtual Distributed Switching (VDS), no podrá quitar el clúster de vCenter y tendrá que utilizar el segundo procedimiento.

Paso 1. Confirme que el clúster actualizado siga mostrando la configuración EAM tal como está presente en los hosts.

Confirme que no hay entradas relacionadas con EAM en /var/log/springpath/stMgr.log antes de que el proceso de eliminación se complete. Para ver esto, inicie sesión en cualquier VM del controlador en el clúster y verifique el archivo stMgr.log.

Nota: Los mensajes de seguimiento dependientes de EAM se pueden ignorar a continuación.

           HXDP 4.0(1a)

2019-05-16-02:06:54.124 [] [] [Curator-ServiceCache-0] DEBUG c.s.sysmgmt.stMgr.StMgrImpl$ - Returning StMgr ZK node id: 02032fb1-092d-4209-a333-73cd71663ccb
2019-05-16-02:06:54.124 [] [] [Curator-ServiceCache-0] DEBUG c.s.s.stMgr.ZKNodeService_StMgr - DefaultZKPayloadNodeService //stCluster/02032fb1-092d-4209-a333-73cd71663ccb: Attempting to get cache value for key: eam_removed
2019-05-16-02:06:54.124 [] [] [Curator-ServiceCache-0] DEBUG c.s.sysmgmt.stMgr.StMgrImpl$ - Returning StMgr ZK node id: 02032fb1-092d-4209-a333-73cd71663ccb

            HXDP 4.0(2b)

"2020-06-05-14:31:37.050 [] [opId=001d5a63341ea0d1, operationId=001d5a63341ea0d1.001d5a1 63341ea0d1<:001d5a63341ea0d1] [pool-2-thread-5] DEBUG c.s.sysmgmt.common.upgrade.ZkUtil$ - Ruta recibida: /eam_remove, datos:"

Paso 2. Para quitar todo el clúster de ESX de vCenter, haga clic con el botón derecho en él y luego elija Eliminar, como se muestra en la imagen.

Paso 3. Vuelva a agregar el clúster HX utilizando el mismo nombre y, a continuación, agregue cada uno de los hosts HX al clúster. Vuelva a registrar el clúster a través de la CLI mediante el registro de clúster de stcli con la información de vCenter adecuada.

Procedimiento 2. Eliminación de EAM sin extracción del clúster desde vCenter.

Si no es posible quitar el clúster de vCenter, se puede utilizar el siguiente procedimiento para desplazarse progresivamente por el proceso por nodo. Este proceso puede llevar mucho más tiempo y requerirá reiniciar las VM del controlador.

Paso 1: Verifique que el clúster esté sano y que las fallas de nodo tolerables sean al menos 1 o mayores

Paso 2: Ingrese el primer host en el modo de mantenimiento. Esto apagará la máquina virtual del controlador

Paso 3: Cancele el registro de la máquina virtual en vCenter quitando la máquina virtual del inventario y, a continuación, vuelva a registrarla siguiendo los siguientes pasos.

Paso 4: Seleccione el host ESXi actual y realice los siguientes pasos para volver a registrar la VM del controlador

          Paso 4a: Vaya a la ficha "Almacenes de datos", haga clic con el botón derecho del ratón en el almacén de datos local denominado "SpringpathDS-<>" y seleccione Examinar archivos.

          Paso 4b: Haga clic en la carpeta stCtlVM-<> y busque el archivo <>.vmx

   Paso 4C: Haga clic con el botón derecho del ratón en el archivo .vmx y seleccione Registrar VM

Paso 5: Inicie sesión en el host ESX respectivo y encienda la máquina virtual del controlador y espere a que el clúster esté en buen estado. Nota: la VM del controlador no se puede encender a través de vCenter y se debe encender a través de la interfaz de usuario de ESXi directa o a través de la CLI de ESXi (vim-cmd).

Paso 6:Repita este procedimiento para todas las SCVM restantes, una por una esperando que el clúster se vuelva saludable antes de ingresar al siguiente host en modo de mantenimiento.

Paso 7: Verifique que todos los iconos de las VM cambien de EAM administrado a un icono de VM normal. Como segunda precaución, ejecute el siguiente comando (desde cualquier VM de control):

HX 4.0(2): "/usr/share/springpath/storfs-misc/hx- scripts/check_eam_status.py"
HX 4.5(1): "check_eam_status"

Paso 7a: El resultado debe decir EAM Enabled: No para todas las VM del controlador. Advertencia: Si no se comprueba correctamente que EAM se ha eliminado correctamente, el clúster se desconectará durante el paso de registro siguiente.

Paso 7b: El resultado debe tener el siguiente aspecto:

Versión HXDP:4.0(2)
root@SpringpathControllerX1441K9NC5:~# /usr/share/springpath/storfs-misc/hx-scripts/check_eam_status.py
URL de vCenter: https://10.33.16.51
Introduzca el nombre de usuario de vCenter (user@domain): administrator@vsphere.localvCenter Password:
stCtlVM-FCH2216V07H - EAM habilitado: No
stCtlVM-FCH2216V1GN - EAM habilitado: No
stCtlVM-FCH2216V08P - EAM habilitado: No

Versión HXDP: 4.5(1)
admin:~$ check_eam_status
URL de vCenter: https://10.33.16.51
Introduzca el nombre de usuario de vCenter (user@domain): administrator@vsphere.localvCenter Password:
stCtlVM-FCH2216V07H - EAM habilitado: No
stCtlVM-FCH2216V1GN - EAM habilitado: No
stCtlVM-FCH2216V08P - EAM habilitado: No

Paso 10: Vuelva a conectar los hosts al VC

Paso 11. Vuelva a registrar el clúster a través de la CLI mediante el registro de clúster de stcli con la información de vCenter adecuada.

Verificación

Registros HXDP

Verifique el /var/log/springpath/stMgr.log en las VM del controlador de almacenamiento que muestran una nueva entrada con la palabra clave eam_remove. Este valor se utiliza para realizar un seguimiento si la dependencia EAM se ha eliminado del clúster HX o si la dependencia EAM no existe en absoluto.

Verá varias entradas como se muestra a continuación,

Ejemplo:

2019-05-16-02:06:54.124 [Curator-ServiceCache-0] DEBUG c.s.stMgr.ZKNodeService_StMgr - DefaultZKPayloadNodeService //stCluster/02032fb1 092d-4209-a333-73cd71663ccb: Intentando obtener el valor de caché para la clave: eam_remove