Aufzeichnungen verwalten

Die ICA-Protokolldatenbank (ICLDB) ist ein Befehlszeilendienstprogramm für Datenbanken, das zum Bearbeiten der Datenbankdatensätze der Sitzungsaufzeichnung verwendet wird. Dieses Dienstprogramm wird während der Installation der Sitzungsaufzeichnung in den Ordner <Session Recording Server installation path>\Bin auf dem Server installiert, der den Sitzungsaufzeichnungsserver hostet.

Hinweis:

Wenn Sie ICLDB verwenden möchten, um in Azure-Dateifreigaben gespeicherte Sitzungsaufzeichnungsdateien zu verwalten, führen Sie den Befehl SsRecUtils.exe -MountAzureFiles aus. SsRecUtils.exe und ICLDB befinden sich im selben Ordner.

Kurzübersichtstabelle

Die folgende Tabelle listet die Befehle und Optionen auf, die für das ICLDB-Dienstprogramm verfügbar sind. Geben Sie die Befehle im folgenden Format ein:

ICLDB [VERSION | LOCATE | DORMANT | IMPORT | ARCHIVE | REMOVE | REMOVEALL | REPAIR] command-options [/L] [/F] [/S] [/?]

Hinweis:

Umfassendere Anweisungen finden Sie in der Hilfe, die dem Dienstprogramm zugeordnet ist. Um auf die Hilfe zuzugreifen, geben Sie in einer Eingabeaufforderung den Ordner \Program Files\Citrix\SessionRecording\Server\Bin ein und geben Sie icldb /? ein. Um Hilfe zu bestimmten Befehlen zu erhalten, geben Sie icldb <specific command> /? ein.

Der Parameter RULES für die Befehle ICLDB ARCHIVE und ICLDB REMOVE

Der Parameter RULES legt erweiterte Filter fest, indem er mehrere Filter streng nach dem /RULES:FIELD-In-["CONDITION","CONDITION"];FIELD-NotIn-["CONDITION","CONDITION"];-Format kombiniert, wobei gilt:

• “FIELD” legt einen Filter mit einem Feld fest, das “path”, “user”, “group”, “deliverygroup”, “application”, “server”, “client” oder eine andere Spalte in der Datenbanktabelle dbo.ICLFile sein kann.

• “In” bedeutet, dass mindestens eine der Filterbedingungen in den Klammern erfüllt sein muss, damit eine Aufzeichnungsdatei ein Operationsobjekt ist.

• “NotIn” bedeutet, dass Aufzeichnungsdateien, die eine der Filterbedingungen in den Klammern erfüllen, vom Vorgang ausgeschlossen werden.

• “CONDITION” legt eine Filterbedingung mit einem Datensatz (oder einer Zeile) in der Datenbanktabelle dbo.ICLFile fest.

• Benutzer- und Gruppendatensätze müssen im Format <domain>.<name> eingegeben werden.

• Pfaddatensätze können mithilfe von Windows-Platzhaltern gefiltert werden.

• Sie müssen jedes “CONDITION“-Element in doppelte Anführungszeichen ("") setzen und zwei “CONDITION“-Elemente durch ein Komma (,) trennen.

• Fügen Sie keine Leerzeichen hinzu, wenn Sie “CONDITION“-Elemente eingeben, es sei denn, ein “CONDITION“-Element selbst enthält Leerzeichen.

• Wenn ein “CONDITION“-Element ein oder mehrere Kommas enthält, schließen Sie das “CONDITION“-Element in doppelte Anführungszeichen ein, denen maskierte doppelte Anführungszeichen """ """ folgen.

• Mehrere Filter können in verschiedenen Kombinationen verwendet werden. Beenden Sie jeden Filter mit einem Semikolon (;).

• Der logische Operator „AND“ wird verwendet, um die mehreren Filter zu berechnen. Die Anzahl der Filter ist unbegrenzt, aber die Gesamtlänge der REGELN darf 2.048 Byte nicht überschreiten.

Beispiele:

• /RULES:group-In-["BUILTIN.Guests"];
• /RULES:path-In-["S:\SessionRecordings\2023*"];group-NotIn-["Mydomain.Suspicious","Mydomain.Persistence"];
• /RULES:deliverygroup-In-["RdsDesktopAndAppGroup"];user-In-["Mydomain.AdminA","""Mydomain.Admin,,,B"""];
• /RULES:EndReasonID-In-["1","2"];

Sitzungsaufzeichnungsdateien archivieren

Um eine ausreichende freie Festplattenkapazität an den Speicherorten für Aufzeichnungen aufrechtzuerhalten, archivieren Sie Sitzungsaufzeichnungsdateien regelmäßig. Je nach verfügbarem Speicherplatz und der typischen Größe der Aufzeichnungsdateien variieren die Archivierungsintervalle. Sitzungsaufzeichnungsdateien müssen älter als zwei Tage ab dem Startdatum sein, bevor sie archiviert werden können. Diese Regel soll verhindern, dass Live-Aufzeichnungen archiviert werden, bevor sie vollständig sind.

Beim Archivieren von Sitzungsaufzeichnungen stehen zwei Methoden zur Verfügung. Der Datenbankeintrag für eine Aufzeichnungsdatei kann auf den Status „archiviert“ aktualisiert werden, während die Datei am Speicherort für Aufzeichnungen verbleibt. Diese Methode kann verwendet werden, um die Suchergebnisse im Player zu reduzieren. Die andere Methode besteht darin, den Datenbankeintrag für eine Aufzeichnungsdatei auf den Status „archiviert“ zu aktualisieren und die Datei vom Speicherort für Aufzeichnungen an einen anderen Speicherort zur Sicherung auf alternative Medien zu verschieben. Beim Verschieben von Sitzungsaufzeichnungsdateien verschiebt das ICLDB-Dienstprogramm diese in das angegebene Verzeichnis, wo die ursprüngliche Dateistruktur Jahr/Monat/Tag nicht mehr existiert.

Der Sitzungsaufzeichnungsdatensatz in der Sitzungsaufzeichnungsdatenbank enthält zwei Felder, die mit der Archivierung verbunden sind – die Archivierungszeit und die Archivierungsnotiz. Die Archivierungszeit stellt das aktuelle Datum und die Uhrzeit dar, zu der eine Aufzeichnung archiviert wurde. Die Archivierungsnotiz ist eine optionale Textnotiz, die während der Archivierung hinzugefügt werden kann. Die beiden Felder zeigen an, dass eine Aufzeichnung archiviert wurde und wann die Archivierung erfolgte.

Im Sitzungsaufzeichnungs-Player zeigen archivierte Sitzungsaufzeichnungen den Status „Archiviert“ sowie Datum und Uhrzeit der Archivierung an. Archivierte Sitzungsaufzeichnungen können weiterhin abgespielt werden, wenn die Dateien nicht verschoben wurden. Wenn eine Sitzungsaufzeichnungsdatei während der Archivierung verschoben wurde, wird ein Fehler „Datei nicht gefunden“ angezeigt. Die Sitzungsaufzeichnungsdatei muss wiederhergestellt werden, bevor die Sitzung abgespielt werden kann. Um eine Sitzungsaufzeichnungsdatei wiederherzustellen, geben Sie die Datei-ID und die Archivierungszeit der Aufzeichnungsdatei an. Die Wiederherstellung archivierter Dateien wird im folgenden Abschnitt Sitzungsaufzeichnungsdateien wiederherstellen ausführlicher behandelt.

Der Befehl ARCHIVE des ICLDB-Dienstprogramms verfügt über mehrere Parameter, die wie folgt beschrieben werden:

• /FILEID:<id> – Ermöglicht die Angabe einer Ziel-Sitzungsaufzeichnungsdatei. Sie können die ID einer Sitzungsaufzeichnungsdatei im Sitzungsaufzeichnungs-Player (Windows) überprüfen. Ein Aufzeichnungsdateiname kann auch als Datei-ID verwendet werden.

• /RETENTION:<days> – Der Aufbewahrungszeitraum in Tagen für Sitzungsaufzeichnungen. Aufzeichnungen, die älter als die angegebene Anzahl von Tagen sind, werden in der Session Recording-Datenbank als archiviert markiert. Der Aufbewahrungszeitraum muss eine ganze Zahl größer oder gleich 2 Tagen sein.

• /FILTER:<filter>: Ermöglicht das Filtern von Dateipfaden mithilfe der Platzhalter * und ?. Der Parameter FILTER ist optional. Wenn Sie den Parameter FILTER hinzufügen, werden nur die Sitzungsaufzeichnungsdateien archiviert, die sowohl RETENTION als auch FILTER erfüllen.

• /RULES:<advanced filters>: Legt erweiterte Filter fest, indem mehrere Filter streng nach dem /RULES:FIELD-In-["CONDITION","CONDITION"];FIELD-NotIn-["CONDITION","CONDITION"];-Format kombiniert werden. Der Parameter RULES und der Parameter FILTER können nicht zusammen verwendet werden. Weitere Informationen finden Sie im vorangehenden Abschnitt Der Parameter RULES für ICLDB ARCHIVE- und ICLDB REMOVE-Befehle in diesem Artikel.

• /LISTFILES – Listet den vollständigen Pfad und Dateinamen der Sitzungsaufzeichnungsdateien auf, während sie archiviert werden. Dieser Parameter ist optional.

• /MOVETO:<directory> – Das Verzeichnis, in das Sie archivierte Sitzungsaufzeichnungsdateien physisch verschieben. Das angegebene Verzeichnis muss vorhanden sein. Dieser Parameter ist optional. Wenn kein Verzeichnis angegeben ist, verbleiben die Dateien an ihrem ursprünglichen Speicherort.

• /NOTE:<note> – Eine Textnotiz, die dem Datenbankeintrag für jede archivierte Sitzungsaufzeichnung hinzugefügt wird. Stellen Sie sicher, dass die Notiz in doppelten Anführungszeichen eingeschlossen ist. Dieser Parameter ist optional.

• /L – Protokolliert die Ergebnisse und Fehler in das Windows-Ereignisprotokoll der Anzahl der archivierten Sitzungsaufzeichnungsdateien. Dieser Parameter ist optional.

• /F – Erzwingt die Ausführung des Archivierungsbefehls ohne Aufforderungen. Dieser Parameter ist optional.

So archivieren Sie Sitzungsaufzeichnungen in der Session Recording-Datenbank und verschieben Sitzungsaufzeichnungsdateien physisch

1. Melden Sie sich als lokaler Administrator am Server an, auf dem der Session Recording-Server installiert ist.

2. Starten Sie eine Eingabeaufforderung.

3. Wechseln Sie vom aktuellen Arbeitsverzeichnis in das Bin-Verzeichnis des Installationspfads des Session Recording-Servers (<Session Recording server Installation Path>\Bin).

4. Führen Sie den Befehl ICLDB ARCHIVE /RETENTION:<days> [/LISTFILES] [/MOVETO:<dir>] [/NOTE:<note>] [/FILTER:<file path filter>] [/RULES:<advanced filters>] [/L] [/F] [/S] [/?] aus. Die Parameter in Klammern sind optional. Entfernen Sie die Klammern, wenn Sie den Befehl ausführen. Der Parameter RULES und der Parameter FILTER können nicht zusammen verwendet werden. days ist der Aufbewahrungszeitraum für Sitzungsaufzeichnungsdateien, directory ist das Verzeichnis, in das archivierte Sitzungsaufzeichnungsdateien verschoben werden, und note ist die Textnotiz, die dem Datenbankeintrag für jede zu archivierende Sitzungsaufzeichnungsdatei hinzugefügt wird. Geben Sie Y ein, um die Archivierung zu bestätigen.

So archivieren Sie nur Sitzungsaufzeichnungen in der Session Recording-Datenbank

1. Melden Sie sich als lokaler Administrator am Server an, auf dem der Session Recording-Server installiert ist.

2. Starten Sie eine Eingabeaufforderung.

3. Wechseln Sie vom aktuellen Arbeitsverzeichnis in das Bin-Verzeichnis des Installationspfads des Session Recording-Servers (<Session Recording server installation path>\Bin).

4. Führen Sie den Befehl ICLDB ARCHIVE /RETENTION:<days> [/LISTFILES] [/NOTE:<note>] [/FILTER:<file path filter>] [/RULES:<advanced filters>] [/L] [/F] [/S] [/?] aus. Die Parameter in Klammern sind optional. Entfernen Sie die Klammern, wenn Sie den Befehl ausführen. Der Parameter RULES und der Parameter FILTER können nicht zusammen verwendet werden. days ist der Aufbewahrungszeitraum für Sitzungsaufzeichnungen und note ist die Textnotiz, die dem Datenbankeintrag für jede zu archivierende Sitzungsaufzeichnung hinzugefügt wird. Geben Sie Y ein, um die Archivierung zu bestätigen.

Sitzungsaufzeichnungsdateien wiederherstellen

Um eine Aufzeichnungsdatei anzuzeigen, die in der Session Recording-Datenbank archiviert und vom Aufzeichnungsspeicherort verschoben wurde, stellen Sie sie wieder her. Archivierte Sitzungsaufzeichnungen, die während der Archivierung nicht vom Aufzeichnungsspeicherort verschoben wurden, sind weiterhin im Player zugänglich.

Es stehen zwei Methoden zum Wiederherstellen von verschobenen Sitzungsaufzeichnungsdateien zur Verfügung. Kopieren Sie die erforderliche Sitzungsaufzeichnungsdatei in das Wiederherstellungsverzeichnis für archivierte Dateien. Oder importieren Sie die erforderliche Sitzungsaufzeichnungsdatei mithilfe des ICLDB-Dienstprogramms zurück in die Session Recording-Datenbank. Wir empfehlen die erste Methode zum Wiederherstellen archivierter Sitzungsaufzeichnungsdateien. Entfernen Sie archivierte Dateien, die in das Wiederherstellungsverzeichnis für archivierte Dateien kopiert wurden, wenn Sie sie nicht mehr benötigen.

Der Session Recording Broker verwendet das Wiederherstellungsverzeichnis für archivierte Dateien, wenn eine Sitzungsaufzeichnungsdatei an ihrem ursprünglichen Speicherort nicht gefunden wird. Dieser Fall tritt auf, wenn der Player eine Sitzungsaufzeichnungsdatei zur Wiedergabe anfordert. Der Session Recording Broker versucht zunächst, die Sitzungsaufzeichnungsdatei am ursprünglichen Speicherort zu finden. Wird die Datei am ursprünglichen Speicherort nicht gefunden, prüft der Session Recording Broker das Wiederherstellungsverzeichnis für archivierte Dateien. Ist die Datei im Wiederherstellungsverzeichnis vorhanden, sendet der Session Recording Broker die Datei zur Wiedergabe an den Player. Wird die Datei nicht gefunden, sendet der Session Recording Broker eine Fehlermeldung „Datei nicht gefunden“ an den Player.

Das Importieren einer archivierten Aufzeichnungsdatei aktualisiert die Session Recording-Datenbank mit den Sitzungsaufzeichnungsinformationen aus der Datei, einschließlich eines neuen Speicherpfads. Das Importieren einer archivierten Sitzungsaufzeichnungsdatei verschiebt die Datei nicht an den ursprünglichen Speicherort zurück, an dem die Sitzung aufgezeichnet wurde.

Hinweis: Bei einer importierten Sitzungsaufzeichnungsdatei werden die Archivierungszeit und die Archivierungsnotiz in der Session Recording-Datenbank gelöscht. Wenn der Befehl ICLDB ARCHIVE das nächste Mal ausgeführt wird, wird die importierte Sitzungsaufzeichnungsdatei möglicherweise erneut archiviert.

Der Befehl ICLDB IMPORT ist nützlich, um eine große Anzahl archivierter Aufzeichnungsdateien zu importieren. Er kann falsche und fehlende Sitzungsaufzeichnungsdaten in der Session Recording-Datenbank reparieren oder aktualisieren. Er ist auch nützlich, um Sitzungsaufzeichnungsdateien von einem Speicherort zu einem anderen auf dem Session Recording-Server zu verschieben. Sie können den Befehl ICLDB IMPORT verwenden, um die Session Recording-Datenbank nach dem Ausführen des Befehls ICLDB REMOVEALL erneut mit Sitzungsaufzeichnungen zu füllen.

Der Befehl IMPORT des ICLDB-Dienstprogramms verfügt über mehrere Parameter, die Sie zum Wiederherstellen archivierter Aufzeichnungsdateien verwenden können:

• /LISTFILES – Listet den vollständigen Pfad und Dateinamen von Sitzungsaufzeichnungsdateien während des Imports auf. Dieser Parameter ist optional.

• /RECURSIVE – Durchsucht alle Unterverzeichnisse nach Sitzungsaufzeichnungsdateien. Dieser Parameter ist optional.

• /RELOCATE – Ohne den Parameter RELOCATE analysiert der Befehl IMPORT Sitzungsaufzeichnungsdateien vollständig, was Zeit in Anspruch nimmt. Mit dem Parameter RELOCATE lokalisiert der Befehl IMPORT einfach die Datenbankeinträge von Sitzungsaufzeichnungsdateien und aktualisiert deren Dateipfade direkt.

• /L – Protokolliert die Ergebnisse und Fehler im Windows-Ereignisprotokoll, die Anzahl der importierten Sitzungsaufzeichnungsdateien. Dieser Parameter ist optional.

• /F – Erzwingt die Ausführung des Befehls IMPORT ohne Aufforderungen. Dieser Parameter ist optional.

Hinweis:

Der Befehl IMPORT des ICLDB-Dienstprogramms bietet auch einen optionalen Parameter, RELOCATE, den Sie zum Verschieben von Aufzeichnungsdateien verwenden können. Weitere Informationen finden Sie im Abschnitt „Sitzungsaufzeichnungsdateien verschieben“ in diesem Artikel.

Sitzungsaufzeichnungsdateien mithilfe des Wiederherstellungsverzeichnisses für archivierte Dateien wiederherstellen

1. Melden Sie sich als lokaler Administrator am Server an, auf dem der Session Recording-Server installiert ist.

2. Bestimmen Sie in den Session Recording Player-Eigenschaften die File ID und Archive Time der archivierten Sitzungsaufzeichnungsdatei.

3. Suchen Sie die Sitzungsaufzeichnungsdatei in Ihren Sicherungen mithilfe der in den Session Recording Player-Eigenschaften angegebenen File ID. Jede Sitzungsaufzeichnung hat einen Dateinamen von i_<FileID>.icl, wobei FileID die ID der Sitzungsaufzeichnungsdatei ist.

4. Kopieren Sie die Sitzungsaufzeichnungsdatei aus Ihrer Sicherung in das Wiederherstellungsverzeichnis für archivierte Dateien. So ermitteln Sie das Wiederherstellungsverzeichnis für archivierte Dateien:

   1. Wählen Sie im Menü Start die Optionen Start > Alle Programme > Citrix® > Session Recording Server Properties.

   2. Wählen Sie in den Session Recording Server Properties die Registerkarte Storage. Das aktuelle Wiederherstellungsverzeichnis wird im Feld Restore directory for archived files angezeigt.

Sitzungsaufzeichnungsdateien mithilfe des ICLDB IMPORT-Befehls wiederherstellen

1. Melden Sie sich als lokaler Administrator am Server an, auf dem der Session Recording-Server installiert ist.

2. Starten Sie eine Eingabeaufforderung.

3. Wechseln Sie vom aktuellen Arbeitsverzeichnis in das Bin-Verzeichnis des Installationspfads des Session Recording-Servers (<Session Recording server installation path>\Bin).

4. Entweder:

   • Führen Sie den Befehl ICLDB IMPORT /LISTFILES /RECURSIVE /L <directory> aus, wobei directory der Name eines oder mehrerer Verzeichnisse ist, die Sitzungsaufzeichnungsdateien enthalten und durch ein Leerzeichen getrennt sind. Geben Sie Y ein, um den Import zu bestätigen.

   • Führen Sie den Befehl ICLDB IMPORT /LISTFILES /L <file> aus, wobei file der Name einer oder mehrerer Sitzungsaufzeichnungsdateien ist, die durch ein Leerzeichen getrennt sind. Platzhalter können verwendet werden, um Sitzungsaufzeichnungsdateien anzugeben. Geben Sie Y ein, um den Import zu bestätigen.

Sitzungsaufzeichnungsdateien verschieben

Sie können Sitzungsaufzeichnungsdateien an andere Speicherpfade für den Lastausgleich oder andere Zwecke verschieben. Um sicherzustellen, dass die Dateien weiterhin wiedergegeben werden können, müssen Sie ihre neuen Pfade in der Session Recording-Datenbank aktualisieren. Verwenden Sie dazu den Befehl ICLDB IMPORT. Um den Importvorgang zu beschleunigen, fügen Sie den Parameter RELOCATE an den Befehl ICLDB IMPORT an.

Hinweis:

Der Parameter RELOCATE ist optional. Ohne den Parameter RELOCATE analysiert der Befehl ICLDB IMPORT die Sitzungsaufzeichnungsdateien vollständig, was Zeit in Anspruch nimmt. Mit dem Parameter RELOCATE lokalisiert der Befehl ICLDB IMPORT einfach die Datenbankeinträge der Sitzungsaufzeichnungsdateien und aktualisiert deren Dateipfade direkt.

Die folgenden Schritte veranschaulichen, wie der Parameter RELOCATE verwendet wird, um neue Dateipfade in der Session Recording-Datenbank zu aktualisieren.

1. Verschieben Sie Sitzungsaufzeichnungsdateien nach Bedarf an andere Speicherpfade.

2. Melden Sie sich als lokaler Administrator auf dem Server an, auf dem der Session Recording-Server installiert ist.

3. Starten Sie eine Eingabeaufforderung.

4. Wechseln Sie vom aktuellen Arbeitsverzeichnis in das Bin-Verzeichnis des Installationspfads des Session Recording-Servers (<Session Recording server installation path>\Bin).

5. Entweder:

   • Führen Sie den Befehl ICLDB IMPORT /LISTFILES /RECURSIVE /RELOCATE /L <directory> aus, wobei directory der Name eines oder mehrerer Verzeichnisse ist, die Sitzungsaufzeichnungsdateien enthalten und durch ein Leerzeichen getrennt sind. Geben Sie Y ein, um den Import zu bestätigen.

   • Führen Sie den Befehl ICLDB IMPORT /LISTFILES /RELOCATE /L <file> aus, wobei file der Name einer oder mehrerer Sitzungsaufzeichnungsdateien ist, die durch ein Leerzeichen getrennt sind. Platzhalter können verwendet werden, um Sitzungsaufzeichnungsdateien anzugeben. Geben Sie Y ein, um den Import zu bestätigen.

Hinweis:

• Der Parameter RELOCATE geht davon aus, dass bereits Datensätze der Sitzungsaufzeichnungsdateien in der Sitzungsaufzeichnungsdatenbank vorhanden sind.
• Die Sitzungsaufzeichnungsdateien müssen abspielbar sein, bevor sie verschoben werden. Andernfalls hilft der Parameter RELOCATE nicht.
• Die neuen Speicherpfade der Sitzungsaufzeichnungsdateien müssen vom Sitzungsaufzeichnungsserver erkannt werden. Sie können sie auf der Registerkarte Speicher der Eigenschaften des Sitzungsaufzeichnungsservers testen.

Nicht reagierende oder inaktive Live-Aufzeichnungen schließen

Standardmäßig wird eine Live-Aufzeichnung als nicht reagierend oder inaktiv betrachtet, wenn 24 Stunden lang keine neuen Daten in die Aufzeichnungsdatei geschrieben wurden. Sie können diesen Zeitschwellenwert auf der Registerkarte Speicher der Eigenschaften des Sitzungsaufzeichnungsservers konfigurieren, um nicht reagierende oder inaktive Live-Aufzeichnungen automatisch zu schließen, wenn dieser Schwellenwert überschritten wird. Der Mindestwert, den Sie festlegen können, ist 12 (Stunden).

Sie können nicht reagierende oder inaktive Live-Aufzeichnungen auch manuell mit dem Befehl ICLDB DORMANT schließen, zum Beispiel:

ICLDB DORMANT [/DAYS:<days> | /HOURS:<hours> | /MINUTES:<minutes> | /FILEID:<id>] [/LISTFILES] [/CLOSEFILES] [/L] [/F] [/S] [/?]
<!--NeedCopy-->

Der Parameter FILEID ermöglicht es Ihnen, eine Ziel-Sitzungsaufzeichnungsdatei anzugeben, und der Parameter CLOSEFILES ermöglicht es Ihnen, nicht reagierende oder inaktive Live-Aufzeichnungen, die Sie angeben, manuell zu schließen.

Tipp:

Sie können die ID einer Sitzungsaufzeichnungsdatei im Sitzungsaufzeichnungs-Player (Windows) überprüfen. Ein Aufzeichnungsdateiname kann auch als Datei-ID verwendet werden.