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 Session Recording, en la carpeta <Session Recording Server installation path>\Bin del servidor que aloja el servidor de Session Recording.

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 denominada 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 denominada 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 de “CONDITION” entre comillas dobles ("") y separar dos elementos de “CONDITION” con una coma (,).

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

• Si un elemento “CONDITION” contiene una o más comas, encierre el elemento “CONDITION” 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 2048 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 difieren 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 las grabaciones en vivo se archiven 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 usar como ID de archivo.

• /RETENTION:<days> - El período de retención en días para las grabaciones de sesión. Las grabaciones anteriores 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 usando los comodines * y ?. El parámetro FILTER es opcional. Si agrega el parámetro FILTER, solo se archivarán los archivos de grabación de sesión 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"];. El parámetro RULES y el parámetro 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 sesión 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 sesión 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 sesión 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 sesión en la base de datos de Grabación de sesiones y mover físicamente los archivos de grabación de sesión

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. El parámetro RULES y el parámetro FILTER no se pueden usar juntos. days es el período de retención para los archivos de grabación de sesión, directory es el directorio al que se mueven los archivos de grabación de sesión 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 sesión que se archiva. Escriba Y para confirmar el archivo.

Para archivar solo grabaciones de sesión 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 (<ruta de instalación del servidor de grabación de sesiones>\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. 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 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 requerido en el directorio de restauración de archivos archivados. O bien, importe el archivo de grabación de sesión requerido 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 Broker de grabación de sesiones utiliza el Directorio de restauración de archivos archivados cuando no se encuentra un archivo de sesión grabado en su ubicación de almacenamiento original. Esto ocurre cuando el reproductor solicita un archivo de sesión grabado para su reproducción. El Broker de grabación de sesiones intenta primero encontrar el archivo en la ubicación de almacenamiento original. Si el archivo no se encuentra en la ubicación de almacenamiento original, el Broker de grabación de sesiones comprueba el Directorio de restauración de archivos archivados. Si el archivo está presente en el directorio de restauración, el Broker de grabación de sesiones lo envía al reproductor para su reproducción. Si el archivo no se encuentra, el Broker de grabación de sesiones 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 sesión del archivo, incluida una nueva ruta de almacenamiento. La importación de un archivo de grabación de sesión archivado no mueve el archivo de nuevo a la ubicación de almacenamiento original cuando se grabó la sesión.

Nota: Un archivo de grabación de sesión 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 sesión 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 las grabaciones de sesiones mientras se importan. Este parámetro es opcional.

• /RECURSIVE – Busca en todos los subdirectorios archivos de grabación de sesiones. 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 archivos de grabación. Para obtener más información, consulte la sección (#relocate-session-recording-files) [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 Session Recording Player Properties, determine el File ID y el Archive Time del archivo de grabación de sesión archivado.

3. Localice el archivo de grabación de sesión en sus copias de seguridad utilizando el File ID especificado en Session Recording Player Properties. 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 sesión.

4. Copie el archivo de grabación de sesión 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ú Start, elija Start > All Programs > Citrix® > Session Recording Server Properties.

   2. En Session Recording Server Properties, seleccione la ficha Storage. El directorio de restauración actual aparece en el campo Restore directory for archived files.

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 el 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. Introduzca 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. Introduzca 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 grabación de sesiones. 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 grabación de sesiones.

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 grabación de sesiones.

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 grabación de sesiones (<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. Introduzca 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. Introduzca Y para confirmar la importación.

Nota:

• El parámetro RELOCATE asume que ya existen registros de los archivos de grabación de sesiones en la base de datos de Grabación de sesiones.
• Los archivos de grabación de sesiones deben poder reproducirse antes de moverlos. De lo contrario, el parámetro RELOCATE no sirve de nada.
• Las nuevas rutas de almacenamiento de los archivos de grabación de sesiones 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 inoperativas

De forma predeterminada, una grabación en directo se considera inactiva o inoperativa si no se escribieron nuevos datos 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 inoperativas 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 inoperativas 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 inoperativas que especifique.

Sugerencia:

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