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, 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 las acciones y los asuntos de los comandos, junto con marcas de tiempo que se pueden usar para diferenciar las secuencias de comandos.
Registro de diagnóstico
Anteriormente, el registro de diagnóstico solo registraba errores de forma predeterminada.
A partir de la versión 2203 LTSR CU5, 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.
Para habilitar el registro de seguimiento, con una cuenta con permisos de administrador local, inicie Windows PowerShell y use el comando Set-STFDiagnostics con los siguientes parámetros:
- -All. Una marca que indica que el seguimiento debe actualizarse para todas las instancias y servicios.
- -TraceLevel. En niveles crecientes de detalle de seguimiento, los valores permitidos para -TraceLevel son: Off, Error, Warning, Info o Verbose. Debido a la gran cantidad de datos que se pueden generar, el seguimiento puede afectar significativamente el rendimiento de StoreFront. No se recomiendan los niveles Info o Verbose a menos que se requieran específicamente para la solución de problemas.
Parámetros opcionales:
- -FileSizeKb. El tamaño del archivo de seguimiento en KB.
- -FileCount. El número de archivos de seguimiento que se deben mantener en el disco a la vez.
- -confirm:$False. Suprime las solicitudes de Windows para permitir que el cmdlet de StoreFront se ejecute cada vez.
La salida de seguimiento se envía a c:\Program Files\Citrix\Receiver StoreFront\admin\trace
Ejemplos
Para habilitar el seguimiento de nivel Verbose para todos los servicios con fines de depuración:
Set-STFDiagnostics -All -TraceLevel "Verbose" -confirm:$False
<!--NeedCopy-->
Para deshabilitar el seguimiento de nivel Verbose y restablecer el nivel de seguimiento al valor predeterminado para todos los servicios:
Set-STFDiagnostics -All -TraceLevel "Info" -confirm:$False
<!--NeedCopy-->
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. Según 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, siga estos pasos:
-
Vaya a la siguiente clave del Registro mediante 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 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 su entorno para cualquier fin que no sea la resolución de problemas se describe con más detalle en CTX200126.