Zuordnungen aktualisieren
Führen Sie die folgenden Schritte aus, um Zuordnungen zu aktualisieren:
1. Bereiten Sie die Eingabedatei vor.
2. Aktualisieren Sie die Zuordnungen.
Voraussetzungen:
• Das Amazon S3 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.
• -b = <bucketName> – Name des Ziel-Buckets
• -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>
Wenn Zuordnungen von einem Amazon S3 Storage in einen anderen Amazon S3 Storage migriert werden, geben Sie den Namen des Ziel-Buckets mithilfe des Arguments -b und den Ziel-Zuordnungstyp als amazonS3 mit dem Argument -t an. Das Tool generiert automatisch den Zielzuordnungspfad basierend auf dem Namen des Ziel-Buckets und der Verzeichnisstruktur des Quellzuordnungspfads.
Wenn Sie Zuordnungen von dateibasierten Depots oder Azure Blob Storage in Amazon S3 Storage migrieren, geben Sie den Zielzuordnungspfad manuell im CSV-Bericht ein. In diesem Fall generiert das Tool den Zielzuordnungspfad nicht automatisch.
 |
• Die Depot-Verzeichnisstruktur im Quell-Amazon S3 Storage und Ziel-Amazon S3 Storage sollte gleich sein, um die korrekten Zielzuordnungspfade mit dem Argument -b 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> – 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> – CSV-Eingabedateipfad
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 Amazon S3 Storage> -t amazonS3
Beispiel:
windchill wt.fv.tools.datamigration.MountMigrationTool migrate -u <username> -p <password> -r defaultuploadfolder1 -m Testbucket/defaultup -t amazonS3
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.
Zusammenfassung der Befehle
windchill wt.fv.tools.FolderToRootFolderConverteraws
s3 cp C:\PTC\Windchill\vaults\defaultuploadvault s3://Testbucket/defaultuploadvault –recursive
snowball.bat start -i <ip address> -u <unlock code> -m <manifest file path>
snowball.bat ls
snowball.bat test -r <vault mount path on host machine>
snowball.bat mkdir s3://<bucketname>/<vaultname>
snowball.bat cp -r <path to vault> s3://<bucketname>/<vaultname>
snowball.bat validate <path on Amazon Snowball>
snowball.bat stopwindchill com.ptc.windchill.objectstorage.amazons3.tools.S3ConfigurationTool configure -u <username> -p <password>
windchill wt.fv.tools.datamigration.DataMigrationVerificationTool validateMigratedData -r <srcRootFolderName> -t <targetMountType> -m <targetMountPath> -u <userName> -p <password>
windchill wt.fv.tools.datamigration.MountMigrationTool migrate -r defaultuploadrootfolder -t amazonS3 -m Testbucket/defaultuploadvault -u <userName> -p <password>
s3 cp C:\PTC\Windchill\vaults\defaultuploadvault s3://Testbucket/defaultuploadvault –recursive
snowball.bat start -i <ip address> -u <unlock code> -m <manifest file path>
snowball.bat ls
snowball.bat test -r <vault mount path on host machine>
snowball.bat mkdir s3://<bucketname>/<vaultname>
snowball.bat cp -r <path to vault> s3://<bucketname>/<vaultname>
snowball.bat validate <path on Amazon Snowball>
snowball.bat stopwindchill com.ptc.windchill.objectstorage.amazons3.tools.S3ConfigurationTool configure -u <username> -p <password>
windchill wt.fv.tools.datamigration.DataMigrationVerificationTool validateMigratedData -r <srcRootFolderName> -t <targetMountType> -m <targetMountPath> -u <userName> -p <password>
windchill wt.fv.tools.datamigration.MountMigrationTool migrate -r defaultuploadrootfolder -t amazonS3 -m Testbucket/defaultuploadvault -u <userName> -p <password>