Administrar grabaciones

ICA log database (ICLDB) es una utilidad de línea de comandos de base de datos que se utiliza para manipular los registros de la base de datos de grabación de sesiones. Esta utilidad se instala, durante la instalación de Grabación de sesiones, en la carpeta <Session Recording Server installation path>\Bin del servidor que aloja el servidor de Grabación de sesiones.

Nota:

Si quiere usar ICLDB para administrar los archivos de grabación de sesiones almacenados en recursos compartidos de archivos de Azure, ejecute el comando SsRecUtils.exe -MountAzureFiles. SsRecUtils.exe e ICLDB están en la misma carpeta.

Tabla de referencia rápida

La siguiente tabla enumera los comandos y las opciones disponibles para la utilidad ICLDB. Escriba los comandos con el siguiente formato:

ICLDB [VERSION | LOCATE | DORMANT | IMPORT | ARCHIVE | REMOVE | REMOVEALL | REPAIR] command-options [/L] [/F] [/S] [/?]

Nota:

Hay instrucciones más detalladas disponibles en la ayuda asociada a la utilidad. Para acceder a la ayuda, desde un símbolo del sistema, vaya a la carpeta \Program Files\Citrix\SessionRecording\Server\Bin y escriba icldb /?. Para acceder a la ayuda de comandos específicos, escriba icldb <specific command> /?.

El parámetro RULES para los comandos ICLDB ARCHIVE e ICLDB REMOVE

El parámetro RULES establece filtros avanzados combinando varios filtros estrictamente de acuerdo con el formato /RULES:FIELD-In-["CONDITION","CONDITION"];FIELD-NotIn-["CONDITION","CONDITION"];, donde:

• “FIELD” establece un filtro con un campo, que puede ser “path”, “user”, “group”, “deliverygroup”, “application”, “server”, “client” o cualquier otra columna de la tabla de base de datos llamada dbo.ICLFile.

• “In” significa que al menos una de las condiciones de filtro entre paréntesis debe cumplirse para que un archivo de grabación sea un objeto de operación.

• “NotIn” significa que los archivos de grabación que cumplen cualquiera de las condiciones de filtro entre paréntesis se excluyen de la operación.

• “CONDITION” establece una condición de filtro con un registro (o fila) en la tabla de base de datos llamada dbo.ICLFile.

• Los registros de usuario y grupo deben introducirse en el formato de <domain>.<name>.

• Los registros de ruta se pueden filtrar utilizando comodines de Windows.

• Debe encerrar cada elemento “CONDITION” entre comillas dobles ("") y separar dos elementos “CONDITION” con una coma (,).

• No añada espacios al introducir elementos “CONDITION” a menos que el propio elemento “CONDITION” contenga espacios.

• Si un elemento “CONDICIÓN” contiene una o más comas, encierre el elemento “CONDICIÓN” entre comillas dobles seguidas de comillas dobles escapadas """ """.

• Se pueden usar varios filtros en diversas combinaciones. Termine cada filtro con un punto y coma (;).

• El operador lógico “AND” se utiliza para calcular los múltiples filtros. No hay límite en el número de filtros, pero la longitud total de las REGLAS no debe exceder los 2.048 bytes.

Ejemplos:

• /RULES:group-In-["BUILTIN.Guests"];
• /RULES:path-In-["S:\SessionRecordings\2023*"];group-NotIn-["Mydomain.Suspicious","Mydomain.Persistence"];
• /RULES:deliverygroup-In-["RdsDesktopAndAppGroup"];user-In-["Mydomain.AdminA","""Mydomain.Admin,,,B"""];
• /RULES:EndReasonID-In-["1","2"];

Archivar archivos de grabación de sesiones

Para mantener un nivel adecuado de capacidad de disco libre en las ubicaciones de almacenamiento de grabaciones, archive los archivos de grabación de sesiones regularmente. Los intervalos de archivado varían según la cantidad de espacio en disco disponible y el tamaño típico de los archivos de grabación. Los archivos de grabación de sesiones deben tener más de dos días desde la fecha de inicio antes de que puedan archivarse. Esta regla es para evitar que se archiven grabaciones en vivo antes de que estén completas.

Hay dos métodos disponibles al archivar grabaciones de sesiones. El registro de la base de datos de un archivo de grabación se puede actualizar para que tenga un estado de archivado mientras el archivo permanece en la ubicación de almacenamiento de grabaciones. Este método se puede utilizar para reducir los resultados de búsqueda en el reproductor. El otro método consiste en actualizar el registro de la base de datos de un archivo de grabación al estado de archivado y mover el archivo de la ubicación de almacenamiento de grabaciones a otra ubicación para realizar una copia de seguridad en medios alternativos. Al mover archivos de grabación de sesiones, la utilidad ICLDB los mueve al directorio especificado donde la estructura de carpetas de archivos original de año/mes/día ya no existe.

El registro de grabación de sesión en la base de datos de Session Recording contiene dos campos asociados con el archivado: la hora de archivado y la nota de archivado. La hora de archivado representa la fecha y hora actuales en que se archivó una grabación. La nota de archivado es una nota de texto opcional que se puede agregar durante el archivado. Los dos campos indican que una grabación ha sido archivada y la hora de archivado.

En el reproductor de Session Recording, las grabaciones de sesiones archivadas muestran un estado de Archivadas y la fecha y hora de archivado. Las grabaciones de sesiones que se han archivado aún pueden reproducirse si los archivos no se han movido. Si un archivo de grabación de sesión se movió durante el archivado, se muestra un error de archivo no encontrado. El archivo de grabación de sesión debe restaurarse antes de que se pueda reproducir la sesión. Para restaurar un archivo de grabación de sesión, proporcione el ID de archivo y la hora de archivado del archivo de grabación. La restauración de archivos archivados se analiza más a fondo en la siguiente sección Restaurar archivos de grabación de sesiones.

El comando ARCHIVE de la utilidad ICLDB tiene varios parámetros que se describen a continuación:

• /FILEID:<id> - Permite especificar un archivo de grabación de sesión de destino. Puede comprobar el ID de un archivo de grabación de sesión en el reproductor de Session Recording (Windows). Un nombre de archivo de grabación también se puede utilizar como ID de archivo.

• /RETENTION:<days> - El período de retención en días para las grabaciones de sesiones. Las grabaciones con una antigüedad superior al número de días especificado se marcan como archivadas en la base de datos de Grabación de sesiones. El período de retención debe ser un número entero mayor o igual a 2 días.

• /FILTER:<filter>: Permite filtrar rutas de archivo mediante los caracteres comodín * y ?. El parámetro FILTER es opcional. Si agrega el parámetro FILTER, solo se archivarán los archivos de grabación de sesiones que cumplan con RETENTION y FILTER.

• /RULES:<advanced filters>: Establece filtros avanzados combinando varios filtros estrictamente de acuerdo con el formato /RULES:FIELD-In-["CONDITION","CONDITION"];FIELD-NotIn-["CONDITION","CONDITION"];. Los parámetros RULES y FILTER no se pueden usar juntos. Para obtener más información, consulte la sección anterior El parámetro RULES para los comandos ICLDB ARCHIVE e ICLDB REMOVE de este artículo.

• /LISTFILES – Enumera la ruta completa y el nombre de archivo de los archivos de grabación de sesiones a medida que se archivan. Este parámetro es opcional.

• /MOVETO:<directory> - El directorio al que se mueven físicamente los archivos de grabación de sesiones archivados. El directorio especificado debe existir. Este parámetro es opcional. Si no se especifica ningún directorio, los archivos permanecen en su ubicación de almacenamiento original.

• /NOTE:<note> - Una nota de texto que se agrega al registro de la base de datos para cada grabación de sesión archivada. Asegúrese de que la nota esté entre comillas dobles. Este parámetro es opcional.

• /L – Registra los resultados y errores en el registro de eventos de Windows del número de archivos de grabación de sesiones archivados. Este parámetro es opcional.

• /F – Fuerza la ejecución del comando de archivo sin avisos. Este parámetro es opcional.

Para archivar grabaciones de sesiones en la base de datos de Grabación de sesiones y mover físicamente los archivos de grabación de sesiones

1. Inicie sesión en el servidor donde está instalado el servidor de Grabación de sesiones como administrador local.

2. Inicie un símbolo del sistema.

3. Cambie del directorio de trabajo actual al directorio Bin de la ruta de instalación del servidor de Grabación de sesiones (<Session Recording server Installation Path>\Bin).

4. Ejecute el comando ICLDB ARCHIVE /RETENTION:<days> [/LISTFILES] [/MOVETO:<dir>] [/NOTE:<note>] [/FILTER:<file path filter>] [/RULES:<advanced filters>] [/L] [/F] [/S] [/?]. Los parámetros entre corchetes son opcionales. Quite los corchetes al ejecutar el comando. Los parámetros RULES y FILTER no se pueden usar juntos. days es el período de retención de los archivos de grabación de sesiones, directory es el directorio al que se mueven los archivos de grabación de sesiones archivados y note es la nota de texto que se agrega al registro de la base de datos para cada archivo de grabación de sesiones que se archiva. Escriba Y para confirmar el archivo.

Para archivar grabaciones de sesiones solo en la base de datos de Grabación de sesiones

1. Inicie sesión en el servidor donde está instalado el servidor de Grabación de sesiones como administrador local.

2. Inicie un símbolo del sistema.

3. Cambie del directorio de trabajo actual al directorio Bin de la ruta de instalación del servidor de grabación de sesiones (<Session Recording server installation path>\Bin).

4. Ejecute el comando ICLDB ARCHIVE /RETENTION:<days> [/LISTFILES] [/NOTE:<note>] [/FILTER:<file path filter>] [/RULES:<advanced filters>] [/L] [/F] [/S] [/?]. Los parámetros entre corchetes son opcionales. Elimine los corchetes al ejecutar el comando. Los parámetros RULES y FILTER no se pueden usar juntos. days es el período de retención de las grabaciones de sesiones y note es la nota de texto que se agrega al registro de la base de datos para cada grabación de sesión que se archiva. Escriba Y para confirmar el archivo.

Restaurar archivos de grabación de sesiones

Para ver un archivo de grabación archivado en la base de datos de grabación de sesiones y movido de la ubicación de almacenamiento de grabaciones, restáurelo. Las grabaciones de sesiones archivadas que no se movieron de la ubicación de almacenamiento de grabaciones durante el archivado siguen siendo accesibles en el reproductor.

Hay dos métodos disponibles para restaurar archivos de grabación de sesiones que se han movido. Copie el archivo de grabación de sesión necesario en el directorio de restauración de archivos archivados. O bien, importe el archivo de grabación de sesión necesario de nuevo a la base de datos de grabación de sesiones mediante la utilidad ICLDB. Recomendamos el primer método para restaurar archivos de grabación de sesiones archivados. Elimine los archivos archivados copiados en el directorio de restauración de archivos archivados cuando ya no los necesite.

El Agente de grabación de sesiones utiliza el Directorio de restauración de archivos archivados cuando no se encuentra un archivo de grabación de sesiones en su ubicación de almacenamiento original. Este caso ocurre cuando el reproductor solicita un archivo de grabación de sesiones para su reproducción. El Agente intenta primero encontrar el archivo de grabación de sesiones en la ubicación de almacenamiento original. Si el archivo no se encuentra en la ubicación de almacenamiento original, el Agente comprueba el Directorio de restauración de archivos archivados. Si el archivo está presente en el directorio de restauración, el Agente envía el archivo al reproductor para su reproducción. Si no se encuentra el archivo, el Agente envía un error de archivo no encontrado al reproductor.

La importación de un archivo de grabación archivado actualiza la base de datos de grabación de sesiones con la información de grabación de sesiones del archivo, incluida una nueva ruta de almacenamiento. La importación de un archivo de grabación de sesiones archivado no devuelve el archivo a la ubicación de almacenamiento original cuando se grabó la sesión.

Nota: Un archivo de grabación de sesiones importado tiene la hora de archivo y la nota de archivo borradas en la base de datos de grabación de sesiones. La próxima vez que se ejecute el comando ICLDB ARCHIVE, el archivo de grabación de sesiones importado podría volver a archivarse.

El comando ICLDB IMPORT es útil para importar un gran número de archivos de grabación archivados. Puede reparar o actualizar datos de grabación de sesiones incorrectos o faltantes en la base de datos de grabación de sesiones. También es útil para mover archivos de grabación de sesiones de una ubicación de almacenamiento a otra en el servidor de grabación de sesiones. Puede usar el comando ICLDB IMPORT para volver a llenar la base de datos de grabación de sesiones con grabaciones de sesiones después de ejecutar el comando ICLDB REMOVEALL.

El comando IMPORT de la utilidad ICLDB tiene varios parámetros que puede usar para restaurar archivos de grabación archivados:

• /LISTFILES – Enumera la ruta completa y el nombre de archivo de los archivos de grabación de sesiones mientras se importan. Este parámetro es opcional.

• /RECURSIVE – Busca archivos de grabación de sesiones en todos los subdirectorios. Este parámetro es opcional.

• /RELOCATE – Sin el parámetro RELOCATE, el comando IMPORT analiza los archivos de grabación de sesiones en su totalidad, lo que lleva tiempo. Con el parámetro RELOCATE, el comando IMPORT simplemente localiza los registros de la base de datos de los archivos de grabación de sesiones y actualiza sus rutas de archivo directamente.

• /L – Registra los resultados y errores en el registro de eventos de Windows el número de archivos de grabación de sesiones importados. Este parámetro es opcional.

• /F – Fuerza la ejecución del comando IMPORT sin avisos. Este parámetro es opcional.

Nota:

El comando IMPORT de la utilidad ICLDB también proporciona un parámetro opcional, RELOCATE, que puede utilizar para reubicar los archivos de grabación. Para obtener más información, consulte la sección Reubicar archivos de grabación de sesiones en este artículo.

Restaurar archivos de grabación de sesiones mediante el directorio de restauración para archivos archivados

1. Inicie sesión como administrador local en el servidor donde está instalado el servidor de grabación de sesiones.

2. En Propiedades del Reproductor de Grabación de Sesiones, determine el ID de archivo y la hora de archivo del archivo de grabación de sesiones archivado.

3. Localice el archivo de grabación de sesiones en sus copias de seguridad utilizando el ID de archivo especificado en Propiedades del Reproductor de Grabación de Sesiones. Cada grabación de sesión tiene un nombre de archivo de i_<FileID>.icl, donde FileID es el ID del archivo de grabación de sesiones.

4. Copie el archivo de grabación de sesiones de su copia de seguridad al directorio de restauración para archivos archivados. Para determinar el directorio de restauración para archivos archivados:

   1. En el menú Inicio, elija Inicio > Todos los programas > Citrix® > Propiedades del servidor de grabación de sesiones.

   2. En Propiedades del servidor de grabación de sesiones, seleccione la ficha Almacenamiento. El directorio de restauración actual aparece en el campo Directorio de restauración para archivos archivados.

Restaurar archivos de grabación de sesiones mediante el comando ICLDB IMPORT

1. Inicie sesión como administrador local en el servidor donde está instalado el servidor de grabación de sesiones.

2. Inicie un símbolo del sistema.

3. Cambie del directorio de trabajo actual al directorio Bin de la ruta de instalación del servidor de grabación de sesiones (<Session Recording server installation path>\Bin).

4. Una de estas opciones:

   • Ejecute el comando ICLDB IMPORT /LISTFILES /RECURSIVE /L <directory> donde directorio es el nombre de uno o más directorios, separados por un espacio, que contienen archivos de grabación de sesiones. Escriba Y para confirmar la importación.

   • Ejecute el comando ICLDB IMPORT /LISTFILES /L <file> donde archivo es el nombre de uno o más archivos de grabación de sesiones, separados por un espacio. Se pueden usar comodines para especificar los archivos de grabación de sesiones. Escriba Y para confirmar la importación.

Reubicar archivos de grabación de sesiones

Puede mover los archivos de grabación de sesiones a diferentes rutas de almacenamiento para el equilibrio de carga u otros fines. Para asegurarse de que los archivos se puedan seguir reproduciendo, debe actualizar sus nuevas rutas en la base de datos de Session Recording. Para ello, utilice el comando ICLDB IMPORT. Para acelerar el proceso de importación, añada el parámetro RELOCATE al comando ICLDB IMPORT.

Nota:

El parámetro RELOCATE es opcional. Sin el parámetro RELOCATE, el comando ICLDB IMPORT analiza los archivos de grabación de sesiones en su totalidad, lo que lleva tiempo. Con el parámetro RELOCATE, el comando ICLDB IMPORT simplemente localiza los registros de la base de datos de los archivos de grabación de sesiones y actualiza sus rutas de archivo directamente.

Los siguientes pasos ilustran cómo usar el parámetro RELOCATE para actualizar las nuevas rutas de archivo en la base de datos de Session Recording.

1. Mueva los archivos de grabación de sesiones a diferentes rutas de almacenamiento según sea necesario.

2. Inicie sesión como administrador local en el servidor donde está instalado el servidor de Session Recording.

3. Inicie un símbolo del sistema.

4. Cambie del directorio de trabajo actual al directorio Bin de la ruta de instalación del servidor de Session Recording (<Session Recording server installation path>\Bin).

5. O bien:

   • Ejecute el comando ICLDB IMPORT /LISTFILES /RECURSIVE /RELOCATE /L <directory> donde directorio es el nombre de uno o más directorios, separados por un espacio, que contienen archivos de grabación de sesiones. Escriba Y para confirmar la importación.

   • Ejecute el comando ICLDB IMPORT /LISTFILES /RELOCATE /L <file> donde archivo es el nombre de uno o más archivos de grabación de sesiones, separados por un espacio. Se pueden usar comodines para especificar los archivos de grabación de sesiones. Escriba Y para confirmar la importación.

Nota:

• El parámetro RELOCATE asume que ya existen registros de los archivos de grabación de sesión en la base de datos de Grabación de sesiones.
• Los archivos de grabación de sesión deben poder reproducirse antes de ser movidos. De lo contrario, el parámetro RELOCATE no sirve de ayuda.
• Las nuevas rutas de almacenamiento de los archivos de grabación de sesión deben ser reconocibles por el servidor de Grabación de sesiones. Puede probarlas en la ficha Almacenamiento de Propiedades del servidor de grabación de sesiones.

Cerrar grabaciones en directo inactivas o que no responden

De forma predeterminada, una grabación en directo se considera inactiva o que no responde si no se escribieron datos nuevos en el archivo de grabación durante 24 horas. Puede configurar este umbral de tiempo en la ficha Almacenamiento de Propiedades del servidor de grabación de sesiones para cerrar automáticamente las grabaciones en directo inactivas o que no responden cuando se supere este umbral. El valor mínimo que puede establecer es 12 (horas).

También puede cerrar manualmente las grabaciones en directo inactivas o que no responden mediante el comando ICLDB DORMANT, por ejemplo:

ICLDB DORMANT [/DAYS:<days> | /HOURS:<hours> | /MINUTES:<minutes> | /FILEID:<id>] [/LISTFILES] [/CLOSEFILES] [/L] [/F] [/S] [/?]
<!--NeedCopy-->

El parámetro FILEID le permite especificar un archivo de grabación de sesión de destino y el parámetro CLOSEFILES le permite cerrar manualmente las grabaciones en directo inactivas o que no responden que especifique.

Sugerencia:

Puede comprobar el ID de un archivo de grabación de sesión en el reproductor de Grabación de sesiones (Windows). Un nombre de archivo de grabación también se puede usar como ID de archivo.