Aufzeichnungen verwalten

ICLDB (ICA Log database) ist ein Datenbankbefehlszeilenprogramm, mit dem Sie Sitzungsaufzeichnungsdatensätze in der Datenbank manipulieren. Dieses Hilfsprogramm wird mit der Sitzungsaufzeichnung im Ordner <Session Recording Server installation path>\Bin auf dem Server mit der Serversoftware der Sitzungsaufzeichnung installiert.

Hinweis:

Führen Sie den Befehl SsRecUtils.exe -MountAzureFiles aus, um mit ICLDB Sitzungsaufzeichnungsdateien zu verwalten, die in Azure-Dateifreigaben gespeichert sind. SsRecUtils.exe und ICLDB befinden sich im selben Ordner.

Übersichtstabelle

In der folgenden Tabelle finden Sie die Befehle und Optionen für das ICLDB-Hilfsprogramm. 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 des Hilfsprogramms. Um auf die Hilfe zuzugreifen, geben Sie an der Eingabeaufforderung den Ordner \Program Files\Citrix\SessionRecording\Server\Bin ein und dann icldb /?. Um Hilfe für bestimmte Befehle zu erhalten, geben Sie Folgendes ein: icldb <specific command> /?.

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

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

• FIELD setzt einen Filter mit einem Feld, 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 Objekt des Vorgangs wird.

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

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

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

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

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

• Fügen Sie bei der Eingabe von CONDITION-Elementen keine Leerzeichen hinzu, es sei denn, das 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, gefolgt von geschützten doppelten Anführungszeichen (""" """).

• Filter können auf verschiedene Weise kombiniert werden. Beenden Sie jeden Filter mit einem Semikolon (;).

• Der logische Operator AND wird zur Verarbeitung der Filter verwendet. Die Anzahl der Filter ist unbegrenzt, aber die Gesamtlänge von 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"];

Archivieren von Sitzungsaufzeichnungsdateien

Archivieren Sie Sitzungsaufzeichnungsdateien regelmäßig, damit an den Speicherorten für die Aufzeichnung immer ausreichend freier Platz zur Verfügung steht. Das Archivierungsintervall hängt von dem verfügbaren Speicherplatz und der Größe typischer Aufzeichnungsdateien ab. Sitzungsaufzeichnungsdateien können ab zwei Tage nach dem Sitzungsstart archiviert werden. Diese Regel soll verhindern, dass Liveaufzeichnungen vor Abschluss archiviert werden.

Sitzungsaufzeichnungen können auf zweierlei Weise archiviert werden. Der Datenbankdatensatz einer Aufzeichnungsdatei kann auf den Status “Archiviert” aktualisiert werden, während die Datei an ihrem Speicherort verbleibt. Durch diese Methode werden die Suchergebnisse im Player verringert. Die zweite Methode besteht darin, den Datenbankdatensatz der Aufzeichnungsdatei auf “Archiviert” zu aktualisieren und die Aufzeichnungsdatei zum Backup auf ein alternatives Speichermedium zu verschieben. Bei Verwendung des ICLDB-Hilfsprogramms werden Sitzungsaufzeichnungsdateien in das angegebene Verzeichnis verschoben, in dem die ursprüngliche Ordnerstruktur Jahr/Monat/Tag nicht besteht.

Ein Datensatz in der Datenbank für die Sitzungsaufzeichnung enthält zwei mit der Archivierung verbundene Felder: die Archivierungszeit und die Archivierungsnotiz. Die Archivierungszeit ist das Datum und die Uhrzeit, zu der eine Aufzeichnung archiviert wurde. Die Archivierungsnotiz ist ein optionaler Text, der bei der Archivierung hinzugefügt werden kann. Die beiden Felder geben an, ob und wann eine Aufzeichnung archiviert wurde.

Im Sitzungsaufzeichnungsplayer werden archivierte Sitzungsaufzeichnungen mit dem Status “Archiviert” und dem Datum und der Uhrzeit der Archivierung angezeigt. Archivierte Sitzungsaufzeichnungen können weiterhin abgespielt werden, sofern die Dateien nicht verschoben wurden. Wurde eine Sitzungsaufzeichnungsdatei bei der Archivierung verschoben, wird gemeldet, dass die Datei nicht gefunden wurde. Die Sitzungsaufzeichnungsdatei muss wiederhergestellt werden, damit sie abgespielt werden kann. Zum Wiederherstellen einer Sitzungsaufzeichnungsdatei geben Sie die Datei-ID und die Uhrzeit der Archivierung für die Aufzeichnungsdatei an. Das Verfahren zur Wiederherstellung archivierter Dateien wird unter Wiederherstellen von Sitzungsaufzeichnungsdateien weiter unten erläutert.

Der Befehl ARCHIVE des Hilfsprogramms ICLDB kann mit folgenden Parametern verwendet werden:

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

• /RETENTION:<tage> - Dauer der Aufbewahrung von Sitzungsaufzeichnungen in Tagen. Aufzeichnungen, die älter als die angegebene Anzahl von Tagen sind, werden in der Datenbank für die Sitzungsaufzeichnung als archiviert markiert. Der Aufbewahrungszeitraum muss mindestens 2 Tage betragen.

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

• /RULES:<erweiterte filter>: Legt erweiterte Filter fest, indem mehrere Filter streng nach dem Format /RULES:FIELD-In-["CONDITION","CONDITION"];FIELD-NotIn-["CONDITION","CONDITION"]; kombiniert werden. Die Parameter RULES und FILTER können nicht zusammen verwendet werden. Weitere Informationen finden Sie unter RULES-Parameter für ICLDB ARCHIVE und ICLDB REMOVE.

• /LISTFILES: vollständigen Pfad und Dateiname der Sitzungsaufzeichnungsdateien bei der Archivierung. Dieser Parameter ist optional.

• /MOVETO:<Verzeichnis> - Verzeichnis, in das archivierte Sitzungsaufzeichnungsdateien verschoben werden. Das Verzeichnis muss vorhanden sein. Dieser Parameter ist optional. Wird kein Verzeichnis angegeben, verbleiben die Dateien an ihrem ursprünglichen Speicherort.

• /NOTE:<Notiz> - Textnotiz, die dem Datenbankdatensatz für jede archivierte Sitzungsaufzeichnung hinzugefügt wird. Die Notiz muss in doppelte Anführungszeichen gesetzt werden. Dieser Parameter ist optional.

• /L: protokolliert Ergebnisse und Fehler in Verbindung mit den archivierten Sitzungsaufzeichnungsdateien im Windows-Ereignisprotokoll. Dieser Parameter ist optional.

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

Archivieren von Sitzungsaufzeichnungen in der Datenbank für die Sitzungsaufzeichnung und physisches Verschieben der Sitzungsaufzeichnungsdateien

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

2. Rufen Sie eine Eingabeaufforderung auf.

3. Wechseln Sie vom aktuellen Arbeitsverzeichnis in das Bin-Verzeichnis des Sitzungsaufzeichnungsserver-Installationspfads (<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. Die Parameter RULES und 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 eine Textnotiz, die dem Datenbankdatensatz jeder archivierten Sitzungsaufzeichnungsdatei hinzugefügt wird. Geben Sie Y ein, um die Archivierung zu bestätigen.

Ausschließliches Archivieren von Sitzungsaufzeichnungen in der Datenbank für die Sitzungsaufzeichnung

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

2. Rufen Sie eine Eingabeaufforderung auf.

3. Wechseln Sie vom aktuellen Arbeitsverzeichnis in das Bin-Verzeichnis des Sitzungsaufzeichnungsserver-Installationspfads (<Installationspfad>\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 RULES-Parameter und der FILTER-Parameter können nicht zusammen verwendet werden. days entspricht dem Aufbewahrungszeitraum für Sitzungsaufzeichnungen und note ist eine Textnotiz, die dem Datenbankdatensatz jeder archivierten Sitzungsaufzeichnung hinzugefügt wird. Geben Sie Y ein, um die Archivierung zu bestätigen.

Wiederherstellen von Sitzungsaufzeichnungsdateien

Zum Anzeigen einer Aufzeichnungsdatei, die in der Datenbank für die Sitzungsaufzeichnung archiviert und dann verschoben wurde, stellen Sie sie wieder her. Archivierte Sitzungsaufzeichnungen, die nicht aus dem Speicherort der Aufzeichnung verschoben wurden, stehen im Player weiterhin zur Verfügung.

Es gibt zwei Wiederherstellungsmethoden für Sitzungsaufzeichnungsdateien, die verschoben wurden. Kopieren Sie die erforderliche Sitzungsaufzeichnungsdatei in das Wiederherstellungsverzeichnis für archivierte Dateien. Oder importieren Sie die erforderliche Sitzungsaufzeichnungsdatei mit ICLDB neu in die Datenbank für die Sitzungsaufzeichnung. Wir empfehlen das erste Verfahren, also das Kopieren. Entfernen Sie in das Wiederherstellungsverzeichnis kopierte archivierte Dateien, wenn Sie sie nicht mehr benötigen.

Der Sitzungsaufzeichnungsbroker verwendet das Wiederherstellungsverzeichnis für archivierte Dateien, wenn eine Sitzungsaufzeichnungsdatei nicht am ursprünglichen Speicherort gefunden wird. Dies passiert, wenn der Player eine Sitzungsaufzeichnungsdatei zur Wiedergabe anfordert. Der Sitzungsaufzeichnungsbroker sucht die Datei zunächst am ursprünglichen Speicherort. Wird sie dort nicht gefunden, überprüft der Sitzungsaufzeichnungsbroker das Wiederherstellungsverzeichnis. Befindet sich die Datei im Wiederherstellungsverzeichnis, sendet der Sitzungsaufzeichnungsbroker sie zur Wiedergabe an den Player. Andernfalls sendet der Sitzungsaufzeichnungsbroker eine Fehlermeldung an den Player, dass die Datei nicht gefunden wurde.

Beim Importieren einer archivierten Aufzeichnungsdatei wird die Datenbank für die Sitzungsaufzeichnung durch die in der Datei enthaltenen Sitzungsaufzeichnungsinformationen einschließlich des neuen Speicherpfads aktualisiert. Beim Importieren werden Sitzungsaufzeichnungsdateien nicht an den ursprünglichen Speicherort ihrer Aufzeichnung zurückverschoben.

Hinweis: Bei importierten Sitzungsaufzeichnungsdateien werden die Uhrzeit der Archivierung und die Archivierungsnotiz gelöscht. Wenn Sie das nächste Mal den Befehl ICLDB ARCHIVE ausführen, können solche importierten Dateien wieder archiviert werden.

Der Befehl ICLDB IMPORT eignet sich zum Importieren großer Zahlen archivierter Aufzeichnungsdateien. Er kann falsche und fehlende Sitzungsaufzeichnungsdaten in der Datenbank für die Sitzungsaufzeichnung reparieren oder aktualisieren. Er kann auch verwendet werden, um Sitzungsaufzeichnungsdateien an einen anderen Speicherort auf dem Sitzungsaufzeichnungsserver zu verschieben. Mit dem Befehl ICLDB IMPORT können Sie außerdem die Datenbank für die Sitzungsaufzeichnung wieder auffüllen, nachdem der Befehl ICLDB REMOVEALL ausgeführt wurde.

Der Befehl IMPORT des ICLDB-Hilfsprogramms hat mehrere Parameter, die Sie für die Wiederherstellung archivierter Aufzeichnungsdateien verwenden können:

• /LISTFILES: vollständigen Pfad und Dateiname der Sitzungsaufzeichnungsdateien beim Import. Dieser Parameter ist optional.

• /RECURSIVE: durchsucht alle Unterverzeichnisse nach Sitzungsaufzeichnungsdateien. Dieser Parameter ist optional.

• /RELOCATE – Ohne den Parameter RELOCATE analysiert der Befehl IMPORT die gesamten Sitzungsaufzeichnungsdateien, was einige Zeit in Anspruch nimmt. Mit dem Parameter RELOCATE sucht der Befehl IMPORT nur die Datenbankeinträge der Sitzungsaufzeichnungsdateien und aktualisiert deren Dateipfade direkt.

• /L: protokolliert Ergebnisse und Fehler in Verbindung mit den 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 ICLDB-Hilfsprogramms enthält auch den optionalen Parameter RELOCATE, den Sie zum Verschieben von Aufzeichnungsdateien verwenden können. Weitere Informationen finden Sie im Abschnitt Sitzungsaufzeichnungsdateien verschieben in diesem Artikel.

Sitzungsaufzeichnungsdateien unter Verwendung 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. Sehen Sie im Sitzungsaufzeichnungsplayer unter “Eigenschaften” die Datei-ID und die Archivierungszeit der gewünschten Sitzungsaufzeichnungsdatei nach.

3. Suchen Sie die Sitzungsaufzeichnungsdatei im Backup anhand der in den Eigenschaften des Sitzungsaufzeichnungsplayers angegebenen Datei-ID. Jede Sitzungsaufzeichnung hat einen Dateinamen im Format i_<FileID>.icl, wobei “FileID” die Datei-ID der Sitzungsaufzeichnungsdatei ist.

4. Kopieren Sie die Sitzungsaufzeichnungsdatei aus dem Backup in das Wiederherstellungsverzeichnis für archivierte Dateien. Suchen des Wiederherstellungsverzeichnisses für archivierte Dateien

   1. Klicken Sie im Menü Start auf Start > Programme > Citrix > Sitzungsaufzeichnungsserver - Eigenschaften.

   2. Klicken Sie unter Sitzungsaufzeichnungsserver - Eigenschaften auf die Registerkarte Speicher. Das aktuelle Wiederherstellungsverzeichnis wird im Feld Wählen Sie das Wiederherstellungsverzeichnis für archivierte Dateien aus angezeigt.

Sitzungsaufzeichnungsdateien mit dem ICLDB-Befehl IMPORT wiederherstellen

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

2. Rufen Sie eine Eingabeaufforderung auf.

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

4. Sie haben folgende Möglichkeiten:

   • Führen Sie den Befehl ICLDB IMPORT /LISTFILES /RECURSIVE /L <directory> aus. directory steht für ein oder mehrere Verzeichnisse mit Sitzungsaufzeichnungsdateien. Mehrere Verzeichnisse trennen Sie durch Leerzeichen. Geben Sie Y ein, um den Import zu bestätigen.

   • Führen Sie den Befehl ICLDB IMPORT /LISTFILES /L <file> aus. file ist der Name einer oder mehrerer Sitzungsaufzeichnungsdateien. Mehrere Dateien trennen Sie durch Leerzeichen. Platzhalterzeichen können beim Angeben Sitzungsaufzeichnungsdateien verwendet werden. Geben Sie Y ein, um den Import zu bestätigen.

Sitzungsaufzeichnungsdateien verschieben

Sie können Sitzungsaufzeichnungsdateien zum Lastausgleich oder zu anderen Zwecken in andere Speicherpfade verschieben. Um sicherzustellen, dass die Dateien weiterhin wiedergegeben werden können, müssen Sie die Datenbank für die Sitzungsaufzeichnung mit den neuen Pfaden aktualisieren. Verwenden Sie hierfür 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 gesamten Sitzungsaufzeichnungsdateien, was einige Zeit in Anspruch nimmt. Mit dem Parameter RELOCATE sucht der Befehl ICLDB IMPORT nur die Datenbankeinträge der Sitzungsaufzeichnungsdateien und aktualisiert deren Dateipfade direkt.

Die folgenden Schritte veranschaulichen, wie Sie den RELOCATE-Parameter verwenden, um Dateipfade in der Datenbank für die Sitzungsaufzeichnung zu aktualisieren.

1. Verschieben Sie Sitzungsaufzeichnungsdateien nach Bedarf in andere Speicherpfade.

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

3. Rufen Sie eine Eingabeaufforderung auf.

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

5. Sie haben folgende Möglichkeiten:

   • Führen Sie den Befehl ICLDB IMPORT /LISTFILES /RECURSIVE /RELOCATE /L <directory> aus. directory steht für ein oder mehrere Verzeichnisse mit Sitzungsaufzeichnungsdateien. Mehrere Verzeichnisse trennen Sie durch Leerzeichen. Geben Sie Y ein, um den Import zu bestätigen.

   • Führen Sie den Befehl ICLDB IMPORT /LISTFILES /RELOCATE /L <file> aus. file ist der Name einer oder mehrerer Sitzungsaufzeichnungsdateien. Mehrere Dateien trennen Sie durch Leerzeichen. Platzhalterzeichen können beim Angeben Sitzungsaufzeichnungsdateien verwendet werden. Geben Sie Y ein, um den Import zu bestätigen.

Hinweis:

• Der Parameter RELOCATE geht davon aus, dass in der Datenbank für die Sitzungsaufzeichnung bereits Datensätze für die Sitzungsaufzeichnungsdateien vorhanden sind.
• Die Sitzungsaufzeichnungsdateien müssen wiedergabefähig sein, um verschoben werden zu können. Andernfalls hilft der Parameter RELOCATE nicht.
• Die neuen Speicherpfade der Sitzungsaufzeichnungsdateien müssen vom Sitzungsaufzeichnungsserver erkannt werden können. Sie können dies auf der Registerkarte Speicher in den Eigenschaften des Sitzungsaufzeichnungsservers überprüfen.

Nicht ansprechbare oder inaktive Live-Aufzeichnungen schließen

Eine Live-Aufzeichnung gilt als nicht ansprechbar oder inaktiv, wenn in sie 24 Stunden lang keine neuen Daten geschrieben werden. Sie können diesen Zeitschwellenwert in Sitzungsaufzeichnungsserver - Eigenschaften auf der Registerkarte Speicher einen Zeitschwellenwert festlegen, nach dessen Ablauf inaktive bzw. nicht ansprechbare Live-Aufzeichnungen automatisch geschlossen werden. Der Mindestwert ist 12 Stunden.

Sie können auch nicht ansprechbare bzw. inaktive Live-Aufzeichnungen mit dem Befehl ICLDB DORMANT schließen. 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 Zielsitzungsaufzeichnungsdatei angeben, mit dem Parameter CLOSEFILES können Sie von Ihnen angegebene Live-Aufzeichnungen, die nicht ansprechbar oder inaktiv sind, manuell schließen.

Tipp:

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