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 \Program Files\Citrix\SessionRecording\Server\Bin auf dem Server mit der Serversoftware der Sitzungsaufzeichnung installiert.
Ü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\Binein und dannicldb /?. Um Hilfe für bestimmte Befehle zu erhalten, geben Sie Folgendes ein:icldb *command* /?.
| Befehl | Beschreibung |
|---|---|
ARCHIVE |
Archiviert die Sitzungsaufzeichnungsdateien, die Sie mit den Parametern RETENTION und FILTER angeben. Der Parameter RETENTION ist obligatorisch. Damit können Sie Sitzungsaufzeichnungsdateien bearbeiten, die älter als der angegebene Aufbewahrungszeitraum sind. Der Parameter FILTER ist optional. Sie können damit Dateipfade unter Verwendung der Platzhalter * und ? filtern. Wenn Sie den FILTER-Parameter hinzufügen, werden nur Sitzungsaufzeichnungsdateien bearbeitet, die sowohl die RETENTION- als auch die FILTER-Kriterien erfüllen. Sie können Aufzeichnungen und Ereignisse in den Aufzeichnungen zu archivieren. Die Ereignisse werden in der Datenbanktabelle ArchivedEvent archiviert. |
DORMANT |
Zählt oder zeigt die Sitzungsaufzeichnungsdateien an, die als inaktiv angesehen werden. Inaktive Dateien sind Sitzungsaufzeichnungen, die aufgrund von Datenverlust nicht abgeschlossen wurden. Verwenden Sie diesen Befehl, wenn Sie den Verdacht haben, dass Sie Daten verlieren. Sie können die ganze Datenbank oder nur Aufzeichnungen, die in der angegebenen Anzahl von Tagen, Stunden oder Minuten aufgezeichnet wurden, auf inaktiv gewordene Sitzungsaufzeichnungsdateien prüfen. |
IMPORT |
Importiert Sitzungsaufzeichnungsdateien in die Datenbank für die Sitzungsaufzeichnung. Mit diesem Befehl erstellen Sie die Datenbank neu, wenn Sie Datensätze der Datenbank verlieren. Mit diesem Befehl führen Sie auch Datenbanken zusammen (wenn Sie zwei Datenbanken haben, können Sie die Dateien von einer der Datenbanken importieren). In Release 2303 wurde der RELOCATE-Parameter für den Befehl IMPORT eingeführt. 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. |
LOCATE |
Sucht und zeigt den vollständigen Pfad einer Sitzungsaufzeichnungsdatei an. Als Kriterium wird die Datei-ID verwendet. Mit diesem Befehl suchen Sie den Speicherort einer Sitzungsaufzeichnungsdatei. Außerdem können Sie mit einer bestimmten Datei prüfen, ob die Datenbank aktuell ist. |
REMOVE |
Entfernt die Verweise auf Sitzungsaufzeichnungsdateien aus der Datenbank. Mit diesem Befehl bereinigen Sie die Datenbank (verwenden Sie diesen Befehl mit Vorsicht). Sie können auch die zugeordneten physischen Dateien löschen. Wenn Sie den Befehl REMOVE verwenden, geben Sie mithilfe der Parameter RETENTION und FILTER die gewünschten Sitzungsaufzeichnungsdateien an. Der Parameter RETENTION ist obligatorisch. Damit können Sie Sitzungsaufzeichnungsdateien bearbeiten, die älter als der angegebene Aufbewahrungszeitraum sind. Der Parameter FILTER ist optional. Sie können damit Dateipfade unter Verwendung der Platzhalter * und ? filtern. Wenn Sie den FILTER-Parameter hinzufügen, werden nur Sitzungsaufzeichnungsdateien bearbeitet, die sowohl die RETENTION- als auch die FILTER-Kriterien erfüllen. |
REMOVEALL |
Entfernt alle Verweise auf Sitzungsaufzeichnungsdateien aus der Datenbank für die Sitzungsaufzeichnung und setzt die Datenbank auf den Originalzustand zurück. Die Dateien selbst werden nicht gelöscht. Sie können sie jedoch nicht im Sitzungsaufzeichnungsplayer suchen. Mit diesem Befehl bereinigen Sie die Datenbank (verwenden Sie diesen Befehl mit Vorsicht). Gelöschte Verweise können nur von einem Backup wiederhergestellt werden. |
VERSION |
Zeigt die Schemaversion der Datenbank für die Sitzungsaufzeichnung an. |
/L |
Protokolliert die Ergebnisse und Fehler im Windows-Ereignisprotokoll. |
/F |
Erzwingt die Ausführung des Befehls ohne Aufforderungen. |
/S |
Unterdrückt die Copyright-Nachricht. |
/? |
Zeigt die Hilfe für die Befehle an. |
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:
-
/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. -
/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
-
Melden Sie sich als lokaler Administrator bei dem Server an, auf dem der Sitzungsaufzeichnungsserver installiert ist.
-
Rufen Sie eine Eingabeaufforderung auf.
-
Wechseln Sie vom aktuellen Arbeitsverzeichnis in das Bin-Verzeichnis des Sitzungsaufzeichnungsserver-Installationspfads (
<Session Recording server Installation Path>/Server/Bin). -
Führen Sie den Befehl
ICLDB ARCHIVE /RETENTION:<days> /LISTFILES /MOVETO:<directory> /NOTE:<note> /L. 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
-
Melden Sie sich als lokaler Administrator bei dem Server an, auf dem der Sitzungsaufzeichnungsserver installiert ist.
-
Rufen Sie eine Eingabeaufforderung auf.
-
Wechseln Sie vom aktuellen Arbeitsverzeichnis in das Bin-Verzeichnis des Sitzungsaufzeichnungsserver-Installationspfads (<Installationspfad>/Server/Bin).
-
Führen Sie den Befehl
ICLDB ARCHIVE /RETENTION:<days> /LISTFILES /NOTE:<note> /Laus. 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 ICLDB-Befehl ARCHIVE ausführen, können solche importierten Dateien wieder archiviert werden.
Der ICLDB-Befehl IMPORT eignet sich zum Importieren großer Zahlen archivierter Sitzungsaufzeichnungsdateien. 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. Sie können mit dem ICLDB-Befehl IMPORT außerdem die Datenbank für die Sitzungsaufzeichnung wieder auffüllen, nachdem der ICLDB-Befehl 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.
-
/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
-
Melden Sie sich als lokaler Administrator bei dem Server an, auf dem der Sitzungsaufzeichnungsserver installiert ist.
-
Sehen Sie im Sitzungsaufzeichnungsplayer unter “Eigenschaften” die Datei-ID und die Archivierungszeit der gewünschten Sitzungsaufzeichnungsdatei nach.
-
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. -
Kopieren Sie die Sitzungsaufzeichnungsdatei aus dem Backup in das Wiederherstellungsverzeichnis für archivierte Dateien. Suchen des Wiederherstellungsverzeichnisses für archivierte Dateien
-
Klicken Sie im Menü Start auf Start > Programme > Citrix > Sitzungsaufzeichnungsserver - Eigenschaften.
-
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
-
Melden Sie sich als lokaler Administrator bei dem Server an, auf dem der Sitzungsaufzeichnungsserver installiert ist.
-
Rufen Sie eine Eingabeaufforderung auf.
-
Wechseln Sie vom aktuellen Arbeitsverzeichnis in das Bin-Verzeichnis des Sitzungsaufzeichnungsserver-Installationspfads (
<Session Recording server installation path>/Server/Bin). -
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.
-
Verschieben Sie Sitzungsaufzeichnungsdateien nach Bedarf in andere Speicherpfade.
-
Melden Sie sich als lokaler Administrator bei dem Server an, auf dem der Sitzungsaufzeichnungsserver installiert ist.
-
Rufen Sie eine Eingabeaufforderung auf.
-
Wechseln Sie vom aktuellen Arbeitsverzeichnis in das Bin-Verzeichnis des Sitzungsaufzeichnungsserver-Installationspfads (
<Session Recording server installation path>/Server/Bin). -
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.