Gérer vos enregistrements de base de données

L’utilitaire de base de données de journalisation ICA (ICLDB) est un utilitaire de ligne de commande pour base de données utilisé pour la manipulation des éléments de base de données constitués d’enregistrements de sessions. Cet utilitaire est installé en même temps que l’enregistrement de session dans le répertoire lecteur \Program Files\Citrix\SessionRecording\Server\Bin du serveur hébergeant le serveur d’enregistrement de session.

Tableau de référence rapide

Le tableau suivant contient la liste des commandes et des options disponibles avec l’utilitaire ICLDB. Tapez 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, entrez le répertoire lecteur \Program Files\Citrix\SessionRecording\Server\Bin et tapez icldb /?. Pour accéder à l’aide de commandes spécifiques, tapez icldb *command* /?.

Archiver les anciens fichiers d’enregistrement de session

Pour maintenir un niveau adéquat de capacité de disque disponible dans les emplacements de stockage des enregistrements, archivez régulièrement les fichiers d’enregistrement de session. Les intervalles d’archivage diffèrent en fonction de la quantité d’espace disque disponible et de la taille typique des fichiers d’enregistrement de session. Les fichiers d’enregistrement de session doivent dater de plus de 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 actifs 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 de session peut être mis à jour vers le statut d’archivage tant que le fichier d’enregistrement de session reste à l’emplacement de stockage de l’enregistrement. Cette méthode peut être utilisée pour réduire les résultats de la recherche dans le lecteur. L’autre méthode consiste à mettre à jour l’enregistrement de la base de données d’un fichier d’enregistrement de session vers le statut archivé et à déplacer le fichier depuis l’emplacement de stockage de l’enregistrement vers un autre emplacement afin de le sauvegarder sur un autre support. Lorsque l’utilitaire ICLDB déplace les fichiers d’enregistrement de session, ceux-ci sont déplacés vers le répertoire spécifié, dans lequel la structure de dossiers 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 représentant la date et l’heure actuelles d’archivage d’un enregistrement de session ; la note d’archivage, une note textuelle facultative pouvant être ajoutée par l’administrateur lors de l’archivage. Les deux champs indiquent qu’un enregistrement de session a été archivé et l’heure d’archivage.

Dans le lecteur d’enregistrement de session, tous les enregistrements de session archivés indiquent l’état Archivé, ainsi que la date et l’heure de l’archivage. Les enregistrements de session 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é lors de l’archivage, une erreur de fichier introuvable est affichée. Le fichier d’enregistrement de session doit être restauré avant que la session ne puisse être lue. Pour restaurer un enregistrement de session, indiquez à l’administrateur l’identifiant de fichier et l’heure d’archivage de l’enregistrement de la session à partir de la boîte de dialogue Propriétés d’enregistrement du Lecteur d’enregistrement de session. La restauration de fichiers archivés est abordée plus loin dans la section Restaurer les fichiers d’enregistrement de session.

La commande archive de l’utilitaire ICLDB a plusieurs paramètres qui sont décrits comme suit :

• /RETENTION:<jours> - Période de rétention, en jours, des 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.

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

• /MOVETO:<répertoire\> - Répertoire dans 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 dans leur emplacement de stockage d’origine.

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

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

• /F – Cette commande force l’exécution de la commande sans invites. Ce paramètre est facultatif.

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

1. Ouvrez une session en tant qu’administrateur local sur le serveur sur lequel le serveur d’enregistrement de session est installé.

2. Démarrez une invite de commande.

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>/Server/Bin).

4. Exécutez la commande ICLDB ARCHIVE /RETENTION:<days> /LISTFILES /MOVETO:<directory> /NOTE:<note> /L où days est la durée de rétention des fichiers d’enregistrement de session, directory est le répertoire dans lequel les fichiers d’enregistrement de session archivés sont déplacés, et note est la note de texte ajoutée à l’enregistrement de la base de données pour chaque fichier d’enregistrement de session archivé. Entrez Y pour confirmer l’archivage.

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

1. Ouvrez une session en tant qu’administrateur local sur le serveur sur lequel le serveur d’enregistrement de session est installé.

2. Démarrez une invite de commande.

3. Passez du répertoire de travail actuel au répertoire Bin du chemin d’installation du serveur d’enregistrement de session (<chemin d’installation du serveur d’enregistrement de session>/Server/Bin).

4. Exécutez la commande ICLDB ARCHIVE /RETENTION:<days> /LISTFILES /NOTE:<note> /L où days est la durée de rétention des fichiers d’enregistrement de session et note est la note de texte ajoutée à l’enregistrement de la base de données pour chaque enregistrement de session archivé. Entrez Y pour confirmer l’archivage.

Restaurer les fichiers d’enregistrement de session

La restauration des fichiers d’enregistrement de session est requise lorsque vous souhaitez afficher un enregistrement de session archivé dans la base de données d’enregistrement de session et que le fichier a été déplacé de l’emplacement de stockage de l’enregistrement. Les enregistrements de session archivés qui n’ont pas été déplacés depuis l’emplacement de stockage des enregistrements pendant l’archivage sont toujours accessibles dans le lecteur d’enregistrement de session.

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 dans la base de données d’enregistrement de session à l’aide de l’utilitaire ICLDB. Citrix recommande la première méthode de restauration des fichiers d’enregistrement de session archivés. Supprimez les fichiers archivés copiés dans le répertoire de restauration lorsque vous n’en avez plus besoin.

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

L’importation de fichiers d’enregistrement de session archivés à l’aide de l’utilitaire ICLDB met à jour la base de données d’enregistrement de session avec les informations d’enregistrement de session provenant du fichier d’enregistrement de session, y compris un nouveau chemin de stockage pour le fichier. L’utilisation de l’utilitaire ICLDB pour importer un fichier d’enregistrement de session archivé ne le déplace pas vers son emplacement de stockage d’origine lors de l’enregistrement de la session.

Remarque : l’heure d’archivage et la note d’archivage sont effacées dans la base de données d’enregistrement de session d’un fichier importé. Par conséquent, lors de la prochaine exécution de la commande ICLDB archive, le fichier d’enregistrement de session importé peut être à nouveau archivé.

La commande ICLDB import est utile pour importer un grand nombre de fichiers d’enregistrement de session archivés, réparer ou mettre à jour des données d’enregistrement de session incorrectes ou manquantes dans la base de données d’enregistrement de session, ou déplacer des fichiers d’enregistrement de session d’un emplacement de stockage vers un autre emplacement sur le serveur d’enregistrement de session. La commande import de l’ICLDB peut également être utilisée pour remplir la base de données d’enregistrement de session avec des enregistrements de session après l’exécution de la commande ICLDB removeall.

La commande import de l’utilitaire ICLDB a plusieurs paramètres qui sont décrits comme suit :

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

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

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

• /F – Cette commande force l’exécution de la commande sans invites. Ce paramètre est facultatif.

Pour restaurer des fichiers d’enregistrement de session à l’aide du répertoire de restauration des fichiers archivés

1. Ouvrez une session en tant qu’administrateur local sur le 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 porte le nom de fichier 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 dans le répertoire de restauration pour fichiers archivés. Pour déterminer le répertoire de restauration pour fichiers archivés :

   1. À partir du menu Démarrer, choisissez Démarrer > Tous les programmes > Citrix > Propriétés du lecteur d’enregistrement de session.

   2. Dans la fenêtre 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.

Pour restaurer des fichiers d’enregistrement de session à l’aide de la commande d’importation ICLDB

1. Ouvrez une session en tant qu’administrateur local sur le serveur sur lequel le serveur d’enregistrement de session est installé.

2. Démarrez une invite de commande.

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>/Server/Bin).

4. Vous pouvez au choix :

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

   • Exécutez la commande ICLDB IMPORT /LISTFILES /L <file> où file est le nom d’un ou de 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 des fichiers d’enregistrement de session. Entrez Y pour confirmer l’importation.