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 \Program Files\Citrix\SessionRecording\Server\Bin sur le serveur hébergeant le serveur d’enregistrement de session.
Tableau de référence rapide
Le tableau suivant répertorie les commandes et options disponibles pour l’utilitaire ICLDB. Saisissez les commandes au 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, puis tapezicldb /?. Pour accéder à l’aide pour des commandes spécifiques, tapezicldb *command* /?.
| Commande | Description |
|---|---|
archive |
Archive les fichiers d’enregistrement de session plus anciens que la période de rétention spécifiée. Utilisez cette commande pour archiver les enregistrements et les événements dans les enregistrements. Les événements sont archivés dans la table de base de données ArchivedEvent. |
dormant |
Affiche ou compte les fichiers d’enregistrement de session considérés comme dormants. Les fichiers dormants sont des enregistrements de session qui n’ont pas été terminés en raison d’une perte de données. Utilisez cette commande pour vérifier si vous soupçonnez une perte de données. Vous pouvez vérifier si les fichiers d’enregistrement de session deviennent dormants pour l’ensemble de la base de données, ou uniquement pour les enregistrements effectués dans le nombre de jours, d’heures ou de minutes spécifié. |
import |
Importe les fichiers d’enregistrement de session dans la base de données d’enregistrement de session. Utilisez cette commande pour reconstruire la base de données si vous perdez des enregistrements de base de données. Utilisez également cette commande pour fusionner des bases de données (si vous avez deux bases de données, vous pouvez importer les fichiers de l’une d’entre elles). |
locate |
Localise et affiche le chemin complet d’un fichier d’enregistrement de session en utilisant l’ID du fichier comme critère. Utilisez cette commande lorsque vous recherchez l’emplacement de stockage d’un fichier d’enregistrement de session. C’est aussi un moyen de vérifier si la base de données est à jour avec un fichier spécifique. |
remove |
Supprime les références aux fichiers d’enregistrement de session de la base de données. Utilisez cette commande (avec prudence) pour nettoyer la base de données. Spécifiez la période de rétention à utiliser comme critère. Vous pouvez également supprimer le fichier physique associé. |
removeall |
Supprime toutes les références aux fichiers d’enregistrement de session de la base de données d’enregistrement de session et restaure la base de données à son état d’origine. Les fichiers physiques réels ne sont pas supprimés ; cependant, vous ne pouvez pas rechercher ces fichiers dans le lecteur d’enregistrement de session. Utilisez cette commande (avec prudence) pour nettoyer la base de données. Les références supprimées ne peuvent être annulées qu’en restaurant à partir de votre sauvegarde. |
version |
Affiche la version du schéma de la base de données d’enregistrement de session. |
/l |
Enregistre les résultats et les erreurs dans le journal d’événements Windows. |
/f |
Force l’exécution de la commande sans invites. |
/s |
Supprime le message de copyright. |
/? |
Affiche l’aide pour les commandes. |
Archiver les 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. 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 que des enregistrements en direct ne soient archivés avant d’être terminés.
Deux méthodes sont disponibles lorsque vous archivez des enregistrements de session. L’enregistrement de la 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 des 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 la base de données pour un fichier d’enregistrement au statut archivé et à déplacer le fichier de l’emplacement de stockage des enregistrements vers un autre emplacement pour une sauvegarde sur un support alternatif. Lorsque l’utilitaire ICLDB déplace les fichiers d’enregistrement de session, les fichiers sont déplacés vers le répertoire spécifié où 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 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 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 ci-dessous :
-
/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.
-
/LISTFILES – Répertorie le chemin 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 textuelle qui est ajoutée à l’enregistrement de la base de données pour chaque enregistrement de session archivé. Assurez-vous que la note est entre guillemets. Ce paramètre est facultatif.
-
/L – Enregistre les résultats et les erreurs dans le journal d’événements Windows concernant le nombre de fichiers d’enregistrement de session archivés. Ce paramètre est facultatif.
-
/F – Force l’exécution de la commande d’archivage 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
-
Connectez-vous au serveur où le serveur d’enregistrement de session est installé en tant qu’administrateur local.
-
Démarrer une invite de commandes.
-
Accédez au répertoire Bin du chemin d’installation du serveur d’enregistrement de session (
<Session Recording server Installation Path>/Server/Bin) à partir du répertoire de travail actuel. -
Exécutez la commande
ICLDB ARCHIVE /RETENTION:<days> /LISTFILES /MOVETO:<directory> /NOTE:<note> /Loù 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 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
-
Connectez-vous au serveur sur lequel le serveur d’enregistrement de session est installé en tant qu’administrateur local.
-
Démarrer une invite de commandes.
-
Accédez au répertoire Bin du chemin d’installation du serveur d’enregistrement de session (<Session Recording server installation path>/Server/Bin) à partir du répertoire de travail actuel.
-
Exécutez la commande
ICLDB ARCHIVE /RETENTION:<days> /LISTFILES /NOTE:<note> /Loù days est la période de rétention des enregistrements 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é. 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 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 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 Broker d’enregistrement de session 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 d’enregistrement de session demande un fichier d’enregistrement pour la lecture. Le Broker tente d’abord de trouver ce fichier à l’emplacement de stockage d’origine. Si le fichier n’est pas trouvé à l’emplacement de stockage d’origine, le 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 Broker l’envoie au Lecteur pour la lecture. Si le fichier n’est pas trouvé, le 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é pourrait ê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 ou manquantes dans la base de données d’enregistrement de session. Elle peut également 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 possède plusieurs paramètres décrits comme suit :
-
/LISTFILES – Répertorie le chemin d’accès complet et le nom des fichiers d’enregistrement de session pendant leur importation. Ce paramètre est facultatif.
-
/RECURSIVE – Recherche les fichiers d’enregistrement de session dans tous les sous-répertoires. Ce paramètre est facultatif.
-
/L – Consigne les résultats et les erreurs dans le journal d’événements Windows, ainsi que le nombre de fichiers d’enregistrement de session importés. Ce paramètre est facultatif.
-
/F – Force l’exécution de la commande d’importation sans invites. Ce paramètre est facultatif.
Pour restaurer les fichiers d’enregistrement de session à l’aide du répertoire de restauration pour les fichiers archivés
-
Connectez-vous au serveur sur lequel le serveur d’enregistrement de session est installé en tant qu’administrateur local.
-
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é.
-
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. -
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 :
-
Dans le menu Démarrer, choisissez Démarrer > Tous les programmes > Citrix® > Propriétés du serveur d’enregistrement de session.
-
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.
-
Pour restaurer les fichiers d’enregistrement de session à l’aide de la commande d’importation ICLDB
-
Connectez-vous au serveur sur lequel le serveur d’enregistrement de session est installé en tant qu’administrateur local.
-
Démarrez une invite de commandes.
-
Changez de répertoire de travail actuel pour le répertoire Bin du chemin d’installation du serveur d’enregistrement de session (
<Session Recording server installation path>/Server/Bin). -
Soit :
-
Exécutez la commande
ICLDB IMPORT /LISTFILES /RECURSIVE /L <directory>où directory 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ù file 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.
-