Workspace Environment Management

Agente

Instalar y configurar el agente

Nota:

  • No instale el agente de Workspace Environment Management (WEM) en el servidor de infraestructura.
  • No instale el agente de WEM y la consola de administración en el mismo equipo.
  • Si quiere asignar recursos publicados en los almacenes de Citrix StoreFront como accesos directos a aplicaciones en WEM desde la consola de administración, asegúrese de que la aplicación Citrix Workspace para Windows esté instalada en la consola de administración y en los equipos host del agente. Para obtener más información, consulte Requisitos del sistema.

Paso 1: Configurar directivas de grupo (opcional)

Si quiere, puede elegir configurar las directivas de grupo para el agente mediante la plantilla administrativa de directivas de grupo de agentes. El paquete de instalación de WEM contiene esta plantilla. Los archivos de plantilla se dividen en archivos ADMX y archivos.adml específicos del idioma. Se recomienda configurar las directivas de grupo en el Controlador de dominio.

Para agregar la directiva de configuración de host del agente, siga estos pasos:

  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 carpeta Directivas de grupo de agentes > 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.

Utilice el Editor de administración de directivas de grupo para configurar un GPO con los siguientes valores:

Editor de administración de directivas de grupo

Servidor de infraestructura. La dirección del servidor de infraestructura WEM. Escriba el nombre o la dirección IP del equipo donde está instalado el servicio de infraestructura.

Puerto de servicio de agente. Puerto en el que el agente se conecta al servidor de infraestructura. El puerto de servicio del agente debe ser el mismo que el puerto configurado para el puerto de servicio del agente durante la configuración de los servicios de infraestructura. Si no se especifica, el puerto es 8286 por defecto.

Puerto de sincronización de caché. (Aplicable a Workspace Environment Management 1909 y anteriores; reemplazado por el puerto de sincronización de datos en caché en Workspace Environment Management 1912 y posteriores). El puerto en el que el proceso de sincronización de la memoria caché del agente se conecta al servicio de infraestructura para sincronizar la memoria caché del agente con el servidor de infraestructura. El puerto de sincronización de memoria caché debe ser el mismo que el puerto que configuró para el puerto de sincronización de memoria caché (Configuración delservicio de infraestructura WEM > Configuración de red) durante la configuración de los servicios de infraestructura. El puerto tiene un valor predeterminado 8285 y corresponde al argumento AgentCacheSyncPort de la línea de comandos.

Puerto de sincronización de datos almacenado en caché. (Aplicable a Workspace Environment Management 1912 y versiones posteriores; reemplaza el puerto de sincronización de caché de Workspace Environment Management 1909 y versiones anteriores). Puerto en el que se conecta el proceso de sincronización de la caché del agente al servicio de infraestructura para sincronizar la caché del agente con el servidor de infraestructura. El puerto de sincronización de datos almacenados en caché debe ser el mismo que el puerto que configuró para el puerto de sincronización de datos en caché (Configuración delservicio de infraestructura WEM > Configuración de red) durante la configuración de los servicios de infraestructura. El puerto tiene un valor predeterminado 8288 y corresponde al argumento CachedDataSyncPort de la línea de comandos. También puede especificar el puerto mediante una opción de línea de comandos en la instalación silenciosa del agente WEM. Por ejemplo:

  • citrix_wem_agent_bundle.exe /quiet CachedDataSyncPort=9000

Citrix Cloud Connectors. No se aplica a las versiones locales de WEM. Deje el estado No configurado.

Configuración de proxy de agente. No se aplica a las versiones locales de 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 2: 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.

Puede ejecutar Citrix Workspace Environment Management Agent Setup en su entorno de usuario. También puede optar por instalar el agente mediante la línea de comandos. De forma predeterminada, el agente se instala en una de las siguientes carpetas, dependiendo del sistema operativo:

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

Para instalar el agente de forma interactiva, siga estos pasos:

  1. Ejecute Citrix Workspace Environment Management Agent Setup.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. Este retraso ocurre 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 ir a la carpeta y, a continuación, haga clic en Siguiente.
    • Si ya ha instalado el agente WEM, 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, seleccione Implementación local.

    Instalación del agente WEM 01

  6. En la página Configuración de Infrastructure Service, especifique el servicio de infraestructura 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.
    • Configure el servicio de infraestructura. Permite configurar el servicio de infraestructura escribiendo el FQDN o la dirección IP del servicio de infraestructura.
    • Puerto de servicio de agente. De forma predeterminada, el valor es 8286.
    • Puerto de sincronización de datos almacenado en caché. De forma predeterminada, el valor es 8288.

    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 ir a la carpeta correspondiente. Como alternativa, puede hacerlo a través del registro. Para ello, primero detenga el servicio de host del agente Citrix WEM y, a continuación, modifique la siguiente clave de registro.

      HKEY_LOCAL_MACHINE\ SYSTEM\ CurrentControlSet\ Control\ Norskale\ Host del agente

      Nombre: AgentCacheAlternateLocation

      Tipo: REG_SZ

      Valor: vacío

      De forma predeterminada, el valor está vacío. La carpeta por defecto es: <WEM agent installation folder path>\Local Databases Set. Si es necesario, especifique una ruta de carpeta diferente. Para que los cambios surtan efecto, reinicie Citrix WEM Agent Host Service. Si el cambio surte efecto, aparecerán los siguientes archivos en la carpeta: LocalAgentCache.db y LocalAgentDatabase.db.

      Precaución:

      Si se modifica el Registro de forma incorrecta, pueden producirse problemas graves que obliguen a reinstalar el sistema operativo. Citrix no puede garantizar que los problemas derivados de la utilización inadecuada del Editor del Registro puedan resolverse. Si utiliza el Editor del Registro, será bajo su propia responsabilidad. Haga una copia de seguridad del Registro antes de modificarlo.

    • 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. La configuración de este retraso 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.

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

  • "Citrix Workspace Environment Management Agent Setup.exe" /quiet Cloud=0

Sugerencia:

Puede que desee consultar los archivos de registros para solucionar problemas de instalación del agente. De forma predeterminada, los archivos de registros que registran todas las acciones que se producen durante la instalación se crean en%TEMP%. Puede utilizar el comando /log log.txt para designar una ubicación específica para los archivos de registros que se van a guardar.

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

Tras la instalación, el agente se ejecuta como Citrix WEM Agent Host Service (anteriormente Norskale Agent Host Service) y Servicio de inicio de sesión de usuario de Citrix WEM Agent. El agente se ejecuta como cuenta LocalSystem. No admitimos el cambio de esta cuenta. El servicio requiere el inicio de sesión como permiso del sistema local.

Paso 3: Crear la caché del servicio del agente (opcional)

De forma predeterminada, la caché del servicio del agente se genera la primera vez que se ejecuta el agente. Puede elegir crear la caché del servicio del agente antes de que se ejecute el agente. Esto resulta útil si quiere crear una imagen que incluya el host del agente WEM como software preinstalado.

Para crear o reconstruir la memoria caché del servicio del agente, ejecute AgentCacheUtility.exe en la carpeta de instalación del agente mediante la línea de comandos. El ejecutable acepta estos argumentos de línea de comandos:

  • -help: muestra una lista de argumentos permitidos
  • -refreshcache o -r: desencadena una compilación o actualización de caché

Paso 4: Reiniciar la máquina para completar la instalación

Información útil

El ejecutable del agente acepta argumentos personalizados como se describe en las secciones Configuración del agente y Configuración del sistema.

Configuración del agente

La configuración del agente WEM incluye:

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

  • AgentCacheLocation. 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.

  • AgentCacheSyncPort. Permite especificar el puerto en el que se conecta el proceso de sincronización de la caché del agente al servicio de infraestructura para sincronizar la caché del agente con el servidor de infraestructura.

  • AgentServicePort. Permite especificar el puerto en el que el agente se conecta al servidor de infraestructura.

  • InfrastructureServer. Permite especificar el FQDN o la dirección IP del servidor de infraestructura en el que se ejecuta el servicio de infraestructura.

  • VUEMAppCmdDelay. 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.

Tenga en cuenta lo siguiente:

  • Si configura los valores a través de la línea de comandos, el instalador del agente WEM utiliza los parámetros configurados.

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

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

Configuración del sistema

La configuración del sistema asociada con el equipo host del agente incluye:

  • GpNetworkStartTimeoutPolicyValue. 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.

  • SyncForegroundPolicy. 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 parámetros 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.

  • WaitForNetwork. 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 garantizan que el servicio del agente WEM se inicie antes de que aparezca la pantalla de inicio de sesión de Windows. Las tres claves se crean en HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Winlogon durante la instalación. Las claves también garantizan 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, podría producirse un tiempo de procesamiento adicional antes de que aparezca la pantalla de inicio de sesión. Le recomendamos que establezca el valor de la clave GpNetworkStartTimeoutPolicyValue en un mínimo de 30 para que tenga un impacto.

  • ServicesPipeTimeout. Le permite configurar el valor de la clave del Registro ServicesPipeTimeout. 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 no configura los valores anteriores mediante la línea de comandos, el instalador del agente WEM no los procesa durante la instalación.

Ejemplos

Puede configurar los parámetros mediante el siguiente formato de línea de comandos:

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

Por ejemplo:

  • Elija una instalación silenciosa o una actualización del agente WEM
    • "Citrix Workspace Environment Management Agent Setup.exe" /quiet Cloud=0
  • Establecer el tiempo de espera de inicio de sesión de usuario en 60 segundos
    • "Citrix Workspace Environment Management Agent Setup.exe" WaitForNetwork=60
Agente