Solucionar problemas de StoreFront
Registros de instalación
Cuando se instala o desinstala StoreFront, el instalador de StoreFront crea los siguientes archivos de registro en el directorio C:\Windows\Temp\StoreFront. Los nombres de los archivos reflejan los componentes que los crearon e incluyen marcas de tiempo.
- Citrix-DeliveryServicesRoleManager-*.log: Se crea cuando StoreFront se instala de forma interactiva.
- Citrix-DeliveryServicesSetupConsole-*.log: Se crea cuando StoreFront se instala de forma silenciosa y cuando StoreFront se desinstala, ya sea de forma interactiva o silenciosa.
- CitrixMsi-CitrixStoreFront-x64-*.log: Se crea cuando StoreFront se instala y desinstala, ya sea de forma interactiva o silenciosa.
Registros de eventos
StoreFront admite el registro de eventos de Windows para el servicio de autenticación, los almacenes y los sitios de Receiver para Web. Cualquier evento que se genere se escribe en el registro de aplicaciones de StoreFront, que puedes ver usando el Visor de eventos en Registros de aplicaciones y servicios > Citrix Delivery Services o Registros de Windows > Aplicación. Puedes controlar el número de entradas de registro duplicadas para un solo evento editando los archivos de configuración para el servicio de autenticación, los almacenes y los sitios de Receiver para Web.
Limitación de registros
-
Usa un editor de texto para abrir el archivo web.config para el 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\ y C:\inetpub\wwwroot\Citrix\storenameWeb\, respectivamente, donde storename es el nombre especificado para el almacén cuando se creó.
-
Busca el siguiente elemento en el archivo.
<logger duplicateInterval="00:01:00" duplicateLimit="10">De forma predeterminada, StoreFront está configurado para limitar el número de entradas de registro duplicadas a 10 por minuto.
-
Cambia el valor del atributo
duplicateIntervalpara establecer el período de tiempo en horas, minutos y segundos durante el cual se supervisan las entradas de registro duplicadas. Usa el atributoduplicateLimitpara establecer el número de entradas duplicadas que deben registrarse dentro del intervalo de tiempo especificado para activar la limitación de registros.
Cuando se activa la limitación de registros, se registra un mensaje de advertencia para indicar que se suprimirán las entradas de registro idénticas posteriores. Una vez que transcurre el límite de tiempo, el registro normal se reanuda y se registra un mensaje informativo que indica que las entradas de registro duplicadas ya no se suprimen.
Registros de PowerShell y 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 temas de comandos, junto con marcas de tiempo que se pueden usar para diferenciar secuencias de comandos.
Registro de diagnósticos
StoreFront escribe los registros de diagnóstico en c:\Program Files\Citrix\Receiver StoreFront\admin\trace
De forma predeterminada, se registran los mensajes de nivel Error, Warning e Info. En la mayoría de los casos, esto incluye suficiente información para diagnosticar cualquier problema.
Puedes habilitar un registro detallado adicional para fines de solución de problemas. Esto solo es necesario si lo solicita el soporte de Citrix®. Esto puede afectar el rendimiento, por lo que debes revertir el TraceLevel a Info una vez que se complete la solución de problemas.
Para habilitar el registro detallado:
-
Con una cuenta con permisos de administrador local, inicia Windows PowerShell.
-
Introduce el comando:
Set-STFDiagnostics -All -TraceLevel "Verbose" -confirm:$False <!--NeedCopy-->Esto habilita el registro “Verbose” para todos los servicios, sin solicitar confirmación. Cuando se introduce este comando, se reinician los servicios de StoreFront. Espera a que el símbolo del sistema de PowerShell regrese para verificar que los servicios han terminado de reiniciarse. Mientras estos servicios se reinician, el servidor de StoreFront no será accesible para los usuarios.
-
Reproduce el problema para crear los registros.
-
Vuelve a establecer el nivel de registro predeterminado para todos los servicios.
Set-STFDiagnostics -All -TraceLevel "Info" -confirm:$False <!--NeedCopy-->
Puedes personalizar aún más el registro de diagnósticos:
-
StoreFront escribe un archivo de registro separado para cada servicio. De forma predeterminada, cada archivo de registro tiene un tamaño de hasta 200 MB y StoreFront escribe hasta cinco archivos de registro por servicio antes de purgar los archivos de registro antiguos. Si necesitas personalizar el tamaño o el número de registros escritos, puedes hacerlo usando los parámetros
-FileSizeKby-FileCount. -
Cambia el nivel de detalle registrado usando
-TraceLevel. Los valores permitidos sonOff,Error,Warning,InfooVerbose. -
El uso del parámetro
-Allestablece los parámetros de registro para todos los servicios. Puedes personalizar el registro para un servicio individual usando-Service [Service name].
Para obtener más información sobre el cmdlet Set-STFDiagnostics, consulta la documentación del SDK de PowerShell de StoreFront.
Registro de archivos 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. Dependiendo de la configuración, este archivo puede almacenarse en la memoria, por lo que no es directamente accesible. Para diagnosticar errores de inicio, puede ser útil ver el contenido de launch.ica.
Para habilitar el registro del archivo launch.ica en el PC cliente, completa los siguientes pasos:
-
Navega a la siguiente clave del registro usando el editor del registro:
Sistemas de 32 bits:
HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\ICA Client\Engine\Configuration\Advanced\Modules\LoggingSistemas de 64 bits:
HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Citrix\ICA Client\Engine\Configuration\Advanced\Modules\Logging -
Establece los dos valores de clave de cadena siguientes:
- 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 tu entorno para cualquier propósito que no sea la solución de problemas se describe con más detalle en CTX200126.