Workspace Environment Management

Instalación y configuración

Utilice la siguiente secuencia para configurar la implementación de servicios WEM (Workspace Environment Management). Revise todo el proceso antes de comenzar la implementación, para familiarizarse con él. Se ofrecen enlaces a vídeos y artículos de la documentación del producto.

Si no está familiarizado con los componentes y la terminología utilizados en una implementación de servicios WEM, consulte Workspace Environment Management Service.

Introducción

Introducción registrándose para obtener una cuenta de Citrix y solicitar una prueba del servicio WEM.

Configurar ubicaciones de recursos e instalar Cloud Connectors

Las ubicaciones de recursos contienen servidores de infraestructura (como Active Directory y Citrix Cloud Connectors) y las máquinas que entregan aplicaciones y escritorios a los usuarios.

Antes de instalar el agente WEM, debe configurar ubicaciones de recursos e instalar al menos un Citrix Cloud Connector en cada una. Para obtener una alta disponibilidad, Citrix recomienda instalar dos Cloud Connectors en cada ubicación de recursos.

Consulte Ubicaciones de recursos y Instalación de Cloud Connector.

Instalar y configurar el agente WEM

Nota:

Para acceder a los recursos publicados en los almacenes de Citrix StoreFront como accesos directos a aplicaciones desde la consola de administración, asegúrese de que la aplicación Citrix Workspace para Windows esté instalada en el equipo host del agente. Para obtener más información, consulte Requisitos del sistema.

Paso 1: Unir máquinas host del agente a AD

Los equipos host del agente deben pertenecer al mismo dominio AD que los Cloud Connectors configurados. Asegúrese de que las máquinas host del agente en cada ubicación de recursos estén unidas correctamente.

Paso 2: Descargar el agente

Descargue el paquete de agentes WEM (Citrix-Workspace-Environment-Management-Agent-Setup.zip) de la ficha Descargas del servicio WEM y guarde una copia en cada host de agente.

Paso 3: Configurar directivas de grupo (opcional)

Si quiere, puede elegir configurar las directivas de grupo. La plantilla administrativa de directivas de grupo de agentes, proporcionada en el paquete de agentes de WEM, agrega la directiva de configuración de host del agente.

  1. Copie la carpeta Directivas de grupo de agentes proporcionada con el paquete de instalación de WEM en el controlador de dominio WEM.

  2. Agregue los archivos ADMX.

    1. Vaya a la carpetaDirectivas de grupo A gent > ADMX .
    2. Copie los dos archivos (Citrix Workspace Environment Management Agent Host Configuration.ADMX y CitrixBase.admx).
    3. Vaya a la carpeta <C:\Windows>\PolicyDefinitions y pegue los archivos.
  3. Agregue los archivos ADML.

    1. Vaya a la carpeta Directivas de grupo de agentes > ADMX > en-US .
    2. Copie los dos archivos (Citrix Workspace Environment Management Agent Host Configuration.ADML y CitrixBase.adml).
    3. Vaya a la carpeta <C:\Windows>\PolicyDefinitions\en-US y pegue los archivos.
  4. En la ventana Editor de administración de directivas de grupo, vaya a Configuración del equipo > Directivas > Plantillas administrativas > Componentes de Citrix > Workspace Environment Management > Configuración del host del agente y configure los siguientes valores:

    Editor de administración de directivas de

Configuración de proxy de agente. El agente WEM confía en conexiones a Internet para conectarse al servicio WEM en Citrix Cloud. La comunicación entre el agente y el servicio sirve para los siguientes fines:

  • Cargar estadísticas y estado en el servicio WEM
  • Mantener la caché del agente sincronizada con la base de datos del servicio WEM
  • Recuperación de la configuración del agente y de la configuración WEM específica del conjunto de configuración del agente

Si quiere, puede elegir configurar un proxy HTTPS para definir cómo se comunica el agente con el servicio. Para ello, haga doble clic en la directiva de configuración del proxy del agente y, a continuación, escriba una dirección de servidor proxy. Por ejemplo, http://10.108.125.51:8080.

Nota:

El servicio WEM no admite servidores proxy que requieren autenticación.

Puerto de servicio de agente. No es necesario para el servicio WEM. Deje el estado “No configurado”.

Puerto de sincronización de datos almacenado en caché. No es necesario para el servicio WEM. Deje el estado “No configurado”.

Citrix Cloud Connectors. Configure al menos un Citrix Cloud Connector. Los equipos host del agente deben estar en el mismo dominio AD que los equipos Cloud Connector configurados.

Descubra Citrix Cloud Connector desde el servicio CVAD. Permite controlar si el agente descubre información de Cloud Connector de la implementación del servicio Citrix Virtual Apps and Desktops (CVAD) relevante si aún no ha configurado Cloud Connectors para el agente. A continuación, el agente se conecta a los equipos de Cloud Connector correspondientes.

Nota:

  • Esta configuración está diseñada para casos en los que el agente WEM se ejecuta en una implementación de servicio CVAD.
  • Esta configuración de directiva no funciona si Cloud Connectors se configura durante la instalación del agente o si la configuración de directiva de Citrix Cloud Connectors está habilitada.

Servidor de infraestructura. No es necesario para el servicio WEM. Deje el estado “No configurado”.

Demora de sincronización adicional de VUEMAppCmd. Especifica, en milisegundos, cuánto tiempo espera el iniciador de aplicaciones del agente (VUEMAppCmd.exe) antes de que se inicien los recursos publicados de Citrix Virtual Apps and Desktops. Esto garantiza que el trabajo del agente necesario se complete primero. El valor recomendado es de 100 a 200. El valor predeterminado es 0.

Paso 4: Instalar el agente

Importante:

Aunque de.NET Framework se puede instalar automáticamente durante la instalación del agente, se recomienda que lo instale manualmente antes de instalar el agente. De lo contrario, debe reiniciar el equipo para continuar con la instalación del agente y podría tardar mucho tiempo en completarse.

El programa de configuración del agente Citrix Workspace Environment Management Agent se proporciona en la descarga del agente. Puede optar por instalar el agente de forma interactiva o mediante la línea de comandos. De forma predeterminada, el agente se instala en una de las siguientes carpetas, en función del sistema operativo (SO):

  • C:\Archivos de programa (x86)\ Citrix\ Workspace Environment Management Agent (en SO de 64 bits)
  • C:\Archivos de programa\ Citrix\ Workspace Environment Management Agent (en SO de 32 bits)

Para instalar el agente de forma interactiva, siga los pasos siguientes:

  1. Ejecute Citrix Workspace Environment Management Agent.exe en su equipo.
  2. Seleccione “Acepto los términos y condiciones de la licencia” y, a continuación, haga clic en Instalar.
  3. En la página de bienvenida, haga clic en Siguiente.

    Nota:

    La página de bienvenida puede tardar algún tiempo en aparecer. Esto sucede cuando falta el software necesario y se está instalando en segundo plano.

  4. En la página Carpeta de destino, haga clic en Siguiente.

    • De forma predeterminada, el campo de la carpeta de destino se rellena automáticamente con la ruta de acceso predeterminada de la carpeta. Si quiere instalar el agente en otra carpeta, haga clic en Cambiar para navegar hasta la carpeta y, a continuación, haga clic en Siguiente.
    • Si el agente WEM ya está instalado, el campo de carpeta de destino se rellena automáticamente con la ruta de acceso de la carpeta de instalación existente.
  5. En la página Tipo de implementación, seleccione el tipo de implementación aplicable y, a continuación, haga clic en Siguiente. En este caso, selecciona Cloud Service Deployment.

    Instalación del agente WEM 01

  6. En la página Configuración de Cloud Service, especifique Citrix Cloud Connectors al que se conecta el agente y, a continuación, haga clic en Siguiente.

    • Omitir configuración. Seleccione esta opción si ya ha configurado la configuración mediante Directiva de grupo.
    • Configurar Citrix Cloud Connectors. Permite configurar Citrix Cloud Connectors escribiendo una lista separada por comas de FQDN o direcciones IP de Cloud Connectors.

    Nota:

    -  Escriba el FQDN o la dirección IP de cada Citrix Cloud Connector. Asegúrese de separar los FQDN o las direcciones IP con comas (,).
    
    • En situaciones en las que se configuran varios Cloud Connectors, el agente WEM selecciona aleatoriamente de la lista un Cloud Connector al que se puede acceder. Este diseño tiene la intención de distribuir el tráfico en todos los Cloud Connectors.

    Instalación del agente WEM 02

  7. En la página Configuración avanzada, configure la configuración avanzada para el agente y, a continuación, haga clic en Siguiente.

    • Ubicación de caché alternativa (opcional). Permite especificar una ubicación alternativa para la caché del agente. Haga clic en Examinar para navegar hasta la carpeta correspondiente.
    • Demora de sincronización extra de VueMapPCMD (opcional). Permite especificar cuánto tiempo espera el iniciador de aplicaciones del agente (VUEMAppCmd.exe) antes de que se inicien los recursos publicados. Esto garantiza que el trabajo del agente necesario se complete primero. El valor predeterminado es 0.

    Nota:

    El valor que escriba para el intervalo de retardo de sincronización adicional debe ser un entero mayor o igual que cero.

    Instalación del agente WEM 03

  8. En la página Listo para instalar, haga clic en Instalar.
  9. Haga clic en Finalizar para salir del asistente de instalación.

Como alternativa, puede elegir una instalación silenciosa del agente WEM mediante la línea de comandos. Para ello, utilice la siguiente línea de comandos:

  • Citrix Workspace Environment Management Agent.exe /quiet Cloud=1

También puede utilizar opciones de línea de comandos para especificar argumentos personalizados. Al hacerlo, puede personalizar la configuración del agente y del sistema durante el proceso de instalación. Para obtener más información, consulte Información útil.

Tras la instalación, el agente se ejecuta como los siguientes servicios: Citrix WEM Agent Host Service y Servicio de inicio de sesión de usuario de Citrix WEM Agent. El agente se ejecuta como cuenta LocalSystem. No se admite el cambio de esta cuenta. Los servicios del agente requieren el permiso “iniciar sesión como sistema local”.

Paso 5: Reinicie la máquina para completar las instalaciones

Qué hacer a continuación

Si quiere migrar su base de datos WEM local existente al servicio WEM, consulte Migrar.

Para comenzar directamente con el servicio WEM, inicie la consola de administración y configure allí los ajustes según sea necesario. Consulte Administrar.

Requisitos previos y recomendaciones

Para garantizar que el agente WEM funciona correctamente, tenga en cuenta los siguientes requisitos previos y recomendaciones:

Requisitos previos

Compruebe que se cumplen los siguientes requisitos:

  • El servicio de notificación de eventos del sistema de Windows está configurado para iniciarse automáticamente al inicio.

  • Los servicios del agente WEM Citrix WEM Agent Host Service y Citrix WEM User Logon Service están configurados para iniciarse automáticamente al inicio.

  • La caché del agente reside en una ubicación persistente siempre que es posible. El uso de una ubicación de caché no persistente puede provocar posibles problemas de sincronización de la caché, uso excesivo de datos de red, problemas de rendimiento, etc.

  • Si la caché del agente reside en una ubicación no persistente, siga los siguientes pasos antes de sellar la imagen base:

    1. Detenga el servicio host del agente Citrix WEM.
    2. Elimine los siguientes archivos de base de datos local del agente: LocalAgentCache.db y LocalAgentDatabase.db.

Recomendaciones

Siga las recomendaciones de esta sección para que la implementación del agente sea correcta:

  • No opere manualmente Citrix WEM Agent Host Service, por ejemplo, mediante scripts de inicio de sesión o inicio. Las operaciones como detener o reiniciar Citrix WEM Agent Host Service pueden impedir que el servicio Netlogon funcione, lo que provoca problemas con otras aplicaciones.

  • No utilice scripts de inicio de sesión para iniciar agentes en modo IU o CMD. De lo contrario, es posible que algunas funcionalidades no funcionen.

Comportamientos de inicio del agente

  • Citrix WEM Agent Host Service vuelve a cargar automáticamente la configuración de Cloud Connector configurada mediante la directiva de grupo después de que se inicie el servicio.

  • Elservicio de inicio de sesión de usuario de Citrix WEM Agent inicia automáticamente Citrix WEM Agent Host Service si el servicio host del agente no se inicia durante el primer inicio de sesión. Este comportamiento garantiza que la configuración del usuario se procese correctamente.

  • Citrix WEM Agent Host Service realiza comprobaciones automáticamente de los siguientes archivos de base de datos locales al inicio: LocalAgentDatabase.db y LocalAgentDatabase.db. Si se aprovisiona la máquina virtual y los archivos de base de datos locales proceden de la imagen base, los archivos de base de datos se purgan automáticamente.

  • Cuando se inicia Citrix WEM Agent Host Service, verifica automáticamente que la caché local del agente se haya actualizado recientemente. Si la caché no se ha actualizado durante más de dos intervalos de tiempo de sincronización de caché configurados, la caché se sincroniza inmediatamente. Por ejemplo, supongamos que el intervalo de sincronización de la caché del agente predeterminado es de 30 minutos. Si la caché no se ha actualizado en los últimos 60 minutos, se sincroniza inmediatamente después de iniciar Citrix WEM Agent Host Service.

  • Durante la instalación, el instalador del agente WEM configura el servicio Windows System Event Notification Service para que se inicie automáticamente.

  • El instalador del agente WEM inicia automáticamente el servicio Netlogon una vez finalizada la actualización del agente WEM.

Opciones de utilidad de caché del agente

Citrix WEM Agent Host Service gestiona la configuración de la actualización y la sincronización de la caché automáticamente. Utilice la utilidad de caché de agentes solo en situaciones en las que sea necesario actualizar inmediatamente la configuración y sincronizar la caché.

Utilice la línea de comandos para ejecutar AgentCacheUtility.exe en la carpeta de instalación del agente. El ejecutable acepta los siguientes argumentos de línea de comandos:

  • -help: Muestra una lista de argumentos permitidos.
  • -RefreshCache o -r: Activa una compilación o actualización de la caché.
  • -RefreshSettings o -S: Actualiza la configuración del host del agente.
  • -Reinitialize o -I: Reinicializa la caché del agente cuando se utiliza junto con la opción -RefreshCache.

Consulte los siguientes ejemplos para obtener información detallada sobre cómo utilizar la línea de comandos:

  • Actualizar la configuración del host del agente:
    • AgentCacheUtility.exe -RefreshSettings
  • Actualizar la configuración del host del agente y la caché de agentes simultáneamente:
    • AgentCacheUtility.exe -RefreshSettings -RefreshCache
  • Reinicialice la caché de agentes:
    • AgentCacheUtility.exe -RefreshCache -Reinitialize

Información útil

El ejecutable del agente acepta argumentos personalizados como se describe a continuación.

Configuración del agente

Consulte a continuación la configuración del agente WEM.

  • Ubicación del agente. Permite especificar la ubicación de instalación del agente. Especifique una ruta de acceso de carpeta válida.

  • Lista de Cloud Connector. Permite especificar el FQDN o la dirección IP de cada Citrix Cloud Connector. Asegúrese de separar FQDN o direcciones IP con comas (,).

  • Retraso de VueMap CMD. Permite especificar cuánto tiempo espera el iniciador de aplicaciones del agente (VUEMAppCmd.exe) antes de que se inicien los recursos publicados de Citrix Virtual Apps and Desktops. El valor predeterminado es 0 (milisegundos). El valor que escriba para el intervalo de retardo de sincronización adicional debe ser un entero mayor o igual que cero.

  • Ubicación de caché del agente. Permite especificar una ubicación alternativa para la caché del agente. Si se configura, el archivo de caché local del agente se guarda en la ubicación designada en lugar de en la carpeta de instalación del agente.

Tenga en cuenta lo siguiente:

  • Si la configuración se configura a través de la línea de comandos, el instalador del agente WEM utiliza la configuración configurada.

  • Si las opciones no se configuran a través de la línea de comandos y existen configuraciones previamente configuradas, el instalador utiliza las opciones configuradas anteriormente.

  • Si la configuración no se configura a través de la línea de comandos y no hay opciones previamente configuradas, el instalador utiliza la configuración predeterminada.

Configuración del sistema

Consulte a continuación la configuración del sistema asociada con el equipo host del agente.

  • Valor de directiva de tiempo de espera de inicio de red de GPS. Permite configurar el valor, en segundos, de la clave de registro GPNetworkStartTimeoutPolicyValue creada durante la instalación. Este argumento especifica cuánto tiempo espera la directiva de grupo a las notificaciones de disponibilidad de red durante el procesamiento de directivas al iniciar sesión. El argumento acepta cualquier número entero en el rango de 1 (mínimo) a 600 (máximo). De forma predeterminada, este valor es 120.

  • Directiva de sincronía de primer plano. Permite configurar el valor del Registro SyncForegRoundPolicy durante la instalación del agente. Esta configuración de directiva determina si el procesamiento de directiva de grupo es sincrónico. Valores aceptados: 0, 1. Si el valor no está establecido o establece el valor en 0, el servicio de inicio de sesión de usuario de Citrix WEM Agent no retrasa los inicios de sesión y la configuración de directivas de grupo de usuario se procesa en segundo plano. Si establece el valor en 1, el servicio de inicio de sesión de usuario de Citrix WEM Agent retrasa los inicios de sesión hasta que finalice el procesamiento de la configuración de directivas de grupo del usuario. De forma predeterminada, el valor no cambia durante la instalación.

    Importante:

    Si la configuración de directivas de grupo se procesa en segundo plano, el Shell de Windows (Explorador de Windows) puede iniciarse antes de que se procesen todas las configuraciones de directiva. Por lo tanto, es posible que algunos ajustes no surtan efecto la primera vez que un usuario inicia sesión. Si quiere que se procese toda la configuración de directiva la primera vez que un usuario inicia sesión, establezca el valor en 1.

  • Espere a la red. Permite configurar el valor, en segundos, de la clave de registro WaitForNetwork creada durante la instalación. Este argumento especifica cuánto tiempo espera el host del agente a que la red esté completamente inicializada y disponible. El argumento acepta cualquier número entero en el rango de 0 (mínimo) a 300 (máximo). De forma predeterminada, este valor es 30.

Las tres claves anteriores se crean en HKEY_LOCAL_MACHINE\ SOFTWARE\ Microsoft\ Windows NT\ CurrentVersion\ Winlogon durante la instalación. Las claves sirven para garantizar que el entorno de usuario reciba los GPO de dirección del servidor de infraestructura antes del inicio de sesión. En entornos de red en los que los servidores de Active Directory o Controlador de dominio son lentos para responder, esto podría dar lugar a un tiempo de procesamiento adicional antes de que aparezca la pantalla de inicio de sesión. Citrix recomienda establecer el valor de la clave GPNetworkStartTimeOutPolicyValue en un mínimo de 30 para que tenga un impacto.

  • Servicios Pipetime out. Le permite configurar el valor de la clave del Registro ServicePipetimeout. La clave se crea durante la instalación en HKEY_LOCAL_MACHINE\ SYSTEM\ CurrentControlSet\ Control. Esta clave del Registro agrega un retraso antes de que el administrador de control de servicios pueda informar sobre el estado del servicio del agente WEM. El retraso impide que el agente falle al impedir que el servicio del agente se inicie antes de que se inicialice la red. Este argumento acepta cualquier valor, en milisegundos. Si no se especifica, se utiliza un valor predeterminado de 60000 (60 segundos).

    Nota:

    Si las opciones anteriores no se configuran mediante la línea de comandos, el instalador del agente WEM no las procesa durante la instalación.

Ejemplos

También puede configurar los parámetros mediante el siguiente formato de línea de comandos:

  • "Citrix Workspace Environment Management Agent.exe" <key=value>

Por ejemplo:

  • Especificar la ubicación de instalación del agente y Citrix Cloud Connectors
    • "Citrix Workspace Environment Management Agent.exe" /quiet AgentLocation="L:\WEM Agent" Cloud=1 CloudConnectorList=cc1.qa.local,cc2.qa.local
  • Establecer “tiempo de espera de red de inicio de sesión de usuario” en 60 segundos
    • "Citrix Workspace Environment Management Agent.exe" WaitForNetwork=60