Zuordnungen aktualisieren
Wenn die Zuordnungen aktualisiert wurden, beginnt das System damit, den Inhalt im Zielsystem zu verwenden. Führen Sie die folgenden Schritte aus, um die Zuordnungen zu aktualisieren:
1. Bereiten Sie die Eingabedatei vor.
2. Aktualisieren Sie die Zuordnungen.
Voraussetzungen:
• Azure Blob Storage-Konto ist mit Windchill konfiguriert.
• Windchill Server wird ausgeführt.
Eingabedatei vorbereiten
Verwenden Sie das Befehlszeilen-Dienstprogramm (PrepareInputDataForMountMigrationTool), um einen Bericht im CSV-Format zu generieren. Sie können diesen CSV-Bericht dann als Eingabe für MountMigrationTool verwenden, um die Zuordnungen zu aktualisieren. Der Bericht wird im Verzeichnis <Windchill>/logs/MountMigration/ gespeichert. Dieser Bericht enthält die folgenden Informationen:
• Stammordner – Eine Liste aller verfügbaren Stammordner
• Quellhost
• Quellzuordnungspfad
• Quell-Zuordnungstyp
• Zielzuordnungspfad
• Ziel-Zuordnungstyp – Standardmäßig ist azureBlob der Ziel-Zuordnungstyp.
Führen Sie den folgenden Befehl in der Windchill Shell aus, um alle möglichen Befehlszeilenoptionen aufzulisten:
windchill wt.fv.tools.datamigration.PrepareInputDataForMountMigrationTool mount -h
Nachfolgend finden Sie eine Liste gültiger Argumente:
• -h = <help> – Hilfe
• -u = <username> – Administrator-Benutzername
• -p = <password> – Administrator-Passwort
• -v = <verbose> – Führt das Dienstprogramm im Debug-Modus aus.
• -c = <container> – Name des Zielcontainers
• -a = <storageAccount> – Name des Zielspeicherkontos
• -t = <mountType> – Ziel-Zuordnungstyp (Standard-Zuordnungstyp ist azureBlob)
Führen Sie den folgenden Befehl in der Windchill Shell aus, um den Bericht zu generieren:
windchill wt.fv.tools.datamigration.PrepareInputDataForMountMigrationTool mount -u <userName> -p <password> -t <mountType>
Der Name des Zielspeicherkontos und der Name des Zielcontainers sind optionale Argumente. Geben Sie den Namen des Zielspeicherkontos und den Namen des Zielcontainers mithilfe der Argumente -a und -c an, um Zuordnungen von einem Azure-Speicher in einen anderen Azure-Speicher zu migrieren. Wenn der Quell-Zuordnungstyp azureBlob lautet, generiert das Tool automatisch den Zielzuordnungspfad basierend auf dem Namen des Zielspeicherkontos, dem Namen des Zielcontainers und der gleichen Verzeichnisstruktur wie der des Quellzuordnungspfads.
Wenn Sie Zuordnungen von dateibasierten Depots oder Amazon S3 Storage zu Azure-Speichern migrieren, geben Sie den Zielzuordnungspfad manuell im CSV-Bericht ein. In diesem Fall generiert das Tool den Zielzuordnungspfad nicht automatisch.
 |
• Die Depot-Verzeichnisstruktur im Azure-Quellspeicher und im Azure-Zielspeicher sollte gleich sein, um die korrekten Zielzuordnungspfade mit -a und -c Argumenten zu generieren. Wenn die Verzeichnisstruktur nicht gleich ist, muss der Zielzuordnungspfad manuell eingegeben werden.
• Wenn ein Stammordner mit der Eigenschaft AutoFolderCreation=false gefunden wird, wird ein Fehler in der Windchill Shell angezeigt. Führen Sie das Tool wt.fv.tools.FolderToRootFolderConverter aus, um diesen Fehler zu beheben.
• Wenn Sie Zuordnungen von dateibasierten Depots in andere dateibasierte Depots migrieren, geben Sie den Zielzuordnungspfad manuell im CSV-Bericht ein. In diesem Fall generiert das Tool den Zielzuordnungspfad nicht automatisch.
|
Zuordnungen aktualisieren
Sie können den im vorigen Schritt generierten CSV-Bericht als Eingabedatei verwenden, um Zuordnungen mithilfe von MountMigrationTool zu aktualisieren.
Führen Sie den folgenden Befehl aus, um alle möglichen Befehlszeilenoptionen aufzulisten:
windchill wt.fv.tools.datamigration.MountMigrationTool migrate -u <username> -p <password> -h
Nachfolgend finden Sie eine Liste gültiger Argumente:
• -h = <help> – Hilfe
• -u = <username> – Administrator-Benutzername
• -p = <password> – Administrator-Passwort
• -v = <verbose> – Führt das Dienstprogramm im Debug-Modus aus.
• -r = <rootFolderName> – Der Name des Stammordners
• -t = <newMountType> – Zuordnungstyp. Gültige Werte sind "amazonS3" und "azureBlob".
• -m = <newMountPath> – Zuordnungspfad auf Amazon S3 Storage oder Azure Blob Storage
• -i = <inputFile> – Der Pfad zur CSV-Eingabedatei
Führen Sie den folgenden Befehl in der Windchill Shell aus, um den Zuordnungstyp und -pfad für alle Stammordner gleichzeitig zu ändern:
windchill wt.fv.tools.datamigration.MountMigrationTool migrate -u <username> -p <password> -i <inputFile>
Führen Sie den folgenden Befehl in der Windchill Shell aus, um den Zuordnungstyp und -pfad für einen Stammordner nach dem anderen zu ändern:
windchill wt.fv.tools.datamigration.MountMigrationTool migrate -u <username> -p <password> -r <RootFolder name> -m <mount path on Azure Blob Storage Container> -t azureBlob
Beispiel:
windchill wt.fv.tools.datamigration.MountMigrationTool migrate -u <username> -p <password> -r defaultuploadfolder1 -m storageaccountname/testcontainer/defaultup -t azureBlob
Nach dem Ausführen des Dienstprogramms mit dem Argument -i zeigt die Zusammenfassung die folgenden Status an:
• Successful – Name der erfolgreich migrierten Stammordner
• Failed – Name der Stammordner, die nicht migriert werden konnten
• Skipped – Name der übersprungenen Stammordner, da sie bei der vorherigen Ausführung erfolgreich migriert wurden
Sie können auch den Zuordnungs-Migrationsstatus in der CSV-Eingabedatei anzeigen, nachdem das Dienstprogramm ausgeführt wurde. Sie können das MountMigrationTool mehrere Male mit derselben CSV-Eingabedatei ausführen.
|
|
Wenn während der Migration ein vorhandener Stammordner einen Spiegel-Stammzuordnungspfad in der Eingabedatei aufweist, wird nur der primäre Pfad verarbeitet, und die sekundären Pfade werden verworfen.
|
Als Alternative zum Befehlszeilentool können Sie die Zuordnung des Stammordners aufheben und ihn für Azure Blob über die Benutzeroberfläche der Depotkonfiguration bereitstellen. Achtung: Während Sie diese Operationen in der Benutzeroberfläche ausführen, dürfen Sie nicht auf Inhalte im Stammordner zugreifen. Wenn Sie eine einzelne Zuordnung mithilfe der Argumente -r, -t und -m migrieren, entfernen Sie die Markierung Read Only des migrierten Stammordners aus der Benutzeroberfläche der Depotkonfiguration. Der Stammordner, den Sie im Abschnitt System auf die Migration vorbereiten neu erstellt haben, kann Dateien enthalten, die im Rahmen dieser Depotmigration nicht aus dem Stammordner verschoben werden müssen.
Nachdem die Depotmigration abgeschlossen ist, stellen Sie die Revaulting- und Inhaltsreplikationszeitpläne wieder her, und konfigurieren Sie die Eigenschaft wt.fv.faultTolerantVaultsAutoRestore.