Gérer vos enregistrements de base de données

L’utilitaire de base de données ICA Log (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 du lecteur 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 les 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, tapez le lecteur : le dossier \Program Files\Citrix\SessionRecording\Server\Bin, et tapez icldb /?. Pour accéder à l’aide pour des commandes spécifiques, tapez icldb *command* /?.

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 de session, les intervalles d’archivage varient. Les fichiers d’enregistrement de session doivent être plus anciens 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 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 de session peut être mis à jour pour avoir un statut archivé tandis que le fichier d’enregistrement de session 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 base de données pour un fichier d’enregistrement de session au statut archivé et également à déplacer le fichier d’enregistrement de session 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 dossier de fichier 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 auxquelles un enregistrement de session a été archivé ; la note d’archivage, une note textuelle facultative qui peut être ajoutée par l’administrateur pendant l’archivage. Les deux champs indiquent qu’un enregistrement de session a été archivé et l’heure de l’archivage.

Dans le Lecteur d’enregistrement de session, tous les enregistrements de session archivés affichent le 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. Ce fichier doit être restauré avant que la session puisse être lue. Pour restaurer un enregistrement, fournissez à l’administrateur l’ID de fichier et l’heure d’archivage de celui-ci, à partir de la boîte de dialogue Propriétés de l’enregistrement dans le Lecteur d’enregistrement de session. 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 :

• /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 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 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 placée entre guillemets doubles. Ce paramètre est facultatif.

• /L – Consigne les résultats et les erreurs dans le journal d’événements Windows du 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 où le serveur d’enregistrement de session est installé en tant qu’administrateur local.

2. Démarrer une invite de commandes.

3. 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.

4. Exécutez la commande ICLDB ARCHIVE /RETENTION:<days> /LISTFILES /MOVETO:<directory> /NOTE:<note> /L où 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

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

2. Démarrer une invite de commandes.

3. 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.

4. Exécutez la commande ICLDB ARCHIVE /RETENTION:<days> /LISTFILES /NOTE:<note> /L où 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

La restauration des fichiers d’enregistrement de session est nécessaire lorsque vous souhaitez afficher un enregistrement de session qui a été archivé dans la base de données d’enregistrement de session et que le fichier a été déplacé de l’emplacement de stockage des enregistrements. 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 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. Citrix® recommande 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 tel fichier 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, il 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. Sinon, si le fichier est introuvable, le Broker envoie une erreur de fichier introuvable au Lecteur.

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 du fichier d’enregistrement de session, y compris un nouveau chemin de stockage pour le fichier d’enregistrement de session. L’utilisation de l’utilitaire ICLDB pour importer 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 : Pour un fichier d’enregistrement de session importé, l’heure d’archivage et la note d’archivage sont effacées dans la base de données d’enregistrement de session. Par conséquent, 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 de session archivés, 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, ou déplacer des fichiers d’enregistrement de session d’un emplacement de stockage à un autre sur le serveur d’enregistrement de session. La commande ICLDB import peut également être utilisée pour repeupler 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 d’accès 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.

• /L – Enregistre 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

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

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.

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

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

4. 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.