Solucionar problemas de StoreFront

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 completado, propague los cambios de configuración al grupo de servidores para que se actualicen los demás servidores de la implementación.

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 la documentación de StoreFront PowerShell SDK.

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.

Solucionar problemas de actualización de StoreFront

Siga estos pasos para solucionar problemas de actualización de StoreFront.

Antes de intentar una actualización

  1. Confirme que tiene una copia de seguridad de todos los servidores de StoreFront.
  2. Compruebe que no intenta actualizar StoreFront desde una versión de fin de vida. Para obtener más información, consulte CTX200356.
  3. Compruebe que va a actualizar StoreFront solamente desde una versión compatible a la versión actual.
  4. Si el servidor de StoreFront forma parte de un grupo de servidores de StoreFront, todos los servidores del grupo deben actualizarse secuencialmente. No se admite la actualización simultánea de un grupo de servidores de StoreFront.
  5. Elimine los archivos thumbs.db que haya en C:\inetpup\wwwroot\citrix o en sus subdirectorios. Muestre los archivos ocultos para completar este paso: Opciones de carpeta > Ver, elija la opción Mostrar archivos, carpetas y unidades ocultos y desmarque la opción Ocultar archivos protegidos del sistema operativo (recomendado).
  6. Inhabilite el software antivirus antes de iniciar la actualización.
  7. Confirme que los servidores que se van a actualizar se hayan quitado de los equilibradores de carga y que no tengan conectadas sesiones de usuario activas.
  8. Reinicie el servidor de StoreFront antes de realizar la actualización.
  9. Detenga manualmente los siguientes servicios:
    • CitrixConfigurationReplication
    • CitrixCredentialWallet
    • CitrixDefaultDomainService
    • CitrixPeerResolutionService
    • CitrixSubscriptionsStore
  10. Asegúrese de que la consola de administración de StoreFront esté cerrada.

Si falla la actualización

  1. En C:\Windows\Temp\StoreFront, abra el archivo CitrixMsi.log* más reciente y busque los errores de excepción que pueda haber.

    Excepciones del tipo Thumbs.db Access: Provocadas por los archivos thumbs.db que hay en C:\inetpup\wwwroot\citrix o en alguno de sus subdirectorios. Elimine los archivos thumbs.db que encuentre.

    Excepciones del tipo Cannot get exclusive file access \in use: Restaure la instantánea o copia de seguridad si está disponible, o bien reinicie el servidor y detenga manualmente los servicios de StoreFront.

    Excepciones del tipo Service cannot be started: Restaure la instantánea o copia de seguridad si está disponible, o bien instale la versión completa de .NET Framework 4.5 (no el perfil de cliente).

  2. Si no hay errores de excepción en CitrixMsi.log*, compruebe Visor de eventos > Delivery Services en el servidor para ver si hay errores que contengan mensajes de los errores de excepción anteriores. Siga el consejo correspondiente.
  3. Si no hay errores de excepción en el Visor de eventos, compruebe los registros de administración en C:\Archivos de programa\Citrix\Receiver StoreFront\Logs para ver si hay errores que contengan mensajes de los errores de excepción anteriores. Siga el consejo correspondiente.

Para quitar StoreFront manualmente

Advertencia:

El hecho de quitar StoreFront manualmente borra toda la información existente.

Para quitar StoreFront manualmente:

  1. Desinstale StoreFront.
  2. Quite el rol de servidor web.
  3. Elimine la carpeta C:\Archivos de programa\Citrix\Receiver StoreFront.
  4. Elimine cualquier subdirectorio de C:\Archivos de programa\Citrix\StoreFront Install.
  5. Elimine la carpeta C:\Inetpub.

Ahora puede reinstalar StoreFront.