Gérer les enregistrements

ICA log database (ICLDB) est un utilitaire de ligne de commande de base de données utilisé pour manipuler les enregistrements de la base de données d’enregistrement de session. Cet utilitaire est installé, lors de l’installation de l’enregistrement de session, dans le dossier <Session Recording Server installation path>\Bin sur le serveur hébergeant le serveur d’enregistrement de session.

Remarque :

Si vous souhaitez utiliser ICLDB pour gérer les fichiers d’enregistrement de session stockés dans des partages de fichiers Azure, exécutez la commande SsRecUtils.exe -MountAzureFiles. SsRecUtils.exe et ICLDB se trouvent dans le même dossier.

Tableau de référence rapide

Le tableau suivant répertorie les commandes et options disponibles pour l’utilitaire ICLDB. Saisissez les commandes en utilisant le format suivant :

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

Remarque :

Des instructions plus détaillées sont disponibles dans l’aide associée à l’utilitaire. Pour accéder à l’aide, à partir d’une invite de commandes, accédez au dossier \Program Files\Citrix\SessionRecording\Server\Bin et tapez icldb /?. Pour accéder à l’aide pour des commandes spécifiques, tapez icldb <specific command> /?.

Le paramètre RULES pour les commandes ICLDB ARCHIVE et ICLDB REMOVE

Le paramètre RULES définit des filtres avancés en combinant plusieurs filtres strictement selon le format /RULES:FIELD-In-["CONDITION","CONDITION"];FIELD-NotIn-["CONDITION","CONDITION"];, où :

• “FIELD” définit un filtre avec un champ, qui peut être “path”, “user”, “group”, “deliverygroup”, “application”, “server”, “client”, ou toute autre colonne de la table de base de données appelée dbo.ICLFile.

• “In” signifie qu’au moins une des conditions de filtre entre parenthèses doit être remplie pour qu’un fichier d’enregistrement soit un objet d’opération.

• “NotIn” signifie que les fichiers d’enregistrement qui remplissent l’une des conditions de filtre entre parenthèses sont exclus de l’opération.

• “CONDITION” définit une condition de filtre avec un enregistrement (ou une ligne) dans la table de base de données appelée dbo.ICLFile.

• Les enregistrements d’utilisateur et de groupe doivent être saisis au format <domain>.<name>.

• Les enregistrements de chemin peuvent être filtrés à l’aide de caractères génériques Windows.

• Vous devez placer chaque élément “CONDITION” entre guillemets doubles ("") et séparer deux éléments “CONDITION” par une virgule (,).

• N’ajoutez pas d’espaces lors de la saisie des éléments “CONDITION” à moins qu’un élément “CONDITION” ne contienne lui-même des espaces.

• Si un élément “CONDITION” contient une ou plusieurs virgules, placez l’élément “CONDITION” entre guillemets doubles suivis de guillemets doubles échappés """ """.

• Plusieurs filtres peuvent être utilisés dans diverses combinaisons. Terminez chaque filtre par un point-virgule (;).

• L’opérateur logique « AND » est utilisé pour calculer les multiples filtres. Il n’y a pas de limite au nombre de filtres, mais la longueur totale des RULES ne doit pas dépasser 2 048 octets.

Exemples :

• /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"];

Archiver les fichiers d’enregistrement de session

Pour maintenir un niveau adéquat de capacité de disque disponible dans les emplacements de stockage d’enregistrements, archivez régulièrement les fichiers d’enregistrement de session. Selon la quantité d’espace disque disponible et la taille typique des fichiers d’enregistrement, les intervalles d’archivage diffèrent. Les fichiers d’enregistrement de session doivent être plus anciens que deux jours à compter de la date de début avant de pouvoir être archivés. Cette règle vise à empêcher l’archivage d’enregistrements en direct avant qu’ils ne soient terminés.

Deux méthodes sont disponibles lorsque vous archivez des enregistrements de session. L’enregistrement de base de données pour un fichier d’enregistrement peut être mis à jour pour avoir un statut archivé tandis que le fichier reste dans l’emplacement de stockage d’enregistrements. Cette méthode peut être utilisée pour réduire les résultats de recherche dans le lecteur. L’autre méthode consiste à mettre à jour l’enregistrement de base de données pour un fichier d’enregistrement au statut archivé et à déplacer le fichier de l’emplacement de stockage d’enregistrements vers un autre emplacement pour une sauvegarde sur un support alternatif. Lors du déplacement des fichiers d’enregistrement de session, l’utilitaire ICLDB les déplace vers le répertoire spécifié où la structure de dossiers de fichiers d’origine année/mois/jour n’existe plus.

L’enregistrement de session dans la base de données d’enregistrement de session contient deux champs associés à l’archivage : l’heure d’archivage et la note d’archivage. L’heure d’archivage représente la date et l’heure actuelles auxquelles un enregistrement a été archivé. La note d’archivage est une note textuelle facultative qui peut être ajoutée pendant l’archivage. Les deux champs indiquent qu’un enregistrement a été archivé et l’heure de l’archivage.

Dans le lecteur d’enregistrement de session, les enregistrements de session archivés affichent un statut Archivé ainsi que la date et l’heure de l’archivage. Les enregistrements de session qui ont été archivés peuvent toujours être lus si les fichiers n’ont pas été déplacés. Si un fichier d’enregistrement de session a été déplacé pendant l’archivage, une erreur de fichier introuvable s’affiche. Le fichier d’enregistrement de session doit être restauré avant que la session ne puisse être lue. Pour restaurer un fichier d’enregistrement de session, fournissez l’ID de fichier et l’heure d’archivage du fichier d’enregistrement. La restauration des fichiers archivés est abordée plus en détail dans la section suivante Restaurer les fichiers d’enregistrement de session.

La commande ARCHIVE de l’utilitaire ICLDB possède plusieurs paramètres décrits comme suit :

• /FILEID:<id> - Permet de spécifier un fichier d’enregistrement de session cible. Vous pouvez vérifier l’ID d’un fichier d’enregistrement de session dans le lecteur d’enregistrement de session (Windows). Un nom de fichier d’enregistrement peut également être utilisé comme ID de fichier.

• /RETENTION:<days> - La période de rétention en jours pour les enregistrements de session. Les enregistrements plus anciens que le nombre de jours spécifié sont marqués comme archivés dans la base de données d’enregistrement de session. La période de rétention doit être un nombre entier supérieur ou égal à 2 jours.

• /FILTER:<filter>: Permet de filtrer les chemins de fichiers en utilisant les caractères génériques * et ?. Le paramètre FILTER est facultatif. Si vous ajoutez le paramètre FILTER, seuls les fichiers d’enregistrement de session qui satisfont à la fois RETENTION et FILTER sont archivés.

• /RULES:<advanced filters>: Définit des filtres avancés en combinant plusieurs filtres strictement conformes au format /RULES:FIELD-In-["CONDITION","CONDITION"];FIELD-NotIn-["CONDITION","CONDITION"];. Le paramètre RULES et le paramètre FILTER ne peuvent pas être utilisés ensemble. Pour plus d’informations, consultez la section précédente Le paramètre RULES pour les commandes ICLDB ARCHIVE et ICLDB REMOVE de cet article.

• /LISTFILES – Répertorie le chemin d’accès complet et le nom de fichier des fichiers d’enregistrement de session au fur et à mesure de leur archivage. Ce paramètre est facultatif.

• /MOVETO:<directory> - Le répertoire vers lequel vous déplacez physiquement les fichiers d’enregistrement de session archivés. Le répertoire spécifié doit exister. Ce paramètre est facultatif. Si aucun répertoire n’est spécifié, les fichiers restent à leur emplacement de stockage d’origine.

• /NOTE:<note> - Une note de texte qui est ajoutée à l’enregistrement de la base de données pour chaque enregistrement de session archivé. Assurez-vous que la note est placée entre guillemets. Ce paramètre est facultatif.

• /L – Consigne les résultats et les erreurs dans le journal des événements Windows concernant le nombre de fichiers d’enregistrement de session archivés. Ce paramètre est facultatif.

• /F – Force la commande d’archivage à s’exécuter sans invites. Ce paramètre est facultatif.

Pour archiver les enregistrements de session dans la base de données d’enregistrement de session et déplacer physiquement les fichiers d’enregistrement de session

1. Connectez-vous au serveur sur lequel le serveur d’enregistrement de session est installé en tant qu’administrateur local.

2. Démarrez une invite de commandes.

3. Passez du répertoire de travail actuel au répertoire Bin du chemin d’installation du serveur d’enregistrement de session (<Session Recording server Installation Path>\Bin).

4. Exécutez la commande ICLDB ARCHIVE /RETENTION:<days> [/LISTFILES] [/MOVETO:<dir>] [/NOTE:<note>] [/FILTER:<file path filter>] [/RULES:<advanced filters>] [/L] [/F] [/S] [/?]. Les paramètres entre crochets sont facultatifs. Supprimez les crochets lors de l’exécution de la commande. Le paramètre RULES et le paramètre FILTER ne peuvent pas être utilisés ensemble. days est la période de rétention des fichiers d’enregistrement de session, directory est le répertoire vers lequel les fichiers d’enregistrement de session archivés sont déplacés, et note est la note de texte qui est ajoutée à l’enregistrement de la base de données pour chaque fichier d’enregistrement de session archivé. Saisissez Y pour confirmer l’archivage.

Pour archiver uniquement les enregistrements de session dans la base de données d’enregistrement de session

1. Connectez-vous au serveur sur lequel le serveur d’enregistrement de session est installé en tant qu’administrateur local.

2. Démarrez une invite de commandes.

3. Passez du répertoire de travail actuel au répertoire Bin du chemin d’installation du serveur d’enregistrement de session (<Session Recording server installation path>\Bin).

4. Exécutez la commande ICLDB ARCHIVE /RETENTION:<days> [/LISTFILES] [/NOTE:<note>] [/FILTER:<file path filter>] [/RULES:<advanced filters>] [/L] [/F] [/S] [/?]. Les paramètres entre crochets sont facultatifs. Supprimez les crochets lors de l’exécution de la commande. Les paramètres RULES et FILTER ne peuvent pas être utilisés ensemble. days est la période de rétention des enregistrements de session et note est la note textuelle ajoutée à l’enregistrement de la base de données pour chaque enregistrement de session archivé. Saisissez Y pour confirmer l’archivage.

Restaurer les fichiers d’enregistrement de session

Pour afficher un fichier d’enregistrement archivé dans la base de données d’enregistrement de session et déplacé de l’emplacement de stockage des enregistrements, restaurez-le. Les enregistrements de session archivés qui n’ont pas été déplacés de l’emplacement de stockage des enregistrements pendant l’archivage restent accessibles dans le lecteur.

Deux méthodes sont disponibles pour restaurer les fichiers d’enregistrement de session qui ont été déplacés. Copiez le fichier d’enregistrement de session requis dans le répertoire de restauration des fichiers archivés. Ou, importez le fichier d’enregistrement de session requis dans la base de données d’enregistrement de session à l’aide de l’utilitaire ICLDB. Nous recommandons la première méthode pour restaurer les fichiers d’enregistrement de session archivés. Supprimez les fichiers archivés copiés dans le répertoire de restauration des fichiers archivés lorsque vous n’en avez plus besoin.

Le Session Recording Broker utilise le répertoire de restauration des fichiers archivés lorsqu’un fichier d’enregistrement de session n’est pas trouvé à son emplacement de stockage d’origine. Ce cas se produit lorsque le lecteur demande un fichier d’enregistrement de session pour la lecture. Le Session Recording Broker tente d’abord de trouver le fichier d’enregistrement de session à l’emplacement de stockage d’origine. Si le fichier n’est pas trouvé à l’emplacement de stockage d’origine, le Session Recording Broker vérifie ensuite le répertoire de restauration des fichiers archivés. Si le fichier est présent dans le répertoire de restauration, le Session Recording Broker envoie le fichier au lecteur pour la lecture. Si le fichier n’est pas trouvé, le Session Recording Broker envoie une erreur de fichier introuvable au lecteur.

L’importation d’un fichier d’enregistrement archivé met à jour la base de données d’enregistrement de session avec les informations d’enregistrement de session du fichier, y compris un nouveau chemin de stockage. L’importation d’un fichier d’enregistrement de session archivé ne déplace pas le fichier vers l’emplacement de stockage d’origine lorsque la session a été enregistrée.

Remarque : Un fichier d’enregistrement de session importé a l’heure d’archivage et la note d’archivage effacées dans la base de données d’enregistrement de session. La prochaine fois que la commande ICLDB ARCHIVE est exécutée, le fichier d’enregistrement de session importé peut être archivé à nouveau.

La commande ICLDB IMPORT est utile pour importer un grand nombre de fichiers d’enregistrement archivés. Elle peut réparer ou mettre à jour des données d’enregistrement de session incorrectes et manquantes dans la base de données d’enregistrement de session. Elle est également utile pour déplacer des fichiers d’enregistrement de session d’un emplacement de stockage à un autre sur le serveur d’enregistrement de session. Vous pouvez utiliser la commande ICLDB IMPORT pour repeupler la base de données d’enregistrement de session avec des enregistrements de session après avoir exécuté la commande ICLDB REMOVEALL.

La commande IMPORT de l’utilitaire ICLDB dispose de plusieurs paramètres que vous pouvez utiliser pour restaurer des fichiers d’enregistrement archivés :

• /LISTFILES – Répertorie le chemin complet et le nom de fichier des fichiers d’enregistrement de session pendant leur importation. Ce paramètre est facultatif.

• /RECURSIVE – Recherche tous les sous-répertoires pour les fichiers d’enregistrement de session. Ce paramètre est facultatif.

• /RELOCATE – Sans le paramètre RELOCATE, la commande IMPORT analyse les fichiers d’enregistrement de session dans leur intégralité, ce qui prend du temps. Avec le paramètre RELOCATE, la commande IMPORT localise simplement les enregistrements de base de données des fichiers d’enregistrement de session et met à jour directement leurs chemins de fichier.

• /L – Enregistre les résultats et les erreurs dans le journal d’événements Windows le nombre de fichiers d’enregistrement de session importés. Ce paramètre est facultatif.

• /F – Force la commande IMPORT à s’exécuter sans invites. Ce paramètre est facultatif.

Remarque :

La commande IMPORT de l’utilitaire ICLDB fournit également un paramètre facultatif, RELOCATE, que vous pouvez utiliser pour relocaliser les fichiers d’enregistrement. Pour plus d’informations, consultez la section Relocaliser les fichiers d’enregistrement de session de cet article.

Restaurer les fichiers d’enregistrement de session à l’aide du répertoire de restauration pour les fichiers archivés

1. Connectez-vous en tant qu’administrateur local au serveur sur lequel le serveur d’enregistrement de session est installé.

2. Dans les propriétés du lecteur d’enregistrement de session, déterminez l’ID de fichier et l’heure d’archivage du fichier d’enregistrement de session archivé.

3. Localisez le fichier d’enregistrement de session dans vos sauvegardes à l’aide de l’ID de fichier spécifié dans les propriétés du lecteur d’enregistrement de session. Chaque enregistrement de session a un nom de fichier de i_<FileID>.icl, où FileID est l’ID du fichier d’enregistrement de session.

4. Copiez le fichier d’enregistrement de session de votre sauvegarde vers le répertoire de restauration pour les fichiers archivés. Pour déterminer le répertoire de restauration pour les fichiers archivés :

   1. Dans le menu Démarrer, choisissez Démarrer > Tous les programmes > Citrix® > Propriétés du serveur d’enregistrement de session.

   2. Dans les Propriétés du serveur d’enregistrement de session, sélectionnez l’onglet Stockage. Le répertoire de restauration actuel apparaît dans le champ Répertoire de restauration pour les fichiers archivés.

Restaurer les fichiers d’enregistrement de session à l’aide de la commande ICLDB IMPORT

1. Connectez-vous en tant qu’administrateur local au serveur sur lequel le serveur d’enregistrement de session est installé.

2. Démarrez une invite de commandes.

3. Passez du répertoire de travail actuel au répertoire Bin du chemin d’installation du serveur d’enregistrement de session (<Session Recording server installation path>\Bin).

4. Soit :

   • Exécutez la commande ICLDB IMPORT /LISTFILES /RECURSIVE /L <directory> où répertoire est le nom d’un ou plusieurs répertoires, séparés par un espace, contenant des fichiers d’enregistrement de session. Saisissez Y pour confirmer l’importation.

   • Exécutez la commande ICLDB IMPORT /LISTFILES /L <file> où fichier est le nom d’un ou plusieurs fichiers d’enregistrement de session, séparés par un espace. Des caractères génériques peuvent être utilisés pour spécifier les fichiers d’enregistrement de session. Saisissez Y pour confirmer l’importation.

Déplacer les fichiers d’enregistrement de session

Vous pouvez déplacer les fichiers d’enregistrement de session vers différents chemins de stockage pour l’équilibrage de charge ou d’autres objectifs. Pour vous assurer que les fichiers peuvent toujours être lus, vous devez mettre à jour leurs nouveaux chemins dans la base de données d’enregistrement de session. Pour ce faire, utilisez la commande ICLDB IMPORT. Pour accélérer le processus d’importation, ajoutez le paramètre RELOCATE à la commande ICLDB IMPORT.

Remarque :

Le paramètre RELOCATE est facultatif. Sans le paramètre RELOCATE, la commande ICLDB IMPORT analyse les fichiers d’enregistrement de session dans leur intégralité, ce qui prend du temps. Avec le paramètre RELOCATE, la commande ICLDB IMPORT localise simplement les enregistrements de base de données des fichiers d’enregistrement de session et met à jour directement leurs chemins de fichier.

Les étapes suivantes illustrent comment utiliser le paramètre RELOCATE pour mettre à jour les nouveaux chemins de fichier dans la base de données d’enregistrement de session.

1. Déplacez les fichiers d’enregistrement de session vers différents chemins de stockage selon les besoins.

2. Connectez-vous en tant qu’administrateur local au serveur sur lequel le serveur d’enregistrement de session est installé.

3. Démarrez une invite de commandes.

4. Accédez du répertoire de travail actuel au répertoire Bin du chemin d’installation du serveur d’enregistrement de session (<Session Recording server installation path>\Bin).

5. Soit :

   • Exécutez la commande ICLDB IMPORT /LISTFILES /RECURSIVE /RELOCATE /L <directory> où répertoire est le nom d’un ou plusieurs répertoires, séparés par un espace, contenant des fichiers d’enregistrement de session. Saisissez Y pour confirmer l’importation.

   • Exécutez la commande ICLDB IMPORT /LISTFILES /RELOCATE /L <file> où fichier est le nom d’un ou plusieurs fichiers d’enregistrement de session, séparés par un espace. Des caractères génériques peuvent être utilisés pour spécifier les fichiers d’enregistrement de session. Saisissez Y pour confirmer l’importation.

Remarque :

• Le paramètre RELOCATE suppose qu’il existe déjà des enregistrements des fichiers d’enregistrement de session dans la base de données d’enregistrement de session.
• Les fichiers d’enregistrement de session doivent être lisibles avant d’être déplacés. Dans le cas contraire, le paramètre RELOCATE ne sera d’aucune utilité.
• Les nouveaux chemins de stockage des fichiers d’enregistrement de session doivent être reconnaissables par le serveur d’enregistrement de session. Vous pouvez les essayer sous l’onglet Storage des propriétés du serveur d’enregistrement de session.

Fermer les enregistrements en direct non réactifs ou inactifs

Par défaut, un enregistrement en direct est considéré comme non réactif ou inactif si aucune nouvelle donnée n’a été écrite dans le fichier d’enregistrement pendant 24 heures. Vous pouvez configurer ce seuil de temps sous l’onglet Storage des propriétés du serveur d’enregistrement de session pour fermer automatiquement les enregistrements en direct non réactifs ou inactifs lorsque ce seuil est dépassé. La valeur minimale que vous pouvez définir est 12 (heures).

Vous pouvez également fermer manuellement les enregistrements en direct non réactifs ou inactifs à l’aide de la commande ICLDB DORMANT, par exemple :

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

Le paramètre FILEID vous permet de spécifier un fichier d’enregistrement de session cible et le paramètre CLOSEFILES vous permet de fermer manuellement les enregistrements en direct non réactifs ou inactifs que vous spécifiez.

Conseil :

Vous pouvez vérifier l’ID d’un fichier d’enregistrement de session dans le lecteur d’enregistrement de session (Windows). Un nom de fichier d’enregistrement peut également être utilisé comme ID de fichier.