StoreFront

Solucionar problemas de StoreFront

Registros de la instalación

Cuando StoreFront se instala o desinstala, el instalador de StoreFront crea los siguientes archivos de registros en el directorio C:\Windows\Temp\StoreFront. Los nombres de archivo reflejan los componentes que los han creado e incluyen marcas de tiempo.

  • Citrix-DeliveryServicesRoleManager-*.log: creado cuando StoreFront se instala de forma interactiva.
  • Citrix-DeliveryServicesSetupConsole-*.log: creado cuando StoreFront se instala de forma silenciosa, y cuando se desinstala, ya sea de forma interactiva o silenciosa.
  • CitrixMsi-CitrixStoreFront-x64-*.log: creado cuando StoreFront se instala o desinstala, ya sea de forma interactiva o silenciosa.

Registros de eventos

StoreFront admite el registro de sucesos de Windows para el servicio de autenticación, los almacenes y los sitios de Receiver para Web. Todos los eventos que se generan se escriben en el registro de aplicaciones de StoreFront, que se puede ver a través de Visor de eventos ya sea en Registros de aplicaciones y servicios > Citrix Delivery Services o mediante Registros de Windows > Aplicación. Para controlar la cantidad de entradas de registro duplicadas de un solo suceso, modifique los archivos de configuración del servicio de autenticación, de los almacenes y de los sitios de Receiver para Web.

Limitación de registros

  1. Utilice un editor de texto para abrir el archivo web.config del servicio de autenticación, el almacén o el sitio de Receiver para Web, que normalmente se encuentran en los directorios C:\inetpub\wwwroot\Citrix\Authentication, C:\inetpub\wwwroot\Citrix\storename, and C:\inetpub\wwwroot\Citrix\storenameWeb\ respectivamente, donde storename es el nombre que se especificó para el almacén cuando se creó.

  2. Busque este elemento en el archivo.

    <logger duplicateInterval="00:01:00" duplicateLimit="10">

    De forma predeterminada, StoreFront se configura para limitar la cantidad de entradas de registro duplicadas a 10 por minuto.

  3. Cambie el valor del atributo duplicateInterval para definir el período en el formato de horas, minutos y segundos durante el que se controlarán las entradas de registros duplicadas. Utilice el atributo duplicateLimit para definir la cantidad de entradas duplicadas que se deben registrar en el intervalo especificado para iniciar la limitación de registros.

Cuando se inicie la limitación de registros, se registrará un mensaje de advertencia para indicar que se omitirán las entradas de registro posteriores que sean idénticas. Después de este límite de tiempo, se reanuda el registro normal y se registra un mensaje informativo que indica que las entradas de registro duplicadas ya no se omitirán.

Registros de PowerShell y de la consola de administración

Los cambios de configuración realizados a través de PowerShell o la consola de administración se registran en C:\Program Files\Citrix\Receiver StoreFront\Admin\logs. Los nombres de los archivos de registro contienen acciones y sujetos de comandos, además de marcas de tiempo que se pueden usar para distinguir las secuencias de comandos.

Registro de diagnósticos

StoreFront escribe los registros de diagnóstico en c:\Program Files\Citrix\Receiver StoreFront\admin\trace

Para StoreFront versión 2311 y versiones superiores, de forma predeterminada, se registran los mensajes de nivel Error, Advertencia e Información. En la mayoría de los casos, esto incluye información suficiente para diagnosticar todos los problemas.

Nota:

En las versiones 2308 y anteriores de StoreFront, de forma predeterminada solo se registran los mensajes de nivel Error.

Para solucionar problemas, puede habilitar el registro detallado adicional. Esto solo es necesario si lo solicita el servicio de asistencia técnica de Citrix. Esto podría afectar al rendimiento, por lo que debe revertir TraceLevel a Info una vez que se complete la solución de problemas.

Para habilitar el registro detallado:

  1. Con una cuenta con permisos de administrador local, inicie Windows PowerShell

  2. Introduzca el comando:

    Set-STFDiagnostics -All -TraceLevel "Verbose" -Override -confirm:$False
    <!--NeedCopy-->
    

    Nota:

    El parámetro -Override solo es necesario para la versión 2311 de StoreFront. Este parámetro se quitará en las versiones futuras de StoreFront.

    Esto permite el registro “detallado” de todos los servicios, sin solicitar confirmación. Cuando se introduce este comando, se reinician los servicios de Storefront. Espere a que vuelva a aparecer el mensaje de PowerShell para verificar que los servicios han terminado de reiniciarse. Mientras se reinician estos servicios, los usuarios no podrán acceder al servidor StoreFront.

  3. Reproduzca el problema para crear los registros.

  4. Vuelva a establecer el registro en el nivel predeterminado para todos los servicios

     Set-STFDiagnostics -All -TraceLevel "Info" -Override -confirm:$False
    <!--NeedCopy-->
    

    Nota:

    El parámetro -Override solo es necesario para la versión 2311 de StoreFront.

Puede personalizar aún más el registro de diagnósticos:

  • StoreFront escribe un archivo de registros independiente para cada servicio. De forma predeterminada, cada archivo de registros tiene un tamaño máximo de 200 Mb y StoreFront escribe hasta 5 archivos de registros por servicio antes de purgar los archivos de registros antiguos. Si necesita personalizar el tamaño o la cantidad de registros escritos, puede hacerlo con los parámetros -FileSizeKb y -FileCount.

  • Cambie el nivel de detalle registrado mediante -TraceLevel. Los valores permitidos son Off, Error, Warning, Info o Verbose.

  • Al usar el parámetro -All, se establecen los parámetros de registro de todos los servicios. Puede personalizar el registro de un servicio individual mediante -Service [Service name]

Para obtener más información sobre el cmdlet Set-STFDiagnostics, consulte el apartado StoreFront PowerShell SDK de la documentación.

Registros del archivo Launch.ica

Cuando un usuario inicia una aplicación o un escritorio, StoreFront genera un archivo llamado launch.ica que la aplicación Workspace lee para determinar cómo conectarse a la aplicación o al escritorio. Según la configuración, este archivo puede estar almacenado en la memoria, por lo que no se puede acceder directamente a él. Para diagnosticar errores de inicio, puede ser útil ver el contenido de launch.ica.

Para habilitar la captura de registros del archivo launch.ica en el equipo cliente, siga estos pasos:

  1. Vaya a la siguiente clave de Registro mediante el Editor del Registro:

    En sistemas de 32 bits: HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\ICA Client\Engine\Configuration\Advanced\Modules\Logging

    En sistemas de 64 bits: HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Citrix\ICA Client\Engine\Configuration\Advanced\Modules\Logging

  2. Establezca estos dos valores de clave de cadena:

    • LogFile=”ruta al archivo de registro”
    • LogICAFile=true

    Por ejemplo:

    LogFile=C:\ica\ica.log
    LogICAFile=true
    <!--NeedCopy-->
    

Nota:

El uso de un archivo ICA en el entorno para un fin que no sea la solución de problemas se describe más detalladamente en CTX200126.

Solucionar problemas de StoreFront