Solucionar problemas de StoreFront
Registros de instalación
Cuando StoreFront se instala o desinstala, 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 se puede ver con el Visor de eventos en Registros de aplicaciones y servicios > Citrix Delivery Services o Registros de Windows > Aplicación. Puede controlar el número de entradas de registro duplicadas para un solo evento editando los archivos de configuración del servicio de autenticación, los almacenes y los sitios de Receiver para Web.
Limitación de registros
-
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\ y C:\inetpub\wwwroot\Citrix\storenameWeb\, respectivamente, donde storename es el nombre especificado para el almacén cuando se creó.
-
Localice 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.
-
Cambie el valor del atributo duplicateInterval para establecer el período de tiempo en horas, minutos y segundos durante el cual se supervisan las entradas de registro duplicadas. Utilice el atributo duplicateLimit para 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 transcurrido el 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 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 asuntos de comandos, junto con marcas de tiempo que se pueden usar para diferenciar las secuencias de comandos.
Registro de diagnósticos
StoreFront escribe registros de diagnóstico en c:\Program Files\Citrix\Receiver StoreFront\admin\trace
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 cualquier problema.
Puede habilitar el 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 debe 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, inicie Windows PowerShell.
-
Introduzca 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. Espere a que el símbolo del sistema de PowerShell vuelva para verificar que los servicios han terminado de reiniciarse. Mientras estos servicios se reinician, los usuarios no podrán acceder al servidor de StoreFront.
-
Reproduzca el problema para crear los registros.
-
Restablezca el registro al nivel predeterminado para todos los servicios.
Set-STFDiagnostics -All -TraceLevel "Info" -confirm:$False <!--NeedCopy-->
Puede personalizar aún más el registro de diagnósticos:
-
StoreFront escribe un archivo de registro independiente 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 necesita personalizar el tamaño o el número de registros escritos, puede hacerlo utilizando los parámetros
-FileSizeKby-FileCount. -
Cambie el nivel de detalle registrado utilizando
-TraceLevel. Los valores permitidos sonOff,Error,Warning,InfooVerbose. -
El uso del parámetro
-Allestablece los parámetros de registro para todos los servicios. Puede personalizar el registro para un servicio individual utilizando-Service [Service name]
Para obtener más información sobre el cmdlet Set-STFDiagnostics, consulte la documentación del SDK de PowerShell de StoreFront.
Registro 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. 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, siga estos pasos:
-
Vaya a la siguiente clave del Registro utilizando 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 -
Establezca los dos siguientes 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 su entorno para cualquier fin que no sea la resolución de problemas se detalla en CTX200126.