Solucionar problemas de StoreFront

Nota:

Puede obtener información sobre los cambios en los nombres de producto en Novedades.

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.

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.

La consola de administración de Citrix StoreFront registra la información de rastreo automáticamente. De forma predeterminada, el rastreo de otras operaciones está inhabilitado y se debe habilitar de forma manual. Los registros creados mediante comandos de Windows PowerShell se almacenan en el directorio \Admin\logs\ de la instalación de StoreFront. Por lo general, su ubicación típica es C:\Archivos de programa\Citrix\Receiver StoreFront. 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.

Importante:

En implementaciones con varios servidores, use solo un servidor a la vez para hacer cambios en la configuración del grupo de servidores. Compruebe que la consola de administración de Citrix StoreFront no se está ejecutando en ninguno de los demás servidores de la implementación. Una vez completados, propague los cambios de configuración al grupo de servidores de modo que los demás servidores de la implementación se actualicen.

Para configurar la 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. Localice el siguiente 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.

Para habilitar el seguimiento para la depuración

Importante:

Las consolas de StoreFront y PowerShell no pueden estar abiertas a la vez. Cierre siempre la consola de administración de StoreFront antes de usar la consola de PowerShell para administrar la configuración de StoreFront. Asimismo, cierre todas las instancias de consola de PowerShell antes de abrir la consola de StoreFront.

El rastreo resultante se envía a C:\Archivos de programa\Citrix\Receiver StoreFront\admin\trace

Rastreo resultante

Nota:

Ejecute Get-Help Set-STFDiagnostics -detailed para obtener ayuda e instrucciones de PowerShell sobre cómo utilizar el cmdlet Set-STFDiagnostics.

Utilice una cuenta con permisos de administrador local para iniciar Windows PowerShell y, en el símbolo del sistema, escriba los siguientes comandos obligatorios para habilitar o inhabilitar el rastreo.

  • -All. Un indicador de que el rastreo debe actualizarse en todas las instancias y servicios.
  • -TraceLevel. Los valores permitidos para -TraceLevel son, en orden creciente de detalle de rastreo: Off, Error, Warning, Info, Verbose. Debido a la gran cantidad de datos que se pueden generar, el rastreo puede afectar significativamente al rendimiento de StoreFront. Los niveles Info o Verbose no se recomiendan, a menos que se requieran específicamente para la solución de problemas.

Parámetros opcionales:

  • -FileSizeKb. El tamaño del archivo de rastreo en KB.
  • -FileCount. Cantidad de archivos de rastreo que se deben mantener en el disco en un momento dado.
  • -confirm:$False. Elimina las solicitudes de Windows para permitir que el cmdlet de StoreFront se ejecute cada vez.

Ejemplos

Para habilitar el rastreo de nivel Verbose (detallado) para todos los servicios con fines de depuración:

Set-STFDiagnostics -All -TraceLevel "Verbose" -confirm:$False

Para inhabilitar el rastreo de nivel Verbose y volver a establecer el nivel de rastreo en el valor predeterminado para todos los servicios:

Set-STFDiagnostics -All -TraceLevel "Error" -confirm:$False

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

Para habilitar la captura de registros del archivo launch.ica

Guarde la información en el archivo launch.ica en el equipo cliente para solucionar diferentes problemas. Los servidores de la Interfaz Web o StoreFront generan el archivo launch.ica.

Para habilitar la captura de registros del archivo launch.ica, 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 el siguiente valor de cadena:

    LogFile=<ruta al archivo de registro, utilice el formato C:\ica\ica.log> LogICAFile=true

Recursos adicionales

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.