Aufzeichnungen verwalten

ICA Log Database (ICLDB) ist ein Befehlszeilendienstprogramm für Datenbanken, das zum Bearbeiten von Sitzungsaufzeichnungs-Datenbanksätzen 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 zum Dienstprogramm. Um auf die Hilfe zuzugreifen, geben Sie an 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 Format /RULES:FIELD-In-["CONDITION","CONDITION"];FIELD-NotIn-["CONDITION","CONDITION"]; 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, von der Operation 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, setzen Sie das “CONDITION“-Element in doppelte Anführungszeichen, 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 RULES 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 zu gewährleisten, archivieren Sie Sitzungsaufzeichnungsdateien regelmäßig. Je nach verfügbarem Speicherplatz und typischer 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 so aktualisiert werden, dass er den Status „archiviert“ hat, 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 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 Aufbewahrungsfrist 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 Aufbewahrungsfrist 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 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 diese 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 wird, 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 doppelte 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 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 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 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 ICLDB ARCHIVE /RETENTION:<days> [/LISTFILES] [/NOTE:<note>] [/FILTER:<file path filter>] [/RULES:<advanced filters>] [/L] [/F] [/S] [/?] Befehl 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 von verschobenen 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 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, ü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. 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 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 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 sowie die Anzahl der importierten Sitzungsaufzeichnungsdateien im Windows-Ereignisprotokoll. Dieser Parameter ist optional.

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

Hinweis:

Der IMPORT-Befehl 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“(#relocate-session-recording-files) 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 Sitzungsaufzeichnungsserver installiert ist.

2. Bestimmen Sie in den Eigenschaften des Sitzungsaufzeichnungsplayers die Datei-ID und die Archivierungszeit der archivierten Sitzungsaufzeichnungsdatei.

3. Suchen Sie die Sitzungsaufzeichnungsdatei in Ihren Sicherungen mithilfe der in den Eigenschaften des Sitzungsaufzeichnungsplayers 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 Startmenü die Optionen Start > Alle Programme > Citrix® > Eigenschaften des Sitzungsaufzeichnungsservers.

   2. Wählen Sie in den Eigenschaften des Sitzungsaufzeichnungsservers die Registerkarte Speicher aus. Das aktuelle Wiederherstellungsverzeichnis wird im Feld Wiederherstellungsverzeichnis für archivierte Dateien angezeigt.

Sitzungsaufzeichnungsdateien mithilfe des ICLDB IMPORT-Befehls wiederherstellen

1. Melden Sie sich als lokaler Administrator bei dem Server an, auf dem der Sitzungsaufzeichnungsserver installiert ist.

2. Starten Sie eine Eingabeaufforderung.

3. Wechseln Sie vom aktuellen Arbeitsverzeichnis in das Bin-Verzeichnis des Installationspfads des Sitzungsaufzeichnungsservers (<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 zum Lastenausgleich oder für andere Zwecke an andere Speicherpfade verschieben. Um sicherzustellen, dass die Dateien weiterhin wiedergegeben werden können, müssen Sie deren neue 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 sucht 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 bei Bedarf an andere Speicherpfade.

2. Melden Sie sich als lokaler Administrator an 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 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 Einträge der Sitzungsaufzeichnungsdateien in der Session Recording-Datenbank vorhanden sind.
• Die Sitzungsaufzeichnungsdateien müssen wiedergebbar sein, bevor sie verschoben werden. Andernfalls hilft der Parameter RELOCATE nicht.
• Die neuen Speicherpfade der Sitzungsaufzeichnungsdateien müssen vom Session Recording-Server erkannt werden können. Sie können sie auf der Registerkarte Speicher der Session Recording-Servereigenschaften testen.

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 diese Zeitschwelle auf der Registerkarte Speicher der Session Recording-Servereigenschaften konfigurieren, um nicht reagierende oder inaktive Live-Aufzeichnungen automatisch zu schließen, wenn diese Schwelle ü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-->

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 Dateiname der Aufzeichnung kann auch als Datei-ID verwendet werden.