Aufzeichnungen verwalten

Die ICA-Protokolldatenbank (ICLDB) ist ein Befehlszeilendienstprogramm, das zum Bearbeiten von Datenbankeinträgen der Sitzungsaufzeichnung verwendet wird. Dieses Dienstprogramm wird während der Installation der Sitzungsaufzeichnung im Ordner <Session Recording Server installation path>\Bin auf dem Server installiert, der den Sitzungsaufzeichnungsserver hostet.

Hinweis:

Wenn Sie ICLDB zum Verwalten von Sitzungsaufzeichnungsdateien verwenden möchten, die in Azure-Dateifreigaben gespeichert sind, führen Sie den Befehl SsRecUtils.exe -MountAzureFiles aus. SsRecUtils.exe und ICLDB befinden sich im selben Ordner.

Kurzübersicht

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] command-options [/L] [/F] [/S] [/?]

Hinweis:

Ausführlichere 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 RULES-Parameter für die Befehle ICLDB ARCHIVE und ICLDB REMOVE

Der RULES-Parameter 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 jede andere Spalte in der Datenbanktabelle namens 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, von der Operation ausgeschlossen werden.

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

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

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

• Sie müssen jedes „CONDITION“-Element in doppelte Anführungszeichen ("") einschließen 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 enthält selbst 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 „UND“ 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 ab dem Startdatum älter als zwei Tage sein, bevor eine Sitzungsaufzeichnungsdatei archiviert werden kann. 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 so aktualisiert werden, dass er den Status „archiviert“ erhält, während die Datei am Speicherort der Aufzeichnung 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 der Aufzeichnung 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 Session Recording-Datenbank 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 Session Recording-Player zeigen archivierte Sitzungsaufzeichnungen den Status „Archiviert“ sowie Datum und Uhrzeit der Archivierung an. Archivierte Sitzungsaufzeichnungen können weiterhin wiedergegeben 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 wiedergegeben 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 näher erläutert.

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 Session Recording-Player (Windows) überprüfen. Ein Aufzeichnungsdateiname kann auch als Datei-ID verwendet werden.

• /RETENTION:<days> – Die Aufbewahrungsdauer in Tagen für Sitzungsaufzeichnungen. Aufzeichnungen, die älter als die angegebene Anzahl von Tagen sind, werden in der Session Recording-Datenbank als archiviert markiert. Die Aufbewahrungsdauer muss eine ganze Zahl größer oder gleich 2 Tage 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 vorhergehenden Abschnitt Der Parameter RULES für ICLDB ARCHIVE- und ICLDB REMOVE-Befehle in diesem Artikel.

• /LISTFILES – Listet den vollständigen Pfad und Dateinamen von 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 der Anzahl der archivierten Sitzungsaufzeichnungsdateien im Windows-Ereignisprotokoll. Dieser Parameter ist optional.

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

So archivieren Sie Sitzungsaufzeichnungen in der Sitzungsaufzeichnungsdatenbank 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 die Aufbewahrungsdauer 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 Sitzungsaufzeichnungsdatenbank

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 die Aufbewahrungsfrist 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 in der Session Recording-Datenbank archivierte und vom Speicherort der Aufzeichnung verschobene Aufzeichnungsdatei anzuzeigen, stellen Sie sie wieder her. Archivierte Sitzungsaufzeichnungen, die während der Archivierung nicht vom Speicherort der Aufzeichnung verschoben wurden, sind weiterhin im Player zugänglich.

Es gibt zwei Methoden zum Wiederherstellen verschobener Sitzungsaufzeichnungsdateien. 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 ein, wenn der Player eine Sitzungsaufzeichnungsdatei zur Wiedergabe anfordert. Der Session Recording Broker versucht zunächst, die Sitzungsaufzeichnungsdatei am ursprünglichen Speicherort zu finden. Wenn die Datei am ursprünglichen Speicherort nicht gefunden wird, überprüft der Session Recording Broker das Wiederherstellungsverzeichnis für archivierte Dateien. Wenn die Datei im Wiederherstellungsverzeichnis vorhanden ist, sendet der Session Recording Broker die Datei zur Wiedergabe an den Player. Wenn die Datei nicht gefunden wird, 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 Archivierungszeit und Archivierungsnotiz in der Session Recording-Datenbank gelöscht. Wenn der Befehl ICLDB ARCHIVE das nächste Mal ausgeführt wird, kann die importierte Sitzungsaufzeichnungsdatei erneut archiviert werden.

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 an einen 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 sowie die Anzahl der importierten Sitzungsaufzeichnungsdateien im Windows-Ereignisprotokoll. Dieser Parameter ist optional.

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

Hinweis:

Der Befehl IMPORT des Dienstprogramms ICLDB 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 bei dem Server an, auf dem der Session Recording-Server installiert ist.

2. Bestimmen Sie in den Session Recording Player-Eigenschaften die Datei-ID und die Archivierungszeit der archivierten Sitzungsaufzeichnungsdatei.

3. Suchen Sie die Sitzungsaufzeichnungsdatei in Ihren Sicherungen mithilfe der in den Session Recording Player-Eigenschaften angegebenen Datei-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 bei dem 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 durch ein Leerzeichen getrennt sind und Sitzungsaufzeichnungsdateien enthalten. 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 zur Lastverteilung oder für andere Zwecke an andere Speicherpfade 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 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 Sie den Parameter RELOCATE verwenden, 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 am 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 durch ein Leerzeichen getrennt sind und Sitzungsaufzeichnungsdateien enthalten. 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 Session Recording-Datenbank vorhanden sind.
• Die Sitzungsaufzeichnungsdateien müssen vor dem Verschieben abspielbar sein. Andernfalls hilft der Parameter RELOCATE nicht.
• Die neuen Speicherpfade der Sitzungsaufzeichnungsdateien müssen vom Session Recording-Server erkannt werden. Sie können sie auf der Registerkarte Speicher der Eigenschaften des Session Recording-Servers überprüfen.

Nicht reagierende oder inaktive Live-Aufzeichnungen schließen

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

Festlegen der Inaktivitätszeit für Aufzeichnungsdateien(/de-de/session-recording/2308/media/setting-recording-file-dormant-time.png)

Sie können nicht reagierende oder inaktive Live-Aufzeichnungen auch manuell mithilfe des Befehls ICLDB DORMANT schließen, zum Beispiel:

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

Mit dem Parameter FILEID können Sie eine Ziel-Sitzungsaufzeichnungsdatei angeben, und mit dem Parameter CLOSEFILES können Sie nicht reagierende oder inaktive Live-Aufzeichnungen, die Sie angeben, manuell schließen.

Tipp:

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