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 logiciel 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 y accéder à partir d’une ligne de commande, tapez icldb /? dans le répertoire du lecteur :\Program Files\Citrix\SessionRecording\Server\Bin. Pour accéder à l’aide de commandes spécifiques, tapez icldb command /?.

Commande Description
archive Permet d’archiver les fichiers d’enregistrement de session plus anciens que la période de rétention spécifiée. Utilisez cette commande pour archiver les fichiers.
dormant Cette commande permet d’afficher ou de compter les fichiers d’enregistrement de session considérés comme dormants. Les fichiers dormants sont des enregistrements de session incomplets en raison d’une perte de données. Utilisez cette commande pour vérifier si vous suspectez une perte de données. Vous pouvez vérifier si les fichiers d’enregistrement de session deviennent dormants pour l’intégralité de la base de données ou si s’il ne s’agit que des enregistrements effectués pendant un certain nombre de jours, d’heures ou de minutes.
import Permet d’importer les fichiers d’enregistrement de session dans la base de données d’enregistrement de session. Utilisez la commande pour reconstituer la base de données si vous perdez les enregistrements de la base de données. Vous pouvez également utiliser la commande pour fusionner des bases de données (si vous avez deux bases de données, vous pouvez importer les fichiers de l’une des bases de données).
locate Permet de localiser et d’afficher le chemin complet vers un fichier d’enregistrement de session en utilisant l’identificateur de fichier comme critère. Utilisez cette commande lorsque vous cherchez l’emplacement d’un fichier d’enregistrement de session. Il s’agit aussi d’une manière de vérifier si la base de données est à jour par rapport à un fichier spécifique.
supprimer Permet de supprimer les références à des fichiers d’enregistrement de session de la base de données. Utilisez cette commande (prudemment) pour nettoyer la base de données. Spécifiez la période de rétention à utiliser comme critères. Vous pouvez également supprimer le fichier physique associé.
removeall Cette commande supprime toutes les références aux fichiers d’enregistrement de session de la base de données d’enregistrement de session et rétablit l’état d’origine de la base de données. Les fichiers physiques ne sont pas supprimés ; il est toutefois impossible de les rechercher dans le lecteur d’enregistrement de session. Utilisez cette commande (prudemment) pour nettoyer la base de données. Les références supprimées ne peuvent être rétablies qu’en effectuant une restauration à partir des fichiers de sauvegarde.
version Cette commande permet d’afficher la version du schéma de la base de données d’enregistrement de session.
/l Cette commande enregistre les résultats et les erreurs dans le journal des événements Windows.
/f Cette commande force l’exécution de la commande sans invites.
/s Cette commande supprime le message de copyright.
/? Cette commande affiche l’aide des commandes.

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. Paramètre 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. Paramètre 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. Paramètre 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. Paramètre facultatif.

  • /F – Cette commande force l’exécution de la commande sans invites. Paramètre 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 (<chemin d’installation du serveur d’enregistrement de session>/Server/Bin).

  4. Exécutez la commande ICLDB ARCHIVE /RETENTION:<jours> /LISTFILES /MOVETO:<répertoire> /NOTE:<note> /Ljours est la durée de rétention des fichiers d’enregistrement de session, répertoire 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:<jours> /LISTFILES /NOTE:<note> /Ljours 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 d’archivage ICLDB, le fichier d’enregistrement de session importé peut être à nouveau archivé.

La commande d’importation ICLDB 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. Paramètre facultatif.

  • /RECURSIVE - Recherche dans tous les sous-répertoires les fichiers d’enregistrement de session. Paramètre 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. Paramètre facultatif.

  • /F – Cette commande force l’exécution de la commande sans invites. Paramètre 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 a le nom de fichier i_<IDFichier>.icl, où IDFichier 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 (<chemin d’installation du serveur d’enregistrement de session>/Server/Bin).

  4. Vous pouvez au choix :

    • Exécutez la commande ICLDB IMPORT /LISTFILES /RECURSIVE /L <répertoire>répertoire 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 <fichier>fichier 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.

Gérer vos enregistrements de base de données