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 répertoire drive:\Program Files\Citrix\SessionRecording\Server\Bin sur le serveur hébergeant le logiciel 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] options de commande [/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, dans le répertoire drive:\Program Files\Citrix\SessionRecording\Server\Bin, saisissez icldb /?. Pour accéder à l’aide pour des commandes spécifiques, saisissez 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 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 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 des 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 de texte 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 archivés peuvent toujours être lus si les fichiers n’ont pas été déplacés. Si un fichier d’enregistrement 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 comporte plusieurs paramètres décrits ci-après :

• /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. Il s’agit d’un paramètre 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. Il s’agit d’un paramètre 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 base de données pour chaque enregistrement de session archivé. Assurez-vous que la note est placée entre guillemets doubles. Il s’agit d’un paramètre facultatif.

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

• /F – Force l’exécution de la commande d’archivage sans invites. Il s’agit d’un paramètre 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é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. 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 textuelle qui est ajoutée à l’enregistrement de la base de données pour chaque fichier d’enregistrement de session en cours d’archivage. 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>/Server/Bin).

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 textuelle qui est ajoutée à l’enregistrement de la base de données pour chaque enregistrement de session en cours d’archivage. 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 est introuvable à son emplacement de stockage d’origine. Ce cas se produit lorsque le Lecteur d’enregistrement de session demande un enregistrement pour la lecture. Le Broker tente d’abord de trouver cet enregistrement à l’emplacement de stockage d’origine. Si l’enregistrement est introuvable à cet emplacement, le Broker vérifie alors le répertoire de restauration des fichiers archivés. Si l’enregistrement y est présent, le Broker l’envoie au Lecteur pour la lecture. Sinon, si l’enregistrement reste 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 : 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. Par conséquent, la prochaine fois que la commande d’archivage ICLDB est exécutée, le fichier d’enregistrement de session importé pourrait être archivé à nouveau.

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 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 possède plusieurs paramètres 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 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 des 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 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 des fichiers archivés. Pour déterminer le répertoire de restauration des 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 des 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.