8.0 MigrateAgent-Dienstprogramm

Mit dem Befehlszeilenprogramm MigrateAgent (MigrateAgent.cli.exe) können Sie die Treiber für die blockbasierte Übertragung installieren, aufrüsten, abfragen und deinstallieren. Beim Installieren, Deinstallieren und Aufrüsten von Treibern muss in jedem Fall ein Neustart erfolgen; mit MigrateAgent können Sie präzise steuern, wann diese Aktionen ausgeführt werden, und somit, wann der Server neu gestartet wird. Mit diesem Dienstprogramm ist es beispielsweise möglich, die Treiber während einer geplanten Ausfallzeit statt während der ersten Reproduktion zu installieren.

Syntax des MigrateAgent-Dienstprogramms:

MigrateAgent.cli.exe [Option] [/psserver=%IP%]

Tabelle 8-1 beschreibt die verfügbaren Optionen und den verfügbaren Switch für den Befehl MigrateAgent.cli.exe.

Tabelle 8-1 Optionen und Schalter für „MigrateAgentCommand“

Verwendung

Beschreibung

Optionen

h |? | help

Zeigt die Nutzung und die Optionen für den Befehl.

logs|view-logs

Öffnet das Anwendungsprotokollverzeichnis.

status

Zeigt den Installationsstatus für den Controller und die Treiber in PlateSpin.

din|driver-install

Installiert die PlateSpin-Treiber.

dup|driver-upgrade

Rüstet die PlateSpin-Treiber auf.

dun|driver-uninstall

Deinstalliert die PlateSpin-Treiber.

Switch

/psserver=%IP%

Lädt die Treiber für die blockbasierte Übertragung vom angegebenen Server herunter, sobald Sie die Option status, driver-install oder driver-upgrade aufrufen.

Eine Kopie der Treiber für die blockbasierte Übertragung ist im Bundle mit dem MigrateAgent-Dienstprogramm enthalten. Alternativ können Sie die Treiber mit dem Befehlszeilenschalter /psserver= vom PlateSpin-Server herunterladen, sobald Sie die Option status, driver-install oder driver-upgrade aufrufen. Dies ist insbesondere dann von Nutzen, wenn der Server mit einem neuen Treiberpaket gepatcht wurde, das MigrateAgent-Befehlszeilenprogramm jedoch nicht.

HINWEIS:Zur Verdeutlichung: Bei der Verwendung von MigrateAgent wird empfohlen, zunächst die Treiber zu installieren, zu deinstallieren oder aufzurüsten und dann das System vor der Reproduktion neu zu starten.

Sie sollten das System bei jedem Installieren, Aufrüsten oder Deinstallieren der Treiber neu starten. Hierdurch wird der derzeit ausgeführte Treiber angehalten, und beim Neustart des Systems wird der neue Treiber angewendet. Wenn Sie das System vor der Reproduktion nicht neu starten, verhält sich der Ursprung weiterhin so, als wäre die Aktion nicht ausgeführt worden. Wenn Sie beispielsweise Treiber installieren und das System dann nicht neu starten, verhält sich der Ursprung so, als wären keine Treiber während der Reproduktion installiert worden. Wenn Sie die Treiber ohne Neustart aufrüsten, verwendet der Ursprung den derzeit ausgeführten Treiber entsprechend so lange weiter, bis Sie das System neu starten.

Mit der Option Status wird der Benutzer daran erinnert, einen Neustart vorzunehmen, falls die Version des installierten Treibers nicht mit der Version des ausgeführten Treibers identisch ist. Beispiel:

C:\MigrateAgent\MigrateAgent.cli.exe status
Step 1 of 2: Querying the PlateSpin controller service
   Done
Step 2 of 2: Querying the installed PlateSpin driver version
   Done

The task completed successfully
PlateSpin Controller Service Status
    The PlateSpin Controller service is not installed
   
PlateSpin Driver Status
    Installed Driver Version: 8.0.0.11
    Running Driver Version: Not running. Reboot to load the driver.
    Upgrade Available: No

PlateSpin erstellt eine Aufgabe, mit der der Benutzer darauf hingewiesen wird, dass zum Abschluss der Treiberinstallation oder -aufrüstung ein Neustart erforderlich ist. Die Benachrichtigung wird in der Aufgabenliste angezeigt (Abbildung 8-1). Während der Reproduktion wird die Benachrichtigung auf der Seite „Befehlsdetails“ angezeigt (Abbildung 8-2).

Abbildung 8-1 Aufgabe für Neustart-Benachrichtigung

Abbildung 8-2 Neustart-Benachrichtigung während der Reproduktion

Beim Neustarten des Ursprungscomputers werden die installierten oder aufgerüsteten Treiber angewendet und gestartet. Wenn der Treiber erst kürzlich installiert wurde, ist nach dem Neustart eine vollständige Reproduktion bzw. eine Serversynchronisierungs-Reproduktion erforderlich, damit alle Änderungen am Ursprung erfasst werden. Diese Serversynchronisierungs-Reproduktion wird dem Benutzer im Feld „Status“ als Warnmeldung angezeigt (Abbildung 8-3). Nachfolgende inkrementelle Reproduktionen werden ohne Warnmeldung ausgeführt.

Abbildung 8-3 Benachrichtigung über erforderliche Serversynchronisierung