Solución de problemas

En este artículo se proporciona información para ayudar a los administradores a solucionar problemas con la aplicación Citrix Workspace.

Conexión

Es posible que se tope con los siguientes problemas de conexión.

Inicio de ICA en Fedora 29/30

Es posible que ICA no se pueda iniciar en Fedora 29/30. Como solución temporal, siga estos pasos:

1. Instale compat-openssl10 con el comando.

   sudo yum install compat-openssl10.x86_64

2. Establezca la variable de entorno en ~/.bashrc para carga en cada sesión. Esta acción apunta a la biblioteca libcrypto antigua.

   export LD_PRELOAD=/lib64/libcrypto.so.1.0.2o

Nota:

La aplicación Citrix Workspace funciona bien en el servidor X.Org, en comparación con el compositor Wayland. Para las distribuciones que tienen Wayland como protocolo de gráficos predeterminado, quite la marca de comentario de cualquiera de las siguientes opciones:

WaylandEnable=false en /etc/gdm/custom.conf o en /etc/gdm3/custom.conf

Cierre sesión e inicie sesión de nuevo para apuntar al servidor de X.Org.

Sesión de escritorio o recurso publicado

Al establecer una conexión con un servidor de Windows, si aparece un cuadro de diálogo con el mensaje “Connecting to server…”, pero luego no aparece ninguna ventana de conexión, es posible que deba configurar el servidor con una licencia de acceso de cliente (CAL). Para obtener más información sobre las licencias, consulte Licencias.

Reconexión de sesión

Es posible que la conexión falle al conectarse de nuevo a una sesión con una profundidad de color superior a la que requiere la aplicación Citrix Workspace. Este error se produce cuando se agota la memoria disponible en el servidor.

Si la reconexión falla, la aplicación Citrix Workspace intenta utilizar la profundidad de color original. En caso contrario, el servidor intenta iniciar una sesión nueva con la profundidad de color solicitada, con lo que deja la sesión original en estado desconectado. Es posible que la segunda conexión falle si sigue faltando memoria en el servidor.

Nombre completo de Internet

Citrix recomienda configurar el DNS (servidor de nombres de dominio) en la red. Esta configuración le permite resolver los nombres de los servidores a los que quiere conectarse. Si el servidor DNS no está configurado, quizás no sea posible resolver el nombre de un servidor en una dirección IP. Como alternativa, puede especificar el servidor por su dirección IP, en lugar de hacerlo por su nombre. Las conexiones TLS requieren un nombre de dominio completo, no una dirección IP.

Sesiones lentas

Si una sesión no se inicia hasta que mueva el mouse, puede que haya un problema con la generación del número aleatorio en el kernel de Linux. Como solución temporal, ejecute un demonio que genere entropía, como rngd (que está basado en hardware) o haveged (de Magic Software).

Conjuntos de cifrado

Si su conexión falla con la nueva función de cifrado:

1. Puede utilizar varias herramientas para comprobar los conjuntos de cifrado que admite su servidor, donde se incluyen:
   • Ssllabs.com (requiere que el servidor tenga acceso a Internet)
   • sslyze (https://github.com/nabla-c0d3/sslyze)
2. En Linux Client WireShark, busque el paquete (Client Hello, Server Hello) con el filtro (ip.addr == VDAIPAddress) para encontrar la sección SSL. El resultado tiene los conjuntos de cifrado enviados por el cliente y aceptados por el servidor.

Citrix Optimization SDK incorrecto

El paquete Citrix Optimization SDK incluye una versión incorrecta de UIDialogLibWebKit.so. Como solución temporal, haga lo siguiente:

1. Descargue la versión 18.10 del paquete del SDK de Citrix Optimization de la página Descargas.

   1. Vaya a la ruta CitrixPluginSDK/UIDialogLib/GTK:

      cd CitrixPluginSDK/UIDialogLib/GTK

   2. Elimine todos los archivos objeto:

      rm -rf *.o

   3. Vaya a la carpeta WebKit:

      cd ../WebKit

   4. Retire el UIDialogLibWebKit.so existente:

      rm -rf UIDialogLibWebKit.so

   5. Utilice el siguiente comando en el directorio WebKit:

      make all

      Se genera el nuevo UIDialogLibWebKit.so.

   6. Copie la nueva biblioteca en el directorio $ICAROOT/lib.

Conjuntos de cifrado débiles para las conexiones SSL

Al establecer una conexión TLS, la aplicación Citrix Workspace ofrece de forma predeterminada una serie de conjuntos de cifrado avanzados y restringidos.

Si se conecta a un servidor que requiere un conjunto de cifrado más antiguo, establezca la opción de configuración SSLCiphers=ALL en la sección [WFClient\] de un archivo de configuración.

Se admiten los siguientes conjuntos de cifrado avanzado:

• TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (0xc030), ALL, GOV
• TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384 (0xc028), ALL, GOV
• TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA (0xc013), ALL, COM

Pérdida de conexión

Al usar el protocolo EDT, es posible que aparezca este mensaje de error: La conexión con “…” se ha perdido. Este problema puede ocurrir si la conexión pasa a través de un enrutador con una unidad de transmisión máxima para EDT que es inferior al valor predeterminado de 1500 bytes. Haga lo siguiente:

• Defina edtMSS=1000 en un archivo de configuración.

Errores de conexión

Los errores de conexión pueden producir varios diálogos de error diferentes. Por ejemplo:

• “Error in connection: A protocol error occurred while communicating with the Authentication Service”
• “The Authentication Service cannot be contacted”
• “Your account cannot be added using this server address”

Estos errores pueden deberse a varios problemas, por ejemplo:

• Cuando el equipo local y el equipo remoto no pueden negociar un protocolo TLS común. Para obtener más información, consulte TLS.
• Cuando el equipo remoto requiere un conjunto de cifrado más antiguo para una conexión TLS. En este caso, puede establecer la opción de configuración SSLCiphers=ALL en la sección \[WFClient\] de un archivo de configuración y ejecutar killall AuthManagerDaemon ServiceRecord selfservice storebrowse antes de reiniciar la conexión.
• Cuando el equipo remoto no pide el certificado de cliente de la manera apropiada. IIS solo debe aceptar o solicitar certificados para Citrix, Authentication y Certificate.
• Otros problemas.

Conexiones con ancho de banda reducido

Citrix recomienda utilizar la versión más reciente de Citrix Virtual Apps and Desktops o Citrix DaaS (antes denominado Citrix Virtual Apps and Desktops Service) en el servidor. Igualmente, use la aplicación Citrix Workspace más reciente en el dispositivo del usuario.

Si utiliza una conexión con poco ancho de banda, puede realizar cambios en la configuración de la aplicación Citrix Workspace y en la forma en que la utiliza para mejorar el rendimiento.

• Configure la conexión de la aplicación Citrix Workspace: La configuración de las conexiones de la aplicación Citrix Workspace puede reducir el ancho de banda que ICA requiere y, así, mejorar el rendimiento.
• Cambie la forma en que se utiliza la aplicación Citrix Workspace: Cambiar la forma en que se utiliza la aplicación Citrix Workspace también puede reducir el ancho de banda requerido para una conexión de alto rendimiento.
• Habilite el sonido UDP: Esta función puede mantener un nivel de latencia regular en redes sobrecargadas durante conexiones Voice-over-IP (VoIP).
• Utilice las versiones más recientes de la aplicación Citrix Workspace para Linux y Citrix Virtual Apps and Desktops o Citrix DaaS: Citrix aumenta y mejora constantemente el rendimiento en cada versión, y muchas funcionalidades de rendimiento requieren la versión más reciente de la aplicación Citrix Workspace y el software de servidor.

Pantalla

Pantalla partida

El problema de pantalla partida se produce cuando dos o más fotogramas distintos aparecen en pantalla al mismo tiempo, en bloques horizontales. Este problema se ve principalmente en áreas grandes de contenido que cambia rápidamente en la pantalla.

Se evita este artefacto cuando se capturan datos en el VDA. Este artefacto no se da cuando los datos se pasan al cliente. Sin embargo, X11 (el subsistema de gráficos de Linux/Unix) no proporciona una forma consistente de dibujar en la pantalla para evitar el artefacto.

Para evitar la pantalla partida, Citrix recomienda el enfoque estándar, que sincroniza el dibujo de la aplicación con el dibujo de la pantalla. Es decir, esperar a que vsvnc inicie el dibujo del fotograma siguiente. Según el hardware gráfico del cliente y el administrador de ventanas que utilice, están disponibles los dos grupos de soluciones siguientes para evitar que la pantalla se parta:

• Parámetros de GPU de X11
• Usar un administrador de composición

Parámetros de GPU de X11

Para gráficos Intel HD, cree un archivo llamado 20-intel.conf en la carpeta xorg.conf.d, con este contenido:

Section "Device"

 Identifier    "Intel Graphics"
 Driver        "intel"
 Option        "AccelMethod" "sna"
 Option        "TearFree" "true"

 EndSection

Para gráficos de NVIDIA, busque en la carpeta xorg.conf.d el archivo que incluya la opción “MetaModes” para su configuración. Para cada uno de los MetaModes utilizados, separados por comas, agregue lo siguiente:

{ForceFullCompositionPipeline = On}

Por ejemplo:

Opción: “MetaModes” “DFP-0: 1920x1200 +0+0 {ForceFullCompositionPipeline = On}”

Nota:

Las distintas distribuciones de Linux usan rutas diferentes para la carpeta xorg.conf.d. Por ejemplo: /etc/X11/xorg.conf.d o /user/share/X11/xorg.conf.d.

Administradores de composición

Use lo siguiente:

• Compiz (integrado en Ubuntu Unity). Instale el administrador de parámetros “CompizConfig Settings Manager”.

  Ejecute “CompizConfig Settings Manager”.

  En General > Composition, desmarque la casilla Undirect Fullscreen Windows.

Nota:

Utilice “CompizConfig Settings Manager” con atención, ya que, si se cambian incorrectamente sus valores, el sistema puede dejar de responder y no iniciarse.

• Compton (una herramienta instalada como complemento). Consulte la documentación o la página principal de Compton para ver todos los detalles. Por ejemplo, ejecute el comando:

  compton --vsync opengl --vsync -aggressive

Entradas de teclado incorrectas

Si utiliza un teclado en un idioma que no sea el inglés, es posible que la presentación en la pantalla no coincida con las entradas del teclado. En este caso, debe especificar el tipo y la distribución del teclado que utiliza. Para obtener más información acerca de la especificación de teclados, consulte Control del comportamiento del teclado.

Redibujado excesivo

Algunos administradores de ventanas informan continuamente de la posición nueva de las ventanas integradas al moverlas, lo que puede producir un redibujado excesivo. Para solucionar este problema, cambie el administrador de ventanas a un modo que solo dibuje los contornos de las ventanas cuando se muevan.

Compatibilidad de iconos

La aplicación Citrix Workspace crea iconos de ventanas que son compatibles con la mayoría de los administradores de ventanas. Sin embargo, estos iconos no son totalmente compatibles con la convención de comunicaciones entre clientes de X.

Compatibilidad total de iconos

Para ofrecer una compatibilidad total de iconos:

1. Abra el archivo de configuración wfclient.ini.
2. Modifique la siguiente línea en la sección [WFClient]: UseIconWindow=True
3. Guarde el archivo y ciérrelo.

Color del cursor

Puede ser difícil ver el cursor si tiene el mismo color, o uno similar, al color del fondo. Para solucionar este problema, establezca que las áreas del cursor sean de color negro o blanco.

Para cambiar el color del cursor

1. Abra el archivo de configuración wfclient.ini.

2. Agregue una de las líneas siguientes a la sección [WFClient]:

   CursorStipple=ffff,ffff (para que el cursor sea negro)

   CursorStipple=0,0 (para que el cursor sea blanco)

3. Guarde el archivo y ciérrelo.

Flash de color

Cuando mueva el puntero en una ventana de conexión, o fuera de ella, los colores de la ventana fuera de foco comienzan a parpadear. Este problema es una limitación conocida cuando se utiliza X Windows System con presentaciones en PseudoColor. De ser posible, utilice una profundidad de color mayor para la conexión afectada.

Cambios de color en presentaciones en color verdadero

Los usuarios tienen la opción de utilizar 256 colores cuando se conectan a un servidor. En esta opción se asume que el hardware del vídeo admite paletas, para permitir que las aplicaciones cambien rápidamente los colores de la paleta con el fin de producir presentaciones animadas.

Las presentaciones en color verdadero no tienen ninguna capacidad para emular la habilidad de producir animaciones cambiando rápidamente la paleta. La emulación de software de este recurso es costosa en tiempo y en tráfico de red. Para reducir este coste, la aplicación Citrix Workspace almacena en búfer los cambios rápidos de la paleta y actualiza la paleta real solamente cada pocos segundos.

Pantalla incorrecta

La aplicación Citrix Workspace utiliza la codificación de caracteres EUC-JP o UTF-8 para los caracteres japoneses, mientras que el servidor utiliza la codificación de caracteres SJIS. La aplicación Citrix Workspace no traduce entre estos grupos de caracteres. Este problema puede provocar problemas de visualización de:

• Archivos que se guardan en el servidor y se ven localmente
• Archivos que se guardan localmente y se ven en el servidor

Este problema afecta además a los caracteres japoneses en los parámetros utilizados en el traspaso de parámetros extendidos.

Extensión de sesión

Las sesiones de pantalla completa abarcan todos los monitores, pero también está disponible una opción de línea de comandos para el control de la presentación en entornos de varios monitores, -span. Con esta opción se pueden ejecutar sesiones de pantalla completa y abarcar monitores adicionales.

La funcionalidad de la barra de herramientas de Desktop Viewer le permite alternar entre una sesión en modo de ventana y una sesión a pantalla completa; además, admite varios monitores para los monitores intersecados.

Importante:

Span no tiene ningún efecto en sesiones de ventanas integradas o normales (incluidas aquellas sesiones en ventanas maximizadas).

La opción -span tiene el siguiente formato: -span [h][o][a|mon1[,mon2[,mon3, mon4]]]

Si se especifica h, se imprime una lista de monitores en stdout. Si h es el valor completo de la opción, wfica se cierra.

Si o se especifica, la ventana de la sesión tendrá el atributo override-redirect.

Precaución:

• No se recomienda usar esta opción. Debe considerarse como última opción y solo utilizarse con administradores de ventanas que presenten dificultades de uso.
• El administrador de ventanas no ve la ventana de la sesión; además, la ventana no tiene icono y no se puede volver a apilar.
• Solo se podrá quitar finalizando la sesión.

Si se especifica a, la aplicación Citrix Workspace intenta crear una sesión que cubra todos los monitores.

La aplicación Citrix Workspace supone que el resto del valor de la opción -span es una lista de números de monitores.

• Un solo valor selecciona un monitor específico.
• Si hay dos valores, se seleccionan los monitores de las esquinas superior izquierda e inferior derecha del área requerida.
• Si hay cuatro valores, se especifican los monitores de los bordes superior, inferior, izquierdo y derecho del área.

Si no se especificó o, wfica utiliza el mensaje _NET_WM_FULLSCREEN_MONITORS para solicitar una disposición de ventanas adecuada desde el administrador de ventanas, en caso de que se admita. De lo contrario, utiliza las directrices de tamaño y posición para solicitar la disposición deseada.

El siguiente comando se puede utilizar para probar la función del administrador de ventanas: xprop -root | grep \_NET\_WM\_FULLSCREEN\_MONITORS

Si no obtiene resultados, no hay función disponible. Si no la hay, es posible que necesite una ventana con el atributo override-redirect. Puede configurar una ventana con el atributo override-redirect mediante -span o.

Para crear una sesión que abarque monitores adicionales desde la línea de comandos:

1. Escriba lo siguiente en una interfaz de comandos:

   /opt/Citrix/ICAClient/wfica -span h

   Se imprime una lista de los números de los monitores actualmente conectados al dispositivo del usuario en stdout y wfica se cierra.

2. Tome nota de estos números de monitores.

3. Escriba lo siguiente en una interfaz de comandos:

   /opt/Citrix/ICAClient/wfica -span \[w\[,x\[,y,z\]\]\]

   Los valores w, x, y z son números de monitor del paso 1 de las etapas anteriores. El valor único w indica un monitor específico. Los valores w y x especifican los monitores de las esquinas superior izquierda e inferior derecha del área requerida. Los cuatro valores w, x, y y z especifican monitores en los bordes superior, inferior, izquierdo y derecho del área.

   Importante:

   • Defina la variable WFICA_OPTS antes de iniciar el autoservicio a través de un explorador web. Para definir esta variable, modifique su archivo de perfil que, por lo general, se encuentra en $HOME/.bash_profile o $HOME/.profile, y agregue una línea para definir la variable WFICA_OPTS. Por ejemplo:

     export WFICA_OPTS="-span a"

   • Este cambio afecta tanto a las sesiones de aplicaciones virtuales como a las de escritorios virtuales.
   • Si ha iniciado self-service o storebrowse, quite los procesos que se iniciaron para que la nueva variable de entorno surta efecto. Quítelos con:

   killall AuthManagerDaemon ServiceRecord storebrowse

Aplicaciones locales

Es posible que no pueda salir de una sesión a pantalla completa para utilizar aplicaciones locales u otras sesiones. Este problema ocurre porque la IU del sistema del cliente está oculta y la función de transparencia de teclado inhabilita el comando habitual del teclado (por ejemplo, Alt+Tab) y, en su lugar, envía el comando al servidor.

Como solución temporal, presione Ctrl+F2 para desactivar temporalmente la función de teclado transparente hasta que la ventana de la sesión vuelva a estar activa y en primer plano. Otra solución temporal es establecer TransparentKeyPassthrough en No en $ICAROOT/config/module.ini. Esta solución temporal inhabilita la función de transparencia de teclado. Sin embargo, es posible que deba supeditar el archivo ICA. Para ello, agregue este parámetro al archivo All_regions.ini.

Cámara web

Actualizar la cámara web predeterminada

Por ahora, la redirección de cámaras web en la aplicación Citrix Workspace para Linux solo admite una cámara web a la vez. La cámara web predeterminada seleccionada se asigna a la ruta del dispositivo /dev/video0, que es, generalmente, la cámara web integrada en equipos portátiles.

Para enumerar todos los dispositivos con funcionalidad de vídeo del sistema, debe instalar las herramientas v4l con el siguiente comando:

sudo apt-get install v4l-util
<!--NeedCopy-->

Enumere los dispositivos de vídeo con el siguiente comando:

v4l2-ctl --list-devices
<!--NeedCopy-->

Es posible que reciba un resultado como el siguiente:

user@user-pc:~ $ v4l2-ctl --list-devices
UVC Camera (046d:09a6) (usb-0000:00:14.0-1):
    /dev/video2
    /dev/video3
    /dev/media1
Integrated Camera: Integrated C (usb-0000:00:14.0-8):
    /dev/video0
    /dev/video1
    /dev/media0
<!--NeedCopy-->

Según el ejemplo anterior, hay dos cámaras web. Puede usar cualquiera de ellas. Citrix recomienda usar el primer índice. Hay un problema conocido con Ubuntu, por lo que es posible que aparezcan varios índices para una cámara web. En este ejemplo, puede usar /dev/video0 y /dev/video2.

Para configurar otra captura de vídeo como predeterminada, haga lo siguiente:

1. Vaya al archivo de configuración ~/.ICAClient/wfclient.ini y modifíquelo.

2. En la sección [WFClient], agregue este parámetro.

   HDXWebCamDevice=<device path>

Por ejemplo, agregue HDXWebCamDevice=/dev/video2 para configurar la cámara web asignada a /dev/video2 en un sistema.

Prestaciones para pruebas

En el cliente, el módulo de redirección de cámaras web se puede utilizar en varios modos para probar componentes aislados en las condiciones del entorno del cliente.

Modo de producción y depuración

Este modo compara la visualización de vídeo en el lado del VDA y los búferes reales que el codificador produce en el lado del cliente. Permite probar todo el proceso.

Para habilitar este modo:

1. Vaya al archivo de configuración ~/.ICAClient/wfclient.ini y modifíquelo.

2. Establezca el valor de HDXWebcamDebug en True.

   HDXWebcamDebug = True

Una vez habilitado este modo, el codificador genera estos archivos con los búferes, según el codificador utilizado:

• Para el codificador H264: /tmp/file_mode_buffers.h264
• Para el codificador Theora: /tmp/file_mode_buffers.theora

Este diagrama describe el modo de producción y depuración:

Modo probador de cámaras web

Este modo le permite probar la cámara web aislada del resto de los elementos del proceso.

./gst_read --buffers | -b BUFFERS_AMOUNT  [ --input_device | -i WEBCAM_DEVICE; default=/dev/video0]
<!--NeedCopy-->

Para habilitar el modo probador de cámaras web, ejecute los siguientes comandos desde la línea de comandos:

   cd /opt/Citrix/ICAClient/util
   <!--NeedCopy-->

   `$./gst_read -b 100 /dev/video0
   <!--NeedCopy-->

Después de habilitar este modo, aparece una vista previa de vídeo y se crea este archivo con los búferes sin procesar de la cámara web:

/tmp/wewbcam_buffers.buff

El único cambio requerido para el modo probador de cámaras web son las opciones --buffers (-b). También puede especificar el dispositivo de cámara web que quiere probar. Por ejemplo, observe lo siguiente:

• ./gst_read -buffers 150
• ./gst_read –buffers 100 –input_device /dev/video2

Este diagrama describe el modo probador de cámaras web:

Modo probador de codificadores

Este modo le permite probar el codificador aislado del proceso.

./gst_read --output_file | -o FILE_NAME [ --buffers | -b BUFFER_AMOUNT; default=10 0 ]  [ --enableH264  | -e ]
<!--NeedCopy-->

Para habilitar el modo probador de codificadores, ejecute los siguientes comandos desde la línea de comandos:

cd /opt/Citrix/ICAClient/util
<!--NeedCopy-->

./gst_read -o ~/file_buffers.h264 -e
 <!--NeedCopy-->

El único cambio requerido para este modo son las opciones --output_file (-o). También puede probar los codificadores Theora o H264 y el búfer que se generaría. Por ejemplo, observe lo siguiente:

• For H264: ./gst_read –output_file ~/file_buffers.h264 –buffers 200 –enableH264
• For Theora: ./gst_read -o ~/file_buffers.theora -b 100

Este diagrama describe el modo probador de codificadores:

Codificador de software H264

Si el codificador H264 basado en software no funciona correctamente, debe verificar sus dependencias mediante estos pasos:

1. Verifique si el plug-in de GStreamer de x264 esté en el sistema como parte de gstreamer-plugins-ugly. Si está disponible en la biblioteca libgstx264.so, ejecute este comando para verificarlo:

   gst-inspect-1.0 x264
   <!--NeedCopy-->
   

   

2. Ejecute este comando para verificar las dependencias de la biblioteca libgstx264.so:

   ldd /usr/lib/x86_64-linux-gnu/gstreamer-1.0/libgstx264.so
   <!--NeedCopy-->
   

   

Si el archivo libgstx264.so no está presente, debe instalar los plug-ins “Ugly” de GStreamer con el siguiente comando:

sudo apt-get install gstreamer1
0-plugins-ugly
<!--NeedCopy-->

Codificador de hardware H264

1. Verifique que el plug-in de vaapi GStreamer esté en el sistema como parte de gstreamer1.0-vaapi. Si está disponible en la biblioteca libgstvaapi.so, ejecute este comando para verificarlo:

   gst-inspect-1.0 vaapi
   <!--NeedCopy-->
   

   

2. Ejecute este comando para verificar las dependencias de la biblioteca libgstvaapi.so:

       ldd /usr/lib/x86_64-linux-gnu/gstreamer-1.0/libgstvaapi.so
   <!--NeedCopy-->
   

   

3. Resuelva las dependencias que falten.

Para instalar y configurar vaapi, siga la guía de instalación de GStreamer vappi.

Recopilar marcos de trabajo GStreamer internos y registros de gst_read

Como alternativa a los registros de ICAClient normales, debe recopilar los registros del módulo gst_read.

Haga lo siguiente para recopilar los registros:

1. Abra un terminal y ejecute los siguientes comandos:

   export GST_DEBUG=2, gst_read_debug:6
   <!--NeedCopy-->
   

   export GST_DEBUG_FILE=~/gst_read.log
   <!--NeedCopy-->
   

   Nota:

   Esta variable establece el nivel de captura de registros y el archivo donde almacenarlos. En este caso, establecemos el nivel 2 para el marco de trabajo GStreamer y el nivel 7 para el módulo gst_read. Para obtener más información, consulte este documento. Solo se recomienda establecer niveles de error y advertencia para el marco de trabajo interno GStreamer y el nivel de registro para gst_read.

2. Descargue un archivo ICA de un VDA válido.

3. En el mismo terminal, ejecute este comando para iniciar una sesión de VDA:

   cd /opt/Citrix/ICAClient
   <!--NeedCopy-->
   

   ./wfica   <ICA file path>/vda.ica
   <!--NeedCopy-->
   

El archivo gst_read.log se genera con el marco de trabajo interno GStreamer y los registros de gst_read.

Inspecciones de los procesos de GStreamer

Para ver los procesos reales que crea el marco de trabajo GStreamer, haga lo siguiente:

1. Cree una carpeta para almacenar los archivos DOT. Por ejemplo: gstIntPipes.
2. Abra un terminal y exporte GST_DEBUG_DUMP_DOT_DIR=<Absolute path>/gstIntPipes. Esta variable indica dónde GStreamer almacena los archivos DOT.
3. Descargue un archivo ICA de un VDA válido.

4. En el mismo terminal, ejecute estos comandos para iniciar una sesión de VDA:

   cd /opt/Citrix/ICAClient/
   <!--NeedCopy-->
   

   ./wfica <ICA file path>/vda.ica
   <!--NeedCopy-->
   

5. El directorio gstIntPipes incluye los archivos DOT. GStreamer genera un archivo DOT para cada cambio de estado en el proceso. Como resultado, puede inspeccionar todos los procesos creados. A continuación se muestra un ejemplo del conjunto de archivos DOT:

   

6. Instale una utilidad de archivos DOT para ver una representación visual de los procesos. Por ejemplo, Graphviz. Estas imágenes son ejemplos de un proceso bien y mal creado:

Proceso creado correctamente:

El proceso no se puede vincular:

Nota:

Para ampliar las imágenes anteriores o cualquier otra imagen, haga clic con el botón secundario en la imagen, seleccione Open image in new tab y amplíe la vista del explorador web según sea necesario.

Como se muestra en la imagen anterior, el segundo proceso no puede vincular el elemento GstCapsFilter y el elemento GstVaapiEncodeH264. Las prestaciones nunca se negocian por completo. Para obtener más información, consulte este documento.

Script de diagnóstico del sistema para RAVE

Proporcionamos un script, rave_troubleshooting.sh, para verificar si la configuración y las dependencias del sistema son adecuadas para admitir las extensiones de vídeo y audio remotos (RAVE).

Nota:

RAVE es una función de HDX que admite la redirección optimizada de cámaras web y la redirección del Reproductor de Windows Media para los VDA de Citrix.

Haga lo siguiente para ejecutar el script:

1. Haga clic en rave_troubleshooting.sh para descargar el script.
2. Abra el terminal de su máquina Linux.
3. Escriba rave_troubleshooting.sh --help o rave_troubleshooting.sh -h para ver los argumentos de la línea de comandos compatibles.

4. Escriba una de estas opciones:

   • rave_troubleshooting.sh -w o rave_troubleshooting.sh --webcam: Utilice este comando para comprobar la redirección de cámaras web. Este es el comando predeterminado.
   • rave_troubleshooting.sh -r o rave_troubleshooting.sh --rave: Use este comando para realizar comprobaciones de RAVE. Aparece una ventana emergente que reproduce un vídeo de prueba h264.

   Se muestran la configuración y las dependencias del sistema.

Explorador web

Explorador local

Al hacer clic en un enlace durante una sesión de Windows, el contenido aparece en un explorador local. La redirección de contenido servidor-cliente está habilitada en wfclient.ini. Esta redirección provoca que se ejecute una aplicación local. Para inhabilitar la redirección de contenido entre servidor y cliente, consulte Redirección de contenido servidor-cliente.

Acceso a los recursos publicados

Cuando accede a recursos publicados, el explorador le pide que guarde un archivo. Los exploradores web distintos de Firefox y Chrome pueden requerir cierta configuración para poder conectar con un recurso publicado. Sin embargo, al intentar acceder a un recurso con un clic en su icono en la página, el explorador web le solicitará guardar el archivo ICA.

Explorador específico

Si tiene problemas para utilizar un explorador web específico, configure la variable de entorno BROWSER para especificar la ruta local y el nombre del explorador web requerido antes de ejecutar setupwfc.

Explorador Firefox

Cuando inicie escritorios o aplicaciones en Firefox, si la página no responde, pruebe a habilitar el plug-in ICA.

Plug-in ICA en Firefox

Cuando el plug-in ICA está habilitado en Firefox, es posible que no se inicien ni las sesiones de escritorio ni las sesiones de aplicación En este caso, pruebe a inhabilitar el plug-in ICA.

Errores de configuración

Estos errores pueden producirse si configuró incorrectamente una entrada de conexión.

E_MISSING_INI_SECTION. Verifique el archivo de configuración: “…”. Falta la sección “…” en el archivo de configuración.

El archivo de configuración se modificó incorrectamente o está dañado.

E_MISSING_INI_ENTRY. Verifique el archivo de configuración: “…”. La sección “…” debe contener una entrada “…”.

El archivo de configuración se modificó incorrectamente o está dañado.

E_INI_VENDOR_RANGE. Verifique el archivo de configuración: “…”. El rango de proveedores de servidor X “…” en el archivo de configuración no es válido.

La información sobre el proveedor del servidor X en el archivo de configuración está dañada. Comuníquese con Citrix.

Errores de configuración de wfclient.ini

Estos errores pueden producirse si ha modificado incorrectamente wfclient.ini.

E_CANNOT_WRITE_FILE - No se puede escribir el archivo: “…”

Se produjo un problema al guardar la base de datos de la conexión; por ejemplo, no hay espacio en el disco.

E_CANNOT_CREATE_FILE - No se puede crear el archivo: “…”

Se produjo un problema al crear una base de datos de la conexión.

E_PNAGENT_FILE_UNREADABLE. No se puede leer el archivo Citrix Virtual Apps “…”: No existe tal archivo o directorio.

O bien:

No se puede leer el archivo de Citrix Virtual Apps “…”: permiso denegado.

Está intentando acceder a un recurso a través de un menú o un elemento de escritorio, pero el archivo de Citrix Virtual Apps and Desktops o Citrix DaaS del recurso no está disponible. Actualice la lista de los recursos publicados. Para hacerlo, seleccione Application Refresh en el menú View e intente acceder nuevamente al recurso. Si el error persiste:

• Compruebe las propiedades del icono del escritorio o del elemento del menú.
• Compruebe el archivo de Citrix Virtual Apps and Desktops o Citrix DaaS al que hace referencia el icono o el elemento.

Otros

Problemas de conexión

Es posible que también encuentre estos problemas.

Cerrar una sesión

Para saber si el servidor ha indicado a la aplicación Citrix Workspace que cierre una sesión, use el programa wfica. Este programa registra cuándo recibe un comando para finalizar la sesión desde el servidor.

Para grabar esta información en el sistema de syslog, agregue SyslogThreshold con el valor 6 a la sección [WFClient] del archivo de configuración. Este parámetro habilita la captura de registros de mensajes que tienen una prioridad de LOG_INFO o mayor. El valor predeterminado para SyslogThreshold es 4 (=LOG_WARNING).

Igualmente, para tener wfica, envíe la información a la salida de “standard error” y agregue PrintLogThreshold con el valor 6 a la sección [WFClient]. El valor predeterminado de PrintLogThreshold es 0 (=LOG_EMERG).

Para obtener más información sobre cómo iniciar sesión, consulte Captura de registros y, para obtener más información sobre la configuración de syslog, consulte Configuración de Syslog.

Parámetros del archivo de configuración

Para cada entrada de wfclient.ini, debe haber una entrada correspondiente en All_Regions.ini para que el parámetro tenga efecto. Además, para cada entrada en las secciones [Thinwire3.0], [ClientDrive] y [TCP/IP] de wfclient.ini, debe haber una entrada correspondiente en canonicalization.ini para que el parámetro tenga efecto. Consulte los archivos All_Regions.ini y canonicalization.ini en el directorio $ICAROOT/config para obtener más información.

Aplicaciones publicadas

Si tiene problemas al ejecutar una aplicación publicada que accede a un puerto serie, es posible que falle (con o sin mensajes de error, según la aplicación propiamente dicha) si otra aplicación bloqueó el puerto. En tales circunstancias, verifique si hay alguna aplicación que haya bloqueado temporalmente el puerto serie, o bien, que haya bloqueado el puerto serie y que se haya cerrado sin desbloquearlo.

Para solucionar este problema, detenga la aplicación que está bloqueando el puerto serie. En cuanto a bloqueos del tipo UUCP, puede que se haya dejado un archivo de bloqueo después de que la aplicación finalice. La ubicación de estos archivos de bloqueo depende del sistema operativo que utilice.

Inicio de la aplicación Citrix Workspace

Si la aplicación Citrix Workspace no se inicia, aparece el mensaje de error “Application default file could not be found or is out of date”. Eso puede ocurrir porque la variable de entorno ICAROOT no se definió correctamente. Esta variable es un requisito si instaló la aplicación Citrix Workspace en una ubicación no predeterminada. Para solucionar este problema, Citrix recomienda que realice alguna de las siguientes acciones:

• Defina ICAROOT como el directorio de instalación.

  Para verificar que la variable de entorno ICAROOT está definida correctamente, intente iniciar la aplicación Citrix Workspace desde una sesión de terminal. Si el mensaje de error continúa, es probable que la variable de entorno ICAROOT no esté definida correctamente.

• Vuelva a instalar la aplicación Citrix Workspace en la ubicación predeterminada. Para obtener más información sobre cómo instalar la aplicación Citrix Workspace, consulte Instalar y configurar.

  Si la aplicación Citrix Workspace se ha instalado anteriormente en la ubicación predeterminada, elimine el directorio /opt/Citrix/ICAClient o $HOME/ICAClient/platform antes de volver a instalarla.

Citrix CryptoKit (anteriormente, SSLSDK)

Para encontrar el número de versión de Citrix CryptoKit (anteriormente SSLSDK) o de OpenSSL que se está utilizando, puede utilizar este comando: strings libctxssl.so | grep "Citrix SSLSDK"

También puede ejecutar este comando en AuthManagerDaemon o en PrimaryAuthManager.

Teclas de acceso rápido

Si el administrador de ventanas utiliza las mismas combinaciones de teclas para proporcionar funcionalidad nativa, las combinaciones de teclas podrían no funcionar correctamente. Por ejemplo, el administrador de ventanas KDE utiliza las combinaciones de teclas desde CTRL+MAYÚS+F1 a CTRL+MAYÚS+F4 para cambiar entre los escritorios 13 a 16. Si observa este problema, intente alguna de estas soluciones:

• El modo traducido en el teclado asigna un conjunto de combinaciones de teclas locales a combinaciones de teclas en el lado del servidor. Por ejemplo, de forma predeterminada en el modo traducido, la combinación CTRL+MAYÚS+F1 está asignada a la combinación ALT+F1 en el lado del servidor. Para reconfigurar esta asignación a una combinación de teclas local alternativa, actualice esta entrada de la sección [WFClient] del archivo $HOME/.ICAClient/wfclient.ini. Este parámetro asigna la combinación de teclas local Alt+Ctrl+F1 en Alt+F1:
  • Cambie Hotkey1Shift=Ctrl+Mayús por Hotkey1Shift=Alt+Ctrl.
• El modo directo en el teclado envía todas las combinaciones de teclas directamente al servidor. No se procesan localmente. Para configurar el modo directo, en la sección [WFClient] de $HOME/.ICAClient/wfclient.ini, defina TransparentKeyPassthrough con el valor Remote.
• Reconfigure el administrador de ventanas de modo que suprima las combinaciones de teclado predeterminadas.

Teclado croata remoto

Este procedimiento garantiza que los caracteres ASCII se envíen correctamente a los escritorios virtuales remotos con distribuciones de teclado croatas.

1. En la sección WFClient del archivo de configuración apropiado, establezca UseEUKSforASCII con el valor True.
2. Establezca UseEUKS con el valor 2.

Teclado japonés

Para configurar el uso del teclado japonés, actualice esta entrada en el archivo de configuración wfclient.ini:

KeyboardLayout=Japanese (JIS)

Teclado ABNT2

Para configurar el uso del teclado ABNT2, actualice esta entrada en el archivo de configuración wfclient.ini:

KeyboardLayout=Brazilian (ABNT2)

Teclado local

Si algunas teclas del teclado local no funcionan de la manera prevista, elija la mejor distribución de servidores de la lista que hay en $ICAROOT/config/module.ini.

Reproductor de Windows Media

Es posible que la aplicación Citrix Workspace no tenga los plug-ins de GStreamer para gestionar un formato solicitado. Normalmente, este problema hace que el servidor solicite un formato distinto. Algunas veces, la comprobación inicial de plug-ins adecuados indica, incorrectamente, que sí existen. Este problema debería detectarse y muestra un cuadro de diálogo de error en el servidor para indicar que el Reproductor de Windows Media encontró un problema al reproducir el archivo. Reproducir el archivo de nuevo dentro de la sesión suele funcionar porque la aplicación Citrix Workspace rechaza el formato. Por eso, el servidor solicita otro formato u ofrece los medios él mismo.

En algunas circunstancias, el hecho de que no haya plug-ins adecuados no se detecta y el archivo no se reproduce correctamente, a pesar de que el indicador de progreso se mueve como es debido en el Reproductor de Windows Media.

Para evitar ver este error o evitar el fallo de reproducción en futuras sesiones:

1. Como solución temporal, agregue la opción de configuración “SpeedScreenMMAVerbose=On” en la sección [WFClient] del archivo $Home/.ICAClient/wfclient.ini, por ejemplo.

2. Reinicie wfica desde un autoservicio que se haya iniciado desde un terminal.

3. Reproduzca un vídeo que pueda generar este error.

4. Tome nota (en la salida de seguimiento) del tipo MIME asociado al plug-in que falta, o el tipo MIME que debe ser compatible, pero no se reproduce (por ejemplo, “video/x-h264…”).

5. Modifique $ICAROOT/config/MediaStreamingConfig.tbl. En la línea con el tipo MIME anotado, introduzca un signo “?” entre los dos puntos (:) y el tipo MIME. Este parámetro inhabilita el formato.

6. Repita los pasos (anteriores) del 2 al 5 para otros formatos de medios que provoquen este error.

7. Distribuya el archivo MediaStreamingConfig.tbl modificado a otras máquinas con el mismo conjunto de plug-ins GStreamer.

Nota:

Como alternativa, después de identificar el tipo MIME es posible instalar un plug-in GStreamer para descifrarlo.

Script para verificar requisitos del sistema para la redirección del Reproductor de Windows Media

Con la versión 2307, presentamos un nuevo script bash para verificar la configuración que necesita la función de redirección del Reproductor de Windows Media en la aplicación Citrix Workspace para Linux. Esta función ayuda a reducir el tiempo de solución de problemas de la función de redirección del Reproductor de Windows Media. Para verificar la configuración, puede usar el mismo script rave_troubleshooting.sh disponible en Script de diagnóstico del sistema para RAVE.

Configuración de un puerto serie

Para configurar un único puerto serie, agregue las siguientes entradas en el archivo de configuración $ICAROOT/config/module.ini:

LastComPortNum=1

ComPort1=device

Para configurar dos puertos serie o más, agregue las siguientes entradas en el archivo de configuración $ICAROOT/config/module.ini:

LastComPortNum=2

ComPort1=device1

ComPort2=device2

Errores

Este tema incluye una lista de otros mensajes de error comunes que pueden aparecer al utilizar la aplicación Citrix Workspace.

Ha ocurrido un error. El código del error es 11 (E_MISSING_INI_SECTION). Consulte la documentación. Cerrándose.

Al ejecutar la aplicación Citrix Workspace desde la línea de comandos, este error normalmente significa que la descripción otorgada en la línea de comandos no se ha encontrado en el archivo appsrv.ini.

E_BAD_OPTION. La opción “…” no es válida.

Falta el argumento para la opción “…”.

E_BAD_ARG. La opción “…” tiene un argumento no válido: “…”.

Se especificó un argumento no válido para la opción “…”.

E_INI_KEY_SYNTAX - La clave “…” en el archivo de configuración “…” no es válida.

La información sobre el proveedor del servidor X en el archivo de configuración está dañada. Cree un archivo de configuración.

E_INI_VALUE_SYNTAX - El valor “…” en el archivo de configuración “…” no es válido.

La información sobre el proveedor del servidor X en el archivo de configuración está dañada. Cree un archivo de configuración.

E_SERVER_NAMELOOKUP_FAILURE - No se puede conectar con el servidor “…”.

No puede resolverse el nombre del servidor.

No se puede escribir en uno o varios archivos: “…”. Corrija los problemas de disco lleno o de permisos, y vuelva a intentarlo.

Verifique si existen problemas de disco lleno o problemas de permisos. Si se detecta y corrige un problema, vuelva a intentar la operación que originó el mensaje de error.

Se perdió la conexión con el servidor. Vuelva a conectarse e inténtelo nuevamente. Puede que falten datos en estos archivos: “…”.

Vuelva a conectarse y vuelva a intentar la operación que originó el error.

Información de diagnóstico

Si tiene problemas con la aplicación Citrix Workspace, es posible que la asistencia técnica de Citrix le pida información de diagnóstico. Esta información permite al equipo diagnosticar el problema y ofrecer la ayuda necesaria para solucionarlo.

Para obtener información de diagnóstico sobre la aplicación Citrix Workspace:

1. En el directorio de instalación, escriba util/lurdump. Se recomienda que haga esta modificación en una sesión abierta y, si es posible, mientras el problema siga activo.

   Se genera un archivo que ofrece información de diagnóstico detallada, la cual incluye detalles de la versión, el contenido de los archivos de configuración de la aplicación Citrix Workspace y los valores de diversas variables del sistema.

2. Revise el archivo para ver si contiene información confidencial antes de enviarlo al departamento de asistencia técnica de Citrix.

Solución de problemas en las conexiones con recursos

Los usuarios pueden administrar sus conexiones activas con la Central de conexiones. La Central de conexiones es una herramienta de productividad que permite a usuarios y administradores solucionar inconvenientes en conexiones lentas o problemáticas. Con la Central de conexiones, los usuarios pueden administrar las conexiones de este modo:

• Cerrar aplicaciones.
• Cerrar la sesión. Este paso finaliza la sesión y cierra todas las aplicaciones que hubiera abiertas.
• Desconectarse de una sesión. Este paso interrumpe la conexión seleccionada con el servidor sin cerrar ninguna aplicación que haya abierta (a menos que el servidor esté configurado para cerrar aplicaciones en caso de desconexión).
• Ver estadísticas de transporte de la conexión.