MobiLink Replay-Dienstprogramm (mlreplay)

Das mlreplay-Dienstprogramm ist ein Tool, mit dem die vom MobiLink-Server aufgezeichneten MobiLink-Protokollinformationen wiedergegeben werden können. Jede aufgezeichnete Datei wird als aufgezeichnete Protokolldatei bezeichnet. Alle von Anfang bis Ende einer Verbindung empfangenen Daten werden in einer separaten Protokolldatei aufgezeichnet. Jede aufgezeichnete Protokolldatei heißt recorded_protocol__x.mlr. Dabei ist x die Auftrags-ID. Mit der MobiLink-Serveroption -rp wird festgelegt, dass der MobiLink-Server alle von Clients empfangenen MobiLink-Protokollinformationen aufzeichnen soll. Siehe mlsrv12-Option -rp.

Zusätzlich zu den Daten, die vom und an den MobiLink-Server gesendet wurden, enthält die aufgezeichnete Protokolldatei auch Zeitinformationen. Damit kann mlreplay die aufgezeichneten Protokollinformationen genauso wiedergeben wie sie ursprünglich ausgeführt wurden. Anhand der Zeitinformationen wird auch versucht, dass der simulierte Client genauso lange benötigt wie der ursprüngliche Client.

Standardmäßig wird die aufgezeichnete Protokolldatei von mlreplay ohne Änderungen wiedergegeben. Sie können die Wiedergabesitzung jedoch mithilfe einer Reihe von Optionen anpassen. Die Informationen zum simulierten Client bestehen aus Benutzername, Kennwort, entfernter ID und letzter Downloadzeit. Diese Informationen können mit den Optionen -u, -p, -r (oder -rg) und -ldt angepasst werden.

Das mlreplay-Dienstprogramm kann eine aufgezeichnete Protokolldatei mit der Option -sci <simulierte_Clientinformationsdatei> auch gleichzeitig für mehrere simulierte Clients wiedergeben. Die Informationsdatei für simulierte Clients ist eine .CSV-Datei, die Benutzername, Kennwort, entfernte ID und letzte Downloadzeit der simulierten Clients auflistet. Das mlreplay-Dienstprogramm startet pro Informationszeile der Informationsdatei einen simulierten Client.

Die Wiedergabesitzung kann mit der Replay-API weiter angepasst werden.

Das mlreplay-Dienstprogramm enthält noch ein weiteres Tool, mlgenreplayapi. Das mlgenreplayapi-Tool liest eine aufgezeichnete Protokolldatei und generiert die Replay-API für das Schema dieser Datei. Die Replay-API kann geändert werden (nur der Code in mlreplaycallbacks.cpp muss geändert werden), um die während der Wiedergabesitzung auf den MobiLink-Server hochgeladenen Daten anzupassen. Die Replay-API wird dann in die Replay-DLL, mit der mlreplay die Wiedergabesitzung anpasst, kompiliert. Die Replay-DLL und eine Informationsdatei für simulierte Clients können nicht zur gleichen Zeit benutzt werden. Die Replay-API enthält einen Callback, der benutzt werden kann, um Informationen eines jeden simulierten Clients abzurufen. Die Anzahl der bei Verwendung der Replay-DLL zu startenden simulierten Clients wird beim Aufruf von mlreplay mit der Befehlszeilenoption -n angegeben. Siehe MobiLink Replay C++-Callback-Methoden.

Syntax

mlreplay [Optionen] [Name=Wert [Name2=Wert2...]] [[DLL_Name] Dateiname]

Option	Beschreibung
-ap	Passt den Fortschritt der in einer Wiedergabesitzung wiedergegebenen Synchronisationen an, damit das mlreplay-Dienstprogramm keine Warnungen wegen nicht übereinstimmenden Offsets auf dem MobiLink-Server verursacht.
-f Zeitskalenfaktor	Auf die aufgezeichneten Zeiten gleichmäßig angewendeter Multiplikator.
-ldt letzte_Downloadzeit	Geben Sie die während der Wiedergabesitzung an MobiLink-Server zu sendende letzte Downloadzeit an. Wenn das gerade wiedergegebene aufgezeichnete Protokoll mehrere Synchronisationen enthält (dies ist möglich, wenn eine beständige Verbindung aufgezeichnet wurde), wird nur die erste letzte Downloadzeit ersetzt. Der Rest wird durch die letzte Downloadzeit, zu der der MobiLink-Server während der Wiedergabesitzung MLReplay sendet, ersetzt. Auch wenn die Option -ldt nicht verwendet wird, ersetzt MLReplay in allen Synchronisationen außer der ersten die letzte Downloadzeit durch die während der Wiedergabesitzung vom MobiLink-Server empfangene letzte Downloadzeit. Eine letzte Downloadzeit kann auch mithilfe der Informationsdatei für simulierte Clients angegeben werden (wenn die Option -sci verwendet wird), oder über den IdentifySimulatedClient-Callback, wenn eine DLL bereitgestellt wird.
-n Anzahl_simulierter_Clients	Die Anzahl auszuführender simulierter Clients. Das Minimum ist 1.
-o Datei	Protokolliert Ausgabenachrichten in der festgelegten Datei.
-ot Datei	Kürzt die Datei und protokolliert dort Ausgabemeldungen.
-p Kennwort	Ersetzt Kennwörter durch das betreffende Kennwort.
-ping Sekunden	Pingt einen MobiLink-Server an, um zu ermitteln, ob der Server für den Empfang von Synchronisationen bereit ist. Standardmäßig pingt mlreplay den Server 60 Sekunden lang an. Wenn die Option -ping verwendet wird, sind die folgenden Rückgabecodes gültig: -1 Zeigt an, dass ein Fehler aufgetreten ist. 0 Gibt an, dass mlreplay den Server anpingen konnte, und dass der Server bereit ist, Synchronisationen zu empfangen. 1 Gibt an, dass mlreplay versucht hat, den Server anzupingen, aber keine Antwort erhielt, und dass der Server folglich nicht bereit ist, Synchronisationen zu empfangen.
-r Entfernte ID	Entfernte IDs durch angegebene entfernte ID ersetzen. Diese Option kann nicht mit der Option -rg verwendet werden.
-rg	Ersetzt entfernte IDs durch eine GUID.
-sci Datei	Versorgt mlreplay mit einer Liste von Benutzernamen, Kennwörtern und entfernten IDs für die Wiedergabe von Synchronisationen. mlreplay erstellt für jede Zeile der Datei einen Thread, um die Synchronisation mit diesen Clientinformationen wiederzugeben. Das Format der einzelnen Zeilen muss [Benutzername],[Kennwort],[entfernte ID] sein. Wenn ein Feld leer bleibt, verwendet mlreplay den entsprechenden Wert der aufgezeichneten Synchronisation. Beachten Sie, dass bei dieser Option die Optionen -u, -p und -r nicht verwendet werden können. Wenn -rg verwendet wird, werden alle leer gelassenen entfernten IDs durch eine GUID ersetzt und nicht durch die entfernte ID in der aufgezeichneten Synchronisation.
-u Benutzername	Ersetzt Benutzernamen durch den angegebenen Benutzernamen.
-x stream(opts)	Der Protokolldatenstrom und die Datenstromoptionen für die Verbindung mit dem MobiLink-Server.

Bemerkungen

Die für die ursprüngliche Synchronisation benötigte Zeit ist Teil der Aufzeichnung. mlreplay kann daher versuchen, die Synchronisation mit derselben Zeitdauer wiederzugeben.

Das mlreplay-Dienstprogramm kann eine aufgezeichnete Protokolldatei mehrmals gleichzeitig wiedergeben.

Verwenden Sie das mlreplay-Dienstprogramm mit den folgenden MobiLink-Serveroptionen:

-rp Geben Sie mit dieser Option das Verzeichnis an, in dem die Synchronisationen für die Wiedergabe mit dem mlreplay-Dienstprogramm aufgezeichnet wurden.
-rrp Verwenden Sie diese Option, um das mlreplay- Dienstprogramm auszuführen, wenn der MobiLink-Server gestartet wird.
-lsc Geben Sie mit dieser Option die Verbindungsinformationen für den lokalen Server an, damit das mlreplay-Dienstprogramm eine Verbindung zum Server herstellen kann.

Siehe auch

Kommentieren Sie diese Seite in DocCommentXchange.