G.3 Migrate Agent-Dienstprogramm für Linux

Stellen Sie vor Installation oder Nutzung von Migrate Agent sicher, dass Ihr System die Anforderungen für das Migrate Agent-Dienstprogramm erfüllt.

G.3.1 Herunterladen und Installieren von Migrate Agent auf einem Linux-Ursprungs-Workload

Stellen Sie vor Installation des Migrate Agent-Dienstprogramms für Linux sicher, dass auf dem Ursprungscomputer die GNU C-Bibliothek (glibc) Version 2.11.3 oder höher installiert ist.

Sorgen Sie dafür, dass Sie die Anwendung mit der entsprechenden Architektur für Ihre Linux-Ursprungscomputer herunterladen. Bei der Eingabe des Dateinamens muss die Groß-/Kleinschreibung beachtet werden.

64 Bit: MigrateAgent-x86_64.tar.gz
32 Bit: MigrateAgent-x86.tar.gz

So können Sie das Migrate Agent-Dienstprogramm für Linux auf den Ursprungs-Workload herunterladen und dort installieren:

Melden Sie sich am Linux-Ursprungs-Workload als Root-Benutzer an.
Rufen Sie die Datei MigrateAgent-arch.tar.gz mit einer der folgenden Methoden ab.

Ersetzen Sie arch durch die entsprechende Architektur (x86_64 oder x86).
- Laden Sie die komprimierte Datei aus der Weboberfläche herunter:
  1. Starten Sie die PlateSpin Migrate-Weboberfläche in einem Webbrowser und melden Sie sich an.
    
    https://<Ihr_PlateSpin_Server >/Migrate
    
    Ersetzen Sie Ihr_PlateSpin_Server durch den DNS-Namen oder die IP-Adresse Ihres PlateSpin Migrate-Servers.
  2. Klicken Sie auf die Registerkarte Downloads.
  3. Klicken Sie auf den Migrate Agent-Anwendungslink für die entsprechende Linux-Plattform (x86_64 oder x86) und speichern Sie dann die Datei MigrateAgent-arch.tar.gz.
  – ODER –
- Kopieren Sie die Datei mit dem Befehl wget vom PlateSpin-Server.
  
  HINWEIS:Wenn das Betriebssystem auf dem PlateSpin Server-Host nur TLS 1.2-Verbindungen akzeptiert, verwenden Sie wget-Version 1.16.1 oder höher auf Ihrem Linux-Ursprungs-Workload.
  1. Starten Sie einen Terminal und geben Sie Folgendes ein:
    wget --no-check-certificate --http-user=<username> --http-password=<password> https://<Your_PlateSpin_Server>/Migrate/Downloads/MigrateAgent-<arch>.tar.gpz
    
    Ersetzen Sie Ihr_PlateSpin_Server durch den DNS-Namen oder die IP-Adresse Ihres PlateSpin Migrate-Servers. Ersetzen Sie arch durch x86_64 oder x86.
Öffnen Sie die Datei MigrateAgent-arch.tar.gz im Archive Manager. Extrahieren Sie dann das Verzeichnis MigrateAgent mitsamt Inhalt in das Verzeichnis root (/).

Alternativ geben Sie an einer Shell-Eingabeaufforderung Folgendes ein:
```
tar xvf MigrateAgent-<arch>.tar.gz
```
Ersetzen Sie arch durch x86_64 oder x86.
Wechseln Sie zum Verzeichnis /MigrateAgent und rufen Sie die Liste des Verzeichnisinhalts ab. Geben Sie Folgendes in einem Terminal ein:
```
cd MigrateAgent
ls
```
Das Verzeichnis enthält die Datei commands und die Skriptdatei MigrateAgent.
Rufen Sie die Befehlshilfe wie folgt auf:
```
./MigrateAgent -h
```

G.3.2 Migrate Agent-Befehle für Linux

Die Syntax zum Ausführen des Migrate Agent-Dienstprogramms lautet:

./MigrateAgent [Command] [-h]

Tabelle G-2 zeigt die verfügbaren Optionen und Argumente für den Befehl MigrateAgent unter Linux.

Tabelle G-2 Migrate Agent-Dienstprogramm für Linux – Befehlsoptionen und Argumente

Verwendung	Beschreibung
Befehle
Registrieren <Server> <Benutzer> [[-p Passwort] \| [-pf <Passwort-Dateipfad>]] Geben Sie für Server den DNS-Namen oder die IP-Adresse Ihres PlateSpin Migrate-Servers an. Geben Sie für Benutzer einen gültigen Benutzernamen eines verwaltungsbefugter Benutzers für den PlateSpin-Server an, der berechtigt ist, einen Workload hinzuzufügen. Führen Sie für das Passwort einen der folgenden Schritte aus: Verwenden Sie die Option -p und geben Sie das Passwort in den Befehl für den angegebenen PlateSpin-Benutzernamen ein. -p mypassword Verwenden Sie die Option „-pf“, um den Pfad zu einer Datei anzugeben, die das Passwort für den angegebenen PlateSpin-Benutzernamen enthält. -pf /tmp/jsmith-password-file.txt Geben Sie das Passwort nicht im Befehl an. Sie werden aufgefordert, das Passwort in die Kommandozeile einzugeben. Beispiel: ./MigrateAgent register 10.10.10.101 jsmith -p jspwd	Registriert diesen Computer als Workload auf dem angegebenen Server. Außerdem werden Treiberaufrüstungen auf dem angegebenen PlateSpin-Server gesucht. Ermöglicht das Hinzufügen von Workloads, die nicht ermittelt werden können. Registrierte Workloads unterscheiden sich von ermittelten Workloads wie folgt: In registrierten Ursprungs-Workloads wird der Ursprungs-Berechtigungsnachweis nicht gespeichert. Sie müssen den Migrate Agent verwenden, um die Linux-blkwatch-Treiber in registrierten Ursprungs-Workloads zu installieren, aufzurüsten und zu entfernen. Nach dem Löschen eines Vertrags für einen registrierten Ursprungs-Workload müssen Sie den OFX-Controller manuell aus dem Workload entfernen. Weitere Informationen hierzu finden Sie unter Abschnitt 42.2.2, Bereinigen von Linux-Workloads.
Status [<Server>] Geben Sie für Server den DNS-Namen oder die IP-Adresse Ihres PlateSpin Migrate-Servers an.	Zeigt den Installationsstatus für den Controller und die Treiber in PlateSpin. Wenn Sie den PlateSpin-Server angeben, werden Treiberaufrüstungen auf dem Server gesucht.
Treiberinstallation [<Server>] Geben Sie für Server den DNS-Namen oder die IP-Adresse Ihres PlateSpin Migrate-Servers an.	Installiert den richtigen PlateSpin-blkwatch-Treiber. Wenn Sie den PlateSpin-Server angeben, werden Treiberaufrüstungen auf dem Server gesucht.
Treiberupgrade [<Server>] Geben Sie für Server den DNS-Namen oder die IP-Adresse Ihres PlateSpin Migrate-Servers an.	Rüstet den installierten PlateSpin-blkwatch-Treiber auf. Wenn Sie den PlateSpin-Server angeben, werden Treiberaufrüstungen auf dem Server gesucht.
driver-uninstall	Deinstalliert den installierten PlateSpin-blkwatch-Treiber aus dem Linux-Ursprungs-Workload.
Konfigurieren <Server> <neuer-Server> Geben Sie für Server den DNS-Namen oder die IP-Adresse Ihres PlateSpin Migrate-Servers an. Geben Sie für neuer-Server den neuen DNS-Namen oder die neue IP-Adresse des PlateSpin Migrate-Servers an. Beispiel: ./MigrateAgent configure 10.10.10.10 10.10.20.20	Hält den OFX-Controller-Dienst (ofxcontroller) an, aktualisiert die OFX-Controller-Konfigurationsdatei mit der neuen Adresse und startet den Dienst neu. Wenn Sie die öffentliche IP-Adresse des PlateSpin-Servers ändern, müssen Sie diesen Befehl auf jedem Ursprungs-Workload ausführen, der für den Server konfiguriert ist.
Befehlsoptionen
Server	Gibt den DNS-Namen oder die IP-Adresse des PlateSpin Migrate-Servers an. Lädt die blkwatch-Treiber vom angegebenen Server herunter, sobald Sie die Option status, driver-install oder driver-upgrade aufrufen.
Benutzer	Gibt den Benutzernamen eines Administratorbenutzers für den PlateSpin-Server an, der berechtigt ist, einen Workload hinzuzufügen.
Optionen
-h, --help	Zeigt die Nutzung und die Optionen für den Befehl.
-p, --password -p <Benutzer-Passwort>	Gibt das Passwort für den Benutzernamen für den PlateSpin-Server an. Wenn Sie das Passwort nicht in der Befehlszeile eingeben, werden Sie durch das Skript zur Eingabe aufgefordert. Das Passwort wird beim Eingeben durch Platzhalterzeichen ersetzt und wird nicht in der Verarbeitungsliste angezeigt. Diese Option darf nicht mit der Option passwordfile kombiniert werden.
-pf, --passwordfile -pf <Pfad_der_Passwortdatei>	Gibt den Pfad zu einer Datei an, die das Passwort für den angegebenen Benutzernamen für den PlateSpin-Server enthält. Diese Option darf nicht mit der Option password kombiniert werden.
Protokollierung
logging.json	Enthält die Protokollierungs-Konfigurationseinstellungen im JSON-Format, mit denen die Aktivitäten des Migrate Agent-Dienstprogramms protokolliert werden sollen. Mit dem Befehl cat rufen Sie die Protokollierungseinstellungen auf: cat MigrateAgent/logging.json Sie können die Datei in einem Texteditor bearbeiten. Legen Sie die Protokollierungsebene fest. Ändern Sie hierzu den Wert "level:" von "DEBUG" in "INFO" oder "ERROR". Beispiel: "level": "DEBUG" Alternativ: "level": "INFO" Alternativ: "level": "ERROR" Die protokollierten Meldungen werden standardmäßig in die Datei MigrateAgent.log im Verzeichnis MigrateAgent geschrieben. Sie können die Einstellung für den Namen der Protokolldatei in der Datei logging.json bearbeiten.
MigrateAgent.log	Enthält die protokollierten Meldungen für den Befehl MigrateAgent. Mit dem Befehl cat rufen Sie das Protokoll auf. cat MigrateAgent.log